thetestgame/steam

Steam (SteamCMD) Docker镜像

注意：这不是Valve官方的Steam Docker容器。

镜像概述和主要用途

该Docker镜像提供了一个通用的Steam专用服务器运行环境，基于steamcmd工具构建，支持部署Linux原生服务器和通过wine运行的Windows服务器。镜像基于Ubuntu系统，包含wine环境和最新的steamcmd工具，适用于搭建各类Steam游戏的专用服务器。

核心功能和特性

• 多平台支持：同时支持Linux原生服务器和Windows服务器（通过wine）
• 自动更新机制：可配置启动时自动更新操作系统、steamcmd及指定的游戏服务器
• 灵活配置：通过环境变量自定义服务器路径、平台类型、应用ID等参数
• 权限管理：支持通过PUID/PGID指定运行用户，避免卷挂载权限问题
• 扩展兼容性：包含supervisord进程管理工具，支持复杂服务器的状态管理
• Winetricks集成：内置winetricks工具，方便配置Windows服务器依赖环境

使用场景和适用范围

适用于需要搭建Steam游戏专用服务器的场景，已验证支持：

• Left 4 Dead（Linux服务器，带SourceMod、MetaMod）
• Left 4 Dead 2（Linux服务器，带SourceMod、MetaMod）
• Conan Exiles（Windows服务器）

版本标签

容器每周自动重建以保持更新

参数说明

端口配置

容器默认暴露以下端口，可根据需要在Docker配置中添加额外端口。详细Steam端口要求见Steam官方文档。

卷配置

用户/组ID

使用数据卷（-v参数）时，主机和容器之间可能出现权限问题。通过PUID和PGID环境变量可指定容器内运行应用的用户ID和组ID，避免权限冲突。

在主机上执行以下命令获取当前用户的ID：

bash
id <username>

输出示例：

uid=1000(myuser) gid=1000(myuser) groups=1000(myuser),4(adm),24(cdrom),27(sudo),46(plugdev),113(lpadmin)

其中uid（用户ID）和gid（组ID）即为PUID和PGID应设置的值。

使用方法和配置说明

docker-compose配置示例

Windows专用服务器

yaml
---
version: "3"
services:
  steam:
    image: thetestgame/steam:stable
    restart: unless-stopped
    ports:
      - 27015:27015
      - 27015:27015/udp
      - 27016:27016/udp
    environment:
      - PUID=1000
      - PGID=1000
      - UPDATE_OS=1
      - UPDATE_STEAM=1
      - UPDATE_SERVER=1
      - PLATFORM=windows
      - STEAM_APP_ID=443030  # Conan Exiles的Steam应用ID
      - TZ=America/Los_Angeles
    volumes:
      - /my/docker/server/data:/data
      - /etc/localtime:/etc/localtime:ro

Linux专用服务器

yaml
---
version: "3"
services:
  steam:
    image: thetestgame/steam:stable
    restart: unless-stopped
    ports:
      - 27015:27015
      - 27015:27015/udp
      - 27016:27016/udp
    environment:
      - PUID=1000
      - PGID=1000
      - UPDATE_OS=1
      - UPDATE_STEAM=1
      - UPDATE_SERVER=1
      - PLATFORM=linux
      - STEAM_APP_ID=294420  # Left 4 Dead 2的Steam应用ID
      - TZ=America/Los_Angeles
    volumes:
      - /my/docker/server/data:/data
      - /etc/localtime:/etc/localtime:ro

自定义服务器脚本

容器启动时会执行/data/custom_server脚本，必须手动创建此脚本并设置为可执行文件。该脚本用于配置服务器启动参数、前置操作（如安装mod、备份）等。

Linux服务器示例（Left 4 Dead）

bash
su - steam -c "/data/server/srcds_run -console -game left4dead -map l4d_hospital01_apartment -port 27015 +maxplayers 4 -nohltv +exec server.cfg"

Windows服务器示例（Conan Exiles）

bash
su - steam -c "xvfb-run --auto-servernum \
  wine64 ${SERVER_DIR}/ConanSandbox/Binaries/Win64/ConanSandboxServer-Win64-Test.exe -nosteamclient -game -server -log"

