Files
admin ea3ad2bb31 docs: 修正 CI/CD 方案的前提 —— 本机可完整访问互联网
之前测的是错的: 我把 --noproxy '*' 和 -x 一起传给 curl, 等于把要测的代理关掉了,
再叠加当时的一过性网络抖动, 得出了"宿主与容器都上不了外网"的错误结论。重测(2026-09-13):

- 宿主: 国内直连 200, 境外经 127.0.0.1:7890 代理 200;
- 容器: 直连 dl.gitea.com 200 / api.github.com 200 / codeload 301
  (仅 github.com 主站直连会超时), 即容器本来就有网, 不需要代理;
- docker daemon 已配代理(/etc/systemd/system/docker.service.d/http-proxy.conf),
  镜像拉取正常: gitea/act_runner:latest 拉到 arm64 v0.6.1(69.3MB),
  docker.gitea.com/runner-images:ubuntu-22.04 等 job 镜像 manifest 均可取;
- 用 act_runner 镜像自带的 generate-config 确认了两个关键能力:
  label 支持 ":host"(宿主模式), container.network 支持 "host"。

据此重写 deploy/ci-cd.md:
- 主方案改为标准做法: runner 用 gitea/act_runner 容器 + compose 管理,
  job 跑在容器里(network: host, 同路径挂载部署克隆与 docker.sock),
  全程不需要 root(ymy 在 docker 组); 宿主二进制 + host 模式降为备选 B
- 去掉了"离线"带来的一堆绕路(一次性下载二进制、不能写 uses: 等);
  不写 uses: 仍保留, 但理由改成"本项目不需要 + 避开 github.com 主站直连超时",
  并给出需要时的 github_mirror / 代理两条路
- 待确认项从 6 条缩到 3 条实质问题(fork PR 审批、job 镜像工具、workflow 语法支持面)

同时修正 compose/README/.env.example 里"容器上不了外网"的措辞:
默认不用代理的真正理由是"容器直连就通、且宿主 7890 只监听回环容器不可达",
而不是"外网不通"。显式空值挡 compose 自动注入的结论不变。
2026-09-13 17:27:47 +08:00

119 lines
6.5 KiB
Bash

