jkread/arkserver

arkserver

Docker镜像：用于运行带有arkmanager的ARK: Survival Evolved专用服务器

概述

本镜像用于在Docker容器中运行ARK: Survival Evolved服务器，基于https://github.com/FezVrasta%E7%9A%84https://github.com/FezVrasta/ark-server-tools%EF%BC%88ark-server-tools%EF%BC%89%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%AE%A1%E7%90%86%E5%8D%95%E5%AE%9E%E4%BE%8BARK%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82

关于arkmanager的更多信息，请参见其仓库：https://github.com/FezVrasta/ark-server-tools

核心功能和特性

• 自动安装：拉取镜像后直接运行，无需额外命令
• 环境变量配置：通过环境变量轻松配置服务器参数
• 定时任务管理：支持通过crontab配置自动备份、更新、每日重启、每周恐龙清理等任务
• 简洁的卷结构：服务器文件、配置、日志、备份等数据通过卷进行持久化
• 继承arkmanager所有功能：包含arkmanager工具的全部特性

标签说明

截至2021-02-18：:latest标签已稳定并将保持，开发变更将在:dev标签中进行。如有任何问题，请反馈。——jkread

使用场景和适用范围

适用于需要快速部署、便捷管理ARK: Survival Evolved专用服务器的场景，包括个人服务器搭建、小型社群服务器运营等，尤其适合希望通过容器化方式简化部署和维护流程的用户。

使用方法和配置说明

安装镜像

拉取最新版本（或其他所需版本）：

bash
docker pull jkread/arkserver:latest

运行服务器

基础运行命令

运行无配置修改的通用服务器：

bash
$ docker run -d \
    -v steam:/home/steam \  # 挂载以持久化创意工坊（模组）下载文件
    -v ark:/ark \  # 挂载包含服务器/备份/日志/配置文件的目录
    -p 27015:27015 -p 27015:27015/udp \  # Steam查询端口
    -p 7778:7778 -p 7778:7778/udp \  # 游戏服务器端口
    -p 7777:7777 -p 7777:7777/udp \ # 游戏服务器端口
    jkread/arkserver

Docker Compose配置示例

（根据需求修改或移除环境变量）：

yaml
version: '3'
volumes:
  ark:
  steam:
services:
  ark:
    image: jkread/arkserver:latest
    container_name: ark
    network_mode: bridge
    restart: always
    ports:
      - 7777:7777
      - 7777:7777/udp
      - 7778:7778
      - 7778:7778/udp
      - 27015:27015
      - 27015:27015/udp
    volumes:
      - ark:/ark
      - steam:/home/steam
    environment:
      - TZ=America/Chicago
      - am_ark_SessionName=Ark Docker Session
      - am_serverMap=TheIsland
      - am_ark_ServerPassword=letmein
      - am_ark_ServerAdminPassword=pleasechangeme
      - am_ark_MaxPlayers=70
      - am_ark_QueryPort=27015
      - am_ark_Port=7778
      - am_ark_RCONPort=32330
      - am_arkwarnminutes=15
      - am_arkAutoUpdateOnStart=true
      - am_arkBackupPreUpdate=true
      - am_arkMaxBackupSizeMB=500
      - am_arkflag_crossplay=false
      - am_arkflag_NoBattlEye=true
      - am_ark_GameModIds=111111111,566885854,731604991,761535755,821530042,889745138,1404697612

注意：如果修改暴露端口（如同一主机运行多个容器/服务器），需同步修改arkmanager配置，以确保arkmanager能正确检查服务器状态，且ARK服务器能正常向Steam发布IP地址和查询端口。

环境变量配置

镜像提供了一组必需环境变量的默认值：

添加额外变量

任何可通过arkmanager配置的值都可通过环境变量设置。容器中所有以am_为前缀的环境变量会映射到arkmanager.cfg文件中对应的配置项。

完整的配置值列表，请参见https://github.com/FezVrasta%E7%9A%84%E6%96%87%E6%A1%A3%EF%BC%9Ahttps://github.com/FezVrasta/ark-server-tools#configuration-files

卷说明

本镜像有两个主要卷，建议挂载为命名卷或主机目录，以持久化服务器安装和所有相关配置文件。Docker卷的更多信息：Docker：使用卷

/ark的子目录

/ark卷包含多个服务器相关文件目录：

GameUserSettings.ini

示例GameUserSettings.ini

必须包含以下内容，否则会被覆盖：

[/Script/ShooterGame.ShooterGameUserSettings]
Version=5