ipshosting/game-ark

ARK: Survival Evolved 专用服务器

镜像概述和主要用途

本镜像为ARK: Survival Evolved（方舟：生存进化）提供专用服务器功能，支持Steam平台玩家连接，当设置PUBLIC_IP时可支持Epic Games玩家跨平台连接。不支持Xbox、PS4平台及通过微软商店（Xbox Game Pass）游玩的PC玩家。

GitHub项目地址：https://github.com/IPS-Hosting/game-images/tree/main/ark

核心功能和特性

• 支持Steam与Epic Games跨平台玩家连接（需配置PUBLIC_IP）
• 提供服务器安装、更新、验证、启动等完整生命周期管理
• 数据持久化存储，支持主机目录挂载
• 可自定义服务器端口、地图、玩家数量、Mod等核心参数
• 支持RCon远程控制台管理
• 灵活的环境变量配置，满足个性化服务器需求

使用场景和适用范围

适用于个人玩家、游戏社区或服务器管理员搭建私有ARK服务器，支持好友联机或社区多人游戏，尤其适合需要自定义服务器规则、Mod和配置的场景。

详细使用方法和配置说明

基本用法

以下为基础操作命令，高级用法请参考Docker官方文档：[***]

shell
# 创建Docker容器
docker create -it --restart always \
  --name ark-server \
  -p 27020:27020/tcp \
  -p 27015:27015/udp \
  -p 7777:7777/udp \
  -p 7778:7778/udp \
  ipshosting/game-ark:v2

# 启动服务器
docker start ark-server

# 停止服务器
docker stop ark-server

# 重启服务器
docker restart ark-server

# 查看服务器日志
docker logs ark-server

# 附加到服务器控制台（实时输入命令和查看输出，按CTRL-P + CTRL-Q断开连接）
docker attach ark-server

# 删除容器
docker rm ark-server

命令说明

容器默认启动行为：安装/更新服务器文件后自动启动服务器。可通过指定命令修改行为：

• update：仅安装最新版本服务器文件，完成后容器退出（不启动服务器）
• update_validate：同update，但额外验证文件完整性，推荐初始安装时使用
• start：直接启动服务器，不执行安装/更新操作

数据持久化

游戏服务器数据存储路径为/home/ips-hosting。默认情况下，Docker会自动创建卷以持久化数据，但容器重建后需手动挂载旧卷才能访问历史数据（详见：[***]

主机目录挂载方法

创建容器时使用-v /主机绝对路径:/home/ips-hosting参数挂载主机目录。容器默认以非root用户（UID 1000）运行，需确保挂载目录有读写权限，两种配置方式：

1. 修改主机目录所有者：
   chown -R 1000 /主机绝对路径

2. 指定容器运行用户：
   先用id 用户名获取主机用户UID，创建容器时添加--user UID参数，例如：docker create --user 500 ...

端口配置

默认端口及用途：

• 27020/tcp（RCon远程控制台）
• 27015/udp（查询端口）
• 7777/udp（游戏端口）
• 7778/udp（原始套接字）- 固定为游戏端口+1

可通过环境变量修改端口：GAME_PORT（游戏端口）、QUERY_PORT（查询端口）、RCON_PORT（RCon端口），修改时需同步更新容器端口映射。

环境变量配置

通过-e "KEY=VAL"参数配置环境变量（可多次使用），修改环境变量需重建容器生效。

用于update和update_validate命令的变量

• BETA_BRANCH：指定服务器测试分支名称
• BETA_PASSWORD：测试分支访问密码

用于start命令的变量

• MAP：服务器地图名称，默认值：TheIsland
• HOST：服务器监听地址，默认值：0.0.0.0
• PUBLIC_IP：服务器公网IP（可选），用于启用Epic Games跨平台连接
• GAME_PORT：游戏端口，默认值：7777（UDP）
• QUERY_PORT：查询端口，默认值：27015（UDP）
• RCON_PORT：RCon端口，默认值：27020（TCP）
• RCON_ENABLED：是否启用RCon，True启用/False禁用，默认值：True
• MAX_PLAYERS：最大玩家数量，默认值：10
• MODS：Mod ID列表（逗号分隔），服务器将自动安装和更新指定Mod
• SESSION_NAME：服务器名称
• RAW_SOCKETS：是否启用原始套接字，true启用
• SERVER_PASSWORD：服务器连接密码（可选）
• SERVER_ADMIN_PASSWORD：管理员密码（用于执行enablecheats命令）
• SERVER_GAME_LOG：是否启用管理员日志，true启用
• SERVER_GAME_LOG_INCLUDE_TRIBE_LOGS：日志是否包含部落日志，true包含
• FORCE_ALLOW_CAVE_FLYERS：是否允许洞穴飞行生物，true允许
• ALLOW_FLYER_CARRY_PVE：PVE模式是否允许飞行生物携带野生生物，true允许
• NO_BATTLEYE：是否禁用BattlEye反作弊，true禁用