前言#

首先最好你可以看上两篇博客的思想和原理

零成本搭建“半永久”Minecraft服务器：一次对云开发平台规则的自动化探索 - MumuHaha Blog

基于GitHub Action的定时启动cnb脚本 - MumuHaha Blog

这两篇博客中，第一篇负责讲解原理，第二篇则是编写的一个通过Github Action来定时启动环境，实现无需服务器，全自动定时启动服务器。那么接下来我会给出后续你可能会用到的一系列脚本。

首先就是cnb的配置文件#

　　cnb的配置文件命名为.cnb.yml，他是用来标记cnb启动的一些配置文件。当然你不需要记住很多。接下来我会给出一个我服务器的示例文件。

1
$:
2
  # vscode 事件：专供页面中启动远程开发用
3
  vscode:
4
    - docker:
5
        build: ./.ide/Dockerfile
6
      runner:
7
        cpus: 32
8
        # tags: cnb:arch:amd64:gpu
9
      services:
10
        - vscode
11
        - docker
12
      stages:
13
        - name: ls
14
          script: ls -al
15
        - name: 启动脚本
16
          script: bash /workspace/start
17
      endStages:
18
        - name: 第一次保存配置
19
          script:
20
            - bash /workspace/gitpush

如上便是服务器启动的示例文件。顾名思义，很多人看到示例文件就差不多懂了。

如上我已经给出配置文件的语法。接下来就是如何持久化保存文件。

持久化保存原理#

由于cnb其实是依赖于git的管理方式，一切的配置文件在重新启动后都会丢失，但是有一个位置比较特殊，那就是/workspace文件夹，这里的文件夹在开发环境开启时和cnb仓库的目录文件夹是一样的。如果我们在这一个文件夹进行修改的话，重新启动环境…

当然还是不能保存（，但是为啥我说这一个文件夹很特殊呢？正式上面我说的这个文件夹，在“开机的时候”和cnb仓库是一样的。那么我们只需要在关机的时候把/workspace文件夹中的内容的修改通过git命令提交上去，那么即使重新开机，我开发环境的/workspace文件夹即使从cnb仓库中拉取，但是由于我已经进行更新了，所以我拉取的就是我更新后的文件。

这里我说的可能比较绕也可能说的不怎么清楚但是你只需要记住所有文件都不能持久化，除了/workspace文件夹的内容！！！

持久化保存的脚本#

　　既然给出了原理那么只需要把修改提交就可以了吧

所以理所当然的一个最简单的脚本

1
git add .
2
git commit -m "数据更新，这里写什么都行"
3
git push origin main

但是这里会有一个问题，如果是用过github的人应该都知道，github不允许在上传超过100M的文件，需要通过git lfs来进行上传。在cnb这个限制是250M所以我们需要找到大于250M的文件把他关联到.gitattributes文件中，这里我给出一键脚本

1
#!/bin/bash
2

3
# ====================================================================
4
# Git 智能推送脚本 (精简修复版)
5
# 作者: Gemini
6
# 描述: 修复 LFS 提交流程错误，且不修改 .gitignore。文件大小限制为 256MB。
7
# ====================================================================
8

9
# 检查当前目录是否为 Git 仓库
10
if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
11
    echo "错误：当前目录不是一个 Git 仓库。请在仓库的根目录执行此脚本。"
12
    exit 1
13
fi
14

15
# 标记是否需要强制推送。默认为不需要。
16
needs_force_push=false
17
# 标记 .gitattributes 是否被修改
18
gitattributes_modified=false
19

20
# ====================================================================
21
# 第一步：清理 Git 历史中的大文件
22
# ====================================================================
23
echo "正在检查 Git 历史中的大文件..."
24

25
filter_temp_file=$(mktemp)
26
# 阈值为 256MB (268435456 bytes)
27
git rev-list --objects --all | git cat-file --batch-check='%(objectname) %(objecttype) %(objectsize) %(rest)' | awk '$3 >= 268435456 {print $4}' > "$filter_temp_file"
28

29
if [ -s "$filter_temp_file" ]; then
30
    echo "警告：在 Git 历史中找到了大文件，正在重写历史记录..."
31
    echo "此操作会永久性修改你的 Git 历史，请确保你已经备份了项目。"
32
    needs_force_push=true
33

34
    git filter-branch --index-filter "git rm --cached --ignore-unmatch $(cat "$filter_temp_file")" --tag-name-filter cat -- --all
35

36
    if [ $? -ne 0 ]; then
37
        echo "清理历史失败。脚本终止。"
38
        rm -f "$filter_temp_file"
