Docker Compose 部署
使用配置文件在同一台 Linux 主机上安装 GameX。
模板默认使用 latest 镜像标签。安装固定版本时,将配置中面板和节点的 :latest 一起改成目标标签,例如 :1.2.0。
1. 准备环境
- Linux
amd64或arm64,同机模板需要 Linux Docker Engine,不支持 Docker Desktop。 - 提前安装并启动 Docker Engine 28+,安装 Docker Compose 2.24+。
- 已安装 curl,当前账号可使用 Docker,服务器可从 GHCR 拉取 GameX 镜像,且
3000端口可用。
2. 下载配置
在服务器上创建安装目录,下载配置文件:
bash
mkdir -p ~/gamex-compose
cd ~/gamex-compose
curl -fSL https://docs.gamexserver.com/install/compose.yaml -o compose.yaml3. 启动服务
在安装目录执行:
bash
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps确认两个服务都已启动。节点会等待面板初始化后再配对,初始化完成前本机节点未在线,并不代表容器启动失败。
4. 打开管理面板
本机安装时打开 http://localhost:3000/setup;远程部署时,先开放面板端口,再打开 http://服务器IP:3000/setup,按向导创建管理员并登录。
面板自动创建 Local Docker 并完成本机节点配对,确认它在执行节点中在线,且 Docker 状态为已启动,再创建服务器。
公网访问建议配置 HTTPS。
通过 SSH 转发访问(可选)
在自己电脑上执行,将 user@host.example 替换为服务器的 SSH 用户和地址:
bash
ssh -N -L 3000:127.0.0.1:3000 user@host.example保持连接,在自己电脑打开 http://localhost:3000/setup。