基线：XHTTP + REALITY 直连#

1
{
2
  "inbounds": [
3
    {
4
      "listen": "0.0.0.0",
5
      "port": 443,
6
      "protocol": "vless",
7
      "settings": {
8
        "users": [{ "id": "你的UUID" }],
9
        "decryption": "none"
10
      },
11
      "streamSettings": {
12
        "method": "xhttp",
13
        "xhttpSettings": { "path": "/yourpath" }, // mode 不填 = auto
14
        "security": "reality",
15
        "realitySettings": {
16
          "target": "www.some-site.com:443",
17
          "serverNames": ["www.some-site.com"],
18
          "privateKey": "PrivateKey",
19
          "shortIds": [""]
20
        }
21
      }
22
    }
23
  ],
24
  "outbounds": [{ "protocol": "freedom" }]
25
}

1
{
2
  "inbounds": [
3
    {
4
      "listen": "127.0.0.1",
5
      "port": 10808,
6
      "protocol": "socks",
7
      "settings": { "udp": true }
8
    }
9
  ],
10
  "outbounds": [
11
    {
12
      "protocol": "vless",
13
      "settings": {
14
        "address": "你的VPS_IP",
15
        "port": 443,
16
        "id": "你的UUID",
17
        "encryption": "none"
18
      },
19
      "streamSettings": {
20
        "method": "xhttp",
21
        "xhttpSettings": { "path": "/yourpath" },
22
        "security": "reality",
23
        "realitySettings": {
24
          "serverName": "www.some-site.com",
25
          "password": "xray x25519 -i 私钥 得到的 Password",
26
          "shortId": "",
27
          "fingerprint": "chrome",
28
          "spiderX": "/"
29
        }
30
      },
31
      // XHTTP 不能开 mux.cool；concurrency 填负数关掉 TCP 复用，XUDP 走聚合隧道
32
      "mux": { "enabled": true, "concurrency": -1, "xudpConcurrency": 16 }
33
    }
34
  ]
35
}

过 CDN（TLS）#

cf1.domain.com 开启橙云、CF 面板 SSL 模式为 Full (strict)，服务端持证书。

1
"streamSettings": {
2
  "method": "xhttp",
3
  "xhttpSettings": { "path": "/yourpath" },
4
  "security": "tls",
5
  "tlsSettings": {
6
    "alpn": ["h2", "http/1.1"],
7
    "certificates": [{
8
      "certificateFile": "/home/vpsadmin/xray_cert/xray.crt",
9
      "keyFile": "/home/vpsadmin/xray_cert/xray.key"
10
    }]
11
  },
12
  // CF 回源必带 CF-Connecting-IP，用它当哨兵头决定是否信任 XFF
13
  "sockopt": { "trustedXForwardedFor": ["CF-Connecting-IP"] }
14
}

客户端 H2 版，address 填优选 IP，serverName 填域名：

1
{
2
  "settings": {
3
    "address": "优选 IP",
4
    "port": 443,
5
    "id": "你的UUID",
6
    "encryption": "none"
7
  },
8
  "streamSettings": {
9
    "method": "xhttp",
10
    "xhttpSettings": { "path": "/yourpath" },
11
    "security": "tls",
12
    "tlsSettings": { "serverName": "cf1.domain.com", "fingerprint": "chrome" }
13
  }
14
}

使用 H3 需显式指定 alpn：

1
"tlsSettings": { "serverName": "cf1.domain.com", "alpn": ["h3"], "fingerprint": "chrome" }

使用 H2 且要流式上行时显式指定 mode（需 CF 面板开 gRPC 支持）：

1
"xhttpSettings": {
2
  "path": "/yourpath",
3
  "mode": "stream-up"   // 或 stream-one
4
}

有的 CDN 会限速 stream-one 但不限 stream-up，遇到断流或降速尝试切换模式或调整混淆参数；若 CDN 对请求体大小敏感，可调分包节奏：

1
"xhttpSettings": {
2
  "path": "/yourpath",
3
  "extra": {
4
    "scMaxEachPostBytes": "500000-1000000",   // 需小于 CDN 允许的最大请求体
5
    "scMinPostsIntervalMs": "10-50"
6
  }
7
}

客户端连接 CF 边缘 IP，CF 用边缘证书握手，按 Host 回源到 VPS，验证 Origin 证书后转发给 Xray。

CF 会掐断下行 100 秒无实际数据的 HTTP，代理长连接需应用层保活，比如使用 sshd 的 ClientAliveInterval。