39
        exit 1
40
    fi
41

42
    git reflog expire --expire=now --all
43
    git gc --prune=now --aggressive
44
    echo "大文件已从 Git 历史中移除。"
45
else
46
    echo "没有在 Git 历史中找到需要移除的大文件。"
47
fi
48

49
rm -f "$filter_temp_file"
50

51
# ====================================================================
52
# 第二步：检查和配置 Git LFS
53
# ====================================================================
54
echo "正在检查当前工作目录中的大文件..."
55

56
# 阈值为 256MB
57
find_result=$(find . -not -path "./.git/*" -type f -size +256M 2>/dev/null)
58

59
if [ -n "$find_result" ]; then
60
    echo "在当前工作目录中找到了大文件，正在添加到 Git LFS 跟踪..."
61

62
    for file in $find_result; do
63
        if ! git check-attr -a -- "$file" | grep -q "lfs"; then
64
            echo "正在添加 $file 到 Git LFS 追踪..."
65
            git lfs track "$file"
66
            gitattributes_modified=true
67
        else
68
            echo "$file 已被 Git LFS 追踪，跳过添加。"
69
        fi
70
    done
71
else
72
    echo "没有在当前工作目录中找到需要添加到 Git LFS 的大文件。"
73
fi
74

75
# ====================================================================
76
# 新增步骤：删除子目录中的所有.gitignore文件（保留根目录的.gitignore）
77
# ====================================================================
78
echo "正在清理子目录中的.gitignore文件..."
79
# 查找所有.gitignore文件，但排除根目录的.gitignore
80
subdir_gitignores=$(find . -mindepth 2 -name ".gitignore" 2>/dev/null)
81

82
if [ -n "$subdir_gitignores" ]; then
83
    echo "发现以下子目录中的.gitignore文件，将被删除："
84
    echo "$subdir_gitignores"
85
    # 删除找到的文件
86
    rm -f $subdir_gitignores
87
    echo "子目录中的.gitignore文件已删除"
88
else
89
    echo "未发现子目录中的.gitignore文件，无需删除"
90
fi
91

92
# ====================================================================
93
# 第三步：提交和推送
94
# ====================================================================
95

96
# 将所有更改（包括 .gitattributes 和 LFS 文件）一次性暂存，以修复核心问题
97
echo "正在暂存所有更改..."
98
git add .
99

100
# 检查是否有东西需要提交
101
if ! git diff --staged --quiet; then
102
    echo "正在提交文件..."
103
    if [ "$gitattributes_modified" = true ]; then
104
        git commit -m "Configure Git LFS and commit large files"
105
    else
106
        git commit -m "Update and commit remaining files"
107
    fi
108
else
109
    echo "没有新的更改需要提交。"
110
fi
111

112
# 推送
113
echo "正在推送到远程仓库..."
114
if [ "$needs_force_push" = true ]; then
115
    echo "由于历史记录被修改，正在执行强制推送..."
116
    git push --force
117
else
118
    echo "无需强制推送，执行正常推送..."
119
    git push
120
fi
121

122
if [ $? -ne 0 ]; then
123
    echo "Git 推送失败。请手动解决问题。"
124
    exit 1
125
fi
126

127
echo "脚本执行完毕。"

在这个脚本中，脚本会先查找大于250M的文件并且把他写入到.gitattributes中，然后先更新.gitattributes再进行全部更新。

自动链接脚本#

这个我在我的b站视频中说过，这里再说一遍，再cnb中超过10分钟不登陆webide或者是ssh会自动回收环境。所以我用python写了一个自动连接的脚本，原理就是自己用ssh链接自己的一个脚本。

脚本如下

1
#!/usr/bin/env python3
2
import requests
3
import json
4
import re
5
import subprocess
6
import time
7
import threading
8
import signal
9
import sys
10
import os
11
import shlex
12

13
# 全局变量
14
ssh_process = None
15
stop_flag = False
16

17
def signal_handler(signum, frame):
18
    """信号处理器，用于优雅退出"""
19
    global stop_flag, ssh_process
20
    print("\n收到退出信号，正在关闭SSH连接...")
21
    stop_flag = True
22
    if ssh_process:
23
        close_ssh_connection()
24
    sys.exit(0)
25

26
def get_workspace_list():
27
    """获取工作空间列表"""
28
    url = "https://api.cnb.cool/workspace/list"
29

30
    params = {
31
        'branch': 'main',
32
        'end': '2100-12-01 00:00:00+0800',
33
        'page': 1,
34
        'pageSize': 20,
35
        'slug': '仓库',
36
        'start': '2024-12-01 00:00:00+0800',
37
        'status': 'running'
38
    }
