接入节点

节点让面板管理一台游戏主机。每台游戏主机安装一个节点。

接入前完成面板初始化，并将 APP_DOMAIN 设为节点可访问的面板地址。

可信同机连接可用 http://127.0.0.1:3000，公网建议使用 HTTPS；一键部署的 Local Docker 已在线时，可直接创建服务器。

1. 获取节点

从 节点 1.2.0 发行版 下载匹配主机的发行包并解压到新目录。

主机	发行包名称	运行游戏服务器所需 Docker
Linux	gamex-v1.2.0-linux-ARCH-unsigned.tar.gz	Docker Engine
macOS	gamex-v1.2.0-darwin-ARCH-unsigned.tar.gz	已启动的 Docker Desktop
Windows	gamex-v1.2.0-windows-ARCH-unsigned.zip	使用 Linux 容器的 Docker Desktop

ARCH：Intel/AMD 使用 amd64，ARM/Apple Silicon 使用 arm64，文件校验见执行节点命令。

2. 接入主机

1. 以面板管理员身份，在执行节点中点击创建节点。
2. 填写名称、主机系统和开机自启选项。
3. 复制生成的安装命令。
4. 在目标主机的节点解压目录执行命令：Linux 使用 sudo ./gamex， Windows 使用管理员 PowerShell，macOS 使用运行 LaunchAgent 的账号。
5. 按安装器提示确认，等待节点上线。

每台主机使用独立节点、身份和状态目录，接入令牌短期有效，不要写入共享脚本或日志。

节点会主动连接面板，无需为节点、文件或终端单独开放入站端口。供玩家连接的游戏端口需另行配置。

3. 检查是否可用

确认节点在线、资源清单未过期，且 Docker 状态为已启动。

Docker 状态	操作
已启动	可创建服务器
未安装	安装并启动 Docker
无法连接	启动引擎并检查连接地址
权限不足	检查节点服务账号的访问权限
异常	查看上报错误和服务日志
等待上报	等待下一次资源清单上报

节点离线时，在解压目录以安装时相同账号和权限运行：

./gamex daemon status
./gamex daemon doctor

Linux 的 root 安装在命令前加 sudo；Windows 将 ./gamex 换成 .\gamex.exe。 根据结果检查服务、面板地址、系统时间、证书和联网情况。 恢复节点状态前先停止服务，见升级与备份。

Docker 状态在下一次清单上报后更新，清单持续过期时检查诊断结果并重启节点。

暂停新增服务器与查看用量

关闭节点的新调度后，将禁止在该节点创建、重建和修复工作区，已有容器继续运行，应用部署变更前需重新启用调度。

资源历史约每分钟记录一次。主机用量独立于 Docker，工作区用量包含游戏服务和终端会话。离线或读数缺失时显示空缺，不代表用量为零。

端口与连通性

排查连接问题时，可请 AI 助手查询节点端口或检查工作区开放端点。节点端口查询需要管理员权限。各项检查的结论范围如下：

检查	结果说明
节点端口	检查主机 TCP/UDP 绑定及运行中容器的开放端口，可用状态仅代表检查当时，不会预留端口
工作区端点	对比已保存配置和 Docker 映射，并从节点主机测试 TCP，不能证明公网可达
UDP 端点	需应用层响应才能确认可达，仅有端口映射不足以判断
工作区网络	分别检查出站 DNS、TCP、TLS、HTTPS，区分出站故障与游戏开放端口问题

保存部署时会检查端口；被其他服务占用或无法确认时不能保存。当前工作区原有且未改变的端口可复用。检查不会预留端口，启动时仍可能遇到新占用。

工作区出站私网隔离需要 Linux，其他系统需选择受支持的网络策略后再部署。

主机 SSH 控制台

1. 在游戏主机启用 SSH 服务，确保节点能通过 127.0.0.1 和所选端口连接。
2. 打开节点的 SSH 控制台，填写账号和密码或私钥。
3. 核对并确认主机密钥后连接。

面板不保存 SSH 凭据和输出。这里操作的是整台游戏主机；工作区的终端只进入对应容器。