注意：Windows服务器需要轻量级窗口管理器支持，xvfb-run --auto-servernum用于提供虚拟显示环境。

无状态服务器脚本

适用于不需要在重启间保存状态的服务器：

Windows

bash
su - steam -c "xvfb-run --auto-servernum \
  wine64 ${SERVER_DIR}/ConanSandbox/Binaries/Win64/ConanSandboxServer-Win64-Test.exe -nosteamclient -game -server -log"

Linux

bash
su - steam -c "/data/server/startserver.sh \
  -configfile=/data/server/serverconfig.xml"

带状态保存的服务器脚本（Bash）

适用于需要正常关闭以保存状态的服务器：

首先在docker-compose中设置适当的关闭等待时间：

yaml
services:
  steam:
    image: thetestgame/steam:latest
    restart: unless-stopped
    stop_grace_period: 1m  # 给予1分钟关闭时间
    # 其他配置...

创建/data/custom_server脚本：

bash
#!/bin/bash
PROCESS_WAIT_TIME=25
WATCHDOG_TIME=300

function shutdown() {
  echo 'Shutting down server ...'
  if [ "$(pgrep -n Conan)" != '' ]; then
    echo "Sending SIGINT to Conan server (max ${PROCESS_WAIT_TIME} secs) ..."
    kill -SIGINT `pgrep -n Conan`
    sleep ${PROCESS_WAIT_TIME}
  fi
  if [ "$(pgrep wine)" != '' ]; then
    echo "Sending SIGINT to wine processes (max ${PROCESS_WAIT_TIME} sec) ..."
    kill -SIGINT `pgrep wine`
    sleep ${PROCESS_WAIT_TIME}
  fi
  exit 0
}
trap shutdown SIGINT SIGKILL SIGTERM

function start_server() {
  su - steam -c "xvfb-run --auto-servernum wine64 ${SERVER_DIR}/ConanSandbox/Binaries/Win64/ConanSandboxServer-Win64-Test.exe -nosteamclient -game -server -log"
}

function watch_server() {
  if ps aux | grep [C]onanSandboxServer > /dev/null; then
    echo 'Server is running ...'
  else
    echo 'Starting server ...'
    start_server &
  fi
}

while true; do
  watch_server
  sleep ${WATCHDOG_TIME} &
  wait
done

使用Supervisord管理服务器

容器内置supervisord进程管理工具，适用于复杂服务器管理。

1. 将/data/custom_server脚本设置为：

bash
/usr/bin/supervisord -c /etc/supervisor/supervisord.conf

2. 在/data/supervisord目录中放置supervisord配置文件，示例配置：

ini
[program:conanexiles]
command=xvfb-run --auto-servernum wine64 ${SERVER_DIR}/ConanSandbox/Binaries/Win64/ConanSandboxServer-Win64-Test.exe -nosteamclient -game -server -log
user=steam
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true

Winetricks使用

winetricks工具已安装在/usr/bin/winetricks，可在custom_server脚本中用于配置Windows服务器依赖：

bash
su - steam -c "winetricks dotnet472"  # 安装.NET Framework 4.7.2
su - steam -c "winetricks vcrun2013"  # 安装Visual C++ 2013运行库

故障排除

"Failed to determine free disk space for ... error 75"

ZFS文件系统上可能出现此错误，需设置显式配额：

bash
sudo zfs set quota=2T zpool1/docker

Windows服务器首次启动需5分钟左右

Wine首次启动可能因初始化环境而延迟，后续启动会加快。可手动执行以下命令缓解：

bash
xvfb-run --autoservernum wineboot --update

"cat: hlds.{PID}.pid: No such file or directory"

srcds_run无法写入PID文件时，手动指定PID文件路径：

bash
srcds_run ... -pidfile /data/server/game.pid

"Could not find steamclient.so"

确保使用su - steam -c加载完整用户环境，或链接steamclient.so：

bash
ln -s -f /steam/.steam/steamcmd/linux32/steamclient.so /steam/.steam/sdk32/steamclient.so

许可信息

Steam Logo、SteamCMD ©2019 Valve Corporation。Steam及Steam徽标是Valve Corporation在美国和/或其他国家的商标和/或注册商标。