sknnr/ark-ascended-server

ark-ascended-server

Ark: Survival Ascended（方舟：生存飞升）的容器化服务器。

本项目通过GE Proton在Debian 12 Linux无头模式下运行Windows版本的Ark: SA二进制文件。

免责声明： 这不是官方镜像。作者或其他任何人不向任何最终用户提供任何形式的支持（无论是明示还是暗示）。您可以自由使用本仓库的内容。

镜像概述

该镜像用于快速部署Ark: Survival Ascended游戏服务器，采用非root用户（steam，uid/gid为***）运行，所有进程无头（无界面）执行。游戏文件安装在/home/steam/ark目录，持久化数据需挂载到/home/steam/ark/ShooterGame/Saved路径。

核心功能

1. 跨平台兼容：通过GE Proton在Linux环境运行Windows游戏服务端
2. 安全运行：以非root用户身份执行所有进程
3. 持久化存储：支持挂载卷保存游戏存档和配置
4. 灵活配置：通过环境变量自定义地图、名称、密码、Mod等参数
5. 多部署方式：支持Docker、Docker Compose、Podman及Kubernetes（Helm Chart）

使用场景

• 个人或小团队搭建私有Ark: Survival Ascended游戏服务器
• 游戏社区提供公共游戏服务
• 开发/测试环境快速部署游戏服务端

配置说明

端口

注意： Ark: SA不再使用旧版查询端口。若无法看到或连接服务器，需检查路由器端口转发（将游戏端口和RCON端口转发到容器主机）。部分ISP可能使用CNAT/CGNAT技术，需联系ISP确认是否支持端口转发或申请静态公网IP。

环境变量

Docker部署示例

bash
docker volume create ark-persistent-data
docker run \
  --detach \
  --name Ark-Ascended-Server \
  --mount type=volume,source=ark-persistent-data,target=/home/steam/ark/ShooterGame/Saved \
  --publish 7777:7777/udp \
  --env=SERVER_MAP=TheIsland_WP \
  --env=SESSION_NAME="Ark Ascended Containerized" \
  --env=SERVER_PASSWORD="PleaseChangeMe" \
  --env=SERVER_ADMIN_PASSWORD="AlsoChangeMe" \
  --env=GAME_PORT=7777 \
  docker.xuanyuan.run/sknnr/ark-ascended-server:latest

Docker Compose部署示例

保存为compose.yaml文件：

yaml
services:
  ark-ascended:
    image: docker.xuanyuan.run/sknnr/ark-ascended-server:latest
    ports:
      - "7777:7777/udp"
      - "27020:27020/tcp"
    environment:
      - SESSION_NAME=Ark Ascended Containerized
      - SERVER_PASSWORD=PleaseChangeMe
      - SERVER_MAP=TheIsland_WP
      - SERVER_ADMIN_PASSWORD=AlsoChangeMe
      - GAME_PORT=7777
      - RCON_PORT=27020
    volumes:
      - ark-persistent-data:/home/steam/ark/ShooterGame/Saved

volumes:
  ark-persistent-data:

启动：docker-compose up -d，停止：docker-compose down

Podman部署示例

bash
podman volume create ark-persistent-data
podman run \
  --detach \
  --name Ark-Ascended-Server \
  --mount type=volume,source=ark-persistent-data,target=/home/steam/ark/ShooterGame/Saved \
  --publish 7777:7777/udp \
  --env=SERVER_MAP=TheIsland_WP \
  --env=SESSION_NAME="Ark Ascended Containerized" \
  --env=SERVER_PASSWORD="PleaseChangeMe" \
  --env=SERVER_ADMIN_PASSWORD="AlsoChangeMe" \
  --env=GAME_PORT=7777 \
  docker.io/sknnr/ark-ascended-server:latest

Kubernetes部署（Helm Chart）

从作者Helm仓库安装：

bash
helm repo add jsknnr https://jsknnr.github.io/helm-charts
helm repo update
# 自定义values.yaml后安装
helm install ark-survival-ascended jsknnr/ark-survival-ascended --values myvalues.yaml

故障排除

连接问题

1. 检查容器主机和路由器是否开放7777/udp、27020/tcp端口
2. 确认路由器端口转发到容器主机
3. 联系ISP确认是否使用CNAT/CGNAT

存储问题

绑定本地目录时，需确保目录所有者为***:***：

bash
chown -R ***:*** /path/to/directory