docker 一键部署 ARK（方舟-生存进化）

此为 steam 版 ARK 的 docker 服务端，可用于搭建私人联机服务器。

搭建过程只用到官方原生的 SteamCMD docker 和 ARK Server configuration 配置。

此工程没有引入网上其他比较热门的 ARK 部署工具，所以它们的配置项均不适用

ARK 当前版本的服务端大小为 18812537984 bytes，约 18G，因为要从 steam 服务器下载，所以国内非常慢甚至连接不上。建议使用香港或韩国的云主机，从海外下载速度较快且不会被 GFW 拦截、国内也有不错的访问速度

1. 使用 root 用户安装 python3、 docker、 docker-compose、 git
2. 使用 root 用户设置虚拟内存（推荐 4G）
3. 添加 id=1000 的用户到 docker 组: usermod -aG docker $(grep 1000 /etc/passwd | awk -F: '{print $1}')
4. 切换到 id=1000 的用户: su - $(grep 1000 /etc/passwd | awk -F: '{print $1}')
5. 之后所有步骤使用 id=1000 的用户执行

之所以要使用 id=1000 的用户，是因为下面构建的 SteamCMD docker 镜像内也强制使用了 id=1000 的用户（steam）。

由于 docker 需要从宿主机挂载服务端的游戏目录，如果宿主机使用 root 用户挂载，会导致 docker 内的用户没有权限而无法读写。所以宿主机需要使用 id=1000 的用户启动 docker。

在 Linux 中， root 的 id=0， 而 1-999 是保留给系统用户的，普通用户的 id 从 1000 开始，docker 内一般只有一个普通用户，故默认 id=1000。

1. 下载此仓库: git clone --depth 1 --branch master https://github.com/lyy289065406/ark-server-docker.git
2. 进入根目录: cd ark-server-docker
3. 构建镜像: bin/build.[sh|ps1]（镜像中不含游戏本体，只有用于下载游戏的 SteamCMD ）
4. 运行镜像: bin/run_docker.[sh|ps1]

如果不想自己构建镜像，可以使用现成的镜像: expm02/ark-server-docker:latest

安装游戏: bin/install_game.[sh|ps1]，此为命令执行后会打开 SteamCMD 交互终端，依次输入：

1. 创建 ARK 游戏目录: force_install_dir /home/steam/games/ark
2. 匿名登录 steam : login anonymous
3. 下载 ARK 服务端: app_update 376030（游戏约 18G，超级慢而且可能失败）

app_update 376030 可能会因为网络原因多次失败，重新执行即可，会断点下载

当 SteamCMD 通道无法安装成功时，可使用此方法（否则应该跳过）：

以上端口均需要：

• docker 映射到宿主机（已配置到 docker-compose.yml）
• 主机防火墙准入（Linux 若没有安装 iptables 则不需要）
• 云主机配置安全组策略

1. 启动 ARK 服务端: bin/run_ark.[sh|ps1] -p ${服务器密码}（默认密码已经公开，建议重新指定）

• ARK 启动约需 10 ~ 15 分钟，如果想验证是否启动成功，可以进入 docker 终端: bin/terminal.[sh|ps1]
• 输入命令 netstat -nua 查看当前监听的 UDP 端口，只要把 7777 和 7778 端口刷出来则表示已成功启动

2. steam 添加服务器:

• 查看 -> 服务器 -> 收藏夹
• 添加服务器 -> 填写 ${云主机公网 IP}:27015 -> 在此地址上寻找游戏 ...
• 当在列表中看到自己的服务器名字后，点击 将选定游戏服务器添加至收藏夹

3. steam 开始游戏:

• 加入线上方舟
• 筛选服务器 -> 收藏
• 加入 -> 输入 服务器密码
• 和小伙伴愉快游戏吧 ~

通过 bin/run_ark.[sh/ps1] 实际上是调用了 ARK 的核心启动脚本 bin/ark.sh，它默认配置了一些常用配置项：

启动过一次服务端后，会在 ShooterGame/Saved/Config/LinuxServer/ 目录下自动创建 GameUserSettings.ini 和 Game.ini 配置文件，可以参考 ARK Server configuration 的参数说明修改这些配置文件。

除了上表的可控配置项，均可在配置文件中修改。否则需要修改脚本 bin/ark.sh。

1. 修改完成后，需要停止镜像: bin/stop.[sh|ps1]
2. 如果修改过 bin/ark.sh，还需要重新构建镜像: bin/build.[sh|ps1]
3. 再次运行镜像: bin/run_docker.[sh|ps1]
4. 然后运行 ARK 服务端: bin/run_ark.[sh|ps1]

只有第一次需要执行上述的步骤，配置好之后，只需要简单 3 条命令即可：

1. 停止镜像: bin/stop.[sh|ps1]
2. 运行镜像: bin/run_docker.[sh|ps1]（参数见脚本内）
3. 运行 ARK: bin/run_ark.[sh|ps1]（参数见脚本内）

