merevge/vintagestory-server

Vintage Story服务器Docker镜像

这是一个用于Vintage Story专用服务器的Docker镜像。服务器和模组在启动时下载，因此镜像保持版本无关性。

核心功能

• 启动时拉取最新服务器版本或固定版本（通过VS_VERSION指定）
• 自动从官方ModDB下载模组及其依赖
• 通过环境变量配置serverconfig.json的常见值
• 将服务器缓存到/data目录，重启时无需重新下载
• 提供不同.NET版本的镜像变体，覆盖不同VS版本需求

支持的标签

镜像同时发布于GHCR：ghcr.io/merevge/vintagestory-server

快速启动

yaml
services:
  vintagestory:
    image: docker.xuanyuan.run/merevge/vintagestory-server:latest
    container_name: vintagestory-server
    restart: unless-stopped
    stop_grace_period: 60s
    stdin_open: true
    tty: true
    ports:
      - "42420:42420/tcp"
      - "42420:42420/udp"
    volumes:
      - ./data:/data
    environment:
      VS_SERVER_NAME: "我的服务器"
      VS_MODS: |
        carryon

bash
docker compose up -d
docker compose logs -f

服务器的所有数据（二进制文件、模组、世界存档、配置）均存储在/data卷中，备份该目录即可完成服务器备份。

常见配置

可通过https://merevge.github.io/VS-Config-Generator/%E7%94%9F%E6%88%90%E7%9A%84%E9%85%8D%E7%BD%AE%E4%BB%A4%E7%89%8C%EF%BC%8C%E9%80%9A%E8%BF%87%60VS_CONFIG_TOKEN%60%E4%B8%80%E9%94%AE%E9%85%8D%E7%BD%AE%E4%B8%96%E7%95%8C%E7%94%9F%E6%88%90%E3%80%81%E6%9C%8D%E5%8A%A1%E5%99%A8%E8%AE%BE%E7%BD%AE%E5%92%8C%E8%A7%92%E8%89%B2%E6%9D%83%E9%99%90%E3%80%82

文档与源码

完整配置参考、模组处理及故障排除：
https://github.com/MErevGe/VintageStory-Server

许可证

MIT许可证。本项目为非官方项目——Vintage Story游戏版权归Anego Studios所有；游戏在运行时下载，不包含在镜像中。