turzam/ark

ARK: Survival Evolved - Docker

本Docker镜像用于管理ARK: Survival Evolved游戏服务器，基于Ark Server Tools（https://github.com/FezVrasta/ark-server-tools%EF%BC%89%E5%AE%9E%E7%8E%B0%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E5%AE%89%E8%A3%85%E3%80%81%E6%9B%B4%E6%96%B0%E3%80%81%E5%90%AF%E5%8A%A8%E3%80%81%E5%A4%87%E4%BB%BD%E3%80%81rcon%E7%AE%A1%E7%90%86%E5%8F%8Amod%E5%A4%84%E7%90%86%E7%AD%89%E5%8A%9F%E8%83%BD%E3%80%82

注意：若使用旧卷，请从template目录获取新的arkmanager.cfg；不要忘记用docker pull docker.xuanyuan.run/turzam/ark获取最新镜像版本。

核心功能

• 简易安装：无需手动安装steamcmd或lib32库
• 集成Ark Server Tools：支持服务器更新/安装/启动/备份/rcon/mod管理
• 便捷crontab配置：轻松设置自动任务
• 配置文件访问：直接编辑ARK核心配置文件
• mod处理：通过工具一键管理mod更新
• 干净停止：Docker stop可安全关闭服务器

使用场景

• 快速搭建ARK游戏服务器
• 多服务器部署（通过修改端口变量）
• 自动更新服务器及mod
• 定期备份服务器数据
• 远程rcon管理服务器

配置说明

部署示例

快速启动服务器

bash
docker run -d -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -e SESSIONNAME=myserver -e ADMINPASSWORD="mypasswordadmin" --name ark docker.xuanyuan.run/turzam/ark

映射卷访问配置文件

bash
docker run -d -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -e SESSIONNAME=myserver -v /my/path/to/ark:/ark --name ark docker.xuanyuan.run/turzam/ark

映射后可编辑/my/path/to/ark/arkmanager.cfg（覆盖GameUserSetting.ini）及/my/path/to/ark/[GameUserSetting.ini/Game.ini]。

启用rcon管理

bash
docker run -d -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -p 32330:32330 -e SESSIONNAME=myserver --name ark docker.xuanyuan.run/turzam/ark

多服务器部署（修改端口）

bash
docker run -d -p 7779:7779 -p 7779:7779/udp -p 27016:27016 -p 27016:27016/udp -p 32331:32330 -e SESSIONNAME=myserver2 -e SERVERPORT=27016 -e STEAMPORT=7779 --name ark2 docker.xuanyuan.run/turzam/ark

常用操作

• 查看状态：docker exec ark arkmanager status
• 更新mod：docker exec ark arkmanager update --update-mods
• 更新服务器：docker exec ark arkmanager update --force
• 强制保存：docker exec ark arkmanager saveworld
• 备份服务器：docker exec ark arkmanager backup
• 升级工具：docker exec ark arkmanager upgrade-tools
• Rcon命令：docker exec ark arkmanager rconcmd ListPlayers（完整命令见http://steamcommunity.com/sharedfiles/filedetails/?id=454529617&searchtext=admin%EF%BC%89

自动任务配置

编辑/my/path/to/ark/crontab添加定时任务：

bash
# 每小时更新服务器及mod
0 * * * * arkmanager update --warn --update-mods >> /ark/log/crontab.log 2>&1
# 每日00:00备份
0 0 * * * arkmanager backup >> /ark/log/crontab.log 2>&1

（cron语法参考：Unix文档）

Mod配置

修改arkmanager.cfg中的ark_GameModIds变量（如ark_GameModIds="987654321,1234568"），启用UPDATEONSTART后重启容器或执行docker exec ark arkmanager update --update-mods。

推荐用法

1. 首次运行：

bash
docker run -it -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -p 32330:32330 -e SESSIONNAME=myserver -e ADMINPASSWORD="mypasswordadmin" -v /my/path/to/ark:/ark --name ark docker.xuanyuan.run/turzam/ark

等待启动后按Ctrl+C停止。

2. 编辑配置文件：/my/path/to/ark/GameUserSetting.ini和Game.ini。

3. 配置mod：编辑/my/path/to/ark/arkserver.cfg。

4. 添加自动任务：编辑/my/path/to/ark/crontab（参考上述示例）。

5. 启动服务器：docker start ark。

6. 检查状态：docker exec ark arkmanager status。

环境变量

• SESSIONNAME：服务器名称（默认：Ark Docker）
• SERVERMAP：地图（默认：TheIsland）
• SERVERPASSWORD：服务器密码（默认：空）
• ADMINPASSWORD：管理员密码（默认：adminpassword）
• SERVERPORT：服务器端口（不可Docker re***d，默认：27015）
• STEAMPORT：Steam端口（不可Docker re***d，默认：7778）
• BACKUPONSTART：启动时备份（1=启用，默认：1）
• UPDATEONSTART：启动时更新（1=启用，默认：1）
• BACKUPONSTOP：停止时备份（1=启用，默认：0）
• WARNONSTOP：停止前警告（1=启用，默认：0）
• TZ：时区（如Europe/Paris）
• UID/GID：卷所有者ID（默认：当前用户）

卷

• /ark：工作目录，包含服务器文件、日志、备份、配置文件等。

暴露端口

• STEAMPORT（默认7778）、SERVERPORT（默认27015）、32330（rcon）

更新日志

• 1.0：初始版本，支持Ark Server Tools 1.3，添加自动更新/备份
• 1.1：支持Ark Server Tools 1.4，处理mod自动更新
• 1.2：添加crontab支持，移除旧变量，增加模板目录
• 1.3：支持Ark Server Tools 1.5，添加BACKUPONSTOP/WARNONSTOP，支持UID/GID设置