kmallea/csgo

CSGO容器化

该Docker镜像用于在容器中运行Counter-Strike: Global Offensive（CSGO）专用服务器。

默认包含以下插件和扩展：

• Metamod
• SourceMod
• SteamWorks
• Updater
• https://github.com/splewis/csgo-pug-setup
• https://github.com/splewis/csgo-practice-mode
• https://github.com/splewis/csgo-retakes%EF%BC%88**%E9%BB%98%E8%AE%A4%E7%A6%81%E7%94%A8**%EF%BC%89

要启动10人比赛/聚会，只需连接服务器并在聊天中输入.setup。练习模式也可从菜单中使用。

Retakes默认禁用。如需启用，设置环境变量RETAKES=1并重启容器。之后可使用控制台变量sm_retakes_enabled 0随时关闭。

使用方法

bash
docker pull kmallea/csgo:latest

如需直接使用镜像，可通过以下命令运行并配置环境变量：

bash
docker run \
  --rm \
  --interactive \
  --tty \
  --detach \
  --mount source=csgo-data,target=/home/steam/csgo \
  --network=host \
  --env "SERVER_HOSTNAME=服务器名称" \
  --env "SERVER_PASSWORD=服务器密码" \
  --env "RCON_PASSWORD=rcon密码" \
  --env "STEAM_ACCOUNT=游戏登录令牌" \
  --env "AUTHKEY=Web API密钥" \
  --env "SOURCEMOD_ADMINS=STEAM_1:0:123456,STEAM_1:0:654321" \
  kmallea/csgo

如需使用绑定卷直接访问文件内容，将上述命令中的卷挂载替换为：--mount type=bind,source=$(pwd),target=/home/steam/csgo。

若计划通过绑定卷手动管理插件，建议设置空值或简化的INSTALL_PLUGINS环境变量以避免冲突（默认值见下文）。

必需的游戏登录令牌

STEAM_ACCOUNT是Valve要求的"游戏登录令牌"，用于运行公共服务器（通过sv_setsteamaccount设置）。获取地址：[***]

注意：若未提供有效令牌，服务器将仅限局域网访问。

可选的Steam Web API密钥（用于Workshop内容）

如需访问Workshop地图和合集，需提供Steam Web API密钥，通过AUTHKEY环境变量传递（命令行参数-authkey <key>）。

密钥生成地址：[***]

设置密钥后，可通过HOST_WORKSHOP_COLLECTION和WORKSHOP_START_MAP环境变量指定Workshop合集和启动地图。

更多信息见Valve开发者 wiki。

SourceMod管理员

可选环境变量SOURCEMOD_ADMINS为逗号分隔的Steam ID列表，服务器启动前会添加至SourceMod管理员列表。

局域网游戏

局域网环境下，添加环境变量LAN=1（如--env "LAN=1"）可自动设置sv_lan 1。

环境变量覆盖

以下为控制服务器配置的环境变量默认值，可通过-e或--env参数覆盖：

bash
SERVER_HOSTNAME=Counter-Strike: Global Offensive Dedicated Server
SERVER_PASSWORD=
RCON_PASSWORD=changeme
STEAM_ACCOUNT=changeme
AUTHKEY=changeme
IP=0.0.0.0
PORT=27015
TV_PORT=27020
TICKRATE=128
FPS_MAX=400
GAME_TYPE=0
GAME_MODE=1
MAP=de_dust2
MAPGROUP=mg_active
HOST_WORKSHOP_COLLECTION=
WORKSHOP_START_MAP=
MAXPLAYERS=12
TV_ENABLE=1
LAN=0
SOURCEMOD_ADMINS=
RETAKES=0
NOMASTER=0

为兼容Docker secrets，以下环境变量支持"_FILE"变体：

bash
SERVER_PASSWORD_FILE
RCON_PASSWORD_FILE
STEAM_ACCOUNT_FILE
AUTHKEY_FILE
SOURCEMOD_ADMINS_FILE

若设置_FILE变量，将使用对应文件内容作为非_FILE变量的值；若两者均设置，非_FILE变量优先。

示例docker-compose配置：

yml
version: "3.7"
services:
  app:
    image: kmallea/csgo
    secrets:
      - csgo_rcon_password
    environment:
      - RCON_PASSWORD_FILE=/run/secrets/csgo_rcon_password

secrets:
  csgo_rcon_password:
    file: ${SECRETS_DIR}/csgo_rcon_password.txt