对于 Fastly、Gcore、CloudFront 这类非 CF 的 CDN 时，trustedXForwardedFor 需使用对应 CDN 每次回源都稳定携带的头（比如Fastly 的 Fastly-Client-IP，CloudFront 的 CloudFront-Viewer-Address），并确认 CDN 把真实客户端 IP 放进了 X-Forwarded-For。

常见问题：

1. 服务端日志报 invalid x_padding length:0、请求被 400。优先考虑是 CDN 未将 URL 的 query string 透传回源，例如 CloudFront 的缓存策略默认不带 query string，需在 Cache Policy 里把 query string 设为转发全部。

2. CDN 或 WAF 识别并拦截 ?x_padding= 导致 403，请求无法回源。考虑把 padding 挪出 URL，开启 xPaddingObfsMode 后把 xPaddingPlacement 设为 cookie 或 header，或尝试更改 xPaddingKey，做法见 把元数据搬出 URL。

Nginx 前置（TLS）#

Nginx 持真证书监听 443，XHTTP 入站监听本地明文：

1
server {
2
    listen 443 ssl;
3
    http2 on;
4
    server_name cf1.domain.com;
5
    ssl_certificate     /etc/ssl/fullchain.pem;
6
    ssl_certificate_key /etc/ssl/privkey.pem;
7

8
    location /yourpath {
9
        grpc_pass grpc://127.0.0.1:1234;          # stream-up / stream-one 用这个
10
        grpc_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
11
        grpc_set_header X-From-Front 1;           # 哨兵头，供 trustedXForwardedFor 匹配
12
        grpc_read_timeout 1h;
13
        grpc_send_timeout 1h;
14
    }
15

16
    location / { root /var/www/html; }            # 其余路径是正常网站
17
}

Xray 入站：

1
{
2
  "listen": "127.0.0.1",
3
  "port": 1234,
4
  "protocol": "vless",
5
  "settings": { "users": [{ "id": "你的UUID" }], "decryption": "none" },
6
  "streamSettings": {
7
    "method": "xhttp",
8
    "xhttpSettings": { "path": "/yourpath" },
9
    "sockopt": { "trustedXForwardedFor": ["X-From-Front"] }
10
  }
11
}

TLS 在 Nginx 终结，按 path 把 /yourpath 以 h2c 转发本地 1234，其余路径当普通网站服务。防御主动探测，TLS 指纹是 Nginx 的而非 Go 的。

TLS 版本由 Nginx 决定，特殊情况可回退 TLS 1.2，用于规避审查方对来自某些机房的 TLS 1.3 进行阻断的策略。

packet-up 模式下 grpc_pass 不适用，更换普通反代并关闭缓冲：

1
location /yourpath {
2
    proxy_pass http://127.0.0.1:1234;
3
    proxy_http_version 1.1;
4
    proxy_buffering off;              // 下行必须关，否则流式下行退化
5
    proxy_request_buffering off;
6
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
7
    proxy_set_header X-From-Front 1;
8
    proxy_read_timeout 1h;
9
}

客户端不出现新块，沿用 上文 的字段。

如需使用 H3，使用 Nginx ≥ 1.25 并监听 QUIC 即可，回源的 location 不变：

1
listen 443 quic reuseport;   # H3，需 Nginx ≥ 1.25
2
listen 443 ssl;
3
http2 on;
4
http3 on;
5
add_header Alt-Svc 'h3=":443"; ma=86400';

客户端 alpn 指定 ["h3"]。

Caddy 默认开启 H3，reverse_proxy 到同一个入站即可。

Cloudflare Worker / Snippet 反代前置#

不想让源站域名直接开橙云回源，可以用 Worker（或更轻量的 Snippet）把请求改写到后端域名再转发，客户端连接 Worker 路由绑定的域名：

1
export default {
2
  async fetch(request) {
3
    const url = new URL(request.url);
4
    const backends = ["b1.origin.com", "b2.origin.com"]; // 后端域名，多填即随机挑
5
    url.hostname = backends[Math.floor(Math.random() * backends.length)];
6
    return fetch(new Request(url, request));
7
  },
8
};

CF 面板里给 Worker 绑定 front.domain.com/yourpath* 路由，客户端 address/serverName/host 指向 front.domain.com，path、UUID、padding 原样透传。

前置域名与源站解耦，适用于随机挑后端、给已被阻断的源站套层 CF 或希望把前置逻辑与回源分开的情况，受 Worker 的 CPU 与子请求配额限制。

Cloudflare Argo 隧道（cloudflared 内网穿透）#

前面几种过 CDN 的方案都要求源站有公网 IP 且要监听端口。依赖 Argo 隧道允许源站无监听端口，公网 IP 和证书。

