初然の博客

加群向导

Thu, 27 Nov 2025 00:00:00 GMT

📬小群体#

QQ
- 点击链接加入群聊[初然的猫猫头窝]
Telegram
- 点击链接加入群聊[然泽茶馆] (闲置)

📬 联系方式#

📫 邮箱：churanneko@qq.com

Android 的 AVB 与启动校验

Wed, 08 Apr 2026 00:00:00 GMT

Android 的 AVB 与启动校验#

目录#

Tip

可直接点击文字跳转至对应章节

Android 的 AVB 与启动校验

简介#

AVB 是在 Android 8 以后引入的启动校验机制。平时用原厂系统几乎无感，但由于一旦你开始解锁 BL、刷第三方镜像、修补 boot 分区、禁用校验 vbmeta，你就会发现如果不禁用 AVB 部分功能(包含Wifi等)是完全用不了的。

很多人碰到的”刷完开不了机”，不是镜像不会刷，是忘了将 AVB 给禁用。好了，回到这里，让我们来看 AVB 到底是什么。

什么是 AVB#

AVB 全称是 Android Verified Boot，负责在启动阶段校验关键分区，确认内容没被改过、签名还在可信链中。

校验的目标通常包括：

boot
init_boot
vendor_boot
system
以及其他被 vbmeta 描述到的分区

vbmeta 是什么#

vbmeta 是 AVB 的元数据镜像。Bootloader 在校验别的分区之前，先看它。vbmeta 里通常放这些内容：

分区描述信息（descriptor）
对应分区的哈希或哈希树
公钥和签名
标志位（flags）
回滚保护用到的版本索引

你会经常在 AVB 领域遇到命令教程带这些后缀：

disable-verity — 禁用 dm-verity 这类运行期校验
disable-verification — 放宽 AVB 的分区校验

很多教程里提到”刷写 vbmeta.img”或者”修补 vbmeta分区”，改的基本就是这块。

[!INFO]
有些设备不止一个 vbmeta，还会拆成 vbmeta_system、vbmeta_vendor 之类。实现会分开，但原理一样。

AVB 的工作流程#

其实流程不复杂：

Bootloader 先读取并校验 vbmeta
vbmeta 里的 descriptor 告诉 Bootloader 还要校验哪些分区
Bootloader 按记录的哈希、签名去验证 boot、init_boot、system 等分区
校验全部通过，继续引导系统
任何一步失败，按当前策略处理

如果 BL 带锁，失败就直接拒绝启动。如果 BL 解锁(允许加载第三方引导程序)，很多设备会允许继续引导，但仍会显示警告。

dm-verity#

dm-verity 属于运行期完整性校验。AVB 负责启动前先校验，dm-verity 负责初始化后继续校验。

它常见于 system、vendor 这类只读分区。系统读取数据块时会对照哈希(sha)树检查内容有没有变化，如果块校验对不上，轻则报错，重则无法启动变砖。

所以很多 Root 或改系统分区的教程，都会让你处理 disable-verity / disable-verification，随后写进 patched vbmeta 里来放宽校验。

Warning

注意，解锁 BL 不等于 dm-verity 自动失效。很多机器解锁以后，基本上都是原厂的，除非你自己动过分区，那么当我没说。

BL 带锁和解锁的区别#

BL 带锁时：

Bootloader 只信任厂商认可的签名
关键分区只要被改，校验大概率直接失败直接会导致变砖(你如果没 9008 授权要么去售后要么只能去闲鱼去买临时授权)
失败后设备通常拒绝继续引导

BL 解锁后：

设备允许引导第三方加载程序
你才能正常刷写 boot、init_boot、vbmeta 这些关键分区
启动时通常会显示解锁警告

如果已经解锁 BL，AVB 的校验不会消失，只是从”严格拒绝”变成”允许继续，但仍会警告”。

至于为什么改了 boot 或 vbmeta 会开不了机#

由于你一旦改了 boot，原来记录在 vbmeta 里的哈希或签名就不匹配了。改了 vbmeta，它自己的签名又可能和当前设备信任的公钥对不上。

常见情况：

boot.img 被 Patch 过，但 vbmeta 还记录着原始校验值
vbmeta.img 被改过，但没有用设备认可的 key 重新签名
你只改了镜像，没有处理 disable-verity / disable-verification
设备还处在带锁状态，Bootloader 不接受修改后的镜像

所以”刷了 Magisk 修补的 boot.img 后开不了机”，很多时候不是 Magisk 有问题，而是 AVB 还在按原来的链做校验。

Warning

如果设备还没解锁 BL，最好不要直接刷改过的 boot 或 vbmeta。

回滚保护#

回滚保护用来防止设备降级到旧版本。vbmeta 里会带回滚索引，设备本地的安全存储也会记一个当前允许的最低版本值。Bootloader 校验时会比较这两个值，如果你刷进去的镜像版本更旧，哪怕签名没问题，也可能直接被拒绝。

所以有些机器”能刷进去旧包，但就是无法正常引导”，可能是回滚保护卡住了。

参考资料#

延伸搜索#

Android 的 Root 与定制 ROM

Wed, 08 Apr 2026 00:00:00 GMT

Android 的 Root 与定制 ROM#

目录#

Tip

可直接点击文字跳转至对应章节

Android 的 Root 与定制 ROM

简介#

Android 只要继续往下折腾，Root 和定制 ROM 基本绕不开。很多人也不是为了研究系统本身，而是原厂系统广告多、限制多、停更快，或者 Google 服务体验不完整。

好了，我们开始把这块理一遍。

