L4 上游

状态：Current

最后核对：2026-05-15

路由：/gateway/l4-upstreams

L4 上游是 L4 链 target stage 可复用的目标端点，也携带入口 SNI 匹配名， 供端口管理计算 TCP TLS 分流路由。

表格字段

字段	含义
Status	是否启用。
Name	运维显示名称。
Endpoint	目标主机/IP 和端口，IPv6 使用 [addr]:port。
SNI	可选入口 TLS/SNI 名称，用于 L4 端口分流。
Actions	编辑或删除。

数据规则

• 创建时需要 name 和 endpoint。
• 当前 UI 里 name 只在创建时可写；编辑时只更新 endpoint、SNI、interval 和启用状态。
• server_names 会自动 trim、lowercase、去空和去重。
• health_check_interval_ms 默认是 0，表示关闭。
• API 不再接受 health_check_path。

创建上游

需要 admin 或 operator。

1. 打开 L4 Upstreams。
2. 点击 Add。
3. 输入名称、IP/主机和端口。
4. 可选填写 SNI，每行一个。
5. 可选填写 TCP ping 间隔，0 表示关闭。
6. 点击 Create。

新的 L4 链会按 upstream id 引用目标，上游 endpoint 变化不会破坏引用。 旧的 endpoint-only 链仍会用 endpoint fallback，修改 endpoint 后请检查旧链。 保存后，SNI 名称会统一转成小写并去重。

SNI 分流

server_names 是入口 ClientHello 匹配条件，用于端口管理页展示和计算 TCP TLS 分流路由。它不会覆盖出站拨号 SNI。