管理服务器
游戏服务器运行在工作区中,各自拥有独立的文件、启动命令、资源、端口和成员。
创建服务器
需要面板管理员权限,以及 Docker 已启动、资源清单未过期的在线节点。
- 在工作区管理中点击创建工作区。
- 输入名称,选择容量足够的节点。
- 选择已启用且适配节点架构的镜像,没有可用镜像时,在镜像管理中添加或启用。
- 设置 CPU 和内存限制。
- 按游戏要求设置容器端口、主机端口和 TCP/UDP 协议;仅玩家需要连接的端口使用公开主机地址。面板保存前会检查主机端口,占用或无法确认的端口会阻止操作。
- 选择出站网络策略与 DNS 服务器。私网隔离需要 Linux 节点和公共 DNS;允许互联网和私网时可继承节点 DNS。修改 DNS 需重新创建容器。
- 填写启动命令,游戏文件尚未准备时可留空。
- 检查配置,点击保存并等待创建完成。结果不确定时,先查看操作记录,再提交新请求。
在文件中将服务端文件上传到 /workspace,补全启动命令后启动服务,并按游戏要求完成初始化与许可确认。
也可通过插件准备服务端文件。
日常操作
| 操作 | 说明 |
|---|---|
| 启动、重启、停止 | 控制主服务,启动和重启需要配置启动命令 |
| 控制台 | 查看主服务输出、发送游戏服务器支持的命令 |
| 终端 | 在工作区内新建或重新连接独立的 Shell 命令会话,需要操作员或管理员权限 |
| 文件 | 上传、下载、编辑、复制、移动和解压 /workspace 下的文件,主服务停止后仍可使用 |
| 启动命令 | 操作员和管理员均可编辑,保存时可能重启服务 |
| 成员 | 管理员分配访问权限,见用户与权限 |
停止主服务不会结束终端会话,文件也仍可使用。未填写启动命令时,先准备文件和命令,再启动游戏。
启动命令从 /workspace 运行,例如 exec ./server。通过面板的启动、重启控制游戏服务,便于查看状态和输出。
显示运行中后,仍需检查控制台并尝试连接游戏。节点离线时状态为未知,不能据此判断服务已停止。
编辑容器配置可能重建工作区,保留 /workspace 并替换其他容器文件;游戏数据应放在 /workspace,重建前先备份。
删除工作区会永久删除容器、数据卷和全部数据,节点离线时会在重新连接后执行删除;需要保留数据时,选择停止。
调整工具布局
桌面端打开工作区工具区域的个性化,勾选要显示的工具,并拖动调整顺序。开启工作台模式后,可把工具分配到右侧或底部,同时查看会话与两个工具区域;拖动分隔线可调整大小。恢复默认会还原工具排列和布局,设置保存在当前浏览器。
手机端点击会话右上角的工具按钮打开工作区工具,再从工具选择器切换控制台、文件或插件。只读成员可以查看控制台和文件,交互终端仅向操作员和管理员开放。
控制台与终端会话
游戏命令在控制台中发送,系统命令在终端中执行。选择已有终端会话可重新连接。
短暂断线后,面板会接续保留的输出;已结束的终端会话保留七天。无法接续时,重新打开最近输出。输入是否送达不确定时,先检查结果再重试,面板不会自动重发输入。
登录仍有效时,面板会先刷新登录状态再连接终端或下载文件;登录失效后按提示重新登录。
文件、环境变量与密钥
文件管理用于 /workspace 下的数据。不要改动系统保留的 .gamex 目录;指向工作区外的链接不可访问。
- 大文件使用上传、下载传输。ZIP、TAR、TAR.GZ 支持预览和解压,旧压缩包文件名乱码时可指定编码。解压会保留已有文件,需选择新目标位置或先处理冲突。
- 上传与插件导入共用系统文件上传上限,默认 2 GiB。超限时,联系管理员在系统设置中检查文件上传上限。
- 在环境变量与密钥中保存应用配置。同名 Secret 优先于普通变量,其值会从采集的输出中脱敏。已有进程保留启动时的环境,修改后需新建终端会话,或通过面板重启服务。
- 助手可仅向 Shell 命令注入任务所需的 Secret;此选择不隔离共享容器内的文件或进程。
/workspace/WORKSPACE.md保存AI 助手使用的共享规则,操作员可在文件管理中编辑,初始化不会覆盖已有内容。
定时任务
- 在工作区的自动化任务中点击创建任务。
- 选择控制台命令、终端脚本、主服务启停或重启、AI 对话。
- 设置单次或重复执行的时间和时区,或选择服务器启动、停止时触发。
- 保存任务。
- 在运行历史中查看结果。
任务使用创建者当前权限,失去写权限或账号被禁用时,无法继续运行的计划会暂停。停用阻止后续运行,删除任务会保留运行历史;取消正在运行的任务不会撤销已经完成的修改。
AI 任务需要已配置的模型,相关设置见 AI 定时任务。
遇到问题
- 没有可用节点或镜像:检查节点连接、清单、Docker、调度状态、版本兼容和镜像架构。
- 无法启动:检查启动命令、游戏文件、Docker、可用内存、端口冲突和控制台错误。
- 玩家无法连接:检查监听地址、公开的 TCP/UDP 端口、主机地址和防火墙。主机端点检查仅确认节点主机可达,不能证明公网可达;UDP 还需应用层响应。
- 无法操作:检查工作区权限、节点连接和进行中的操作。重建、修复、恢复会等待冲突操作结束,请求排队不代表已经完成。
- 运行环境被隔离或丢失:先查看状态说明和操作审计,再由管理员核实容器身份及保留数据并执行修复。