适合 NAT VPS、无 DDNS 且只有动态 IPv6 的机器、回源端口受限或源站 IP 无法直连的情况。

XHTTP 入站监听本地明文，由 cloudflared 的 ingress 按域名直接转发：

1
{
2
  "listen": "127.0.0.1",
3
  "port": 1234,
4
  "protocol": "vless",
5
  "settings": { "users": [{ "id": "你的UUID" }], "decryption": "none" },
6
  "streamSettings": {
7
    "method": "xhttp",
8
    "xhttpSettings": { "path": "/yourpath" }
9
  }
10
}

cloudflared 固定隧道配置：

1
tunnel: 你的隧道ID
2
credentials-file: /home/vpsadmin/.cloudflared/你的隧道ID.json
3
protocol: auto # 隧道到 CF 边缘的传输，优先尝试 QUIC(UDP 7844)，异常时自动回落 H2，如已确定 UDP 被封锁或环境对 QUIC 支持不佳，可直接指定为 http2
4
ingress:
5
  - hostname: cf1.domain.com
6
    service: http://127.0.0.1:1234
7
    originRequest:
8
      http2Origin: true # 回源本地入站用 H2，XHTTP 需要
9
  - service: http_status:404

客户端沿用 过 CDN（TLS） 的字段，serverName 与 host 填隧道绑定的 cf1.domain.com。

注意：

• 必须用固定（命名）隧道，trycloudflare 临时隧道不支持 XHTTP
• 回源经隧道只有 H2，TLS 由 CF 边缘和隧道负责，Xray 入站明文 h2c
• 一条隧道可按 hostname 分流给多个入站，也能和 Worker 前置配合使用

上下行分离#

downloadSettings 是一套完整的 streamSettings 外加 address/port，method 必须为 "xhttp"（不可省略），security 可为 "tls" 或 "reality"。

sockopt 项也可被分享，上行 sockopt 设 "penetrate": true 可覆盖下行，适合使用 mark 的情况。

1
"streamSettings": {
2
  "method": "xhttp",
3
  "security": "tls",
4
  "tlsSettings": { "serverName": "cf1.domain.com", "fingerprint": "chrome" },
5
  "xhttpSettings": {
6
    "path": "/yourpath",
7
    "mode": "stream-up",    // 不能使用 stream-one
8
    "extra": {
9
      "downloadSettings": {
10
        "address": "优选 IPv6",
11
        "port": 443,
12
        "method": "xhttp",
13
        "security": "tls",
14
        "tlsSettings": { "serverName": "cf1.domain.com", "alpn": ["h3"], "fingerprint": "chrome" },
15
        "xhttpSettings": { "path": "/yourpath" }   // path 必须一致
16
      }
17
    }
18
  }
19
}

1
"streamSettings": {
2
  "method": "xhttp",
3
  "security": "tls",
4
  "tlsSettings": { "serverName": "cf1.domain.com", "fingerprint": "chrome" },
5
  "xhttpSettings": {
6
    "path": "/yourpath",
7
    "mode": "stream-up",
8
    "extra": {
9
      "downloadSettings": {
10
        "address": "另一家 CDN 的 IP",
11
        "port": 443,
12
        "method": "xhttp",
13
        "security": "tls",
14
        "tlsSettings": { "serverName": "b.other-cdn.com", "fingerprint": "chrome" },
15
        "xhttpSettings": { "path": "/yourpath" }
16
      }
17
    }
18
  }
19
}

1
"streamSettings": {
2
  "method": "xhttp",
3
  "security": "tls",
4
  "tlsSettings": { "serverName": "cf1.domain.com", "fingerprint": "chrome" },
5
  "xhttpSettings": {
6
    "host": "cf3.domain.com",       // 客户端发送优先级 host > serverName > address
7
    "path": "/yourpath",
8
    "mode": "stream-up",
9
    "extra": {
10
      "downloadSettings": {
11
        "address": "优选 IP",
12
        "port": 443,
13
        "method": "xhttp",
14
        "security": "tls",
15
        "tlsSettings": { "serverName": "cf2.domain.com", "alpn": ["h3"], "fingerprint": "chrome" },
16
        "xhttpSettings": { "host": "cf3.domain.com", "path": "/yourpath" }
17
      }
18
    }
19
  }
20
}

