gameservermanagers/steamcmd

SteamCMD Docker镜像

https://hub.docker.com/r/gameservermanagers/steamcmd https://github.com/GameServerManagers/docker-steamcmd/actions

https://github.com/GameServerManagers/docker-steamcmd/blob/main/LICENSE

概述

SteamCMD是Steam客户端的命令行版本，允许在无头服务器上下载和安装游戏/服务器应用。此容器镜像每日构建，可在https://hub.docker.com/r/gameservermanagers/steamcmd%E5%92%8Chttps://github.com/GameServerManagers/docker-steamcmd/pkgs/container/steamcmd%E8%8E%B7%E5%8F%96%E3%80%82

镜像标签

*日期基于Canonical发布的LTS支持计划中的标准（免费）安全更新结束时间。扩展安全维护（ESM）可能会延长这些日期，但如果上游包（如SteamCMD依赖项）不可用，镜像可能会提前弃用。

使用方法

拉取最新镜像并打开SteamCMD交互式终端：

bash
docker run -it --rm gameservermanagers/steamcmd:latest

下载并更新应用到当前主机目录（示例：Garry's Mod专用服务器 - appid 4020）：

bash
docker run -it --rm \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  -v "$PWD:/data" \
  gameservermanagers/steamcmd:latest \
  +force_install_dir /data +login anonymous +app_update 4020 +quit

数据持久化

SteamCMD将其库数据（清单、仓库、创意工坊缓存）存储在/home/steam/.local/share/Steam。我们使用+force_install_dir将应用文件放置在独立目录中。如果省略+force_install_dir（或在第一个+app_update之后放置），应用将安装在：

text
/home/steam/.local/share/Steam/steamapps/common/<应用名称>

使用独立挂载（如/data）并配合+force_install_dir /data可将应用文件与Steam库缓存分离。

绑定挂载示例

bash
docker run -it --rm \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  -v "$PWD:/data" \
  -v "/path/on/host/steamcmd-app:/home/steam/.local/share/Steam" \
  gameservermanagers/steamcmd:latest \
  +force_install_dir /data +login anonymous +app_update 4020 +quit

Docker卷示例

bash
docker volume create steamcmd-data
docker volume create steamcmd-app
docker run -it --rm \
  -v "steamcmd-data:/data" \
  -v "steamcmd-app:/home/steam/.local/share/Steam" \
  gameservermanagers/steamcmd:latest \
  +force_install_dir /data +login anonymous +app_update 4020 +quit

用户、UID和GID（PUID/PGID）

镜像使用非root用户steam（默认UID:GID 1000:1000）。可通过环境变量PUID和PGID在运行时覆盖这些ID；入口点会在执行SteamCMD前映射用户/组，使创建的文件与主机用户匹配。

运行时覆盖（推荐）

bash
docker run --rm \
  -e PUID=1001 -e PGID=1001 \
  -v "$PWD/steam-app:/home/steam/.local/share/Steam" \
  -v "$PWD/server-data:/data" \
  gameservermanagers/steamcmd:latest \
  +force_install_dir /data +login anonymous +app_update 4020 +quit

构建时默认值（可选）

也可修改构建时默认值（大多数用户不需要）：

bash
docker build --build-arg PUID=1001 --build-arg PGID=1001 -t steamcmd:uid1001 -f Dockerfile.ubuntu-2404 .

权限故障排除

登录示例

SteamCMD支持和认证登录。尽可能使用登录。

***登录（首选）

bash
docker run --rm \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  -v "$PWD/steam-app:/home/steam/.local/share/Steam" \
  -v "$PWD/server-data:/data" \
  gameservermanagers/steamcmd:latest \
  +force_install_dir /data +login anonymous +app_update 4020 +quit

认证登录（用户名/密码）

某些应用（如特定私有分支、工具或测试版仓库）需要Steam账户。

无状态（无持久Steam数据）

首次使用几乎总会触发Steam Guard，之后也可能再次触发，因为没有数据持久化：

bash
docker run --rm \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  -v "$PWD/server-data:/data" \
  gameservermanagers/steamcmd:latest \
  +@ShutdownOnFailedCommand 1 +force_install_dir /data \
  +login "${STEAM_USER}" "${STEAM_PASS}" +app_update 223350 +quit

持久化（推荐）

持久化/home/steam/.local/share/Steam，使sentry（guard）文件被缓存，后续运行无需代码提示。

bash
docker run --rm \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  -v "$PWD/steam-app:/home/steam/.local/share/Steam" \
  -v "$PWD/server-data:/data" \
  gameservermanagers/steamcmd:latest \
  +@ShutdownOnFailedCommand 1 \
  +force_install_dir /data \
  +login "${STEAM_USER}" "${STEAM_PASS}" +app_update 223350 +quit

建议：

• 对于认证工作流，始终挂载持久化Steam数据（见数据持久化部分）以避免重复的Steam Guard提示。
• 通过环境变量或一次性密钥传递凭据，不要硬编码到提交到源代码控制的compose文件中。
• 任何Steam Guard（2FA/电子邮件）提示后，可内联提供代码：+login user pass CODE（第三个参数），或交互式运行一次以在挂载的Steam目录中缓存sentry文件。
• 使用仅具有所需权限的专用临时账户；切勿使用主账户。
• 将挂载的Steam数据目录视为敏感数据（包含身份验证令牌/sentry文件），不要公开。

处理Steam Guard/2FA

1. 使用持久化Steam数据挂载交互式运行一次。
2. 提示时输入代码（不要添加到脚本中）。
3. 后续脚本运行无需进一步提示，因为sentry文件已存储。

SteamCMD命令

可在镜像名称后链式添加的常用命令/标志（顺序重要；见下方说明）：

命令说明

• 推荐顺序：+@ShutdownOnFailedCommand 1 +@NoPromptForPassword 1 +force_install_dir /data +login ... +app_update <appid> validate +quit
• +force_install_dir必须放在第一个+app_update之前，否则文件会进入默认库（/home/steam/Steam/steamapps）。
• 谨慎使用validate；仅在初始安装或怀疑损坏时使用。
• 复杂多应用工作流使用脚本文件（+runscript）；每行应镜像内联形式（无shell引用问题）。
• 创意工坊项目需先安装基础应用（服务器）；创意工坊内容位于应用的workshop目录下。
• +download_depot可能需要认证登录和正确的分支访问权限；清单是版本特定的。

常见问题

Q: 如何查找appid？
搜索SteamDB并使用显示的数字App ID。

Q: 为什么出现"连接失败"或SSL错误？
通常是临时网络问题或防火墙DPI干扰。重试，或确保出站TCP 27015/27036和HTTPS端口开放。

Q: 能否在一次容器调用中运行多个更新？
可以，链式添加多个+app_update命令或使用包含每行一个命令的运行脚本文件。

Q: 是否需要暴露端口？
下载内容不需要。游戏服务器端口由使用下载文件构建/运行的单独服务器容器处理。

注意事项

此容器基于https://github.com/steamcmd/docker%E5%AE%B9%E5%99%A8%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8ELinuxGSM%E6%B8%B8%E6%88%8F%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82