hermsi/ark-server

Docker化ARK服务器（使用https://github.com/FezVrasta/ark-server-tools%E7%AE%A1%E7%90%86%EF%BC%89

您可以使用此镜像启动公共或私有会话的ARK服务器，服务器本身由ARK-Server-Tools进行管理。

标签

此镜像始终安装当前可用的最新版本ARK服务器。因此，标签对应镜像所使用的ARK-Server-Tools版本。

使用方法

⚠️ Windows / WSL 注意事项 ⚠️

请将容器卷直接挂载到WSL的文件系统中。 挂载到Windows管理的文件系统会导致安装过程极其缓慢甚至卡住。

启动ARK服务器

基本配置

服务器的基本配置通过启动容器时设置环境变量完成：

启动ARK服务器

docker run

我个人更推荐使用docker-compose，但对于希望直接运行ARK服务器的用户，可使用以下命令：

bash
# 您可能需要修改SESSION_NAME、ADMIN_PASSWORD或主机卷路径
$ docker run -d --name="ark_server" --restart=always -v "${HOME}/ark-server:/app" -e SESSION_NAME="Awesome ARK is awesome" -e ADMIN_PASSWORD="FooB4r"

docker-compose

若要使用docker-compose启动（我个人更推荐此方式而非简单的docker run），可参考以下docker-compose.yml配置：

yml
version: '3'

services:
  server:
    restart: always
    container_name: ark_server
    image: docker.xuanyuan.run/hermsi/ark-server:latest
    volumes:
      - ${HOME}/ark-server:/app
      - ${HOME}/ark-server-backups:/home/steam/ARK-Backups
    environment:
      - SESSION_NAME=${SESSION_NAME}
      - SERVER_MAP=${SERVER_MAP}
      - SERVER_PASSWORD=${SERVER_PASSWORD}
      - ADMIN_PASSWORD=${ADMIN_PASSWORD}
      - MAX_PLAYERS=${MAX_PLAYERS}
      - UPDATE_ON_START=${UPDATE_ON_START}
      - BACKUP_ON_STOP=${BACKUP_ON_STOP}
      - PRE_UPDATE_BACKUP=${PRE_UPDATE_BACKUP}
      - WARN_ON_STOP=${WARN_ON_STOP}
    ports:
      # ARK游戏客户端连接端口
      - "7777:7777/udp"
      # UDP原始套接字端口（始终为游戏客户端端口+1）
      - "7778:7778/udp"
      # RCON管理端口
      - "27020:27020/tcp"
      # Steam服务器列表端口
      - "27015:27015/udp"
    networks:
      - default

修改上述docker-compose.yml后，启动服务器：

bash
$ docker-compose up -d

调整配置

容器启动且ARK安装完成后，您可以开始调整配置。基本上，您可以修改ARK-Server-Tools支持的所有设置。有关可用命令的参考，请查看https://github.com/FezVrasta/ark-server-tools#configuration%E3%80%82

主要配置文件位于容器内以下路径：

• /app/server/ShooterGame/Saved/Config/LinuxServer/GameUserSettings.ini
• /app/server/ShooterGame/Saved/Config/LinuxServer/Game.ini

您可以直接修改这些文件以应用更改。

或者，您可以使用ARK-Server-Tools运行任何可用命令来应用更改：

bash
$ docker exec ark_server arkmanager status
$ docker exec ark_server arkmanager update --force
$ docker exec ark_server arkmanager installmods

完整命令列表请https://github.com/FezVrasta/ark-server-tools#commands-acting-on-instances%E3%80%82

添加定时任务

您还可以在容器内添加定时任务，例如用于更新或备份。为此，请编辑服务器卷中的crontab文件：

bash
$ vim "${HOME}/ark-server/crontab"

添加有效的定时任务语法：

bash
0 0 * * * arkmanager update --warn --update-mods >> ${SERVER_VOLUME}/log/crontab.log 2>&1
0 0 * * * arkmanager backup >> ${SERVER_VOLUME}/log/crontab.log 2>&1

保存文件（:wq）并重启容器：

bash
$ docker restart ark_server