Root 与 su#

Root 就是 Android 的最高权限，底层是 Linux 的 root 用户。拿到 Root 后可以改系统文件、跑模块、装需要高权限的工具。

注意，权限放开之后风险也会跟着上来。删错文件、刷错模块、改错权限，结果都可能比普通 App 崩掉麻烦得多。

su 是 Linux 里的 switch user。Root 之后很多 App 实际上就是通过调用 su 去提权。Root 管理器负责弹授权、记录请求，决定某个 App 是允许、拒绝还是仅本次放行。

主流 Root 方案#

现在主流方案就这几条：

Invalid directive. ("github" directive must be leaf type "::github{repo="owner/repo"}")

Android 的分区系统

Wed, 08 Apr 2026 00:00:00 GMT

Android 的分区系统#

目录#

Tip

可直接点击文字跳转至对应章节

Android 的分区系统

简介#

由于 Android 版本迭代，新设备的分区结构已经比以前复杂不少。如果你后面要碰刷机、Root、AVB 这些，分区这块绕不过去。

几个最常见的分区#

boot — 保存内核与 ramdisk，很多 Root 方案直接是以启动时侵入来提权的
init_boot — Android 13+ 新设备常见，保存通用 ramdisk
vendor_boot — 厂商相关的 ramdisk 和设备树
system — Android 系统主体文件
vendor — 厂商驱动与 HAL
vbmeta — AVB 校验元数据（在 AVB 那篇会细说）
userdata — 用户数据分区，格式化会清空数据
super — 动态分区容器，里面可以切出多个逻辑分区

你可以使用以下命令来查看自己设备上实际有哪些分区：

Terminal window

1
adb shell ls -la /dev/block/by-name/

A-Only 与 A/B#

早期设备只有一套分区（A-Only），OTA 更新时直接覆盖原分区。由于更新过程中如果出问题，很容易直接把系统刷坏，后面 Google 在 Android 7.0 引入了 A/B 分区。

A/B 分区准备两套槽位（slot_a / slot_b），平时从一套启动，更新的时候写另一套，随后切换槽位。这样 OTA 更稳，更新失败也更容易回退。

现在新设备基本都已经是 A/B 或者 Virtual A/B 了，A-Only 越来越少见。

Virtual A/B 与动态分区#

Google 在 Android 10 引入了动态分区（Dynamic Partition），随后在 Android 11 引入了 Virtual A/B。配合动态分区之后，很多分区的大小和布局不再固定死了。

所以你拿到新设备一看，分区名好像没几个，实际上很多原来独立的分区都被塞进了 super 里。

super 分区#

super 就是动态分区引入的容器。它不是普通意义上的单一分区，更像一个大的容器，其中包含了多个逻辑分区：

system
vendor
product
system_ext
odm

如果你在教程里看到”动态分区”这个词，基本就绕不开 super。刷机的时候有些操作需要对 super 做处理，也是由于这个原因。

init_boot#

这里注意一下，这个分区容易搞混。

以前刷 Root，教程告诉你修补 boot.img 就行。但由于 GKI 和启动结构调整，部分 Android 13+ 设备把原来 boot 里的一部分内容拆出去了，单独放到 init_boot。

所以现在很多教程已经不是修补 boot.img，而是修补 init_boot.img。这不是教程写错了，而是设备的分区结构变了。最好刷之前先搞清楚自己设备是哪种分区方案。

刷机时最常碰到的几个分区#

boot
init_boot
vendor_boot
vbmeta
userdata

其中改 boot / init_boot 大多和 Root 有关，改 vbmeta 大多和 AVB 校验有关，格式化 userdata 大多和双清、解锁 BL、换 ROM 有关。

分区这块先到这，谢谢阅读。

参考资料#

AOSP 官方文档

延伸搜索#

Android 的基本概念

Wed, 08 Apr 2026 00:00:00 GMT

Android 的基本概念#

目录#

Tip

可直接点击文字跳转至对应章节

Android 的基本概念

简介#

这篇整理了刷机、Root、换 ROM 过程中会碰到的常见名词。遇到不认识的词可以回来查。

Android 与 AOSP#

AOSP（Android Open Source Project）是 Google 开源的 Android 基础代码，厂商和社区都在这个基础上改。

Pixel — Google 基于 AOSP
HyperOS / One UI / ColorOS — 厂商定制
LineageOS / crDroid — 社区第三方 ROM

Android 底层是 Linux 内核，后面碰到 Root、SELinux、su 等概念，基本上都能绕回 Linux。

Bootloader（BL）#

Bootloader 是引导加载程序，负责初始化硬件并在系统启动前决定是否继续加载后面的镜像。出厂时基本是锁的，只允许加载厂商认可并签名的镜像。解锁之后才允许加载第三方引导程序。

解锁前后的区别#

锁着的时候，Bootloader 配合 AVB 对关键分区做校验，你只能引导官方系统。解锁之后允许加载第三方引导程序，才能改 boot、vbmeta、init_boot 这些关键分区。

你可以使用以下命令来解锁 BL：

Terminal window

1
fastboot flashing unlock

Warning

注意，解锁时大多数设备会自动格式化 userdata 分区，也就是清空数据。部分品牌还会熔断 eFuse（如三星 Knox），不可逆。

各家解锁政策#

差别很大，简单列一下：

Google Pixel — 最简单，直接 fastboot flashing unlock
小米 — 国内现在基本走不了官方渠道，账号、答题、等待期都加上了
一加 / OPPO — 很多机型要走深度测试或审核流程
三星 — 限制更重，不同地区差异很大
vivo / 荣耀 / 华为 — 官方一般不开放解锁路径