服务启动后会自动生成以下 3 个目录：

• 配置目录: ./volumes/steam/games/ark/ShooterGame/Saved/Config/*
• 存档目录: ./volumes/steam/games/ark/ShooterGame/Saved/SavedArks/*
• 日志目录: ./volumes/steam/games/ark/ShooterGame/Saved/Logs/*

迁移前可以执行脚本 bin/backup.[sh|ps1] 将其备份到 backup 目录。

建议设置 crontab -e 定时任务自动备份 :

# 每小时备份一次存档
# 其中把 ${ARK_DIR} 换成实际 ark-server-docker 工程的绝对路径
# 例如: /home/steam/workspace/github/ark-server-docker
0 */1 * * * cd ${ARK_DIR} && bin/backup.sh > /tmp/backup.log

bin/backup.[sh|ps1] 脚本会自动删除 3 天前的存档记录，避免服务器硬盘溢出

在 ark-mods 仓库中列出了推荐的 MOD。

把期望要安装的 MOD 复制到 ./volumes/steam/games/ark/ShooterGame/Content/Mods 目录后，在使用 bin/run_ark.[sh|ps1] 脚本启动服务器时，通过 -i ${MOD_IDS} 按需指定即可。

详见 《在 ARK 安装 MOD 指引》

虽然用 bin/run_ark.[sh|ps1] 脚本可以一键启动，但是定制个性化服务时的启动参数还是太多，不方便记忆。

所以可以自行再添加一些封装脚本在 sbin 目录（此目录不会把文件同步到 Git 仓库），可以参考样例 sbin/onekey_demo.sh：

#!/bin/bash
# sbin/onekey_demo.sh
#------------------------------------------------
# 示例：sbin/onekey_demo.sh 
#           [-s ${ServerName}]                  # 服务器名称（在 steam 服务器上看到的）
#           [-m ${MapName}]                     # 地图名
#           [-c ${PlayerAmount}]                # 最大玩家数
#           [-p ${ServerPassword}]              # 服务器密码
#           [-a ${AminPassword}]                # 管理员密码
#           [-d ${Difficulty}]                  # 游戏难度
#           [-h ${HarvestAmount}]               # 资源获得倍率
#           [-t ${TamingSpeed}]                 # 驯服恐龙倍率
#           [-r ${ResourcesRespawnPeriod}]      # 资源重生倍率
#           [-g ${CropGrowthSpeed}]             # 作物生长倍率
#           [-x ${XPMultiplier}]                # 经验获得倍率
#           [-i ${ModIds}]                      # 地图 MOD ID 列表，用英文逗号分隔
#------------------------------------------------

# 启动容器
bin/run_docker.sh
sleep 5

# 启动 ARK 服务端
bin/run_ark.sh  -s "EXP_ARK_Server" -p "EXP123456" -a "ADMIN654321" \
                -h "3" -t "5" -r "0.5" -g "2" -x "10" -c "10" \
                -m "Ragnarok" -i "1404697612,928102085,2885013943,751991809,731604991,889745138,902616446,1211297684,893904615,895711211,1232362083,618916953,722649005"

因为 steam 的客户端会自动升级，当版本不匹配时，客户端无法找到服务端，此时需要使用 steam 通道在线升级：

1. 重新构建镜像（因为新版本需要更新 SteamCMD 才能下载）: bin/build.[sh|ps1] -c OFF
2. 启动容器: bin/run_docker.[sh|ps1]
3. 打开 steam 交互终端: bin/install_game.[sh|ps1]
4. 匿名登录 steam : login anonymous
5. 更新 ARK 服务端: app_update 376030 validate（游戏约 18G，超级慢而且可能失败）

• 构建 ARK 环境镜像: bin/build.[sh|ps1]
• 发布 ARK 环境镜像: bin/deploy.[sh|ps1]
• 运行 ARK 环境容器: bin/run_docker.[sh|ps1]（参数见脚本内）
• 安装 ARK 服务端: bin/install_game.[sh|ps1]
• 运行 ARK 服务端: bin/run_ark.[sh|ps1]（参数见脚本内）
• 进入 ARK 环境容器终端: bin/terminal.[sh|ps1]（参数见脚本内）
• 停止 ARK 服务端与环境容器: bin/stop.[sh|ps1]
• 备份 ARK 服务端存档: bin/backup.[sh|ps1]
• 恢复 ARK 服务端存档: bin/recover.[sh|ps1]
• 清除 ARK 服务端存档、配置和日志文件: bin/clean.[sh|ps1]

• 《Linux 搭建方舟服务器教程 方舟生存进化》
• 《在 Linux 系统下安装 steamCMD》
• 《Linux 搭建 ARK 服务器》
• 《方舟生存进化: docker一键部署》
• 《Dockerize ARK managed with ARK-Server-Tools》
• 《ark-server-tools》
• 《arkserver》