【思路】CS2服务端自动检查并更新脚本（Linux+Docker环境）

1122 字

6 分钟

【思路】CS2服务端自动检查并更新脚本（Linux+Docker环境）

2026-01-02

笔记

群晖

/

CS2

/

steam

前言：#

首先看标题这个是linux+docker环境，幻梦的steamcmd和cs2服务端都是分别跑在容器里的。如果不是这个环境的没法直接使用脚本，但是只看思路是足够的。

然后这个脚本理论上应该适配所有V社游戏的服务器，但是幻梦暂时没有对本文的脚本进行完整的测试，所以只算提供一个思路而不是教程。

CS2之前其实是有自动更新插件的，但是作者已经快1年没更新了。issue里其他人fork的版本也不怎么好用，迫于实际需求幻梦就只能自己写一个了。

为什么是shell脚本而不是一个插件？很简单，幻梦没有看完CSS插件的开发文档，同时也没兴趣不断维护一个随时可能失效的插件，幻梦的需求是功能简单、稳定能用。有什么能稳的过shell和Valve官方提供的api呢？

第一步：通过steamcmd获取最新的buildID#

完成更新一共分四步。获取官方最新的buildID，获取本地的buildID，对比两者，不一致则进行更新。

获取buildID的命令是steamcmd +login anonymous +app_status 730 +quit

docker环境获取的脚本则是，注意更改容器名称再运行

1
docker exec [steamcmd容器名] \
2
  /home/steam/steamcmd/steamcmd.sh \
3
  +login anonymous \
4
  +app_info_print 730 \
5
  +quit

正常情况下steamcmd会返回一个json，里面对我们有用的只有branches-public-buildid。其他的幻梦下文里省略掉了

1
"branches"{
2
        "public"{
3
                "buildid"               "21248816"
4
                "timeupdated"           "1766101800"
5
        }
6
}

接下来我们上docker的提取脚本

1
#!/usr/bin/env bash
2
set -euo pipefail
3

4
CONTAINER="steamcmd"
5
STEAMCMD="/home/steam/steamcmd/steamcmd.sh"
6
APPID=730
7

8
#执行steamcmd并获取输出
9
OUTPUT=$(docker exec "$CONTAINER" \
10
  "$STEAMCMD" \
11
  +login anonymous \
12
  +app_info_print "$APPID" \
13
  +quit 2>/dev/null)
14

15
#提取public分支的buildid
16
BUILDID=$(echo "$OUTPUT" | awk '
17
  /"branches"/ {in_branches=1}
18
  in_branches && /"public"/ {in_public=1}
19
  in_public && /"buildid"/ {
20
    gsub(/"/,"")
21
    print $2
22
    exit
23
  }')
24

25
if [[ -z "$BUILDID" ]]; then
26
  echo "ERROR: failed to extract buildid" >&2
27
  exit 1
28
fi
29

30
echo "$BUILDID"

正常情况下这个脚本应该输出21248816 ，或者类似的id

第二步：获取服务端buildID#

服务端的buildID在appmanifest_730.acf 这个文件中，通常他在docker里的路径如下/home/steam/cs2-dedicated/steamapps/appmanifest_730.acf

docker环境的我们通过以下指令获取，注意修改容器名称再运行

1
docker exec [修改容器名称] \
2
  awk -F'"' '/"buildid"/ {print $4}' \
3
  /home/steam/cs2-dedicated/steamapps/appmanifest_730.acf

现在得到结果是21248816 说明无需更新

第三步：检查更新的完整脚本#

1
#!/usr/bin/env bash
2
#请在此处进行配置
3
# SteamCMD 容器
4
STEAMCMD_CONTAINER="steamcmd"
5
STEAMCMD_BIN="/home/steam/steamcmd/steamcmd.sh"
6

7
# CS2 服务器容器
8
CS2_CONTAINER="CS2-normal" #容器名字
9
CS2_APP_MANIFEST="/home/steam/cs2-dedicated/steamapps/appmanifest_730.acf" #acf文件位置
10

11
# Steam AppID，cs2为730，csgo为740，请自行查阅
12
APPID=730
13

14
# SteamCMD 超时
15
STEAMCMD_TIMEOUT=60
16

17
#更新运行脚本，根据实际情况进行选择
18
# UPDATE_HANDLER="docker restart CS2-huifang"
19
# UPDATE_HANDLER="/volume2/docker/CS2/update_cs2.sh"
20
# UPDATE_HANDLER="docker exec CS2-huifang ./update.sh"
21
UPDATE_HANDLER="docker restart CS2-normal"
22

23
#log输出函数
24
log() {
25
  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"
26
}
27

28
#更新脚本函数
29
run_update_handler() {
30
  log "Executing update handler:"
31
  log ">>> $UPDATE_HANDLER"
32
  set +e
33
  eval "$UPDATE_HANDLER"
34
  RC=$?
35
  set -e
36
  if [[ $RC -ne 0 ]]; then
37
    log "ERROR: Update handler failed with code $RC"
38
    exit 11
39
  fi
40
}
41

42
log "CS2 update check started" #检查脚本开始
43

44
#检查steamcmd最新的id
45
log "Querying remote buildid..."
46
set +e
47
STEAMCMD_OUTPUT=$(
48
  docker exec "$STEAMCMD_CONTAINER" \
49
    timeout "$STEAMCMD_TIMEOUT" \
50
    "$STEAMCMD_BIN" \
51
      +login anonymous \
52
      +app_info_print "$APPID" \
53
      +quit 2>&1
54
)
55
STEAMCMD_RC=$?
56
set -e
57
REMOTE_BUILDID=$(echo "$STEAMCMD_OUTPUT" | awk -F'"' '/"buildid"/ {print $4; exit}')
58
if [[ -z "$REMOTE_BUILDID" ]]; then
59
  log "ERROR: Failed to retrieve remote buildid"
60
  exit 2
61
fi
62
log "Remote buildid: $REMOTE_BUILDID" #输出线上最新的构建id
63

64
#检查本地的构建id
65
log "Reading local buildid..."
66

67
LOCAL_BUILDID=$(
68
  docker exec "$CS2_CONTAINER" \
69
    awk -F'"' '/"buildid"/ {print $4}' "$CS2_APP_MANIFEST" #配置的acf位置变量
70
)
71

72
if [[ -z "$LOCAL_BUILDID" ]]; then
73
  log "ERROR: Failed to retrieve local buildid"
74
  exit 3
75
fi
76
log "Local buildid : $LOCAL_BUILDID"
77

78
#对比本地与steamcmd的版本是否存在差别
79
if [[ "$LOCAL_BUILDID" == "$REMOTE_BUILDID" ]]; then
80
  log "RESULT: CS2 server is up to date."
81
  exit 0
82
fi
83
log "RESULT: UPDATE REQUIRED!!!"
84
run_update_handler #调用更新
85

86
log "Update handler finished"
87
exit 10