devidian/vintagestory

Vintage Story服务器Docker镜像文档

镜像概述和主要用途

本镜像用于运行Vintage Story游戏的专用服务器，支持稳定版和不稳定版切换，提供数据持久化存储，适用于个人搭建私人服务器或游戏社区部署多实例服务器环境。

核心功能和特性

• 支持稳定版（latest标签）和不稳定版（unstable标签）服务器
• 数据持久化：通过卷挂载保存游戏世界、配置文件等数据
• 灵活配置：支持自定义启动命令、覆盖配置文件
• 跨环境兼容：可通过Docker Compose部署，支持TrueNAS等平台

使用方法和配置说明

使用docker run运行

基础运行命令：

bash
docker run -pd 42420:42420 --name VintageStoryServer devidian/vintagestory:latest

建议使用下方Docker Compose方式进行自定义配置部署

使用docker compose运行

创建docker-compose.yml文件，基础配置如下：

yaml
services:
  vsserver-stable:
    image: devidian/vintagestory:latest
    container_name: vsserver
    restart: unless-stopped
    volumes:
      # • 游戏世界默认存储在主机的/appdata/vintagestory/vs（容器内为/gamedata/vs）
      # • 多服务器部署时修改左侧主机路径
      # • 可使用Docker卷替代主机路径
      - /appdata/vintagestory:/gamedata
    ports:
      - 42420:42420
    environment:
      VS_DATA_PATH: /gamedata

使用不稳定版本

将配置中的latest标签替换为unstable即可使用不稳定版服务器。

更新容器

1. 拉取最新镜像：docker compose pull
2. 重启容器：docker compose up -d

复制/覆盖文件

若使用主机卷挂载，可直接编辑主机路径下的文件：

1. 停止容器
2. 修改文件
3. 重启容器

在TrueNAS中运行

若卷挂载存在问题，使用以下配置（采用Docker卷而非主机路径）：

yaml
services:
  vsserver-stable:
    image: devidian/vintagestory:latest
    container_name: vsserver
    restart: unless-stopped
    volumes:
      - vsdata:/gamedata
    ports:
      - 42420:42420
    environment:
      VS_DATA_PATH: /gamedata
volumes:
  vsdata:

启动后可能需要进入容器shell安装nano并编辑/gamedata/vs/serverconfig.json配置文件

首次运行配置

服务器默认启用白名单，首次运行需进行如下配置以允许连接：

禁用白名单

修改服务器配置中的"StartupCommands": null为"StartupCommands": "/whitelist off"，登录后可重新启用并添加玩家。

添加玩家到白名单

1. 方法一：修改StartupCommands为"/whitelist add [playeruid]"（玩家UID可在登录后从playerdata.json中获取）
2. 方法二：直接编辑playerswhitelisted.json文件：

json
[
  {
    "PlayerUID": "<玩家UID>",
    "PlayerName": "<玩家名称>",
    "UntilDate": "2075-01-11T16:59:54.4917519+00:00",
    "Reason": null,
    "IssuedByPlayerName": "管理员名称"
  }
]

常用启动命令

以下命令可优化游戏体验（添加到StartupCommands或服务器内执行）：

故障排除与帮助

• ***联系：Devidian#1334
• 服务器：<[]>
• GitHub Issues：https://github.com/Devidian/docker-vintagestory

Docker调试命令

进入运行中的容器进行调试：

bash
docker exec -it [容器名称] sh