1
"xhttpSettings": {
2
  "path": "/yourpath",
3
  "mode": "stream-up",
4
  "extra": {
5
    // 上行数据少，全挤在一条底层连接上；过 Nginx 时须限制 hMaxRequestTimes 和 hMaxReusableSecs
6
    "xmux": {
7
      "maxConcurrency": 0, "maxConnections": 1, "cMaxReuseTimes": 0,
8
      "hMaxRequestTimes": 0, "hMaxReusableSecs": 0, "hKeepAlivePeriod": 0
9
    },
10
    "downloadSettings": {
11
      "address": "回程优的 IP",
12
      "port": 443,
13
      "method": "xhttp",
14
      "security": "tls",
15
      "tlsSettings": { "serverName": "cf1.domain.com", "fingerprint": "chrome" },
16
      "xhttpSettings": {
17
        "path": "/yourpath",
18
        "extra": {
19
          // 下行数据多，每条底层连接只跑一个请求，摊到多条链路
20
          "xmux": {
21
            "maxConcurrency": 1, "maxConnections": 0, "cMaxReuseTimes": 0,
22
            "hMaxRequestTimes": 0, "hMaxReusableSecs": 0, "hKeepAlivePeriod": 0
23
          }
24
        }
25
      }
26
    }
27
  }
28
}

1
{
2
  "inbounds": [
3
    // XHTTP 明文入站，监听本地
4
    {
5
      "listen": "127.0.0.1",
6
      "port": 1234,
7
      "protocol": "vless",
8
      "settings": { "users": [{ "id": "你的UUID" }], "decryption": "none" },
9
      "streamSettings": {
10
        "method": "xhttp",
11
        "xhttpSettings": { "path": "/yourpath" },
12
        "sockopt": { "trustedXForwardedFor": ["CF-Connecting-IP"] }
13
      }
14
    },
15
    // 入口 A：REALITY 监听 443，非法 VLESS 首包回落到 1234
16
    {
17
      "listen": "0.0.0.0",
18
      "port": 443,
19
      "protocol": "vless",
20
      "settings": {
21
        "users": [{ "id": "一个用不到的UUID" }],
22
        "decryption": "none",
23
        "fallbacks": [{ "dest": 1234, "xver": 0 }]
24
      },
25
      "streamSettings": {
26
        "method": "raw",
27
        "security": "reality",
28
        "realitySettings": {
29
          "target": "www.some-site.com:443",
30
          "serverNames": ["www.some-site.com"],
31
          "privateKey": "PrivateKey",
32
          "shortIds": [""]
33
        }
34
      }
35
    }
36
  ],
37
  "outbounds": [{ "protocol": "freedom" }]
38
}

1
server {
2
    listen 8443 ssl;
3
    http2 on;
4
    server_name cf1.domain.com;
5
    ssl_certificate     /etc/ssl/fullchain.pem;
6
    ssl_certificate_key /etc/ssl/privkey.pem;
7

8
    location /yourpath {
9
        proxy_pass http://127.0.0.1:1234;
10
        proxy_http_version 1.1;
11
        proxy_buffering off;
12
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
13
        proxy_read_timeout 1h;
14
        proxy_send_timeout 1h;
15
    }
16
}

1
{
2
  "settings": {
3
    "address": "你的VPS_IP",
4
    "port": 443,
5
    "id": "你的UUID",
6
    "encryption": "none"
7
  },
8
  "streamSettings": {
9
    "method": "xhttp",
10
    "security": "reality",
11
    "realitySettings": {
12
      "serverName": "www.some-site.com",
13
      "password": "Password",
14
      "shortId": "",
15
      "fingerprint": "chrome"
16
    },
17
    "xhttpSettings": {
18
      "path": "/yourpath",
19
      "mode": "stream-up",
20
      "extra": {
21
        "downloadSettings": {
22
          "address": "优选 IP",
23
          "port": 443,
24
          "method": "xhttp",
25
          "security": "tls",
26
          "tlsSettings": {
27
            "serverName": "cf1.domain.com",
28
            "alpn": ["h3"],
29
            "fingerprint": "chrome"
30
          },
31
          "xhttpSettings": { "path": "/yourpath" }
32
        }
33
      }
34
    }
35
  }
36
}

443 端口复用#

443 监听 raw + REALITY 入站，REALITY 鉴权失败的流量回落本机 Nginx，由 Nginx 提供伪装站并将 /yourpath 反代到内部 XHTTP 入站；REALITY 鉴权通过但首包非法的流量回落到同一个内部 XHTTP 入站：