PugSetup控制台变量

PugSetup默认配置可通过环境变量控制。所有前缀为SM_PUGSETUP_的环境变量会更新$CSGODIR/csgo/cfg/sourcemod/pugsetup.cfg中的对应控制台变量。

注意：pugsetup.cfg在插件首次加载时自动生成，因此可能需要在首次运行后重启容器使文件生效。

示例：设置sm_pugsetup_snake_captain_picks和sm_pugsetup_message_prefix：

bash
  ...
  --env "SM_PUGSETUP_SNAKE_CAPTAIN_PICKS=2" \
  --env "SM_PUGSETUP_MESSAGE_PREFIX=[{YELLOW}芝麻街{NORMAL}]" \
  ...

对应pugsetup.cfg内容：

bash
...
sm_pugsetup_snake_captain_picks "2"
sm_pugsetup_message_prefix "[{YELLOW}芝麻街{NORMAL}]"
...

故障排除

若无法使用--network=host，需手动发布端口：

bash
docker run \
  --rm \
  --interactive \
  --tty \
  --detach \
  --mount source=csgo-data,target=/home/steam/csgo \
  --publish 27015:27015/tcp \
  --publish 27015:27015/udp \
  --publish 27020:27020/tcp \
  --publish 27020:27020/udp \
  --env "SERVER_HOSTNAME=服务器名称" \
  --env "SERVER_PASSWORD=服务器密码" \
  --env "RCON_PASSWORD=rcon密码" \
  --env "STEAM_ACCOUNT=游戏登录令牌" \
  --env "AUTHKEY=Web API密钥" \
  --env "SOURCEMOD_ADMINS=STEAM_1:0:123456,STEAM_1:0:654321" \
  kmallea/csgo

手动构建

bash
docker build -t csgo-dedicated-server .

或

bash
make

游戏数据在首次运行时下载（约26GB）。如需重建容器保留数据，需挂载卷至/home/steam/csgo（支持数据卷或绑定卷，插件在容器启动时安装）。

覆盖SteamCMD、Metamod、SourceMod和PugSetup版本

SteamCMD

SteamCMD在构建时安装，可通过构建参数STEAMCMD_URL覆盖下载地址：

bash
docker build \
  -t $(IMAGE_NAME) \
  --build-arg STEAMCMD_URL=https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz \
  .

Metamod、SourceMod、PugSetup、Retakes等

所有插件和扩展在容器启动时安装，可通过INSTALL_PLUGINS环境变量管理（空格分隔的插件URL列表，换行符会转换为空格）。覆盖时需包含Metamod和SourceMod，否则依赖插件无法运行。

默认值：

bash
INSTALL_PLUGINS="${INSTALL_PLUGINS:-https://mms.alliedmods.net/mmsdrop/1.10/mmsource-1.10.7-git971-linux.tar.gz
https://sm.alliedmods.net/smdrop/1.10/sourcemod-1.10.0-git6478-linux.tar.gz
https://github.com/splewis/csgo-pug-setup/releases/download/2.0.5/pugsetup_2.0.5.zip
https://github.com/splewis/csgo-retakes/releases/download/v0.3.4/retakes_0.3.4.zip
https://github.com/b3none/retakes-instadefuse/releases/download/1.4.0/retakes-instadefuse.smx
https://github.com/b3none/retakes-autoplant/releases/download/2.3.0/retakes_autoplant.smx
https://github.com/b3none/retakes-hud/releases/download/2.2.5/retakes-hud.smx
}"

每个插件URL会生成校验和并存储为$CSGO_DIR/csgo/<checksum>.marker，避免重复下载已安装插件。

添加自定义配置文件等

构建时

containerfs目录对应steam用户主目录（/home/steam），CSGO游戏数据位于其中。如需添加文件，将其放入containerfs下对应路径，构建后会出现在镜像中。

建议通过运行时INSTALL_PLUGINS环境变量安装插件，实现与镜像解耦。

运行时

• 参考上文INSTALL_PLUGINS部分安装插件。
• 数据卷：使用docker cp命令从主机复制文件到数据卷。
• 绑定卷：直接复制文件到绑定目录，如需手动管理所有内容，可清空INSTALL_PLUGINS变量。

本地测试

构建后：

1. 编辑Makefile中的环境变量。
2. 运行make server启动本地局域网服务器测试。
3. 运行make test执行测试。