如果知道自己要刷机，最好买设备之前先查一下能不能解锁 BL。

fastboot 与 EDL#

fastboot 是 PC 和 Bootloader 之间通信的协议。手机进 fastboot 模式后，你可以在电脑上直接操作设备：

Terminal window

1
# 解锁 BL
2
fastboot flashing unlock
3

4
# 刷入镜像
5
fastboot flash boot patched_boot.img
6

7
# 临时启动镜像（不写入）
8
fastboot boot recovery.img
9

10
# 重启
11
fastboot reboot

这里 fastboot boot 只是临时启动，不会写进分区，重启后恢复原样。

EDL（9008 模式）是高通平台更底层的救砖模式，一般用来救已经开不了机的设备。普通情况不用碰。

ADB#

adb（Android Debug Bridge）是系统运行起来之后常用的调试工具。它和 fastboot 不是一回事——fastboot 工作在 Bootloader 阶段，adb 工作在系统或 Recovery 阶段。

Terminal window

1
# 查看设备
2
adb devices
3

4
# 进入 shell
5
adb shell
6

7
# 推送文件
8
adb push local_file /sdcard/
9

10
# 拉取文件
11
adb pull /sdcard/remote_file ./
12

13
# 安装 APK
14
adb install app.apk

Recovery#

Recovery 是独立于主系统之外的小环境，主要用来做系统维护——刷升级包、清分区、恢复出厂设置、备份和恢复。

出厂自带的 Recovery 功能有限，一般只能刷官方签名的 OTA 包。第三方 Recovery 常见的是 TWRP 和 OrangeFox：

Invalid directive. ("github" directive must be leaf type "::github{repo="owner/repo"}")

训练 LLM 的心得分享

Fri, 27 Feb 2026 00:00:00 GMT

训练 LLM 的心得分享：从零到 Liko 第五代#

目录#

Tip

可直接点击文字跳转至对应章节