1
{
2
  "inbounds": [
3
    // 内部 XHTTP 入站，监听本地
4
    {
5
      "listen": "127.0.0.1", // 也可使用 Unix socket
6
      "port": 1234,
7
      "protocol": "vless",
8
      "settings": {
9
        "users": [{ "id": "XHTTP 的 UUID" }],
10
        "decryption": "none"
11
      },
12
      "streamSettings": {
13
        "method": "xhttp",
14
        "xhttpSettings": { "path": "/yourpath" },
15
        // CF 回源带 CF-Connecting-IP，Nginx 前置注入 X-From-Front
16
        "sockopt": {
17
          "trustedXForwardedFor": ["CF-Connecting-IP", "X-From-Front"]
18
        }
19
      }
20
    },
21
    // raw + REALITY入站，承载 Vision 直连，其余回落
22
    {
23
      "listen": "0.0.0.0",
24
      "port": 443,
25
      "protocol": "vless",
26
      "settings": {
27
        "users": [{ "id": "Vision 的 UUID", "flow": "xtls-rprx-vision" }],
28
        "decryption": "none",
29
        "fallbacks": [{ "dest": 1234, "xver": 0 }] // XHTTP 的 H2 preface 非法，回落到 1234
30
      },
31
      "streamSettings": {
32
        "method": "raw",
33
        "security": "reality",
34
        "realitySettings": {
35
          "target": "127.0.0.1:8443",
36
          "serverNames": ["your.domain.com"],
37
          "privateKey": "PrivateKey",
38
          "shortIds": [""]
39
        }
40
      }
41
    }
42
  ],
43
  "outbounds": [{ "protocol": "freedom" }]
44
}

XHTTP 的 UUID 只在内部入站校验，几种客户端出站方案共用同一个 path 和 UUID。Nginx 配置参考 Nginx 前置，将监听端口改为8443，并给 your.domain.com 配置 server_name 用于主动探测回落即可。

不能使用 path 进行回落，REALITY/TLS 下为 H2，path 提取只解析 H1 的明文请求行，且 XHTTP 会在 path 后追加 UUID 和 seq，H1 下同样无法匹配。

元数据搬出 URL#

默认情况下会话 ID、seq 拼在 path，padding 置于 Referer，位置固定；请求混淆 的参数能把 packet-up 伪装成普通带 cookie 的 GET，请求变成一串没有 body 的 GET：

1
"xhttpSettings": {
2
  "path": "/yourpath",
3
  "mode": "packet-up",
4
  "extra": {
5
    "xPaddingObfsMode": true,
6
    "xPaddingPlacement": "cookie",
7
    "xPaddingKey": "_ga",
8
    "xPaddingMethod": "tokenish",
9
    "sessionIDPlacement": "cookie",
10
    "sessionIDKey": "sid",
11
    "sessionIDTable": "Base62",
12
    "sessionIDLength": "16-24",
13
    "seqPlacement": "cookie",
14
    "seqKey": "n",
15
    "uplinkDataPlacement": "cookie",
16
    "uplinkDataKey": "d",
17
    "uplinkHTTPMethod": "GET"
18
  }
19
}

uplinkDataPlacement 和 uplinkHTTPMethod 的 GET 仅支持 packet-up 模式，会话 ID 从 UUID 换成 16-24 位的 Base62 串，更像普通 session token。

cookie 每块只装 2 到 3 KB（uplinkChunkSize 可调），上行一大就是一长串 cookie，所以只适合上行小或应对 body 检查的场景。

下行 GET 的 Content-Type: text/event-stream 可由服务端配置 noSSEHeader 去掉；使用 stream-up/one 时，上行的 application/grpc 伪装可由客户端配置 noGRPCHeader 去掉。

Browser Dialer#

使用真实浏览器的网络栈和 TLS 指纹发起连接，数据经本地 WebSocket 回到 Xray，有一定的性能损耗：

1
XRAY_BROWSER_DIALER=127.0.0.1:8080 ./xray -c config.json

浏览器打开 localhost:8080 并保持。注意：

• address 必须是域名，要指定 IP 就改系统 hosts 或内置 DNS
• tlsSettings 将失效，HTTP 版本由浏览器决定，SNI == host == address
• 浏览器到服务端必须直连

Firefox 93+ 在严格追踪保护 / 隐私窗口下会无视 unsafe-url 等宽松 referrer 策略并裁掉跨站请求的 Referer(Mozilla 安全博客)，padding 默认置于 Referer 会连不上，把 padding 挪到 header 即可以解决。

四层调优（BBR / TFO / MPTCP）#

XHTTP 走 H1/H2 时底层是一条 TCP，可在 sockopt 里对它做拥塞控制、握手和多路径调优：

