drpsychick/arkserver

ARK: Survival Evolved Docker镜像文档

镜像概述和主要用途

本镜像为ARK: Survival Evolved（方舟：生存进化）游戏服务器提供Linux环境下的Docker化部署方案，支持单实例服务器搭建和多节点ARK集群部署，旨在简化游戏服务器的配置、启动和维护流程。

核心功能和特性

• 基于Linux环境构建，兼容主流Docker运行平台
• 支持单实例服务器快速部署，满足小型私人服务器需求
• 原生支持ARK集群部署，实现多地图数据互通（玩家角色、恐龙等跨地图共享）
• 支持通过环境变量自定义服务器参数（名称、地图、难度、玩家上限等）
• 数据持久化设计，确保游戏存档、配置文件和集群数据不丢失
• 轻量级架构，降低服务器部署复杂度和资源占用

使用场景和适用范围

• 个人玩家搭建私人ARK服务器，与朋友进行联机游戏
• 游戏社区部署多地图集群服务器，提供丰富的游戏体验
• 服务器管理员简化ARK服务器的部署、更新和维护流程
• 需要快速扩展或迁移ARK游戏服务的场景

详细使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 服务器硬件满足ARK运行要求（建议最低配置：4核CPU、8GB内存、50GB+存储空间）

单实例部署

基本启动命令

bash
docker run -d \
  --name ark-server \
  -p 7777:7777/udp \
  -p 7778:7778/udp \
  -p 27015:27015/udp \
  -v /path/to/ark/data:/ark/server \
  -e SERVER_NAME="My ARK Server" \
  -e SERVER_MAP="TheIsland" \
  -e ADMIN_PASSWORD="your-admin-password" \
  -e MAX_PLAYERS=20 \
  sickhub/arkserver

参数说明

• 端口映射：默认需要映射3个UDP端口
  • 7777：游戏连接端口
  • 7778：查询端口
  • 27015：Steam查询端口（可选，用于游戏列表显示）
• 数据卷挂载：/path/to/ark/data为宿主机目录，用于持久化存储服务器配置、游戏存档和日志
• 核心环境变量：
  • SERVER_NAME：服务器名称（显示在游戏服务器列表）
  • SERVER_MAP：游戏地图（支持官方地图如"TheIsland"、"ScorchedEarth_P"、"Aberration_P"等）
  • ADMIN_PASSWORD：管理员密码（用于游戏内执行管理员命令）
  • MAX_PLAYERS：最大玩家数量（默认20）
  • DIFFICULTY：游戏难度系数（0.1-5.0，默认1.0）
  • SERVER_PORT：自定义游戏端口（默认7777）

集群部署

Docker Compose配置示例（双节点集群）

yaml
version: '3'

services:
  ark-theisland:
    image: sickhub/arkserver
    container_name: ark-theisland
    ports:
      - "7777:7777/udp"
      - "7778:7778/udp"
      - "27015:27015/udp"
    volumes:
      - ./ark-data/theisland:/ark/server
      - ./ark-cluster:/ark/cluster  # 共享集群数据目录
    environment:
      - SERVER_NAME="ARK Cluster - The Island"
      - SERVER_MAP="TheIsland"
      - ADMIN_PASSWORD="cluster-admin-123"
      - MAX_PLAYERS=15
      - CLUSTER_ID="my-ark-cluster-001"  # 集群唯一标识，所有节点需一致
      - CLUSTER_DIR="/ark/cluster"  # 集群数据存储路径
    restart: unless-stopped

  ark-scorched:
    image: sickhub/arkserver
    container_name: ark-scorched
    ports:
      - "7779:7777/udp"  # 集群节点需使用不同端口
      - "7780:7778/udp"
      - "27016:27015/udp"
    volumes:
      - ./ark-data/scorched:/ark/server
      - ./ark-cluster:/ark/cluster  # 共享集群数据目录
    environment:
      - SERVER_NAME="ARK Cluster - Scorched Earth"
      - SERVER_MAP="ScorchedEarth_P"
      - ADMIN_PASSWORD="cluster-admin-123"
      - MAX_PLAYERS=15
      - CLUSTER_ID="my-ark-cluster-001"  # 与其他节点保持一致
      - CLUSTER_DIR="/ark/cluster"
    restart: unless-stopped

集群部署注意事项

• 所有集群节点必须使用相同的CLUSTER_ID以确保数据互通
• 通过共享/ark/cluster目录实现跨节点数据同步（玩家角色、恐龙、物品等）
• 不同节点需映射不同端口，避免宿主机端口冲突
• 建议为集群节点配置固定IP和端口转发规则（如部署在云服务器需配置安全组）

数据备份与恢复

1. 备份：定期复制持久化数据卷目录（如./ark-data和./ark-cluster）到安全存储位置
2. 恢复：将备份文件覆盖回原数据卷目录，重启容器即可恢复服务

常见问题解决

• 服务器启动失败：检查宿主机内存是否充足（建议≥8GB）、端口是否被占用（使用netstat -tulpn排查）
• 玩家连接超时：确认端口映射正确且防火墙已开放对应UDP端口（7777、7778等）
• 集群节点无法互通：验证CLUSTER_ID是否一致、集群目录是否正确共享、节点间网络是否互通