硬件与系统要求

SCP: 5K 包含大量 AI 运算与物理碰撞，对服务器硬件有一定要求：

• 最低配置（4核 4G）：适合 2-3 人体验。怪物密集场景可能有轻微卡顿。

• 推荐配置（8核 8G）：适合 4 人以上游玩，能保证流畅运行。

• 网络要求：必须具备独立公网 IP。

• 操作系统：建议使用 Linux（如 Ubuntu 22.04 或 Debian 12，勿使用 Windows）。

前置准备：本教程基于 Docker。如果服务器尚未安装 Docker，请先参考【第一章：安装 Docker 环境】。

第一步：准备配置文件

以下是 SCP: 5K 的标准配置文件（docker-compose.yml），你可以直接复制备用：

YAML

version: '3.8' 

services:
  scp5k-server:
    image: cyzl0721/scp5k:latest # 拉取最新的游戏服务端镜像
    container_name: scp5k-server # 容器名称
    restart: unless-stopped      # 崩溃或重启时自动恢复运行
    ports:
      # 端口映射（左侧为云服务器端口，右侧为容器端口）
      - "7778:7778/udp"
      - "7778:7778/tcp"
      - "27015:27015/udp"
      - "25575:25575/tcp"
    environment:
      # 游戏服务器设置
      - PORT=7778
      - QUERY_PORT=27015
      - SERVER_NAME=My SCP 5K Server   # 大厅显示的服务器名称
      - MAX_PLAYERS=8                  # 最大玩家数
      - RCON_PASSWORD=YourStrongPassword # RCON 管理员密码（请务必修改）
      - UPDATE_ON_START=false          # 启动时是否强制更新（设为 false 可加快开服速度）
      - OVERWRITE_CONFIG=false         # 配置文件防覆盖保护
    volumes:
      # 数据持久化：保留游戏存档和配置，防止容器删除后数据丢失
      - scp5k-data:/scp5k/Pandemic/Saved

volumes:
  scp5k-data:

第二步：在云服务器上部署

使用 SSH 工具（如 FinalShell、Xshell）连接到服务器终端后，按以下步骤操作：

1. 创建并进入专属文件夹 执行以下命令新建目录：

Bash

mkdir -p /root/scp5k
cd /root/scp5k

2. 新建配置文件 输入以下命令，使用系统自带的 vi 编辑器打开文件：

Bash

vi docker-compose.yml

3. 粘贴代码 进入黑屏界面后，先按一下键盘上的字母 i。确认屏幕左下角出现 -- INSERT -- 或 -- 插入 -- 提示后，再点击鼠标右键，将刚才复制的代码粘贴进去。

注意：YAML 文件对空格要求极严，粘贴后请勿使用 Tab 键调整排版，保持原样即可。

4. 保存并退出 代码粘贴完成后，按顺序执行以下按键操作：

• 按 Esc 键退出编辑模式（左下角的 INSERT 提示会消失）。

• 输入 :wq （英文冒号、w、q，代表保存并退出）。

• 按回车键确认。

5. 启动服务器 文件保存后，输入以下命令在后台启动服务：

Bash

docker compose up -d

等待进度条下载完毕，出现绿色的 Started 提示，即代表服务器运行成功。

第三步：服务器状态与日志管理

服务器后台运行后，你可以随时通过以下基础指令检查工作状态。

1. 查看运行状态与端口 输入以下命令：

Bash

docker ps

回车后，重点关注输出列表中的两个参数：

• STATUS（状态）：显示 Up x minutes 表示运行正常；若显示 Restarting 说明程序报错不断重启，通常是代码格式错误或端口被占用。

• PORTS（端口）：确认有类似 0.0.0.0:7778->7778/udp 的字样，表示端口已对外映射。

2. 查看实时后台日志 刚启动时需要时间加载地图。通过以下命令可以实时查看加载进度：

Bash

docker logs -f scp5k-server

当日志中刷出 Server started 或 Map loaded 等字眼时，说明开服完成，玩家可以搜索进入。

提示：按 Ctrl + C 可强行退出日志滚动界面，回到终端输入状态。这不会影响服务器在后台运行。

结语与注意事项

跟着教程走到这里，你的 SCP: 5K 服务器就已经搭建完成了。最后提醒两点极易踩坑的地方：

1. 防火墙放行：必须在云服务器的控制台（如阿里云、腾讯云的安全组页面）放行对应的端口（7778、27015、25575）。如果没有放行，大厅里将搜不到你的服务器。

2. RCON 密码安全：不要泄露你在配置文件里设置的 RCON_PASSWORD，该密码拥有服务器的最高控制权限。

祝各位收容顺利，玩得开心！

[容器详细信息请点我]