39

40
    headers = {
41
        'accept': 'application/json',
42
        'Authorization': 'APITOKEN'
43
    }
44

45
    try:
46
        response = requests.get(url, params=params, headers=headers)
47
        response.raise_for_status()
48
        return response.json()
49
    except requests.exceptions.RequestException as e:
50
        print(f"获取工作空间列表失败: {e}")
51
        return None
52

53
def get_workspace_detail(sn):
54
    """获取工作空间详细信息"""
55
    url = f"https://api.cnb.cool/仓库/-/workspace/detail/{sn}"
56

57
    headers = {
58
        'accept': 'application/json',
59
        'Authorization': '5Q5MZm1285Efm9udrYEHE50gnoG'
60
    }
61

62
    try:
63
        response = requests.get(url, headers=headers)
64
        response.raise_for_status()
65
        return response.json()
66
    except requests.exceptions.RequestException as e:
67
        print(f"获取工作空间详情失败: {e}")
68
        return None
69

70
def extract_ssh_command(ssh_string):
71
    """从SSH字符串中提取SSH命令"""
72
    # 移除可能的引号和多余的空格
73
    ssh_command = ssh_string.strip().strip('"')
74
    return ssh_command
75

76
def update_config_json(ssh_command):
77
    """更新config.json文件"""
78
    try:
79
        # 读取现有的config.json
80
        with open('config.json', 'r', encoding='utf-8') as f:
81
            config = json.load(f)
82

83
        # 添加SSH命令
84
        config['ssh_command'] = ssh_command
85

86
        # 写回文件
87
        with open('config.json', 'w', encoding='utf-8') as f:
88
            json.dump(config, f, indent=2, ensure_ascii=False)
89

90
        print(f"已成功更新config.json，添加SSH命令: {ssh_command}")
91

92
    except Exception as e:
93
        print(f"更新config.json失败: {e}")
94

95
def execute_ssh_command(ssh_command):
96
    """执行SSH命令"""
97
    global ssh_process
98

99
    try:
100
        print(f"正在执行SSH命令: {ssh_command}")
101

102
        # 解析SSH命令
103
        ssh_parts = shlex.split(ssh_command)
104

105
        # 添加SSH选项以避免主机密钥检查
106
        ssh_parts.insert(1, '-o')
107
        ssh_parts.insert(2, 'StrictHostKeyChecking=no')
108
        ssh_parts.insert(3, '-o')
109
        ssh_parts.insert(4, 'UserKnownHostsFile=/dev/null')
110

111
        print(f"完整SSH命令: {' '.join(ssh_parts)}")
112

113
        # 执行SSH连接
114
        ssh_process = subprocess.Popen(
115
            ssh_parts,
116
            stdout=subprocess.PIPE,
117
            stderr=subprocess.PIPE,
118
            stdin=subprocess.PIPE,
119
            text=True,
120
            bufsize=1,
121
            universal_newlines=True
122
        )
123

124
        # 等待一段时间检查连接状态
125
        time.sleep(3)
126

127
        if ssh_process.poll() is None:
128
            print("SSH连接已建立")
129
            return True
130
        else:
131
            stdout, stderr = ssh_process.communicate()
132
            print(f"SSH连接失败")
133
            print(f"stdout: {stdout}")
134
            print(f"stderr: {stderr}")
135
            return False
136

137
    except Exception as e:
138
        print(f"执行SSH命令失败: {e}")
139
        return False
140

141
def close_ssh_connection():
142
    """关闭SSH连接"""
143
    global ssh_process
144

145
    if ssh_process:
146
        try:
147
            print("正在关闭SSH连接...")
148
            ssh_process.terminate()
149
            ssh_process.wait(timeout=5)
150
            print("SSH连接已关闭")
151
        except subprocess.TimeoutExpired:
152
            print("SSH连接关闭超时，强制终止...")
153
            ssh_process.kill()
154
        except Exception as e:
155
            print(f"关闭SSH连接时出错: {e}")
156
        finally:
157
            ssh_process = None
158

159
def check_connection_status():
160
    """检查连接状态"""
161
    global ssh_process
162
    if ssh_process:
163
        return ssh_process.poll() is None
164
    return False
165

166
def ssh_connection_manager():
167
    """SSH连接管理器，处理自动重连"""
168
    global stop_flag, ssh_process
169

170
    reconnect_interval = 300  # 5分钟
171
    last_connect_time = time.time()
172
    connection_active = True
173

174
    while not stop_flag:
