nat

package

v0.0.1 Latest Latest Go to latest Published: Jan 1, 2026 License: MIT Imports: 6 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/netxops/unicontroller

Links

Open Source Insights

Documentation ¶

Constants ¶

View Source

const (
	TransTypeSNAT = "SNAT" // 转换类型为snat
	TransTypeDNAT = "DNAT" // 转换类型为dnat
	TransTypeBNAT = "BNAT" // 转换类型为bnat
)

TransType 转换类型（请求参数）

View Source

const (
	NATTypeSNAT = "SNAT" // 转换类型为源地址转换
	NATTypeDNAT = "DNAT" // 转换类型为目的地址转换
	NATTypeBNAT = "BNAT" // 转换类型为双向地址转换
)

NATType NAT类型（响应中的natType）

View Source

const (
	DstNetobjTypeZone      = "ZONE"      // 区域
	DstNetobjTypeInterface = "INTERFACE" // 接口
)

DstNetobjType 目的网络对象类型（SNAT使用）

View Source

const (
	DstIPobjTypeIPGroup = "IPGROUP" // IP组
	DstIPobjTypeIP      = "IP"      // 指定的IP列表
)

DstIPobjType 目的IP对象类型（DNAT/BNAT使用）

View Source

const (
	TransferTypeOutifIP = "OUTIF_IP" // 出接口ip
	TransferTypeIPRange = "IP_RANGE" // ip范围
	TransferTypeIP      = "IP"       // 单个IP
	TransferTypeIPGroup = "IPGROUP"  // ip组
	TransferTypeNoTrans = "NO_TRANS" // 不转换
)

TransferType 转换类型（SNAT源转换）

View Source

const (
	DNATTransferTypeIPRange  = "IP_RANGE"  // ip范围
	DNATTransferTypeIP       = "IP"        // 单个IP
	DNATTransferTypeIPPrefix = "IP_PREFIX" // 转换前缀
	DNATTransferTypeIPGroup  = "IPGROUP"   // ip组
	DNATTransferTypeNoTrans  = "NO_TRANS"  // 不转换
	DNATTransferTypeSLBPool  = "SLB_POOL"  // slb地址池转换
)

DNATTransferType DNAT转换类型

View Source

const (
	StickyOff    = "OFF"    // 关闭sticky功能
	StickyStrict = "STRICT" // 开启sticky功能严格模式
	StickyLoose  = "LOOSE"  // 开启sticky功能宽松模式
)

Sticky 转换模式开关

View Source

const (
	TranferModeStatic  = "STATIC"  // 静态转换
	TranferModeDynamic = "DYNAMIC" // 动态转换
)

TranferMode 转换模式

View Source

const (
	PortModeRandom      = "RANDOM"       // 自由分配
	PortModeStaticBlock = "STATIC_BLOCK" // 静态端口段
)

PortMode 端口分配类型

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type BNATInfo ¶

type BNATInfo struct {
	SrcZones      []string        `json:"srcZones"`      // 需要匹配的源区域
	SrcIPGroups   []string        `json:"srcIpGroups"`   // 需要匹配的源IP组
	DstIPobj      DstIPobj        `json:"dstIpobj"`      // 需要匹配的目的IP组或者IP
	NatService    []string        `json:"natService"`    // 引用的服务组
	TransferDst   BNATTransferDst `json:"transferDst"`   // 目的转换相关数据
	DNATIgnoreACL bool            `json:"dnatIgnoreAcl"` // 忽略访问控制
	BypassACLLog  bool            `json:"bypassAclLog"`  // 忽略访问控制匹配上策略上报会话日志
	TransferSrc   BNATTransferSrc `json:"transferSrc"`   // 源转换相关数据
}

BNATInfo BNAT信息

type BNATTransferDst ¶

type BNATTransferDst struct {
	TransferType         string      `json:"transferType"`         // 转换类型
	DNATEnableScheduling bool        `json:"dnatEnableScheduling"` // 双向转换使用负载均衡
	IPRange              *IPRange    `json:"ipRange"`              // 转换的IP范围，当transferType转换类型为IP_RANGE时选择
	SpecifyIP            string      `json:"specifyIp"`            // 转换的单个IP，当transferType转换类型为IP时选择
	IPPrefix             string      `json:"ipPrefix"`             // IPv4网段,掩码格式
	IPGroups             []string    `json:"ipGroups"`             // 转换的IP组，当transferType转换类型为IPGROUP时选择
	TransferPort         []PortRange `json:"transferPort"`         // 转换端口，数组为空表示不转换端口
	SLBPool              string      `json:"slbPool"`              // 引用负载均衡地址池对象
}