# =============================================================================
# deploy/.env —— 复制为 .env 后填写。.env 已被 .gitignore 排除, 不要提交。
#
# cp .env.example .env
#
# 已有部署的密钥【不要重新生成】: 从现有 /etc/gitea/app.ini 对应段抄写
# (INTERNAL_TOKEN / LFS_JWT_SECRET / oauth2 JWT_SECRET 变更会使已发出的令牌失效)。
#
# 注意: 值里若含 $ 需要写成 $$(compose 会做变量插值); 含 # 或空格要用引号。
# =============================================================================
# -----------------------------------------------------------------------------
# 路径
# -----------------------------------------------------------------------------
# Gitea 数据根目录(容器内挂到 /data), 结构为 gitea/(配置与日志) 与 git/(仓库)
GITEA_DATA_DIR=/srv/gitea
# PostgreSQL 数据目录(容器内挂到 /var/lib/postgresql)
# postgres:18 的布局: 实际数据在 <此目录>/18/docker,
# 所以这里给父目录即可(不要再按老写法挂 /var/lib/postgresql/data)
POSTGRES_DATA_DIR=/srv/pgdata
# -----------------------------------------------------------------------------
# 定制覆盖层(Gitea 客制化: 首页 / 中文术语 / 去 Gitea 化)
# 官方镜像里 GITEA_CUSTOM=/data/gitea, 因此定制内容是挂到
# /data/gitea/{templates,public,options} —— 不是 /data/gitea/custom!
# 这是仓库里的 customization/custom 目录, 相对路径按 deploy/ 解析。
# 生效前先确保产物已生成: python3 customization/build.py
# -----------------------------------------------------------------------------
GITEA_CUSTOM_DIR=../customization/custom
# -----------------------------------------------------------------------------
# 容器出站代理(见 compose.yaml 同段落注释 / README 陷阱 6)
# 默认: compose.yaml 里显式写成空值, 即容器内【不用代理】。这不是省事, 是有意的:
# * compose 会把「运行 compose 的 shell」里的 http_proxy 自动注入容器, 而本机登录
# shell 里是 127.0.0.1:7890 —— 那个地址在容器里是容器自己, 一旦被注入, Gitea
# 启动时 OIDC discovery 就失败, 统一身份认证登录 404; 显式给空值能挡住注入。
# * 容器【直连外网是通的】(实测 dl.gitea.com / api.github.com / codeload 都能直连),
# 平台功能相关的出站(OIDC)也在内网直连, 所以不需要代理。
# 将来若确实要给容器配代理, 必须是【容器可达】的地址(别写 127.0.0.1, 那是容器自己):
# -----------------------------------------------------------------------------
#GITEA_HTTP_PROXY=https://cpp.tongji.sh:7890
#GITEA_HTTPS_PROXY=https://cpp.tongji.sh:7890
#GITEA_NO_PROXY=localhost,127.0.0.1,::1,10.80.42.185,.local,.internal
# -----------------------------------------------------------------------------
# 版本(锁定, 便于回滚)
# -----------------------------------------------------------------------------
GITEA_VERSION=1.27.3
POSTGRES_VERSION=18.6
# -----------------------------------------------------------------------------
# 对外地址(必须与现有 Apache 反代一致, 否则链接/克隆地址会错)
# 现有: ROOT_URL = https://cpp.tongji.sh/QA
# Apache: ProxyPass /QA http://localhost:2080
# -----------------------------------------------------------------------------
GITEA_DOMAIN=10.80.42.185
GITEA_ROOT_URL=https://cpp.tongji.sh/QA
GITEA_NO_REPLY_ADDRESS=noreply.10.80.42.185
# 容器发布的回环端口, 必须等于 Apache ProxyPass 的目标端口
GITEA_HTTP_PORT=2080
# 离线模式(沿用现有 app.ini 的 OFFLINE_MODE=true)
GITEA_OFFLINE_MODE=true
# -----------------------------------------------------------------------------
# 容器内 git 用户 uid/gid —— 必须与 GITEA_DATA_DIR 的属主一致
# 现有宿主: /var/lib/gitea 属主 git:git = 982:982
# -----------------------------------------------------------------------------
GITEA_UID=982
GITEA_GID=982
# -----------------------------------------------------------------------------
# 站点名
# ★ 走【裸变量 APP_NAME】(compose 映射为 APP_NAME, 不是 GITEA__*):
# 镜像 /etc/s6/gitea/setup 用 envsubst 渲染模板, 模板第一行是
# `APP_NAME = $APP_NAME`。GITEA__DEFAULT__APP_NAME 不生效(原因见 README)。
# 从现有 app.ini 的【顶层】(无段名)抄写真实值; 全新部署才自行取名。
# -----------------------------------------------------------------------------
GITEA_APP_NAME=Gitea
# -----------------------------------------------------------------------------
# Webhook 出站白名单(逗号分隔; loopback 是内置网络名)
# loopback 为内置项; 其余按实际通知服务填写。
# 从现有 app.ini 的【[security] 段】抄写真实值。
# 段位: 1.27 的规范位置就是 [security]; [webhook] 是 v28.0.0 将移除的
# deprecated fallback(modules/setting/webhook.go)。
# -----------------------------------------------------------------------------
GITEA_ALLOWED_HOST_LIST=loopback,example.com
# -----------------------------------------------------------------------------
# 密钥 —— 【必须沿用现有值】
# INTERNAL_TOKEN / LFS_JWT_SECRET / oauth2 JWT_SECRET 变更会使已发出的令牌失效。
# 从现有 /etc/gitea/app.ini 抄写; 只有全新部署才用 generate secret 生成。
#
# GITEA_SECRET_KEY 特别说明:
# 现有 /etc/gitea/app.ini **没有** SECRET_KEY, 实例一直在用 Gitea 内置默认值。
# 默认留空 = 容器同样使用内置默认值, SSO 与已加密数据行为不变。
# 如需轮换(安全加固), 填一个新的随机值, 但必须在切换后到管理后台
# 重新填写 OIDC(OAuth2)登录源的 Client Secret, 并验证登录。详见 README。
# 生成新值:
# docker run --rm docker.gitea.com/gitea:1.27.3 gitea generate secret SECRET_KEY
# -----------------------------------------------------------------------------
GITEA_SECRET_KEY=
GITEA_INTERNAL_TOKEN=
GITEA_LFS_JWT_SECRET=
GITEA_OAUTH2_JWT_SECRET=
# -----------------------------------------------------------------------------
# PostgreSQL(容器内部)
# 现有集群: db=giteadb, user=gitea, collate=zh_CN.UTF-8
# -----------------------------------------------------------------------------
POSTGRES_DB=giteadb
POSTGRES_USER=gitea
POSTGRES_PASSWORD=
# -----------------------------------------------------------------------------
# 时区
# -----------------------------------------------------------------------------
TZ=Asia/Shanghai