代理协议 · 配置文档

Trojan 的连接密码、握手名称和证书怎样核对

配置 Trojan 时,先确认密码和握手身份,再区分连接安全扩展、承载方式与 UDP 开关,逐项对齐远端要求。

  • password
  • TLS
  • SNI
  • Reality
  • UDP
章节索引

先配身份与连接地址

密码负责 Trojan 的身份认证,TLS 则是连接所必需的安全层。配置写入 proxies 数组后,还须逐项对上远端的地址、端口和握手名称。

先完成基础连接项,再加入 password。SNI 未单列时取 server 的地址;涉及域名证书、CDN 或 Reality 时,应另行核对握手名称。

name必填
给此出站取一个独立名称,避免配置内重名。
type必填
协议类型应写作 trojan。
server必填
在此指定远端主机,可使用域名,也可使用 IP。
port必填
填入远端实际监听的端口,不能凭示例推定。
password必填
认证用的密码由远端提供,字符内容需逐一相符。

再检查握手身份

对 Trojan 而言,TLS 并非由 tls: true 这项额外打开。握手所用名称、应用协议协商、客户端指纹以及证书检查方式,需要分别设置。

sni可选
此处决定 TLS 握手名称;未设置便取 server。使用域名证书或 CDN 时,先确认该名称能与证书对应。
alpn可选
列出 TLS 协商的应用协议,并核对远端与承载方式是否接受这些取值。
client-fingerprint可选
此项描述 uTLS 的客户端握手特征。取值可为 chrome,也可为 random;所指对象是客户端而非证书。
fingerprint可选
此处用于固定证书的 SHA-256 摘要;client-fingerprint 描述的则是另一类信息。
skip-cert-verify谨慎
开关写为 true 就会略过证书检查;排查结束后应恢复身份校验。
name-cert-verify可选
可单独调整检查证书时使用的 DNSName,实际发送的 SNI 仍保持原值。
certificate / private-key可选
若远端要求 mTLS,再成对提供客户端证书与私钥。

按远端选用安全扩展

是否需要 Reality、ShadowTLS、Restls 或 JLS,取决于远端启用了哪种连接层。确认适用项后再填参数,避免把相冲突的方案叠在一起。

reality-opts.public-keyReality
使用与远端 Reality 私钥配对的公钥。
reality-opts.short-idReality
从远端接受的 short ID 中取值。
reality-opts.support-x25519mlkem768可选
只有通信双方均支持 X25519-MLKEM768,才声明使用该密钥交换能力。
shadow-tls-opts按服务端
远端采用 ShadowTLS 才配置其版本及密码;sni 仍承担握手名称的作用。
restls-opts按服务端
密码及 TLS 版本提示应随远端 Restls 设置填写。
jls-opts按服务端
若远端选用 JLS,则提供它要求的用户名和密码。

确认承载方式再填参数

可选的承载方式是 WebSocket 或 gRPC。network 留空,或者给出这里未识别的取值,连接都会走 TCP。

承载选项与对应设置
network关联参数如何使用
tcp不另设专用 opts省略时采用此项
wsws-opts用于指定 WebSocket 的 Host、路径与 Early Data
grpcgrpc-opts用于填写 gRPC 的服务名及连接选项
network可选
可显式选择 ws 或 grpc;超出这些选项时将使用 TCP。
ws-optsWebSocket
WebSocket 的 Host、路径和 Early Data 需同时核对远端及反向代理设置。
grpc-optsgRPC
将 grpc-service-name 与其余连接选项对照远端逐项填写。
smux仅 TCP
sing-mux 适用的范围是 TCP,不能把它当成 gRPC 自带的复用机制。

区分 UDP 开关与附加加密

是否放行 UDP,与 trojan-go 的 Shadowsocks AEAD 扩展分别控制不同能力;未启用该扩展就无需配置 ss-opts。

udp可选
初始值为 false;要允许 UDP,应改成 true,并核实远端也能处理。
ss-opts.enabled可选
远端 trojan-go 开启 Shadowsocks AEAD 扩展后,此项才应置为 true。
ss-opts.method默认 aes-128-gcm
扩展接受的算法依次列为 aes-128-gcm、aes-256-gcm 及 chacha20-ietf-poly1305,选择须与远端相符。
ss-opts.password启用时必填
这里的扩展密码不可为空;另需填写顶层 password 完成 Trojan 认证。

读懂示例并定位错配

此处以 TLS 承载 Trojan 展示基础字段。WebSocket、Reality、gRPC 及 ss-opts 均须先获远端支持,再增补到配置。

  • 检查 network 的承载选项,不能因 TLS 协商支持 h2,就推定它和 alpn: [h2] 是相同设置。
  • 握手不成功时,对照反向代理域名、SNI 以及证书检查所用名称。
  • 附加扩展的 ss-opts.password 无法顶替顶层 password 所承担的协议认证。
  • 远端若采用 gRPC,客户端的承载方式及 grpc-service-name 都要相应调整。
YAML
proxies:
  - name: trojan-tls
    type: trojan
    server: edge.example.com
    port: 443
    password: your-trojan-password
    sni: origin.example.com
    alpn:
      - h2
      - http/1.1
    client-fingerprint: chrome
    udp: true
    network: tcp