GSM-Agent部署指南

一、在主控创建节点

1. 登录 `/admin` → **节点管理** → **添加节点**  
2. 填写名称、IP（Agent 所在机器可被主控探测/展示的地址）、端口（默认 `9090`）  
3. 创建成功后记下：  
   - **配置地址（config_url）**：形如  
     `https://你的主控/api/v1/agent/config/<config_key>`  
   - 或 Token（也可手动写入 `agent.conf`）

二、准备 Agent

1. 主控上传 Agent 安装包（权限 `node:agent`）：节点管理 → 上传 Agent 包  
   - Windows 包一般存为 `data/agent/windows-amd64.exe`  
2. 在节点部署弹窗或系统设置中的下载地址获取安装包

三、配置并启动

1. 在游戏机上新建目录，例如 `C:\gsm-agent\`，放入 `gsm-agent.exe`
2. 在Agent控制台窗口填入从主控节点管理中获取到的config_key，如：https://你的主控域名/api/v1/agent/config/你的config_key

四、确认在线

- 主控 **节点管理** 中该节点显示在线  
- 概览里能看到心跳与资源（CPU/内存/网络）  
- 可选：对节点执行「连接」探测  

五、生产运行模式（Windows）

- 控制台模式：前台窗口运行，适合调试  
- **服务模式**：主控节点管理中可远程切换为 Windows 服务（服务名 `GSMNodeAgent`）  

六、游戏源目录

Agent 工作目录下：
data/
  game-sources/     ← 各游戏源文件（按模板 source_files_path 分子目录）
  servers/          ← 实例工作目录（通常 data/servers/{服务器ID}）
  logs/
```
示例：模板里 `source_files_path = cstrike`，则应准备：
data/game-sources/cstrike/   （内含 srcds.exe 及游戏文件）

主控也可对节点发起「游戏源下载」批量推送（需模板/节点侧能力已配置）。