client

package
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 27, 2026 License: AGPL-3.0 Imports: 18 Imported by: 0

Documentation

Overview

Package client 实现 Agent 到主控的 WebSocket 客户端: 认证、心跳、断线指数退避重连、指令处理与回执、流量采集上报。

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Client

type Client struct {
	BaseURL         string // ws://<主控地址>/node/ws(连接时追加 ?node_id=)
	NodeID          string
	Secret          string
	Heartbeat       time.Duration
	ReconnectMax    time.Duration
	Xray            *xrayproc.Proc
	Collector       *collector.Collector
	Stats           *stats.Collector
	CollectInterval time.Duration
	ReportInterval  time.Duration
	// Phase T:内部账户存储 + 证书落盘目录
	Accounts *accounts.Store
	CertsDir string
	// Upgrade 升级源(repo/mirror 来自节点配置 update 段);nil = 面板触发升级不可用。
	// SelfRestart 升级完成后的重启回调(systemd 服务内由 main 注入 systemctl restart);
	// nil = 手动运行模式,替换后仅提示手动重启。
	Upgrade     *upgrade.Fetcher
	SelfRestart func() error
	// XrayUpgrade xray 内核升级源(repo 恒为 XTLS/Xray-core,镜像沿用 update 段);nil = 不支持内核替换。
	XrayUpgrade *upgrade.XrayFetcher
	// GeoDir 规则库目录(内核升级时从同一发布包同步 geoip.dat/geosite.dat);空 = 默认值。
	GeoDir string

	// Outbox 持久化发件箱(审计 F1):采集到的增量先落盘成不可变批次,收到主控
	// traffic_ack(ok) 才删批。nil 时 Run 内建纯内存发件箱(等价旧行为,仅供测试)。
	Outbox *outbox.Outbox
	// contains filtered or unexported fields
}

Client 节点端客户端。

func (*Client) Run

func (c *Client) Run(ctx context.Context)

Run 常驻运行:流量采集上报 + 连接/服务/重连。

func (*Client) TriggerHeartbeat added in v0.1.15

func (c *Client) TriggerHeartbeat()

TriggerHeartbeat 立即发一帧心跳(告警用:xray 放弃自动拉起时把原因尽快送达主控)。

func (*Client) TriggerReconnect

func (c *Client) TriggerReconnect()

TriggerReconnect 主动断开当前长连接以触发指数退避外的立即重连(如 Xray 重启后向主控重新对齐用户)。

Jump to

Keyboard shortcuts

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