SCP: Secret Laboratory

GitHub: []
LocalAdmin: []

镜像概述和主要用途

本镜像用于快速部署和运行SCP: Secret Laboratory游戏服务器，基于Docker容器化技术，支持服务器的安装、更新、启动及管理。提供数据持久化、端口自定义、环境变量配置等功能，简化游戏服务器的搭建和维护流程，适用于个人或小型社区服务器场景。

核心功能和特性

• 自动安装与更新：支持update（安装最新版本）、update_validate（安装并验证文件，推荐初始部署）命令，确保服务器版本最新。
• 数据持久化：游戏数据存储于/home/ips-hosting目录，默认通过Docker卷持久化，支持挂载主机目录实现数据长期保存。
• 端口灵活配置：默认使用7777端口（UDP游戏端口、TCP查询端口），可通过GAME_PORT环境变量修改，需同步调整端口映射。
• 环境变量自定义：支持配置服务器分支、日志长度限制、游戏端口等，通过环境变量动态修改服务器配置文件。
• 控制台交互：支持通过docker attach实时连接服务器控制台，执行命令并查看输出。

使用场景和适用范围

适用于需要搭建SCP: Secret Laboratory游戏服务器的用户，尤其是希望简化部署流程、快速上手并灵活管理服务器的场景。支持个人游戏服务器、小型社区服务器等，满足不同规模的游戏服务需求。

详细使用方法和配置说明

基本使用

以下是容器的基本操作命令（高级用法请参考Docker文档）：

shell
# 创建容器
docker create -it --restart always \
  --name scpsl-server \
  -p 7777:7777/udp \
  -p 7777:7777/tcp \
  ipshosting/game-scpsl:v2

# 启动服务器
docker start scpsl-server

# 停止服务器
docker stop scpsl-server

# 重启服务器
docker restart scpsl-server

# 查看服务器日志
docker logs scpsl-server

# 连接服务器控制台（实时输入命令和查看输出，按CTRL-P + CTRL-Q断开连接）
docker attach scpsl-server

# 删除容器
docker rm scpsl-server

命令说明

默认启动容器时，会自动安装、更新服务器并启动。可通过指定命令修改行为：

• update：仅安装服务器最新版本，完成后容器退出，不启动服务器。
• update_validate：安装服务器并验证文件完整性，推荐初始部署时使用。
• start：仅启动服务器，不执行安装或更新操作。

数据持久化

游戏服务器数据存储于容器内/home/ips-hosting目录。默认情况下，Docker会自动创建卷持久化数据，容器重启后数据保留。若需手动管理数据（如容器重建后保留数据），可挂载主机目录：

shell
docker create -it --restart always \
  --name scpsl-server \
  -v /主机绝对路径:/home/ips-hosting \  # 挂载主机目录
  -p 7777:7777/udp \
  -p 7777:7777/tcp \
  ipshosting/game-scpsl:v2

容器默认以UID 1000的用户运行，需确保挂载目录权限正确：

• 方法1：修改主机目录所有者：chown -R 1000 /主机绝对路径
• 方法2：通过--user 用户名/ID指定容器运行用户（需为主机目录所有者ID）

端口配置

默认端口：

• 7777/udp：游戏端口
• 7777/tcp：查询端口（与游戏端口相同）

可通过GAME_PORT环境变量修改端口，需同步更新容器端口映射。例如修改为8888端口：

shell
docker create -it --restart always \
  --name scpsl-server \
  -p 8888:8888/udp \  # 同步更新端口映射
  -p 8888:8888/tcp \
  -e "GAME_PORT=8888" \  # 设置环境变量
  ipshosting/game-scpsl:v2

环境变量配置

通过-e "KEY=VAL" flag配置环境变量（可多次使用），修改需重建容器。

update/update_validate命令适用变量

以下变量在执行update或update_validate时生效：

• BETA_BRANCH：指定服务器分支（用于下载测试版等非默认分支）
• BETA_PASSWORD：测试版分支的密码（若分支需要）

start命令适用变量

以下变量在执行start时始终生效：

• GAME_PORT：游戏端口，默认7777，需同步修改端口映射
• LOG_LENGTH_LIMIT：LocalAdmin日志文件大小限制，支持k/M/G/T后缀，默认1G

通过环境变量修改配置文件

启动时可通过前缀为CONFIG*的环境变量修改config_gameplay.txt文件：已存在的配置项会被修改，不存在的会被添加，变量名大小写不敏感。示例：

shell
# 修改服务器名称：server_name: My New Server Name
docker create -it ... -e "CONFIG_SERVER_NAME=My New Server Name" ...

# 启用原生套接字：use_native_sockets: true
docker create -it ... -e "config_use_native_sockets=true" ...

# 添加新配置项：my_new_property: 3.66
docker create -it ... -e "cOnFiG_my_new_property=3.66" ...