BNATTransferDst BNAT目的转换信息

type BNATTransferSrc ¶

type BNATTransferSrc struct {
	TransferType string   `json:"transferType"` // 转换类型
	IPRange      *IPRange `json:"ipRange"`      // 转换的IP范围，当transferType转换类型为IP_RANGE时选择
	TranferMode  string   `json:"tranferMode"`  // 转换模式 (STATIC/DYNAMIC)
	SpecifyIP    string   `json:"specifyIp"`    // 转换的单个IP，当transferType转换类型为IP时选择
	IPGroups     []string `json:"ipGroups"`     // 转换的IP组，当transferType转换类型为IPGROUP时选择
}

BNATTransferSrc BNAT源转换信息

type Client ¶

type Client struct {
	// contains filtered or unexported fields
}

Client NAT策略客户端

func NewClient ¶

func NewClient(host, token, sessid string, httpClient *http.Client) *Client

NewClient 创建新的NAT策略客户端

func (*Client) GetNats ¶

func (c *Client) GetNats(req *GetNatsRequest) (*GetNatsResponse, error)

GetNats 获取NAT策略列表

type DNATInfo ¶

type DNATInfo struct {
	SrcZones      []string     `json:"srcZones"`      // 需要匹配的源区域
	SrcIPGroups   []string     `json:"srcIpGroups"`   // 需要匹配的源IP组
	DstIPobj      DstIPobj     `json:"dstIpobj"`      // 需要匹配的目的IP组或者IP
	NatService    []string     `json:"natService"`    // 引用的服务组
	Transfer      DNATTransfer `json:"transfer"`      // 目的地址转换相关数据
	DNATIgnoreACL bool         `json:"dnatIgnoreAcl"` // 忽略访问控制
	BypassACLLog  bool         `json:"bypassAclLog"`  // 忽略访问控制匹配上策略上报会话日志
}

DNATInfo DNAT信息

type DNATTransfer ¶

type DNATTransfer struct {
	TransferType         string      `json:"transferType"`         // 目的转换类型
	DNATEnableScheduling bool        `json:"dnatEnableScheduling"` // 目的转换使用负载均衡
	IPRange              *IPRange    `json:"ipRange"`              // 转换的IP范围，当transferType转换类型为IP_RANGE时选择
	SpecifyIP            string      `json:"specifyIp"`            // 转换的单个IP
	IPPrefix             string      `json:"ipPrefix"`             // IPv4网段,掩码格式
	IPGroups             []string    `json:"ipGroups"`             // 转换的IP组
	TransferPort         []PortRange `json:"transferPort"`         // 转换端口，数组为空表示不转换端口
	SLBPool              string      `json:"slbPool"`              // 引用负载均衡地址池对象
}

DNATTransfer DNAT转换信息

type DstIPobj ¶

type DstIPobj struct {
	DstIPobjType string   `json:"dstIpobjType"` // 目的类型 (IPGROUP/IP)
	SpecifyIP    []string `json:"specifyIp"`    // 指定的IP数组，当dstIpobjType目的类型为IP时选择
	IPGroups     []string `json:"ipGroups"`     // 目的地址指定的IP组，当dstIpobjType目的类型为IPGROUP时选择
}

DstIPobj 目的IP对象（DNAT/BNAT使用）

type DstNetobj ¶

type DstNetobj struct {
	DstNetobjType string   `json:"dstNetobjType"` // 需要匹配的目的类型 (ZONE/INTERFACE)
	Interface     string   `json:"interface"`     // 目的接口，当dstNetobjType类型为INTERFACE时选择
	Zone          []string `json:"zone"`          // 目的区域，当dstNetobjType类型为ZONE时选择
}

DstNetobj 目的网络对象（SNAT使用）

type GetNatsRequest ¶

type GetNatsRequest struct {
	// 起始位置，从 0 开始 (0-2000000, 默认0)
	Start int
	// 移动搜索参数项 (1-95字符)
	MoveSearch string
	// 获取最大长度，限制最大值，如果数据不够可能返回小于 length (1-200, 默认100)
	Length int
	// 移动搜索位置参数项
	Position int
	// 选择字段，字段用逗号分隔 (最大1000字符)
	Select string
	// NAT名字前缀过滤 (1-95字符)
	NamePrefix string
	// 模糊搜索关键字 (最大95字符)
	Search string
	// 用于指定转换类型, 可选SNAT,DNAT,BNAT
	TransType string
}

GetNatsRequest 获取NAT策略请求参数

type GetNatsResponse ¶

