ipshosting/game-csgo

反恐精英：全球攻势(CS:GO)游戏服务器Docker镜像

GitHub: https://github.com/IPS-Hosting/game-images/tree/main/csgo

镜像概述

本Docker镜像用于快速部署和运行反恐精英：全球攻势(CS:GO)游戏服务器，支持服务器更新、数据持久化、自定义端口映射及丰富的环境变量配置，适用于个人、游戏社区或赛事组织搭建CS:GO服务器。

核心功能与特性

• 支持服务器安装、更新与验证（update、update_validate命令）
• 数据持久化存储，支持挂载主机目录或使用Docker卷
• 自定义端口配置（游戏端口、客户端端口、TV端口）
• 丰富的环境变量控制（玩家数量、tickrate、游戏模式、VAC开关等）
• 支持 Workshop 地图集加载与认证
• 实时服务器控制台交互

使用场景

• 个人玩家搭建私人CS:GO服务器
• 游戏社区部署公共或会员专属服务器
• 电子竞技赛事临时或长期服务器搭建
• 开发/测试环境中快速部署CS:GO服务器实例

使用方法

基础操作

高级用法请参考：[***]

shell
# 创建Docker容器
docker create -it --restart always \
  --name csgo-server \
  -p 27015:27015/udp \
  -p 27015:27015/tcp \
  -p 27005:27005/tcp \
  -p 27020:27020/udp \
  -e "GSLT=YOUR_GSLT" \
  ipshosting/game-csgo:v2

# 启动服务器
docker start csgo-server

# 停止服务器
docker stop csgo-server

# 重启服务器
docker restart csgo-server

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

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

# 删除容器
docker rm csgo-server

启动命令

默认情况下，启动容器时会安装、更新服务器，然后启动CS:GO服务器。可通过指定不同命令修改此行为：

• update：仅安装服务器最新版本，完成后容器退出（不启动服务器）
• update_validate：同update，但会验证文件完整性，推荐初始安装时使用
• start：仅启动服务器，不执行安装或更新

数据持久化

游戏服务器数据存储在/home/ips-hosting目录。默认情况下，Docker会自动创建卷以持久化数据，但重建容器时会创建新卷，需手动挂载旧卷才能访问历史数据（详见：[***]

挂载主机目录实现持久化

创建容器时使用-v /绝对路径/主机目录:/home/ips-hosting参数挂载主机目录。容器默认以非root用户（ID 1000）运行，需确保挂载目录有正确权限：

• 方法1：修改主机目录所有者为ID 1000
  chown -R 1000 /绝对路径/主机目录

• 方法2：指定容器运行用户ID（需与主机目录所有者ID匹配）
  查看本地用户ID：id 用户名，创建容器时添加--user 用户ID参数，如docker create --user 500 ...

端口配置

默认需要映射以下端口：

• 27015/udp（游戏端口）
• 27015/tcp（rcon，与游戏端口相同）
• 27005/tcp（客户端端口）
• 27020/udp（TV端口）

可通过环境变量GAME_PORT、CLIENT_PORT和TV_PORT修改端口，修改后需同步更新容器端口映射。

环境变量配置

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

update/update_validate 阶段变量

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

• BETA_BRANCH：指定要下载的服务器测试分支
• BETA_PASSWORD：测试分支的密码

start 阶段变量

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

• GSLT：游戏服务器登录令牌（必填），需从Steam开发者平台生成
• HOST：服务器监听地址，默认0.0.0.0
• GAME_PORT：游戏端口，默认27015（修改时需同步更新端口映射）
• CLIENT_PORT：客户端端口，默认27005（修改时需同步更新端口映射）
• TV_PORT：TV端口，默认27020（修改时需同步更新端口映射）
• MAX_PLAYERS：最大玩家数，默认10
• TICKRATE：服务器tickrate，默认66
• GAME_TYPE与GAME_MODE：共同指定游戏模式，默认经典休闲模式（GAME_TYPE=0，GAME_MODE=0）

游戏模式对应值

• WORKSHOP_START_MAP：启动时加载的Workshop地图ID，需配合HOST_WORKSHOP_COLLECTION使用（地图需包含在地图集中）
• HOST_WORKSHOP_COLLECTION：Workshop地图集ID，需配合AUTHKEY使用
• AUTHKEY：Steam Web API密钥，从Steam开发者平台生成，用于加载Workshop地图集
• INSECURE：设为true禁用VAC反作弊
• NOBOTS：设为true禁用机器人