ztjs

💡 1. 为什么需要自建 WebSocket 代理？

本网页为静态网页，不提供任何网络传输、协议转换功能，您需要在本地托管私有ws代理工具，将网页的websocket转成udp,用以和根服务器通信。

🪐 2. 私有 Planet 与 WS 代理如何协同？

当您搭建私有网络（如使用 ztncui 或 mkworld 生成私有 planet 文件）时：

上传私有 Planet：在总览页上传 planet 二进制文件，浏览器客户端将定向向您的私有根服务器发起通信。
运行 WS 代理：在任意可访问私有根服务器的服务器或本机运行下方的 Node.js 代理，代理接收浏览器的 WS 数据帧并转发到私有根服务器的真实 UDP 端口（默认 9993）。
填入 WS URL 并启动：在节点总览中将代理地址（如 ws://127.0.0.1:8080/ws 或 wss://your-domain.com/ws）填入并启动节点即可。

⚡ 3. Node.js 代理服务快速运行

本代理为零外部依赖设计，仅需本地安装 Node.js（>= 16）：

# 1. 保存下方的 proxy.js 代码，在终端中直接运行（默认监听 0.0.0.0:8080，路径
                        /ws）：
                        node proxy.js -p 8080

                        # 2. （可选）安装 ws 库以提升高并发网络吞吐：
                        npm install ws
                        node proxy.js -p 8080
                    

常用命令行参数：

-p, --port <port>: 监听端口（默认 8080，支持环境变量 PORT）
-h, --host <host>: 监听地址（默认 0.0.0.0，支持环境变量 HOST）
--path <path>: WebSocket 路径（默认 /ws，支持环境变量 WS_PATH）

🛡️ 4. 生产环境后台常驻部署

# 方式 A：使用 PM2 守护进程管理
                        npm install -g pm2
                        pm2 start proxy.js --name zt-proxy -- -p 8080
                        pm2 save && pm2 startup

                        # 方式 B：后台 nohup 运行
                        nohup node proxy.js -p 8080 > proxy.log 2>&1 &
                    

🔒 5. 配合 Nginx 配置 WSS (SSL/TLS 加密)

如果网页通过 HTTPS 访问，浏览器要求 WebSocket 必须使用 wss:// 安全连接，可在 Nginx 中添加如下反向代理配置：

location /ws {
                        proxy_pass http://127.0.0.1:8080;
                        proxy_http_version 1.1;
                        proxy_set_header Upgrade $http_upgrade;
                        proxy_set_header Connection "Upgrade";
                        proxy_set_header Host $host;
                        proxy_read_timeout 86400s;
                        proxy_send_timeout 86400s;
                        }
                    

📄 Node.js WebSocket 代理完整代码 (proxy.js)

纯原生 Node.js 实现（零第三方依赖，兼容 Node.js 16+），内置 RFC 6455 协议栈与 IPv4/IPv6 双栈 UDP 套接字自动转换。

🚀 节点运行控制 📖 代理部署说明 & 获取 Nodejs 代理代码 ↗

WebSocket 隧道代理地址 (WS Proxy URL):

🪐 根服务器 Planet 配置 (私有 Planet 支持) 官方默认 Planet

Planet 模式: 官方默认

World ID: -

根服务器数量 (Roots): -

持久化存储: 内置默认

已配置的根服务器 (Root Servers) 与通信端点:

                    已使用官方全球根服务器集群
                

💡 上传由 mkworld / ztncui 生成的 planet 文件后将永久保存于浏览器本地数据库中

📈 实时运行指标

运行状态: 未运行

已连接 WS 中继: -

本机节点地址 (10-digit): -

已加入网络数量: 0

➕ 加入新网络

16 位十六进制网络 ID (Network ID):

📑 已加入的网络列表

尚未加入任何网络或节点未运行

⚡ ICMP Ping 连通性探测发送 ICMP Echo 并计算精确 RTT

选择所属私网 ID:

目标服务器 IP 地址:

等待发起探测...

🔌 用户态 TCP 套接字直连测试

所属私网 ID:

目标 IP:

端口:

发送数据包 Payload:

TCP 连接会话未激活

🌐 用户态 HTTP 服务器配置与控制已停止

所属私网 ID:

监听端口 (Port):

响应正文 (Response Body):

访问 URL (私网 IP): -

本机回环 URL: -

累计请求命中次数 (Hits): 0

服务运行与请求日志:

HTTP 服务未运行。点击“启动 HTTP 服务”开启监听，默认返回 helloworld。

📟 控制台输出 (stdout / stderr)