zsuatem/vintagestory

Vintage Story Server Docker镜像

概述

Vintage Story服务器的Docker镜像，支持amd64、arm64和arm v7架构（1.18.8+版本仅支持AMD64），提供简单易用的部署方式，适合快速搭建游戏服务器并进行配置管理。

标签结构

• latest、stable - 最新稳定版本
  • 1.16 - 最新1.16.x系列稳定版本（如1.14、1.15）
    • 1.16.4 - 具体稳定版本（如1.14.10、1.15.2）
• unstable - 最新不稳定版本
  • 1.16.5-rc.1 - 预览版/RC版本（如v1.14.0-pre.11、v1.15.0-pre.8）

使用方法

简单运行

默认设置运行（不推荐用于生产环境）：

docker
docker run --name vintagestory -d -it -p 42420:42420/tcp docker.xuanyuan.run/zsuatem/vintagestory:latest

数据文件夹

数据文件夹包含服务器配置、存档、mod等关键文件，默认挂载到随机命名卷。如需自定义配置或添加mod，建议挂载该文件夹或单独文件。

数据文件夹结构：

.
|-- BackupSaves
|-- Backups
|-- Cache
|-- Logs
|-- Macros
|-- Mods
|-- Playerdata
|-- Saves
|-- WorldEdit
|-- serverconfig.json
`-- servermagicnumbers.json

若不挂载文件，可通过docker cp复制文件到容器，例如：

bash
docker cp ./serverconfig.json vintagestory:/vintagestory/data/serverconfig.json

控制台访问

通过以下命令访问服务器控制台：

bash
docker attach vintagestory

（其中vintagestory为容器名称）

分离控制台使用快捷键：Ctrl+P Q

Docker run部署

挂载数据卷运行（推荐）：

docker
docker run --name vintagestory -d -it \
    -p 42420:42420/tcp \
    -v vsserverdata:/vintagestory/data \
    docker.xuanyuan.run/zsuatem/vintagestory:latest

Docker Compose部署

创建docker-compose.yml文件：

yml
version: "3.9"

services:
    vintagestory:
        image: docker.xuanyuan.run/zsuatem/vintagestory:latest
        container_name: vintagestory
        restart: always
        ports:
            - 42420:42420/tcp
        volumes:
            - vsserverdata:/vintagestory/data
        stdin_open: true
        tty: true

volumes:
        vsserverdata:

有用的链接

• 官方游戏网站 Vintage Story
• GitHub仓库 https://github.com/zsuatem/VintageStory-Docker