1
"streamSettings": {
2
  "method": "xhttp",
3
  "xhttpSettings": { "path": "/yourpath" },
4
  "sockopt": {
5
    "tcpFastOpen": true,      // TFO，省一次握手往返
6
    "tcpCongestion": "bbr",   // 这条连接单独用 BBR
7
    "tcpMptcp": true          // MPTCP 多路径
8
  }
9
}

注意：

• tcpCongestion 使用 bbr 前先确认内核支持，sockopt 只改这条连接，全局启用需要 sysctl 设置 net.core.default_qdisc=fq 和 net.ipv4.tcp_congestion_control=bbr
• tcpMptcp 需要 Linux 5.6+ 且 net.mptcp.enabled=1，客户端所在系统也要支持，只开一端等于没开
• tcpFastOpen 也可以填队列长度（整数），需客户端、服务端、中间盒都放行，任一环节失败回退普通握手
• 过 CDN 时客户端到 CF 边缘的握手由 CF 决定，sockopt 只对 CF 回源段、直连与自建反代链路有意义
• 上下行分离时上行、下行各有各的 sockopt；上行设 "penetrate": true 可覆盖下行

FinalMask 给 H3 调拥塞控制#

1
"streamSettings": {
2
  "method": "xhttp",
3
  "xhttpSettings": { "path": "/yourpath" },
4
  "security": "tls",
5
  // 直连，serverName 用解析到 VPS 的域名（灰云或主域）
6
  "tlsSettings": { "serverName": "domain.com", "alpn": ["h3"], "fingerprint": "chrome" },
7
  "finalmask": {
8
    "quicParams": { "congestion": "force-brutal", "brutalUp": "30 mbps" },
9
    "udp": [
10
      // v26.9.9 起端口跳跃是独立的 UDP mask，须在最外层，仅客户端
11
      { "type": "udphop", "settings": { "remotePorts": "20000-50000", "interval": "5-10", "mode": "intervalRemote" } }
12
    ]
13
  }
14
}

XHTTP H3 无协商机制，不支持 brutal，只能用免协商的 force-brutal，它强制上行按 brutalUp 定速发包。两者都只对 H3 直连有意义。

不适用套 CDN 的方案。套 CF 时 force-brutal 定速的是客户端到对端的 QUIC，到 CF 边缘终止并以 H2/H1 回源；端口跳跃改的是客户端 QUIC 的目标端口，而 CF 边缘只在标准端口接收 QUIC。

端口跳跃在 v26.9.9 从 quicParams.udpHop 挪到了 finalmask.udp 下，字段 ports 改为 remotePorts 且必须显式指定 mode：

• “intervalRemote”：周期换远端端口，底层 socket 和本地源端口不动，最经典的端口跳跃
• “intervalLocal”：周期换本地源端口，跳跃点新开本地 UDP socket
• “perConnRemote”：每条连接定一次，之后整条连接固定不变

老写法在新版会被静默丢弃；服务端要让被跳到的整段端口都能到达 QUIC 监听端口，一般在 nftables/iptables 对端口段进行重定向。

H3 直连默认带着 quic-go 的 Chrome QUIC 指纹（零长 Connection ID），要关掉可在 quicParams 里设 disableChromeParrot。官方文档不建议服务端裸跑 quic-go H3，更推荐藏在真 Nginx/Caddy 后面。

Cloudflare#

橙云子域：CF 代理流量，可做 CDN 优选、域前置、回源目标。

灰云子域：CF 只做 DNS 解析、不代理，只有灰云才能解析出真实 IP，适合给直连节点当 address。

当面板 SSL 模式为 Flexible 时，CF 回源走明文 HTTP，建议使用 Full (strict) 并配证书。

回源端口需要是 Cloudflare 支持的端口，非标端口（比如 10086）需使用 Origin Rule 重写回源端口。

CF 面板可选设置 Cache Rules，按 CDN 主机名或 XHTTP path 匹配、缓存资格设为绕过（Bypass），虽然 XHTTP 下行本来就不进缓存，但可以预防 CF 版本行为变化。

VLESS Encryption#

过 CDN 时外层 TLS 终结在 CF 边缘，CF 解密后能看到内层 VLESS 明文。纯 VLESS 自身不加密，能读到明文的包括 CF 本身，以及回源段若非 Full (strict) 时 CF 与 VPS 之间的中间人。

VLESS Encryption 在 VLESS 内层端到端认证加密，独立于外层 TLS 与公共 CA 体系，客户端预置服务端静态公钥（X25519 或 ML-KEM-768），每条连接做临时密钥交换，兼具前向安全与后量子安全；载荷走 AES-256-GCM / ChaCha20-Poly1305，即使 CF 或链路上任何人拿着有效证书 MITM 掉外层 TLS，没有服务端静态私钥也无法伪造内层握手和读取内容。

