docs: 添加 runner 自主维护 docker-compose 配置指南

.gitea/RUNNER-MAINTENANCE.md

@@ -0,0 +1,62 @@
+# Gitea Runner 自主维护配置指南
+
+## 当前状态
+- Runner 名称: gitea-runner (online, label: docker)
+- 维护 workflow: `.gitea/workflows/runner-maintenance.yaml` (每 6 小时 + 手动触发)
+
+## 宿主机 docker-compose 推荐配置
+
+在 fnOS 上找到 gitea-runner 的 compose 文件，确保包含以下配置：
+
+```yaml
+services:
+  gitea:
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:3000/api/healthz"]
+      interval: 10s
+      retries: 3
+      start_period: 30s
+      timeout: 10s
+
+  gitea-runner:
+    image: gitea/act_runner:latest
+    container_name: gitea-runner
+    restart: unless-stopped
+    depends_on:
+      gitea:
+        condition: service_healthy
+        restart: true
+    volumes:
+      - ./runner-data:/data
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - GITEA_INSTANCE_URL=https://gitea.windychen00n.work
+      - GITEA_RUNNER_JOB_CONTAINER_NETWORK=<gitea所在docker网络名>
+      # 首次注册时需要，之后可删除
+      # - GITEA_RUNNER_REGISTRATION_TOKEN=<token>
+    networks:
+      - <gitea所在docker网络名>
+
+networks:
+  <gitea所在docker网络名>:
+    external: true
+```
+
+## 查找 docker 网络名
+
+在 fnOS SSH 执行：
+```bash
+docker inspect gitea --format "{{range $k,$v := .NetworkSettings.Networks}}{{$k}}{{end}}"
+docker inspect gitea-runner --format "{{range $k,$v := .NetworkSettings.Networks}}{{$k}}{{end}}"
+```
+
+将 `GITEA_RUNNER_JOB_CONTAINER_NETWORK` 设为 gitea 容器所在的网络名，
+这样 CI job 容器才能通过 `http://gitea:3000` 和 `http://verdaccio:4873` 访问内网服务。
+
+## 应用后验证
+
+```bash
+docker compose up -d gitea-runner
+```
+
+然后在 Gitea 页面手动触发 "Runner Self-Maintenance" workflow，应全部通过。