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
// MetricsInterval 快车道实时指标周期(agent.yaml 的 metrics_interval,默认 3s)。
MetricsInterval time.Duration
ReconnectMax time.Duration
Xray *xrayproc.Proc
Collector *collector.Collector
Stats *stats.Collector
CollectInterval time.Duration
ReportInterval time.Duration
// 证书落盘目录(push_cert / push_ca / sync_certs)
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) TriggerHeartbeat ¶ added in v0.1.15
func (c *Client) TriggerHeartbeat()
TriggerHeartbeat 立即发一帧心跳(告警用:xray 放弃自动拉起时把原因尽快送达主控)。
func (*Client) TriggerReconnect ¶
func (c *Client) TriggerReconnect()
TriggerReconnect 主动断开当前长连接以触发指数退避外的立即重连(如 Xray 重启后向主控重新对齐用户)。
Click to show internal directories.
Click to hide internal directories.