TLS 握手失败时,alpn 经常被误当成“开启 HTTPS”的开关。sing-box 官方共享 TLS 文档把它定义为应用层协议协商列表,入站和出站都可以出现;它需要与对端实际支持的协议相容。alpn 不能替代 server_name、证书校验或传输协议,列表写对也不等于远端一定接受。
先锁定实际 TLS 连接
保存原配置和最早一条握手错误,确认报错来自代理出站、DNS 加密连接还是其他 TLS 组件。连接超时、证书名称不匹配和 ALPN 协商失败属于不同层次,先定位组件再改字段。服务提供方或你管理的服务端文档是协议列表的依据,不要从无关网站复制值。
alpn 是数组;常见协议名称是否可用必须由端点说明确认。下面的写法只展示字段形状,h2 和 http/1.1 仅作为说明用占位,不代表任何服务的必填值:
{
"tls": {
"enabled": true,
"alpn": ["由服务端文档确认的协议"]
}
}
一次只改协商列表
- 记录现有
server_name、地址、端口、证书校验状态和出站标签,先备份。 - 依据服务端文档把
alpn改成明确支持的顺序,运行配置检查;不要同时改insecure、指纹或传输层。 - 完全建立一条新连接,查看日志是否进入 TLS 握手,以及协商出的协议或首个错误。
- 若 ALPN 错误消失但证书错误出现,转查名称和信任链;若仍超时,回到地址、端口和网络路径。
- 用原配置复测一次,确认差异只来自列表。问题未定位时恢复备份,不要把
insecure当作验收条件。
观察日志时,先记下握手阶段的第一条错误和本次连接使用的出站标签,再比较修改前后的结果。若对端明确返回“不支持协议”,才继续调整列表顺序或成员;若错误停留在连接建立前,优先检查地址、端口和网络路径。多个 TLS 组件共用一份配置时,必须确认实际生效的是哪一个对象,否则容易把无关连接的日志当成证据。测试结束后关闭旧连接,清除只在内存中的临时状态,再用同一目标建立新会话。这样可以判断变化来自协商,而不是复用的旧握手。无法从服务端资料确认协议时,保持原列表并向服务维护者核实,避免盲目扩大兼容范围。
证书主机名的检查步骤见 server_name 证书域名,指纹字段的边界见 uTLS 指纹排查。回滚后要关闭旧连接并重新建立会话,旧会话不能证明恢复成功。
官方来源
来源核验日期:2026-10-26。本文只把 alpn 作为官方定义的协商数组说明,具体协议值以对应服务端文档为准。