🌊 第04章 · 客户端配置与连接

客户端 UUID 配置连接

客户端配置与连接¶

这一章讲服务端 Xray(VLESS+WS)配好之后,客户端那边怎么把流量连进来。重点是拿到 4 个要素:地址、端口、UUID、路径,然后填进客户端(Windows/Android/Mac/路由器等)。本机的 Xray 走的是 "VLESS + WebSocket + 域名(443)" 的组合。

连接需要的信息(服务端已成,给你这些)¶

要素	含义	本机示例
地址(Address)	服务器域名或 IP	`bangdream.xyz`
端口(Port)	上网入口(通常 443)	`443`
UUID	你的"钥匙",唯一凭证	`/root/.deploy/xray_uuid` 里的值
传输(Network)	用什么伪装	`ws`(WebSocket)
路径(Path)	WS 的握手路径(伪装)	`/ws-f033eda368eb1b99f9d79a4f`

安全 | UUID 和 WS 路径就是你的配对钥匙,别泄露。本机把它们单独存在 /root/.deploy/xray_uuid 与 /root/.deploy/xray_wspath,权限 600。

通用导入格式(分享链接)¶

很多客户端支持一键导入,链接格式大致是:

vless://<UUID>@<域名>:<端口>?encryption=none&security=none&type=ws&host=<域名>&path=<路径>#名称

例如:

vless://72f6b462-da16-41cb-8370-d737f34d1710@bangdream.xyz:443?encryption=none&security=none&type=ws&host=bangdream.xyz&path=/ws-f033eda368eb1b99f9d79a4f#bangdream

提示 | 用 v2rayN(Windows)、v2rayNG(Android)、Shadowrocket(iOS)、Clash/Sing-box(跨平台)等客户端,最省事的是扫码/粘贴分享链接自动导入。

手动填配置(以 v2rayN 为例)¶

服务器 → 添加 VLESS 节点。
填上面 4 个要素:

地址(Address): bangdream.xyz
端口(Port):   443
用户ID(UUID): 72f6b462-...
流控(flow):   (留空)
加密(encryption): none
传输(transport): ws
路径(path):   /ws-f033eda368eb1b99f9d79a4f
伪装域名(host): bangdream.xyz   # 或留空,端主机头
TLS:        (根据 security=none 无需)

关键参数说明¶

参数	作用
`encryption=none`	VLESS 默认"明文壳",真正的加密由外层 TLS 承担;此处填 none
`security=none`	本机 Xray 配置里 WS 的 `security` 是 `none`(因为已在 nginx 外层走了 TLS),所以客户端也配 `none`
`host`	WebSocket 握手时带的 Host 头(要与 nginx WS 反代匹配)
`path`	WS 路径(要与 nginx location 对应的 path 完全一致)

容易错 | 若服务端在 nginx 终止了 TLS,客户端安全(security)填 none 但地址仍用域名 443(由 nginx 做 TLS 握手)。若把 security 误填 tls,会再套一层 TLS 导致握手失败。要严格对齐服务端 config.json 的 streamSettings.

客户端连接检查¶

连不上时,先确认服务端在不在:

# 服务端从这查
ss -tlnp | grep ':10086'          # xray 监听?
systemctl status xray
# 走外层 nginx 的 443 + path 是否通(从公网)
curl -s -o /dev/null -w "%{http_code}\n" https://bangdream.xyz/ws-f033eda368eb1b99f9d79a4f

而客户端检查: - 看代理是否"可连接"。 - 看能否访问被墙站点(如 Google)。

提示 | 若服务端通、客户端不通,先看客户端有没有开了其他代理/系统代理冲突、防火墙是否放行 443、以及 host/path/UUID 是否填对。

常见客户端与导入工具¶

客户端	平台	说明
v2rayN	Windows	主流,支持 VLESS/WS
v2rayNG	Android	安卓主流
Clash Verge / ClashX	多端	走 Clash 代理规则
Shadowrocket	iOS	iOS 常用
Sing-box / passwall	路由器/OpenWrt	全局/分流
Clash.Aria2 等	路由	家庭全局代理

注意 | 用 Clash/Sing-box 时,VLESS WS 节点要写成对应的 type: vless,network: ws,并带 ws-opts 的 path 与 host。