================================================================
  ngroker 客户端 - 使用指南
================================================================

【前提：安装 Node.js】

请先安装 Node.js（版本 16 或以上）：
  官网下载：https://nodejs.org/zh-cn/download/

  Windows：下载 .msi 安装包，一路下一步即可。
  macOS：下载 .pkg 安装包，或通过 Homebrew：brew install node
  Linux：sudo apt install nodejs npm  （Ubuntu/Debian）
         sudo yum install nodejs      （CentOS/RHEL）

安装完成后，在终端运行以下命令确认安装成功：
  node --version    （应显示 v16.x.x 或更高）
  npm --version

================================================================
  第一步：安装依赖
================================================================

打开终端（Windows 按 Win+R 输入 cmd），进入本文件夹：
  cd 本文件夹路径

运行：
  npm install

这会自动安装所需的依赖库，只需执行一次。

================================================================
  第二步：配置
================================================================

1. 用文本编辑器打开 client.config.json，填写以下信息：

   server    —— 服务器地址，管理员提供，格式：wss://yourdomain.com/tunnel
   subdomain —— 你的子域名，管理员分配，例如：myapp
   port      —— 你本地服务的端口号，例如：3000
   token     —— 你的隧道令牌，登录控制台后在"账户信息"中查看

   示例：
   {
     "server": "wss://tunnel.example.com/tunnel",
     "subdomain": "myapp",
     "port": 3000,
     "token": "abc123..."
   }

================================================================
  第三步：启动
================================================================

Windows：   双击 run.bat
macOS/Linux：在终端运行 bash run.sh    或    node index.js

启动成功后，你会看到类似如下输出：
  Tunnel active!
  Public URL : https://myapp.example.com
  Local port : 127.0.0.1:3000

此时，通过 Public URL 即可从外网访问你的本地服务。

================================================================
  常见问题
================================================================

Q: 提示 "No tunnel registered for 'xxx'"
A: 确认服务器地址和子域名是否正确，检查管理员是否已分配该子域名给你。

Q: 提示 "Invalid token"
A: 重新登录控制台，复制最新的隧道令牌。

Q: 断开后自动重连失败
A: 检查网络连接，或服务器是否在线。客户端会每 3 秒自动重试。

Q: 本地服务无法访问（502 Bad Gateway）
A: 确认本地服务（port 中填写的端口）已经启动。

================================================================
  技术支持
================================================================

请访问官网获取联系方式，或在登录后台查看服务状态。

================================================================
