jonakoudijs/screeps

Screeps Server Docker 镜像文档

镜像概述

Screeps Server Docker镜像是用于部署和运行Screeps多人在线编程游戏服务器的容器化解决方案。该镜像基于官方Screeps服务器核心构建，封装了运行游戏服务所需的依赖环境，旨在简化服务器部署流程，降低管理复杂度，让用户能够快速搭建属于自己的Screeps游戏服务器。

核心功能与特性

• 便捷部署：通过Docker容器化封装，无需手动配置依赖环境，一键启动游戏服务器
• 数据持久化：支持游戏数据（玩家进度、房间状态等）持久化存储，避免容器重启导致数据丢失
• 配置灵活：通过环境变量和配置文件支持服务器参数自定义，如服务器名称、PVP模式、资源倍率等
• 跨平台兼容：可在任何支持Docker的操作系统（Linux、Windows、macOS）上运行
• 低资源占用：优化镜像体积，降低服务器运行时的系统资源消耗

使用场景

• 个人游戏服务器：玩家搭建私人Screeps服务器，与朋友共同体验游戏
• 开发测试环境：游戏开发者用于测试自定义脚本、模组兼容性的本地服务器
• 小型社区服务器：为小型游戏社区提供专属游戏服务，支持自定义规则
• 教学环境：用于编程教学，通过游戏化方式提升学习兴趣

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动Screeps服务器容器：

bash
docker run -d \
  --name screeps-server \
  -p 21025:21025 \
  -v /path/to/local/data:/data \
  -e SCREEPS_SERVER_NAME="My Screeps Server" \
  -e SCREEPS_ADMIN_PASSWORD="securepassword" \
  docker.xuanyuan.run/screeps/server

参数说明：

• -p 21025:21025：映射游戏服务器默认端口（21025为Screeps标准通信端口）
• -v /path/to/local/data:/data：挂载本地目录至容器内/data目录，实现数据持久化
• -e SCREEPS_SERVER_NAME：设置服务器名称（客户端显示）
• -e SCREEPS_ADMIN_PASSWORD：设置管理员密码（用于服务器管理界面登录）

Docker Compose 配置

创建docker-compose.yml文件，实现更便捷的服务管理：

yaml
version: '3'
services:
  screeps-server:
    image: docker.xuanyuan.run/screeps/server
    container_name: screeps-server
    ports:
      - "21025:21025"
    volumes:
      - ./screeps-data:/data
    environment:
      - SCREEPS_SERVER_NAME=My Community Server
      - SCREEPS_ADMIN_PASSWORD=your_admin_password
      - SCREEPS_PVP_ENABLED=true
      - SCREEPS_TICK_RATE=60
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

数据持久化

容器内游戏数据（玩家存档、房间状态、配置文件等）存储于/data目录，需通过挂载卷实现持久化：

• 本地目录挂载：-v /local/path:/data
• Docker Volume挂载：-v screeps-data-volume:/data（需先创建卷：docker volume create screeps-data-volume）

环境变量配置

服务器管理

1. 访问管理界面：通过浏览器访问 http://服务器IP:21025，使用管理员密码登录
2. 查看日志：docker logs -f screeps-server
3. 停止/重启服务：

   bash
   docker stop screeps-server
   docker start screeps-server
   

高级配置

如需自定义服务器规则或安装模组，可通过修改挂载的/data目录下的配置文件实现：

• 服务器配置文件：/data/config.yml
• 模组安装：将模组文件放入/data/node_modules目录（需符合Screeps模组规范）