文档：修正 CI 配置指南中 DEFAULT_ACTIONS_URL 说明

原 §1.2 示例把 DEFAULT_ACTIONS_URL 写成 https://gitea.com，易误导为该填自己的网址。
实际语义：它控制 action（如 actions/checkout@v4）的下载源——默认 github.com，
self = 从自己 Gitea 实例拉（需先把 action 镜像进实例），并非填实例域名。

新增 §1.2.1 专节（取值表 + 按网络环境选择 + 官方 FAQ 原文引用）；
§4.3 同步修正（原文误写"gitea.com 代理"），并把零依赖 git 写法列为内网首选。

docs/环境与部署/CI配置指南.md

@@ -50,12 +50,34 @@ ENABLED = true
 ```ini
 [actions]
 ENABLED = true
-; 可选：限制单仓库并发任务数，防 runner 被占满
-DEFAULT_ACTIONS_URL = https://gitea.com
 ```
 
 改完 **重启 Gitea 服务**（Docker：`docker restart <容器名>`；二进制：重启进程）。
 
+### 1.2.1 `DEFAULT_ACTIONS_URL` 是什么（**容易搞反**）
+
+它**不是你的 Gitea 地址**，而是控制 **`uses: actions/checkout@v4` 这类 action 从哪里下载**：
+
+| 取值 | 行为 |
+|---|---|
+| **不配（默认）** | 从 **[github.com](https://github.com)** 拉取 action |
+| `self` | 从**你自己的 Gitea 实例**拉取（要求 action 已镜像进你的实例） |
+| 具体 URL（如 `https://gitea.com`） | 从该地址拉取 |
+
+> ⚠️ **不要把你的实例域名写进去当普通 URL**——要"从自己实例拉"就用关键字 **`self`**；
+> 且**写了 `self` 还得先把 action 镜像进自己实例**，否则 `actions/checkout` 依然拉不到。
+
+**按你的网络环境选择**：
+
+| 场景 | 配置 |
+|---|---|
+| 服务器**能**访问 github.com | **什么都不配**（默认走 github.com，最省事） |
+| 内网，**不能**访问 github.com | 建议**改用零依赖写法**（见 §4.3 方案 3），`DEFAULT_ACTIONS_URL` 配不配都行；<br>若坚持用 `actions/checkout@v4`，则需 `DEFAULT_ACTIONS_URL = self` **且**把该 action 镜像进实例 |
+
+> Gitea 官方 FAQ 原文：*"From `https://github.com` by default, or from your own instance
+> when `[actions].DEFAULT_ACTIONS_URL` is `self`."* 使用别处 action 也可在 workflow 里直接写全路径：
+> `uses: https://gitea.com/owner/repo@ref` / `uses: self:owner/repo@ref`。
+
 ### 1.3 验证
 
 浏览器打开仓库地址，顶部/侧栏应出现 **Actions** 标签页。
@@ -215,13 +237,13 @@ on:
 
 ### 4.3 内网无公网时的 action 拉取（重要）
 
-workflow 用了 `actions/checkout@v4`。Gitea 默认从 **gitea.com** 代理拉取官方 action；
-若实例不通外网，会在 checkout 步骤卡住/失败。三种处置：
+workflow 用了 `actions/checkout@v4`。**默认从 `github.com` 拉取**（见 §1.2.1）；实例不通
+github.com 会在 checkout 步骤卡住/失败。三种处置：
 
-1. **开代理**：在 Gitea `app.ini` 配 `[actions] DEFAULT_ACTIONS_URL = https://gitea.com`
-   并确保服务器能访问该域名；
-2. **镜像**：改 `DEFAULT_ACTIONS_URL` 指向可达的 action 镜像；
-3. **零依赖**：把 checkout 换成纯 git 命令（不依赖任何 action）：
+1. **镜像到自有实例**：`DEFAULT_ACTIONS_URL = self`，**并先把 `actions/checkout` 导入你自己的 Gitea**；
+2. **指向可达镜像**：`DEFAULT_ACTIONS_URL` 指向某个能访问的 action 站（或在 workflow 里
+   直接写全路径 `uses: https://<host>/owner/repo@ref`）；
+3. **零依赖**（内网最稳，推荐）：把 checkout 换成纯 git 命令，不依赖任何 action：
 
 ```yaml
       - name: Checkout
@@ -233,7 +255,8 @@ workflow 用了 `actions/checkout@v4`。Gitea 默认从 **gitea.com** 代理拉
           git checkout $env:GITHUB_SHA
 ```
 
-> 方案 3 无需任何外部 action，内网最稳；代价是失去 checkout 的缓存优化。
+> 方案 3 无需任何外部 action 与任何 `DEFAULT_ACTIONS_URL` 配置；代价是失去 checkout 的缓存优化。
+> 参考：Gitea FAQ「Where will the runner download scripts when using actions such as `actions/checkout@v4`?」
 
 ---
 
@@ -290,4 +313,5 @@ workflow 用了 `actions/checkout@v4`。Gitea 默认从 **gitea.com** 代理拉
 
 | 日期 | 变更 |
 |---|---|
+| 2026-10-01 | **修正 `DEFAULT_ACTIONS_URL` 说明**（原 §1.2 示例误导）：新增 §1.2.1 明确它控制的是 **action 下载源**（默认 `github.com`；`self` = 从自己实例拉且需先镜像 action），**不是填自己的 Gitea 地址**；§4.3 同步修正（原文误写"gitea.com 代理"），并补零依赖写法为内网首选。依据：Gitea 官方 FAQ + config-cheat-sheet |
 | 2026-10-01 | 初版：Gitea Actions 配置全流程（服务端开关 / Windows runner 注册 / runner 软件环境 / workflow 位置与触发 / 内网 action 拉取 / 端到端验证清单 / 故障排查 / 日常维护） |