# AnyTLS 客户端配置示例

资料与配置校验日期：2026-11-01。

这两份文件是 VPNDevelop 的教学示例，不是免费节点、订阅或一键生产部署方案。`example.com` 只是占位域名，不是本文提供的 AnyTLS 服务。使用前必须替换为你获授权使用的服务器地址、端口、认证密码和证书对应名称。

## 文件及用途

| 文件 | 实现 | 已完成的验证 |
| --- | --- | --- |
| `sing-box-client.json` | sing-box | 官方 1.14.4 darwin/arm64 二进制 `check` 通过 |
| `mihomo-client.yaml` | mihomo | 官方 1.19.33 darwin/arm64 二进制 `-t` 通过 |

两份文件是完整的最小客户端配置示例，不是只含一个出站的片段。它们使用本机 `127.0.0.1:1080` 的 HTTP/SOCKS 混合代理入口，不启用 TUN、局域网访问、远程控制接口、自动系统代理或全设备接管；只有主动使用该代理入口的应用流量才会进入此示例。两个程序不能同时占用同一个本地端口。

**本次只完成配置格式和静态安全检查，未启动代理服务，未进行 TLS 握手、认证、转发或中国大陆网络实测。** 配置检查通过不代表节点存在、证书有效、密码正确、所有客户端兼容或目标网络可用。不要把文件原样启动后对 `example.com` 做代理请求。

## 修改前的安全检查

1. 将 `server` 换成自己的节点地址，保持服务器端口与服务端监听一致。
2. 将 `REPLACE_WITH_YOUR_OWN_PASSWORD` 换为该节点分配的高强度密码，不要在截图、公开仓库或工单中泄露它。
3. sing-box 的 `tls.server_name`、mihomo 的 `sni` 应与实际服务端证书及部署要求匹配；不能随意填另一个网站名称。
4. 保持 sing-box 的 `tls.enabled: true`、`tls.insecure: false`，以及 mihomo 的 `skip-cert-verify: false`。证书报错应检查名称、有效期、链与受信任CA，不以关闭验证作为常规修复。
5. 当前示例依赖系统信任的证书链。私有CA、自签证书或证书固定需要依据所用实现另行配置，并规划更新与撤销流程。
6. 根据已安装的真实版本再次校验；示例没有验证所有旧版本。支持 AnyTLS 的内核并不自动证明每个 GUI、订阅转换器或 App 都完整支持。

## 参数与默认值

- sing-box 的 `idle_session_check_interval` 与 `idle_session_timeout` 使用时长字符串，例如 `"30s"`；mihomo 对应字段用连字符，示例填写数字 `30`，单位为秒。
- 官方文档列出的两个检查/超时默认值均为 30 秒；`min_idle_session` / `min-idle-session` 默认均为 **0**。sing-box 官方结构示例里的 `5` 是展示值，不是默认值。本示例显式写为 0，并不声称这是所有网络的最优配置。
- `min_idle_session` 指空闲会话保留数量，不是同时在线用户数，也不是连接越多越快。
- mihomo 的 `udp: true` 表示允许该实现转发 UDP 业务，不表示 AnyTLS 外层变成原生 UDP/QUIC。
- 未加入 `client_metadata`、TLS指纹、ALPN、ECH、REALITY或自定义填充等高级设置，避免把不同实现的能力和参数混在一起。
- 两份示例均不设置直连故障回退；该代理出站失败时，不应靠一条自动直连规则掩盖失败。此处也不承诺整个操作系统的流量保护。

## 重新校验

安装对应官方软件后，在下载目录执行以下**检查命令**，不要把检查命令误认为启动命令：

```sh
sing-box check -c sing-box-client.json
mihomo -t -f mihomo-client.yaml
```

正式接入还需在你控制的测试环境验证：正确与错误证书、认证失败、连接超时、业务 TCP/UDP、DNS和路由、网络切换、重连与备用入口。记录版本、设备、运营商和时间，勿把个别成功样本写成全国稳定可用。

## 官方依据

- [sing-box AnyTLS 出站](https://sing-box.sagernet.org/configuration/outbound/anytls/)
- [sing-box AnyTLS 入站](https://sing-box.sagernet.org/configuration/inbound/anytls/)
- [sing-box TLS](https://sing-box.sagernet.org/configuration/shared/tls/)
- [sing-box mixed 入站](https://sing-box.sagernet.org/configuration/inbound/mixed/)
- [mihomo AnyTLS](https://wiki.metacubex.one/config/proxies/anytls/)
- [mihomo TLS](https://wiki.metacubex.one/config/proxies/tls/)
- [mihomo 全局配置](https://wiki.metacubex.one/config/general/)
- [AnyTLS 参考实现及安全提醒](https://github.com/anytls/anytls-go)

本文与示例由 VPNDevelop 整理，不代表协议项目或客户端开发者背书。