type GetNatsResponse struct {
	Code    int    `json:"code"`    // 错误码
	Message string `json:"message"` // 错误信息
	Data    struct {
		TotalItems    int32     `json:"totalItems"`    // 总共多少项目
		TotalPages    int32     `json:"totalPages"`    // 总共多少页
		PageNumber    int32     `json:"pageNumber"`    // 当前页码，从 1 开始
		PageSize      int32     `json:"pageSize"`      // 每页多大
		ItemsOffset   int32     `json:"itemsOffset"`   // 当前条目偏移，从 0 开始
		ItemLength    int32     `json:"itemLength"`    // 数据列表长度
		PrivateOffset uint64    `json:"privateOffset"` // 内部偏移
		Items         []NATItem `json:"items"`         // 有效数据列表
	} `json:"data"`
}

GetNatsResponse 获取NAT策略响应

func (*GetNatsResponse) IsSuccess ¶

func (r *GetNatsResponse) IsSuccess() bool

IsSuccess 检查请求是否成功

type IPRange ¶

type IPRange struct {
	Start string `json:"start"` // IP范围起始地址
	End   string `json:"end"`   // IP范围结束地址
}

IPRange IP范围

type NATItem ¶

type NATItem struct {
	UUID        string    `json:"uuid"`        // 唯一标识ID
	Name        string    `json:"name"`        // 策略名称
	NATHit      uint64    `json:"natHit"`      // nat策略匹配次数
	Enable      bool      `json:"enable"`      // 是否启用
	Position    int32     `json:"position"`    // 表示位置状态
	NATType     string    `json:"natType"`     // nat类型 (SNAT/DNAT/BNAT)
	Description string    `json:"description"` // 描述
	Schedule    string    `json:"schedule"`    // 生效时间，引用时间计划对象
	SNAT        *SNATInfo `json:"snat"`        // snat信息,策略类型为源地址转换时使用
	DNAT        *DNATInfo `json:"dnat"`        // dnat信息,策略类型为目的地址转换时使用
	BNAT        *BNATInfo `json:"bnat"`        // bnat信息,策略类型为双向转换时使用
}

NATItem NAT策略项

type PortRange ¶

type PortRange struct {
	Start int32 `json:"start"` // 网络端口起始值 (0-65535)
	End   int32 `json:"end"`   // 网络端口结束值 (0-65535)
}

PortRange 端口范围

type SNATInfo ¶

type SNATInfo struct {
	SrcZones    []string  `json:"srcZones"`    // 需要匹配的源区域
	SrcIPGroups []string  `json:"srcIpGroups"` // 需要匹配的源IP组
	DstNetobj   DstNetobj `json:"dstNetobj"`   // 需要匹配的目的区域或者接口
	DstIPGroups []string  `json:"dstIpGroups"` // 需要匹配的目的IP组
	NatService  []string  `json:"natService"`  // 引用的服务组
	Transfer    Transfer  `json:"transfer"`    // 源地址转换相关数据
}

SNATInfo SNAT信息

type TransPort ¶

type TransPort struct {
	PortMode  string    `json:"portMode"`  // 端口分配类型 (RANDOM/STATIC_BLOCK)
	PortRange PortRange `json:"portRange"` // 端口范围
	BlockSize uint16    `json:"blockSize"` // 端口段大小
}

TransPort 源转换端口配置参数

type Transfer ¶

type Transfer struct {
	TransferType string     `json:"transferType"` // 源转换类型
	Sticky       string     `json:"sticky"`       // 转换模式开关 (OFF/STRICT/LOOSE)
	IPRange      *IPRange   `json:"ipRange"`      // 源转换IP范围参数，当transferType转换类型为IP_RANGE时选择
	TranferMode  string     `json:"tranferMode"`  // IP范围转换模式 (STATIC/DYNAMIC)
	SpecifyIP    string     `json:"specifyIp"`    // 转换的单个IP
	IPGroups     []string   `json:"ipGroups"`     // 转换的IP组
	TransPort    *TransPort `json:"transPort"`    // 源转换端口配置参数
}

Transfer SNAT转换信息

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Documentation ¶

Index ¶

Constants ¶

Variables ¶

Functions ¶

Types ¶

type BNATInfo ¶

type BNATTransferDst ¶

type BNATTransferSrc ¶

type Client ¶

func NewClient ¶

func (*Client) GetNats ¶

type DNATInfo ¶

type DNATTransfer ¶

type DstIPobj ¶

type DstNetobj ¶

type GetNatsRequest ¶

type GetNatsResponse ¶

func (*GetNatsResponse) IsSuccess ¶

type IPRange ¶

type NATItem ¶

type PortRange ¶

type SNATInfo ¶

type TransPort ¶

type Transfer ¶

Source Files ¶