cm2network/steamcmd 镜像文档

![]([] ![Docker Build Status]([] ![Docker Stars]([] ![Docker Pulls]([] ![]([] ![]([***]

支持的标签及对应 Dockerfile 链接

• steam, steam-bookworm, latest (bookworm/Dockerfile)
• root, root-bookworm (bookworm/Dockerfile)
• steam-bullseye, bullseye (bullseye/Dockerfile)
• root-bullseye (bullseye/Dockerfile)

镜像概述和主要用途

SteamCMD（Steam 控制台客户端）是 Steam 客户端的命令行版本，主要用于通过命令行界面安装和更新 Steam 上可用的各种专用服务器。它适用于使用 SteamPipe 内容系统的游戏，所有游戏均已从已弃用的 HLDSUpdateTool 迁移到 SteamCMD。

该镜像包含 Valve 的 SteamCMD 二进制文件，设计为最小化镜像，可作为基于 Steam 的专用服务器的基础镜像使用。

核心功能和特性

• 提供命令行界面的 Steam 客户端
• 支持安装和更新 Steam 平台上的专用服务器
• 兼容使用 SteamPipe 内容系统的游戏
• 提供非 root 用户安全运行环境
• 支持多种 Debian 版本变体（bookworm、bullseye）
• 可通过数据卷持久化 SteamCMD 安装和登录会话

使用场景和适用范围

• 作为游戏服务器 Docker 镜像的基础镜像
• 测试 Steam 平台专用服务器的安装
• 自动化部署和更新 Steam 游戏服务器
• 构建自定义游戏服务器镜像
• 开发和测试与 Steam 服务器相关的应用程序

使用方法和配置说明

基本交互式使用

可以通过以下命令以交互方式运行镜像：

console
$ docker run -it --name=steamcmd cm2network/steamcmd bash
$ ./steamcmd.sh +force_install_dir /home/steam/squad-dedicated +login anonymous +app_update 403240 +quit

此方法适用于测试特定游戏服务器安装。上述示例命令会安装 SQUAD 专用服务器。

使用命名卷持久化数据

console
# 可选：创建用于存储登录会话的卷
$ docker volume create steamcmd_login_volume
# 可选：创建用于存储 SteamCMD 安装的卷
$ docker volume create steamcmd_volume

$ docker run -it \
    -v "steamcmd_login_volume:/home/steam/Steam" \
    -v "steamcmd_volume:/home/steam/steamcmd" \
    cm2network/steamcmd bash

当需要下载非*** AppID 或上传 steampipe 构建时，此设置是必要的。

配置说明

• SteamCMD 可执行文件路径：/home/steam/steamcmd.sh
• 镜像包含 nano 文本编辑器，便于配置文件编辑
• 默认工作目录：/home/steam
• 默认用户：steam（UID 1000）

镜像变体

steamcmd 镜像提供两种主要变体，适用于不同使用场景：

steamcmd:latest（默认镜像）

这是默认推荐的镜像。如果不确定需求，建议使用此版本。设计用作构建其他镜像的基础，默认用户为 steam，在高层 Dockerfile 中执行的任何命令都将以此用户身份执行。

steamcmd:root

这是一个特殊用途镜像，默认用户为 root。如果需要为游戏服务器安装额外软件包且不想创建过多层，此版本是合适的选择。

注意：以 root 用户运行 steamcmd.sh 会失败，因为目录所有者是 steam 用户。可以使用 su steam 切换用户，或使用 chown 更改目录所有权。

使用示例

以下是基于此镜像的游戏服务器镜像示例：

贡献者

![Contributors Display]([***]