训练 LLM 的心得分享：从零到 Liko 第五代
训练框架
版本演进
- 预训练数据演进
- V4-和-V5-详细对比
- [SFT-数据演进 V1→V5](#sft-数据演进 v1→v5)
训练过程

简介#

该文档分享了我从零开始训练中文 LLM 的实践心得，目前已经迭代到了 Liko（灵可）第五代。

Tip

训练一个 LLM 需要考虑多种因素，数据清洗是最关键的一步

训练环境#

硬件配置#

说实话，训练 LLM 对硬件要求还是挺高的。我目前使用的是：

GPU: 单卡 RTX 4090 24G（租的）
内存: 90G(我这里是AutoDL分给我的Docker容器,AutoDL实际主机的大概在730G左右)
磁盘: 30G系统盘 + 50G 数据缓存盘

Tip

这也是我选择租 GPU 服务器的原因——毕竟不是每个人都有多卡高配置的环境

目前训练数据量在 10GB 左右，数据和模型差不多有个 125M 的水平。这个规模对于个人实验来说比较合适，既不会太消耗资源，也能看到不错的效果。

数据准备#

数据集选择#

训练过程中下载的是 CCI3-HQ 分卷，数据量大概 11GB 左右。

经过对比，我发现 CCI3-HQ 相对来说比 CCI3-Data 要更干净，因为是已经清理过的数据。这一点非常重要——训练一个 LLM，数据必须得是清洗过的。

Warning

关于分词器的选择：如果你要训练中文模型，最好使用 Qwen 的分词器。我这里使用的是 GPT 的分词器，可能不是最优选择。

可用数据资源#

以下是一些我整理的开源数据资源：

BAAI 开源的数据（需要自行同意许可）:

代码训练集:

StarCoder2

BigCode 开源的数据（需要自行同意许可）:

训练框架#

目前使用的是 nanochat 外加 LLM 自己写的脚本。

后续 V6 版本我准备使用 uv + HuggingFace Transformers 来进行训练。

版本演进#

从 V1 到 V5，Liko 模型经历了多次迭代，以下是各版本的数据和训练情况：

预训练数据演进#

版本	数据源	数据量	Token 数量	备注
V1/V2	项目内早期小语料	-	~19 万	早期小语料测试
V3	simplewiki 样本	~25MB	~2,645 万	加入维基百科数据
V4	中文维基清洗语料	~2.6GB	~27.5 亿	主增量，使用 CCI2-Data 抽样
V5	BAAI/CCI3-HQ	10.778GB (11 分卷)	~76 亿	当前版本，GPT-2 BPE 预处理

V4 和 V5 详细对比#

V4:

训练数据：BAAI/CCI2-Data 抽样文件 cci2_approx_5gb.jsonl
规模：1,826,579 行
训练结论：20k 步跑完，最佳点在 ~15.8k 附近（val_loss 最低）

V5:

训练数据：BAAI/CCI3-HQ，11 个分卷共 10.778GB
预处理：GPT-2 BPE
- 行数：1,836,229
- 训练 tokens：7,593,980,487
- 验证 tokens：400,017,578
- 词表大小：50,257
训练结论：40k 步明显优于 70k 步

Warning

为什么 70k 步反而不如 40k 步？

70k 步是从 40k 步的检查点继续训练的，而且学习率没有正确调整，导致模型出现退化现象（输出乱码）。这说明了学习率调度和训练步数规划的重要性。

SFT 数据演进（V1→V5）#

版本	数据文件	条数	说明
V1	`liko_train_std_expanded_v1.jsonl`	126	基于规范问答扩写
V2	`liko_train_std_expanded_v2.jsonl`	198	新增 72 条，强化身份认知 + 防提示词注入
V3	`liko_train_std_expanded_v3_multilingual.jsonl`	294	新增 96 条，加入多语言样本
V4	`tiny_sft_v4_mix.jsonl`	720	混合版（60% 通用对话/30% 规范问答/10% 身份防注入）

Tip

V5 的 40k 步 checkpoint 是目前最佳模型。70k 步是从 40k 步检查点继续训练，因学习率未正确调整导致退化

训练过程#

训练步数与-Loss-曲线#

训练步数和 Loss 曲线是监控训练过程的重要指标。通过观察这些曲线，可以判断模型是否过拟合、欠拟合，或者是否需要调整学习率等超参数。

以下是 Liko 第五代从 0 到 40k 步的训练日志曲线：

训练日志曲线 (0-40k)

模型测试输出#

在训练到 40k 步时，我进行了多次采样测试（均未进行 SFT 微调）：

测试配置 1（温度 0.7，max_tokens=50）:

推理测试 - 温度 0.7

测试配置 2（温度 0.9，repetition_penalty=1.15，top-k=50）:

续写测试 - 温度 0.9

Tip

以上测试均直接使用基础模型采样，未进行 SFT 微调

GPU-租赁的优势#

租 GPU 服务器确实是一个比较好的选择：

成本低：几块钱就能跑一次训练
灵活：可以根据需求选择不同的配置
无需维护：不用自己操心硬件维护

Tip

几块钱就能把一个中文模型带回家，已经是一个不错的成就了

训练-LLM-需要考虑的因素#

经过这段时间的实践，我总结出训练 LLM 需要考虑以下几个关键因素：

因素	说明
GPU 显存和算力	显存大小决定了你能训练多大的模型，算力决定了训练速度
RAM 运行内存	数据处理和加载需要足够的内存，否则会成为瓶颈
磁盘空间	训练数据通常很大，需要足够的磁盘空间来存储

总结#

训练一个 LLM 确实需要考虑多种因素，但通过合理的选择和规划，个人也能完成这个看似”高大上”的任务。

目前的 Liko 第五代还在持续训练中，后续会继续分享更多的经验和成果。如果你对训练 LLM 感兴趣，欢迎一起交流讨论！

Tip

希望有老哥送给我多卡高配置的 GPU，还有一个比较好的带宽服务器

参考资源#

类型	链接
HuggingFace 镜像	https://hf-mirror.com/
Transformers 学习	https://huggingface.co/docs/transformers/main_classes/trainer

数据#

Tip

本文提到的所有数据集和工具均需要自行配置和下载

配置 Docker 镜像源

Fri, 26 Dec 2025 00:00:00 GMT

配置Docker Compose源#

Tip

可直接点击文字跳转至对应章节

目录#

配置Docker Compose源

简介#

在国内，由于部分运营商可能对国外网站或镜像源进行 SNI 拦截或 DNS 污染，直接访问官方 Docker 镜像源可能会较慢甚至失败。因此，建议使用 国内加速源 来拉取 Docker 安装包和镜像，从而提升下载速度和稳定性。

安装 Docker#

使用 LinuxMirror 脚本安装#

使用 LinuxMirror 提供的脚本进行安装(推荐)

Terminal window

1
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

使用官方脚本安装#

或者使用 Docker Hub 官方提供的脚本进行安装

Terminal window

1
bash <(curl -fsSL https://get.docker.com)

指定镜像源安装#

再或者使用 Docker Hub 官方提供的脚本进行安装再指定镜像源(—mirror 后的参数为镜像源)

Terminal window

1
bash <(curl -fsSL https://get.docker.com) --mirror Aliyun

Tip

如已经安装，只需要修改 Docker 部分请跳转至配置docker

配置 Docker#

一般针对于小白,我比较推荐直接使用 Docker Compose 来完成部署项目，因为部署只需要写好 docker-compose.yaml 文件，随后在 docker-compose.yaml 的同级目录运行 docker compose up -d 即可完成部署。

好了，我们开始配置 Docker Registry 源的配置。

使用脚本修改#

上方我们有提到使用安装脚本,那么这里也可以使用直接脚本来完成修改。

Terminal window

1
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

自行修改#

自行修改 Docker 源,这也是一种备选方式,也是我个人比较推荐的方式。

编辑配置文件#

Terminal window

1
# 可选备份
2
cp /etc/docker/daemon.json /etc/docker/daemon.json.bak
3

4
# 使用nano 编辑器(推荐)
5
nano /etc/docker/daemon.json
6

7
# 或使用vim编辑器
8
vim /etc/docker/daemon.json

Tip

如果没有安装 nano 编辑器，请自行使用 apt 安装。

如果显示没有权限修改，请在命令前加上 sudo ，打比方：sudo nano "/etc/..." 。

Vim 退出时需要按下 ESC 后,输入 :wq 命令后回车来进行写入并退出。

文件示例#

这里给个示例,且使用的 毫秒镜像 源。你可以直接复制并将它写入你的文件。

1
{
2
  "registry-mirrors": ["https://docker.1ms.run"]
3
}

重载服务#

Warning

注意重载 Docker 服务时,所有的 Docker 容器及服务会重启。

修改 daemon.json 后需要重载服务，才能让新配置生效。

重载服务

Terminal window

1
systemctl daemon-reexec
2
systemctl restart docker

如果无法执行此命令请在命令前添加 sudo 。

重载完成后，你可以使用以下命令来验证配置是否生效：

Terminal window

1
docker info | grep -A 5 "Registry Mirrors"

如果输出中包含你配置的镜像源地址，说明配置生效了。

Docker镜像源列表#

这里是 Docker Registry 列表

1
# 毫秒镜像
2
http://docker.1ms.run
3

4
# DockerProxy
5
http://dockerproxy.net
6

7
# DaoCloud
8
http://docker.m.daocloud.io
9

10
# 阿里云
11
http://registry.cn-hangzhou.aliyuncs.com     # 阿里云-杭州
12
http://registry.cn-shanghai.aliyuncs.com    # 阿里云-上海
13
http://registry.cn-qingdao.aliyuncs.com    # 阿里云-青岛
14
http://registry.cn-beijing.aliyuncs.com     # 阿里云-北京
15
http://registry.cn-zhangjiakou.aliyuncs.com # 阿里云-张家口
16
http://registry.cn-huhehaote.aliyuncs.com   # 阿里云-呼和浩特
17
http://registry.cn-wulanchabu.aliyuncs.com  # 阿里云-乌兰察布
18
http://registry.cn-shenzhen.aliyuncs.com   # 阿里云-深圳
19
http://registry.cn-heyuan.aliyuncs.com      # 阿里云-河源
20
http://registry.cn-guangzhou.aliyuncs.com   # 阿里云-广州
21
http://registry.cn-chengdu.aliyuncs.com    # 阿里云-成都
22
http://registry.cn-hongkong.aliyuncs.com    # 阿里云-香港
23
http://registry.ap-northeast-1.aliyuncs.com  # 阿里云-日本
24
http://registry.ap-southeast-1.aliyuncs.com # 阿里云-新加坡
25
http://registry.ap-southeast-3.aliyuncs.com # 阿里云-马来西亚
26
http://registry.ap-southeast-5.aliyuncs.com # 阿里云-印尼
27
http://registry.eu-central-1.aliyuncs.com   # 阿里云-德国
28
http://registry.eu-west-1.aliyuncs.com      # 阿里云-英国
29
http://registry.us-west-1.aliyuncs.com      # 阿里云-美国西部
30
http://registry.us-east-1.aliyuncs.com       # 阿里云-美国东部
31
http://registry.me-east-1.aliyuncs.com      # 阿里云-中东
32

33
# 腾讯云镜像
34
http://mirror.ccs.tencentyun.com
35

36
# Google 镜像
37
https://gcr.io
38
https://asia.gcr.io
39
https://eu.gcr.io
40

41
# Docker Hub 官方镜像
42
https://registry.hub.docker.com

显示更多显示更少

使用Docker Compose快速部署NapCat

Thu, 27 Nov 2025 00:00:00 GMT

使用Docker Compose快速部署NapCat#

目录#

Tip

可直接点击文字跳转至对应章节

使用Docker Compose快速部署NapCat

简介#

该文档介绍了如何使用Docker Compose快速部署NapCat。

Tip

该文章只针对于Linux系统

什么是NapCat?#

基于 TypeScript 构建的 Bot 框架，通过相应的启动器或者框架，主动调用 QQ Node 模块提供给客户端的接口，实现 Bot 的功能。

开始#

安装Docker#

运行以下命令安装Docker(如果已经安装Docker可以跳过此步骤)：

Terminal window

1
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

随后根据脚本提示完成Docker的安装。

下载NapCat Docker Compose文件#

你可以使用以下命令将 docker-compose.yml 文件下载到你的项目目录中：

Terminal window

1
cd /path/to/your/project
2
curl -o docker-compose.yml https://raw.githubusercontent.com/ChuranNeko/NapCat-Docker-Template/main/docker-compose.yml

或者使用Github代理：

Terminal window

1
cd /path/to/your/project
2
curl -sSL-o docker-compose.yml https://gh-proxy.org/https://raw.githubusercontent.com/ChuranNeko/NapCat-Docker-Template/main/docker-compose.yml

此处的 /path/to/your/project 需要替换为你希望存放 docker-compose.yml 文件的实际路径。

docker-compose.yml 只部署NapCat服务，如果你需要其他服务，请替换为相应的模板文件名称。

该项目已经提供了NapCat单服务、AstrBot+Napcat、等多种模板文件，您可以根据需要选择合适的模板文件进行下载。

启动服务#

只需要在包含该仓库下载的 docker-compose.yml 文件的目录下运行以下命令即可启动 NapCat 服务：

Terminal window

1
docker compose up -d

查看日志#

你可以使用以下命令查看 NapCat 服务的日志以获取Token登录WebUI：

Terminal window

1
docker compose logs napcat

停止服务#

你可以使用以下命令停止 NapCat 服务：

Terminal window

1
docker compose down

重启服务#

你可以使用以下命令重启 NapCat 服务：

Terminal window

1
docker compose restart napcat

对接#

Tip

NapCat 支持多种对接方式，您可以参考官方文档进行配置：

NapCat 对接文档

附加说明#

Tip

该仓库已经提供了NapCat单服务、AstrBot+Napcat、多种模板文件，您可以根据需要选择合适的模板文件进行下载。

ChuranNeko

NapCat-Docker-Template

Waiting for api.github.com...

00K

Waiting...

免责声明#

Warning

为了确保 NapCat 服务的安全性,此处已经将 调试端口 只允许本地访问,如果你需要部署到外网调试您的NapCat，请手动移除 docker-compose.yml 文件中 napcat 服务的 post 中的 127.0.0.1移除，如果手动移除后遭到任何安全问题,本仓库及作者概不负责。

数据#

Tip

该仓库的模板文件均存储在 ./data/* 目录下， *为对接框架的名称，您可以根据需要进行修改和定制。 ./data/napcat 目录存储NapCat服务的数据。 ./data/qq 目录存储QQ账号的数据。

Unity中国特供转国际版本

Wed, 26 Nov 2025 00:00:00 GMT

Unity中国特供转国际版本#

目录#

Tip

可直接点击文字跳转至对应章节

简介
判断
为什么要安装国际版本
解决方法
Unity 列表
引用
示例图片

简介#

此文章说明如何解决安装Unity时为中国特供版本,如何转换为国际版本的帮助。

判断#

查看Unity Hub安装的Unity版本后缀是否携带c1后缀,如果有则为中国特供版本,否则为国际版本。

为什么要安装国际版本#

Unity中国特供版存在功能限制，强制用户安装中国特供版本的Unity等。

以下内容引用自Unity中国想钱想疯了。

1
这次事件再次证明了两点
2

3
1. Unity官方无论是对于本文中提及的收入问题，还是这次如何计算下载量问题，都属于拍脑袋定的政策，完全没有明确的量化标准。
4
2. Unity内部也不统一思想，官网的解释都能互相矛盾。
5
这次定价不仅对中小开发者和独立开发者不友好，还是要杀死超休闲游戏的节奏。国内情况我不清楚，但海外如voodoo这种超休闲大厂，很多产品就是Unity做的，推广纯靠买量，一个用户买量成本也就几美分，现在即使按照最便宜的档位算，也几乎成本翻倍了，这谁顶得住？

解决方法#

如果已经安装了Unity,请先卸载当前版本的Unity,然后再尝试进行以下步骤。

方法一#

也是最简单的方法通过官方的Unity Editor官方的发行界面下载Unity Editor,随后将安装好的Unity版本添加至UnityHub(可选)。

点我跳转至官方的Unity Editor发行界面

方法二#

使用代理软件来进行安装,市面上有很多代理软件可供选择,例如Shadowsocks、V2Ray、Clash等。

以下是推荐代理软件的GitHub仓库地址(现依旧在更新的仓库,截至2025.11.26):

v2rayN - 客户端多平台支持
Clash Verge - Clash 变体客户端，支持 Windows/Mac/Linux，GUI 友好，兼容 Meta 内核。

如果你使用的是Shadowsocks/Clash类的代理软件，只需修改浏览器的HTTP/HTTPS代理或者修改规则即可

以下是在Windows/MacOS系统的解决方式

Windows:

将以下文本使用 记事本 或者其他编辑器保存后,右键重命名为 .bat 后缀名

点我跳转至示例截图

Terminal window

1
@echo off
2

3
# 此处1080为你的代理端口,如果代理端口不在1080,请修改为你的代理端口
4
set HTTP_PROXY=http://127.0.0.1:1080
5
set http_proxy=http://127.0.0.1:1080
6
set HTTPS_PROXY=http://127.0.0.1:1080
7
set https_proxy=http://127.0.0.1:1080
8

9
# 此处为Unity Hub的默认安装路径,如果你的安装路径不一样请修改为你的安装路径
10
start "" "C:\Program Files\Unity Hub\Unity Hub.exe"

MacOS：需要在终端中运行下面脚本，然后把生成的launchUnityHub.command挪到一个方便的位置（例如桌面）

Terminal window

1
echo '#!/bin/bash
2
# 此处1080为你的代理端口,如果代理端口不在1080,请修改为你的代理端口
3
export HTTP_PROXY=http://127.0.0.1:1080
4
export http_proxy=http://127.0.0.1:1080
5
export HTTPS_PROXY=http://127.0.0.1:1080
6
export https_proxy=http://127.0.0.1:1080
7
nohup "/Applications/Unity Hub.app/Contents/MacOS/Unity Hub" &>/dev/null &' > launchUnityHub.command
8
chmod +x launchUnityHub.command

双击运行生成的launchUnityHub.command即可启动Unity Hub。

方法二#

如果你的代理软件支持TUN模式,可以直接开启TUN模式+全局代理。

如果有已安装的Unity Hub版本，先卸载，为以防万一，卸载之后删除~/AppData/Roaming这个目录下的Unity Hub目录。然后再安装。 Windows可以运行以下命令以删除Unity Hub的配置文件夹:

Terminal window

1
rd /s /q " %USERPROFILE%\AppData\Roaming\UnityHub"

直接开启TUN模式,然后直接下载Unity国际版本。

点击这里下载Windows版本点击这里下载MacOS版本

这里有一些Unity编辑器的软链接安装版本列表

点我跳转至安装版本列表

Unity 列表#

VRChat官方给出的Unity版本是2022.3.22f1

点击此处安装VRChat官方推荐的Unity版本

这里是Unity软连接地址(点击对应版本号会自动唤起本地的Unity Hub应用开始安装对应版本的Unity):

Tips: 如果你下列没有需要版本你可以以unityhub://开头然后又添加上 {版本号} 的格式来安装其他版本的Unity。

由于版本有点多,我给出了一个版本目录(基于如何取得Unity Hub内旧版本Unity下载链接基础上优化显示)方便你更好的找到他们。

Unity 2020.1#

2020.1.1xf1

2020.1.17f1/9957aee8edc2

2020.1.16f1/f483ad6465d6

2020.1.15f1/97d0ae02d19d

2020.1.14f1/d81f64f5201d

2020.1.13f1/5e24f28bfbc0

2020.1.12f1/55b56f0a86e3

2020.1.11f1/698c1113cef0

2020.1.10f1/974a9d56f159

2020.1.xf1

2020.1.9f1/145f5172610f

2020.1.8f1/22e8c0b0c3ec

2020.1.7f1/064ffcdb64ad

2020.1.6f1/fc477ca6df10

2020.1.5f1/e025938fdedc

2020.1.4f1/fa717bb873ec

2020.1.3f1/cf5c4788e1d8

2020.1.2f1/7b32bc54ba47

2020.1.1f1/2285c3239188

2020.1.0f1/2ab9c4179772

Unity 2019.4(LTS)#

2019.4.2xf1

2019.4.20f1/6dd1c08eedfa

2019.4.1xf1

2019.4.19f1/ca5b14067cec

2019.4.18f1/3310a4d4f880

2019.4.17f1/667c8606c536

2019.4.16f1/e05b6e02d63e

2019.4.15f1/fbf367ac14e9

2019.4.14f1/4037e52648cd

2019.4.13f1/518737b1de84

2019.4.12f1/225e826a680e

2019.4.11f1/2d9804dddde

2019.4.10f1/5311b3af6f69

2019.4.xf1

2019.4.9f1/50fe8a171dd9

2019.4.8f1/60781d942082

2019.4.7f1/e992b1a16e65

2019.4.6f1/a7aea80e3716

2019.4.5f1/81610f64359c

2019.4.4f1/1f1dac67805b

2019.4.3f1/f880dceab6fe

2019.4.2f1/20b4642a3455

2019.4.1f1/e6c045e14e4e

2019.4.0f1/0af376155913

Unity 2019.3#

2019.3.1xf1

2019.3.15f1/59ff3e03856d

2019.3.14f1/2b330bf6d2d8

2019.3.13f1/d4ddf0d95db9

2019.3.12f1/84b23722532d

2019.3.11f1/ceef2d848e70

2019.3.10f1/5968d7f82152

2019.3.xf1

2019.3.9f1/e6e740a1c473

2019.3.8f1/4ba98e9386ed

2019.3.7f1/6437fd74d35d

2019.3.6f1/5c3fb0a11183

2019.3.5f1/d691e07d38ef

2019.3.4f1/4f139db2fdbd

2019.3.3f1/7ceaae5f7503

2019.3.2f1/c46a3a38511e

2019.3.1f1/89d6087839c2

2019.3.0f6/27ab2135bccf

Unity 2019.2#

2019.2.1xf1

2019.2.21f1/9d528d026557

2019.2.20f1/c67d00285037

2019.2.19f1/929ab4d01772

2019.2.18f1/bbf64de26e34

2019.2.17f1/8e603399ca02

2019.2.16f1/b9898e2d04a4

2019.2.15f1/dcb72c2e9334

2019.2.14f1/49dd4e9fa428

2019.2.13f1/e20f6c7e5017

2019.2.12f1/b1a7e1fb4fa5

2019.2.11f1/5f859a4cfee5

2019.2.10f1/923acd2d43aa

2019.2.xf1

2019.2.9f1/ebce4d76e6e8

2019.2.8f1/ff5b465c8d13

2019.2.7f2/c96f78eb5904

2019.2.5f1/9dace1eed4cc

2019.2.4f1/c63b2af89a85

2019.2.3f1/8e55c27a4621

2019.2.2f1/ab112815d860

2019.2.1f1/ca4d5af0be6f

2019.2.0f1/20c1667945cf

Unity 2019.1#

2019.1.1xf1

2019.1.14f1/148b5891095a 2019.1.13f1/b5956c0a61e7 2019.1.12f1/f04f5427219e 2019.1.11f1/9b001d489a54 2019.1.10f1/f007ed779b7a

2019.1.xf1

2019.1.9f1/d5f1b37da199 2019.1.8f1/7938dd008a75 2019.1.7f1/f3c4928e5742 2019.1.6f1/f2970305fe1c 2019.1.5f1/0ca0f5646614 2019.1.4f1/ffa3a7a2dd7d 2019.1.3f1/dc414eb9ed43 2019.1.2f1/3e18427e571f 2019.1.1f1/fef62e97e63b 2019.1.0f2/292b93d75a2c

Unity 2018.4(LTS)#

2018.4.32f1

2018.4.32f1/fba45da84107

2018.4.31f1/212ea663d844

2018.4.30f1/c698a062d8e6

2018.4.29f1/50cce2edf27f

2018.4.28f1/a2d4f71491a4

2018.4.27f1/4e283b7d3f88

2018.4.26f1/a7ac1c6396db

2018.4.25f1/b07bfa0a8827

2018.4.24f1/3071911a89e9

2018.4.23f1/c9cf1a90e812

2018.4.22f1/3362ffbb7aa1

2018.4.21f1/fd3915227633

2018.4.20f1/008688490035

2018.4.1xf1

2018.4.19f1/459f70f82ea4

2018.4.18f1/61fce66342ad

2018.4.17f1/b830f56f42f0

2018.4.16f1/e6e9ca02b32a

2018.4.15f1/13f5a1bf9ca1

2018.4.14f1/05119b33d0b7

2018.4.13f1/497f083a43af

2018.4.12f1/59ddc4c59b4f

2018.4.11f1/7098af2f11ea

2018.4.10f1/a0470569e97b

2018.4.9f1/ca372476eaba

2018.4.8f1/9bc9d983d803

2018.4.7f1/b9a993fd1334

2018.4.6f1/cde1bbcc9f0d

2018.4.5f1/7b38f8ac282e

2018.4.4f1/5440768ff61c

2018.4.3f1/8a9509a5aff9

2018.4.2f1/d6fb3630ea75

2018.4.1f1/b7c424a951c0

2018.4.0f1/b6ffa8986c8d

Unity 2018.3#

2018.3.1xf1

2018.3.14f1/d0e9f15437b1

2018.3.13f1/06548a9e9582

2018.3.12f1/8afd630d1f5b

2018.3.11f1/5063218e4ab8

2018.3.10f1/f88de2c96e63

2018.3.9f1/947e1ea5aa8d

2018.3.8f1/fc0fe30d6d91

2018.3.7f1/9e14d22a41bb

2018.3.6f1/a220877bc173

2018.3.5f1/76b3e37670a4

2018.3.4f1/1d952368ca3a

2018.3.3f1/393bae82dbb8

2018.3.2f1/b3c100a4b73a

2018.3.1f1/bb579dc42f1d

2018.3.0f2/6e9a27477296

Unity 2018.2#

2018.2.2xf1

2018.2.21f1/a122f5dc316d

2018.2.20f1/cef3e6c0c622

2018.2.1xf1

2018.2.19f1/06990f28ba00

2018.2.18f1/4550892b6062

2018.2.17f1/88933597c842

2018.2.16f1/39a4ac3d51f6

2018.2.15f1/65e0713a5949

2018.2.14f1/3262fb3b0716

2018.2.13f1/83fbdcd35118

2018.2.12f1/0a46ddfcfad4

2018.2.11f1/38bd7dec5000

2018.2.10f1/674aa5a67ed5

2018.2.xf1

2018.2.9f1/2207421190e9

2018.2.8f1/ae1180820377

2018.2.7f1/4ebd28dd9664

2018.2.6f1/c591d9a97a0b

2018.2.5f1/3071d1717b71

2018.2.4f1/cb262d9ddeaf

2018.2.3f1/1431a7d2ced7

2018.2.2f1/c18cef34cbcd

2018.2.1f1/1a9968d9f99c

2018.2.0f2/787658998520

Unity 2018.1#

2018.1.xf2

2018.1.9f2/a6cc294b73ee

2018.1.8f1/26051d4de9e9

2018.1.7f1/4cb482063d12

2018.1.6f1/57cc34175ccf

2018.1.5f1/732dbf75922d

2018.1.4f1/1a308f4ebef1

2018.1.3f1/a53ad04f7c7f

2018.1.2f1/a46d718d282d

2018.1.1f1/b8cbb5de9840

2018.1.0f2/d4d99f31acba

Unity 2017.4(LTS)#

2017.4.4xf1

2017.4.40f1/6e14067f8a9a

2017.4.3xf1

2017.4.39f1/947131c5be7e

2017.4.38f1/82ac2fb100ce

2017.4.37f1/78b69503ebc4

2017.4.36f1/c663def8414c

2017.4.35f1/e57a7bcbbf0b

2017.4.34f1/121f18246307

2017.4.33f1/a8557a619e24

2017.4.32f1/4da3ed968770

2017.4.31f1/9c8dbc3421cb

2017.4.30f1/c6fa43736cae

2017.4.2xf1

2017.4.29f1/06508aa14ca1

2017.4.28f1/e3a0f7dd2097

2017.4.27f1/0c4b856e4c6e

2017.4.26f1/3b349d10f010

2017.4.25f1/9cba1c3a94f1

2017.4.24f1/786769fc3439

2017.4.23f1/f80c8a98b1b5

2017.4.22f1/eb4bc6fa7f1d

2017.4.21f1/de35fe252486

2017.4.20f2/413dbd19b6dc

2017.4.1xf1

2017.4.19f1/47cd37c28be8

2017.4.18f1/a9236f402e28

2017.4.17f1/05307cddbb71

2017.4.16f1/7f7bdd1ef02b

2017.4.15f1/5d485b4897a7

2017.4.14f1/b28150134d55

2017.4.13f1/6902ad48015d

2017.4.12f1/b582b87345b1

2017.4.11f1/8c6b8ef6d111

2017.4.10f1/f2cce2a5991f

2017.4.10f1

2017.4.9f1/6d84dfc57ccf

2017.4.8f1/5ab7f4878ef1

2017.4.7f1/de9eb5ca33c5

2017.4.6f1/c24f30193bac

2017.4.5f1/89d1db9cb682

2017.4.4f1/645c9050ba4d

2017.4.3f1/21ae32b5a9cb

2017.4.2f2/52d9cb89b362

2017.4.1f1/9231f953d9d3

Unity 2017.3#

2017.3.1f1/fc1d3344e6ea

2017.3.0f3/a9f86dcd79df

Unity 2017.2#

2017.2.5f1/588dc79c95ed

2017.2.4f1/f1557d1f61fd

2017.2.3f1/372229934efd

2017.2.2f1/1f4e0f9b6a50

2017.2.1f1/94bf3f9e6b5e

2017.2.0f3/46dda1414e51

Unity 2017.1#

2017.1.5f1/9758a36cfaa6

2017.1.4f1/9fd71167a288

2017.1.3f1/574eeb502d14

2017.1.2f1/cc85bf6a8a04

2017.1.1f1/5d30cf096e79

2017.1.0f3/472613c02cf7

Unity 5#

Unity5.6以下版本不支持从Unity Hub中部署，故无法提供链接

引用#

文章引用了大部分文章并总结,原文地址如下:

如何逃离Unity中国特供版

Unity中国想钱想疯了

如何取得Unity Hub内旧版本Unity下载链接