175
        current_time = time.time()
176

177
        # 检查是否需要重连
178
        if current_time - last_connect_time >= reconnect_interval:
179
            print(f"\n[{time.strftime('%Y-%m-%d %H:%M:%S')}] 执行定时重连...")
180

181
            # 关闭现有连接
182
            close_ssh_connection()
183

184
            # 获取最新的SSH命令
185
            ssh_command = get_ssh_command_from_config()
186
            if ssh_command:
187
                # 建立新连接
188
                if execute_ssh_command(ssh_command):
189
                    last_connect_time = current_time
190
                    connection_active = True
191
                    print(f"重连成功，下次重连时间: {time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(current_time + reconnect_interval))}")
192
                else:
193
                    print("重连失败，将在下次循环中重试")
194
                    connection_active = False
195
            else:
196
                print("无法获取SSH命令，将在下次循环中重试")
197
                connection_active = False
198

199
        # 检查SSH进程是否还在运行
200
        if not check_connection_status() and connection_active:
201
            print("SSH连接已断开，准备重连...")
202
            connection_active = False
203
            last_connect_time = 0  # 立即重连
204

205
        # 等待一段时间再检查
206
        time.sleep(10)
207

208
def get_ssh_command_from_config():
209
    """从config.json中获取SSH命令"""
210
    try:
211
        with open('config.json', 'r', encoding='utf-8') as f:
212
            config = json.load(f)
213

214
        if 'ssh_command' in config:
215
            return config['ssh_command']
216
        else:
217
            return None
218
    except Exception as e:
219
        print(f"读取config.json失败: {e}")
220
        return None
221

222
def main():
223
    global stop_flag
224

225
    print("=" * 60)
226
    print("SSH工作空间连接管理器")
227
    print("=" * 60)
228

229
    # 设置信号处理器
230
    signal.signal(signal.SIGINT, signal_handler)
231
    signal.signal(signal.SIGTERM, signal_handler)
232

233
    print("开始获取工作空间信息...")
234

235
    # 第一步：获取工作空间列表
236
    workspace_list = get_workspace_list()
237
    if not workspace_list:
238
        print("无法获取工作空间列表")
239
        return
240

241
    print("工作空间列表获取成功")
242

243
    # 提取sn值
244
    if 'list' in workspace_list and len(workspace_list['list']) > 0:
245
        sn = workspace_list['list'][0]['sn']
246
        print(f"提取到sn值: {sn}")
247

248
        # 第二步：获取工作空间详情
249
        workspace_detail = get_workspace_detail(sn)
250
        if not workspace_detail:
251
            print("无法获取工作空间详情")
252
            return
253

254
        print("工作空间详情获取成功")
255

256
        # 提取SSH命令
257
        if 'ssh' in workspace_detail:
258
            ssh_command = extract_ssh_command(workspace_detail['ssh'])
259
            print(f"提取到SSH命令: {ssh_command}")
260

261
            # 更新config.json
262
            update_config_json(ssh_command)
263

264
            print("\n" + "=" * 60)
265
            print("SSH信息获取完成，正在建立连接...")
266
            print("=" * 60)
267

268
            # 直接建立SSH连接
269
            if execute_ssh_command(ssh_command):
270
                print("初始SSH连接成功，启动自动重连管理器...")
271
                print("=" * 60)
272

273
                # 启动自动重连管理器线程
274
                reconnect_thread = threading.Thread(target=ssh_connection_manager, daemon=True)
275
                reconnect_thread.start()
276

277
                print("SSH连接管理器已启动")
278
                print("连接将每5分钟自动重连一次")
279
                print("按Ctrl+C退出")
280
                print("=" * 60)
281

282
                # 主线程等待
283
                try:
284
                    while not stop_flag:
285
                        time.sleep(1)
286
                except KeyboardInterrupt:
287
                    print("\n收到键盘中断信号")
288
                    stop_flag = True
289
                    close_ssh_connection()
290
            else:
291
                print("SSH连接失败")
292
        else:
293
            print("未找到SSH信息")
294
    else:
295
        print("工作空间列表为空")
296

297
if __name__ == "__main__":
298
    main()

你需要更新这里的“仓库”（两处），“APITOKEN”（一处），你自己用ctrl+f进行查找和替换即可。

结尾#

　　最后说一句，数据无价，这个方法终究是邪门歪道（但是性能真的太强辣！！）请对数据做好备份（最起码每隔一个星期开几个备份分支吧！！！），然后这个服务器是没有公网的请用内网穿透。最后最后，补药跳脸，邪门歪道不要蹬鼻子上脸。