执行 xray vlessenc 生成配对的 decryption/encryption，输出含 X25519 与 ML-KEM-768 两版，二选一不要混用（握手本身两者都后量子安全，ML-KEM-768 版额外能防客户端参数泄露后被未来量子计算机破解出私钥冒充服务端）

配置串以 . 分块:

1
"mlkem768x25519plus.<mode>.<rtt>.<padding...>.<key>[.<key>...]"

mlkem768x25519plus 为握手方式，<mode> 为流量外观：

• “native”：头部有公钥特征，流量为 TLSv1.3 的 23 3 3 l>>8 l AEAD 头特征
• “xorpub”：头部无公钥特征，流量同上
• “random”：全随机数加密

<rtt> 服务端为 0-RTT 有效期如 600s（可写范围 60-600s，0 则关闭 0-RTT），客户端为 0rtt/1rtt。

<padding> 是可选参数，仅作用于 1-RTT 以消除握手的长度特征，每个字段为 probability-from-to 三段式：

1
<probability>-<from>-<to>

• <probability>：0–100 的百分比（实际命中率为 (probability+1)%）
• <from> / <to>：左闭右开区间。len 类为字节数，gap 类为毫秒数

字段按 len、gap 交替串联，以 strings.Split(padding, ".") 结果数组的下标判断，偶数（i%2 == 0）为 len，奇数（i%2 == 1）为 gap。

双端默认值均为 “100-111-1111.75-0-111.50-0-3333”：

1. “100-111-1111”: 在 1-RTT client/server hello 后以 100% 的概率粘上随机 111 到 1111 字节的 padding
2. “75-0-111”: 以 75% 的概率等待随机 0 到 111 ms
3. “50-0-3333”: 再次以 50% 的概率发送随机 0 到 3333 字节的 padding（若为 0 则不 Write()）

服务端、客户端可以设置不同的 padding 参数，按 len、gap 的顺序无限串联；padding 参数必须整体位于 key 之前。

第一个 padding 概率必须为 100% 且 <from>-<to> 都必须 ≥ 18+17 = 35，所有 len 段最大值之和必须 ≤ 18+65535 = 65553。

<key> 为身份认证密钥，至少选择 1 个：

• decryption: X25519 私钥(32B) | ML-KEM-768 种子(64B)
• encryption: X25519 公钥(32B) | ML-KEM-768 封装密钥(1184B)

配置串在格式上支持多级 relay 密钥链，认证密钥块可重复。客户端按中继顺序依次列出链路上每一级的公钥或封装密钥，核心按这个顺序逐级完成身份认证，每一级都基于公私钥机制，且下一级被上一级加密绑定。

客户端（出站 encryption）在 <key> 按中继顺序配置链路上每一级的密钥（即列出 N 个密钥，第 j 个是第 j 级节点的公钥或封装密钥），每一级独立完成一次身份认证。

服务端（入站 decryption，即终止节点），只配置自己终止的级，通常就是一个密钥。中间节点转发时只剥离自己那一级，把剩余部分连同 iv 继续往下传，全程不解密流量。

中间节点只配置自己的私钥以及下一级公钥的 hash32，并不解密流量。相邻两级通过一个 32 字节的 blake3 hash 绑定，发送方向第 j 级写入的是第 j+1 级公钥的 hash32，并用第 j 级协商出的密钥加密；第 j 级节点解出后与本地记录比对，不符合直接断连。

例如对于一个三级密钥链 C → A → B → S：

级数直接决定握手长度：

$L_{\text{relays}}=\sum_{i=1}^{n}\ell_i+32(n-1)$

其中：

• $L_r$: relays 长度
• $\ell_i$: 第 $i$ 级密钥材料长度
• $n$: 级数

$P_h = \ell_{\mathrm{iv}} + L_r,\quad \ell_{\mathrm{iv}} = 16$

其中：

• $P_h$: 握手前缀长度
• $\ell_{\mathrm{iv}}$: iv 的长度，固定为 $16$ 字节

IMPORTANT

Xray-core 尚未实现中转转发。开发者表示：入站即出站，这个需要写代码来中转，Xray-core 暂无此功能，计划在 vless-relay 项目中实现（参考）。即关于多级密钥链，目前仅在格式上有除 hash32 字段以外的支持，转发还尚未实现

最短可用形式：

1
"decryption": "mlkem768x25519plus.native.600s.<X25519 Privatekey | ML-KEM-768 Seed>"

