先配身份与连接地址
密码负责 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 | 省略时采用此项 |
| ws | ws-opts | 用于指定 WebSocket 的 Host、路径与 Early Data |
| grpc | grpc-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都要相应调整。
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