dekun
4b3f6a1de2
Document new install flow, ports, migration script, and v2rayN Reality settings across README and docs/. Co-authored-by: Cursor <cursoragent@cursor.com>
4.8 KiB
4.8 KiB
客户端导入与测试指南
部署完成后，在 管理面板 复制各节点的 VLESS / Hy2 链接；或本地运行 bash scripts/render-client.sh 生成 client/generated/share-links.txt。
一、连通性测试（推荐顺序）
1. Reality（TCP 443，Xray）
在国内网络下测试（不要在 VPS 本机 curl 自己）：
# Windows PowerShell — 仅测端口是否可达
Test-NetConnection -ComputerName YOUR_VPS_IP -Port 443
v2rayN 中对 VLESS 节点 右键 → 测试真链接延迟，应显示毫秒数（不是 -1）。
连上后访问 https://www.google.com 或 https://ip.sb 确认出口 IP 为 VPS。
2. Hysteria2（UDP 8443+）
- 第一个节点：UDP 8443
- 第二个节点：UDP 8444（依此类推）
UDP 无法用普通 TCP 工具测。从面板 重新复制 Hy2 链接（多节点升级后端口可能已变），导入客户端测试。
若 Reality 可用但 Hysteria2 不通，可能是运营商 QoS/封锁 UDP，可继续只用 Reality。
3. 故障判断
| 现象 | 可能原因 |
|---|---|
ping 通 IP，VLESS 测速 -1 |
Reality 参数或密钥不同步 → bash scripts/verify-reality.sh |
| Hy2 不通，VLESS 正常 | UDP 未放行或端口错误（需 8443–8499/UDP） |
| ping 不通 | IP 可能被封，考虑换 IP |
| 连接成功但无网 | 检查防火墙、journalctl -u xray -f |
二、Windows
方案 A：v2rayN（推荐）
- 下载 v2rayN（选
v2rayN-With-Core.zip或自带 Xray 的版本） - 设置 → 核心类型：VLESS 使用 Xray 核心（不要用 sing-box 核心跑 Reality）
- 托盘 → 服务器 → 从剪贴板导入批量 URL
- 从面板复制
vless://...与hy2://...分别导入 - 设为活动服务器，路由选 绕过大陆
手动核对 Reality 参数：
| 字段 | 值 |
|---|---|
| 地址 | VPS IP（或域名，SNI 仍用 microsoft） |
| 端口 | 443 |
| 用户 ID | 面板节点 UUID |
| 流控 | xtls-rprx-vision |
| 传输 | tcp / raw（Xray 26+ 显示 raw 正常） |
| 安全 | reality |
| SNI | www.microsoft.com（不要用 Hy2 域名） |
| Fingerprint | chrome |
| Public Key | .env 的 REALITY_PUBLIC_KEY |
| Short ID | .env 的 REALITY_SHORT_ID |
| SpiderX | /（空着可能连不上） |
常见错误：Hy2 的 SNI 是
66.hyf2.cc，Reality 的 SNI 必须是www.microsoft.com，两者不要混用。
方案 B：sing-box 客户端
- 下载 sing-box for Windows
- 将
client/generated/sing-box-client.json放入配置目录 - 以管理员运行（TUN 模式需要），选择
reality出站
方案 C：Nekoray
- 下载 Nekoray
- Program → Add profile from clipboard，粘贴
vless://链接 - 右键 → Start
三、Android
v2rayNG（推荐）
- GitHub Releases 安装 arm64-v8a APK（多数新机）
- 右上角 + → 从剪贴板导入（先复制面板
vless://链接） - 再导入
hy2://备用节点 - 点击右下角 V 连接
- 设置 → 路由设置 → 绕过局域网及大陆地址
四、iOS
需要美区 Apple ID 或已有购买记录。
Shadowrocket（小火箭）
- App Store 安装 Shadowrocket
- + → 从剪贴板导入
vless://链接 - 再添加
hy2://备用 - 连接后 连通性测试 应显示延迟
手动添加 Reality：
- 类型：VLESS
- 地址：VPS IP
- 端口：443
- UUID：面板中的 UUID
- TLS：REALITY
- SNI：
REALITY_SERVER_NAME（默认www.microsoft.com） - Public Key / Short ID：从
.env或面板链接复制 - uTLS：chrome
- Flow：xtls-rprx-vision
Streisand
+ → Import from Clipboard，粘贴链接后连接。
五、macOS
与 Windows 类似：V2rayU / Nekoray / sing-box，从剪贴板导入面板链接。
六、日常使用建议
- 默认节点：Reality（
vless://） - 备用节点：Hysteria2（UDP 卡顿时切换）
- 不要分享节点链接
- 每月检查：
systemctl status xray sing-box、证书续期（acme.sh 自动）
七、分享链接格式参考
面板生成的 VLESS 链接示例：
vless://UUID@IP:443?encryption=none&flow=xtls-rprx-vision&security=reality&sni=SNI&fp=chrome&pbk=PUBLIC_KEY&sid=SHORT_ID&spx=%2F&type=tcp#名称
Hy2（端口随节点变化，以面板为准）：
hy2://PASSWORD@DOMAIN:8443?sni=DOMAIN#名称-Hy2
完整链接见面板或 client/generated/share-links.txt。