pepecitron/vintagestory-server

Vintage Story Server Docker镜像

镜像概述

Vintage Story Server Docker镜像是一款用于快速部署和管理Vintage Story游戏服务器的容器化解决方案。Vintage Story是一款沙盒生存类游戏，该镜像允许用户通过环境变量自定义服务器核心参数和世界生成规则，支持数据持久化存储，并提供灵活的版本控制，适用于个人或小型社区搭建游戏服务器。

核心功能和特性

• 全面的配置选项：支持通过环境变量配置服务器基础参数（端口、名称、玩家限制等）和世界详细设置（游戏模式、气候、资源生成等）。
• 数据持久化：通过卷挂载实现服务器文件、世界数据及日志的持久化存储，确保服务器重启后数据不丢失。
• 版本灵活性：支持指定服务器分支（stable/unstable）和版本号，满足不同稳定性需求。
• 安全与性能控制：包含内存使用限制、连接队列管理、登录Flood保护等功能，保障服务器稳定运行。
• 完整的世界自定义：可调整游戏模式、生物行为、地形生成、资源分布等数十项世界参数，打造个性化游戏体验。

使用场景和适用范围

• 个人服务器：玩家快速搭建私人服务器，与朋友联机游戏。
• 小型社区：为小团体提供稳定的游戏环境，支持自定义规则。
• 测试环境：开发者或玩家测试不同版本、配置下的游戏体验。
• 临时服务器：快速部署短期活动或测试用服务器，便于迁移和管理。

使用方法和配置说明

卷挂载

该镜像通过以下卷实现数据持久化：

• /data/server-file：存储服务器配置文件、世界数据、日志及所有运行时文件。建议将此目录挂载到宿主机目录，确保数据持久化。

暴露端口

• 42420：Vintage Story服务器默认通信端口，用于玩家连接，需映射到宿主机端口。

环境变量配置

服务器核心配置变量

世界配置变量（WORLDCONFIG_*）

注：世界配置变量包含超过50项详细参数（如资源生成率、气候系统、生物强度等），完整列表可参考镜像环境变量定义，上述为常用示例。

系统用户配置变量

部署示例

Docker Run 快速启动

bash
docker run -d \
  --name vsserver \
  -p 42420:42420 \
  -v /path/on/host:/data/server-file \
  -e SERVER_NAME="My Vintage Server" \
  -e SERVER_MAX_CLIENTS=8 \
  -e SERVER_PUBLIC=false \
  -e WORLDCONFIG_GAMEMODE=survival \
  -e WORLDCONFIG_STARTING_CLIMATE=temperate \
  pepecitron/vintagestory-server

Docker Compose 配置（推荐）

yaml
version: "3.8"

services:
  vintage-story:
    container_name: vsserver
    image: pepecitron/vintagestory-server
    restart: unless-stopped  # 自动重启（非手动停止时）
    stdin_open: true         # 允许控制台交互
    tty: true                # 分配伪终端
    ports:
      - "42420:42420"        # 端口映射
    volumes:
      - ./server-data:/data/server-file  # 数据持久化目录
    environment:
      # 服务器基础配置
      - SERVER_BRANCH=stable
      - SERVER_NAME="Community Server"
      - SERVER_DESCRIPTION="A friendly server for Vintage Story players"
      - SERVER_MAX_CLIENTS=15
      - SERVER_PORT=42420
      - SERVER_PASSWORD=MyServer123  # 连接密码
      # 世界配置
      - WORLDCONFIG_GAMEMODE=survival
      - WORLDCONFIG_WORLD_SEED=Vintage2024
      - WORLDCONFIG_CREATURE_HOSTILITY=aggressive
      - WORLDCONFIG_LANDCOVER=0.75  # 75%土地覆盖率
      # 系统用户
      - UID=1000
      - GID=1000

服务器控制台交互

如需与服务器控制台交互（如执行命令、查看日志），需确保容器已配置stdin_open: true和tty: true（如上述Compose示例）。通过以下命令连接：

bash
docker attach vsserver

断开控制台连接时，使用组合键 Control-p + Control-q（避免直接关闭终端导致服务器停止）。