技术文档

本文档面向技术运维人员和游戏开发者，详细介绍如何将您的游戏客户端接入本系统，以及如何部署节点和解包服务。

适用范围：所有需要将游戏流量通过代理转发的场景。

前置条件：您已拥有一台或多台云服务器，并已获取后台分配的 snkey。

在您的登陆器中，只需在启动游戏前调用代理程序即可完成接入。

示例代码（C/C++）：

宏定义说明：

修改游戏连接地址：

将游戏客户端原本连接的服务端IP，改为后台为您分配的本地监听IP（格式如 127.0.*.*），端口保持不变。该IP在后台"我的应用"中查看。

节点是公网转发入口，负责接收客户端流量并转发至解包服务。

推荐系统：CentOS 7/8 或 Ubuntu 18.04+

部署步骤：

1. 创建目录：
   mkdir -p /opt/node
   cd /opt/node
2. 上传节点程序：将 node 可执行文件放入该目录，并赋予执行权限：
   chmod +x node
3. 安装 PM2（进程管理工具）：
   sudo yum install nodejs -y
   npm install pm2 -g
4. 启动节点：
   pm2 start ./node --name "node" -- -key node_secret_key_123
5. 开放端口：确保服务器防火墙放行 17777 端口（TCP/UDP）。两个协议都开放

说明：节点默认监听 17777 端口，该端口用于与代理端（DLL/EXE）通信及健康检查。多个节点可部署在不同服务器，后台会自动分配。

解包服务负责解密游戏数据，并与游戏服务器建立长连接。建议与游戏服务器部署在同一机器或内网，以隐藏游戏服务器真实IP。

部署步骤：

1. 上传程序：将 unpack.exe 放到游戏服务器任意目录（例如 C:\unpack 或 /opt/unpack）。
2. 创建启动脚本（Windows）：新建 start_unpack.bat 文件，内容如下：
   @echo off
   echo Starting Unpack...
   unpack.exe -key 您后台的snkey
   pause
   注意：-key 参数使用的是您在后台创建的 snkey（而不是节点密钥），用于解包服务向后台拉取端口映射。
3. 开放端口：确保防火墙放行 8889 端口（TCP），该端口供节点连接。
4. 后台配置：在后台"我的应用"中，将 解包IP 设置为 您的服务器IP:8889（例如 101.227.42.80:8889）。

登录后台后，依次完成以下配置：

1. 查看应用信息

进入 我的应用 → 点击对应应用 查看，获得以下信息：

字段	说明
监听IP	分配给您的本地IP（如 127.0.1.5），游戏客户端需连接此IP
加密密钥	代理与解包服务协同工作的密钥（无需手动处理）
解包IP	您部署的解包服务地址（格式：IP:8889）
单机最高连接数	默认20，可根据实际游戏调整（如飞飞游戏一个号约2-3个连接）

2. 新建端口映射

在应用详情页点击 新增映射，填写：

字段	说明	示例
监听端口	游戏客户端使用的本地端口	15400
目标 IP	游戏服务器的真实IP	192.168.1.100
目标端口	游戏服务器接收连接的端口	15400（通常与监听端口一致）

飞飞游戏默认有三个端口：15400、23000、28000，请依次添加。

1. 客户端启动：运行登陆器，观察代理程序是否正常启动（托盘图标出现）。
2. 游戏登录：使用游戏客户端连接 127.0.*.* 对应端口，应能正常登录。
3. 节点状态：后台"节点列表"中查看节点状态是否为"活跃"。
4. 日志检查：如有异常，查看 proxy.log、node 或 unpack 日志进行排查。

如需了解系统概念和用户操作，请参阅 使用帮助。

如有疑问，可联系管理员或查看系统日志。