1
"encryption": "mlkem768x25519plus.native.0rtt.<X25519 PublicKey | ML-KEM-768 EncapsulationKey>"

注意：

• REALITY 本身已在同一条直连链路上做了服务端认证与端到端加密，无需另外设置
• 裸跑（即 security: "none" 且无可靠 finalmask 时） 抗不住熵检测与主动探测，不要这样做
• 只要 TLS 终结在你不完全信任的中间盒，VLESS Encryption 就有意义

1
"users": [{ "id": "你的UUID", "flow": "xtls-rprx-vision" }],
2
"decryption": "mlkem768x25519plus.native.600s.<X25519 Privatekey | ML-KEM-768 Seed>"

1
"users": [{ "id": "你的UUID", "flow": "xtls-rprx-vision", "encryption": "mlkem768x25519plus.native.0rtt.<X25519 PublicKey | ML-KEM-768 EncapsulationKey>" }]

ECH 加密#

ECH（Encrypted Client Hello）将 ClientHello 拆成内外两层，内层为真实域名，用 ECHConfig 内的 HPKE 公钥加密后置于 encrypted_client_hello 扩展；外层是 Decoy SNI。中间人因此无法得知真实的 SNI。

客户端启用 ECH 需设置 tlsSettings.echConfigList，有两种形式：

1
xray tls ech --serverName domain.com    # 外层 SNI，输出 ECH config list 与 ECH server keys
2
xray tls ech --pem                      # 输出 PEM
3
xray tls ech -i "<ECH server keys>"     # 丢失 config list 可由 server keys 反推

1
"tlsSettings": {
2
  "serverName": "domain.com",
3
  "certificates": [
4
    { "certificateFile": "/home/vpsadmin/xray_cert/xray.crt", "keyFile": "/home/vpsadmin/xray_cert/xray.key" }
5
  ],
6
  "echServerKeys": "<ECH server keys>"
7
}

1
"tlsSettings": {
2
  "serverName": "domain.com",
3
  "echConfigList": "<ECH config list>"
4
}

1
dig +short HTTPS cf1.domain.com
2
# 1 . alpn="h2,h3" ipv4hint=... ech="AEX+DQBB..."

1
"tlsSettings": {
2
  "serverName": "cf1.domain.com",
3
  "alpn": ["h2"],
4
  "echConfigList": "cf1.domain.com+udp://1.1.1.1:53"
5
}

1
"tlsSettings": {
2
  "serverName": "cf1.domain.com",
3
  "echConfigList": "https://1.1.1.1/dns-query",
4
  "echSockopt": { "dialerProxy": "proxy" }
5
}

ACME DNS-01 证书#

登录 Cloudflare 获取 Cloudflare API Token

验证 token 是否存活：

1
curl -s -H "Authorization: Bearer 你的token" https://api.cloudflare.com/client/v4/user/tokens/verify

签发证书：

1
export CF_Token="你的token"
2
export CF_Account_ID="你的AccountID"
3

4
acme.sh --set-default-ca --server letsencrypt
5
acme.sh --issue --dns dns_cf -d "domain.com" -d "*.domain.com" --keylength ec-256

token 会被明文存进 ~/.acme.sh/account.conf 供续期自动复用，机器需保证安全，如发生泄露需要在面板 Revoke。

安装给 Xray：

1
mkdir ~/xray_cert
2
acme.sh --install-cert -d "domain.com" --ecc \
3
    --fullchain-file ~/xray_cert/xray.crt \
4
    --key-file ~/xray_cert/xray.key
5
chmod +r ~/xray_cert/xray.key   # Xray 非 root 运行时

acme.sh 自带每日 cron，自动续期并重新执行 install-cert，Xray 默认热重载证书。

CF Origin CA 证书#

只有 CF 信任，15 年免续：

1. 面板 -> SSL/TLS -> Origin Server -> Create Certificate
2. 保持默认：ECC 私钥，Hostnames 填 domain.com 和 *.domain.com，15 年有效期 -> Create
3. 页面给出 Origin Certificate 和 Private Key 两段 PEM，存成两个文件：

1
mkdir ~/xray_cert
2
vim ~/xray_cert/xray.crt   # 粘贴 Origin Certificate 整段，含 BEGIN/END 行
3
vim ~/xray_cert/xray.key   # 粘贴 Private Key 整段
4
chmod 600 ~/xray_cert/xray.key
5
chmod +r ~/xray_cert/xray.crt

4. Xray/Nginx 的引用方式与 ACME 完全一致，泄露或换机器时在 Origin Server 页面 Revoke。