refracta/dcss-server

dcss-server Docker镜像文档

镜像概述

dcss-server是针对Dungeon Crawl Stone Soup（DCSS）游戏设计的Docker镜像，旨在简化多人游戏服务器的部署流程。DCSS是一款开源回合制角色扮演游戏，支持单人及多人模式。该镜像封装了DCSS服务器运行所需的完整环境，用户无需手动配置依赖、编译代码或管理系统环境，通过Docker即可快速启动和管理多人游戏服务器。

核心功能与特性

• 预配置环境：内置最新稳定版DCSS服务器程序及依赖库，开箱即用，无需手动搭建运行环境。
• 灵活配置：支持通过环境变量或挂载配置文件自定义服务器参数（如游戏模式、地图生成规则、玩家权限等）。
• 数据持久化：支持挂载本地目录保存服务器日志、游戏存档和配置文件，确保数据不丢失。
• 版本兼容性：支持指定DCSS游戏版本，可通过标签选择不同版本的服务器（如latest、0.29等）。
• 轻量级设计：基于Alpine或Debian精简基础镜像，减少资源占用，适合低配置服务器运行。

使用场景

• 私人联机：个人玩家快速搭建临时服务器，与朋友进行多人游戏。
• 社区服务器：游戏社区或组织部署公共服务器，提供稳定的多人游戏服务。
• 开发测试：开发者测试不同版本DCSS服务器的功能或自定义游戏规则。

使用方法与配置说明

快速启动

通过以下命令可快速启动默认配置的DCSS服务器：

bash
docker run -d -p 8080:8080 --name dcss-server refracta/dcss-server

• -d：后台运行容器
• -p 8080:8080：映射容器8080端口到主机（默认DCSS服务器端口）
• --name dcss-server：指定容器名称
• refracta/dcss-server：镜像名称（可指定标签如refracta/dcss-server:0.29选择版本）

自定义配置

通过环境变量或挂载配置文件进行自定义：

环境变量配置（部分常用变量）：

• SERVER_NAME：服务器名称，默认"DCSS Server"
• MAX_PLAYERS：最大玩家数，默认10
• GAME_MODE：游戏模式，可选"normal"（默认）、"tournament"等
• LOG_LEVEL：日志级别，可选"info"（默认）、"debug"、"warn"

示例：

bash
docker run -d -p 8080:8080 \
  -e SERVER_NAME="My DCSS Server" \
  -e MAX_PLAYERS=15 \
  -e GAME_MODE="tournament" \
  --name dcss-server refracta/dcss-server

配置文件挂载： 将本地自定义配置文件（如server.conf）挂载到容器内配置目录（通常为/app/dcss/server.conf）：

bash
docker run -d -p 8080:8080 \
  -v /local/path/server.conf:/app/dcss/server.conf \
  --name dcss-server refracta/dcss-server

Docker Compose配置

创建docker-compose.yml文件简化管理：

yaml
version: '3'
services:
  dcss-server:
    image: refracta/dcss-server:latest
    container_name: dcss-server
    ports:
      - "8080:8080"
    environment:
      - SERVER_NAME="Family DCSS Server"
      - MAX_PLAYERS=8
      - LOG_LEVEL=debug
    volumes:
      - ./server-data:/app/dcss/data  # 持久化游戏数据和日志
    restart: unless-stopped

启动：docker-compose up -d

服务器访问与管理

• 连接服务器：玩家通过DCSS客户端，输入服务器IP和端口（如your-server-ip:8080）连接。
• 查看日志：docker logs dcss-server
• 停止服务器：docker stop dcss-server
• 更新镜像：docker pull refracta/dcss-server后重启容器

注意事项

• 确保主机防火墙开放服务器端口（默认8080）。
• 持久化数据时，本地目录需有读写权限。
• 不同版本DCSS服务器配置参数可能有差异，建议参考对应版本官方文档调整配置文件。