Files
tjhlp-gitea/customization/preview/compose.yaml
T
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

111 lines
5.3 KiB
YAML

# =============================================================================
# TJHLP 定制预览实例(与生产完全隔离, 只绑定回环)
#
# 目的: 在不动生产容器/数据的前提下, 用【与生产相同版本】的官方镜像验证
# customization/custom 下的模板、文案、静态资源效果。
#
# 与生产(deploy/compose.yaml)的区别:
# * 项目名 gitea-preview, 容器名 gitea-preview, 端口 127.0.0.1:2081
# * 数据库用 sqlite(预览不需要 PostgreSQL)
# * 数据目录 preview/data(gitignore), 删除即重置
# * RUN_MODE=dev: 修改 custom/ 下的模板或语言文件后自动热加载, 无需重启
# * 把 customization/custom 只读挂载到容器的 GITEA_CUSTOM/custom
#
# 用法(见 preview.sh):
# ./preview.sh up 启动
# ./preview.sh logs 看日志
# ./preview.sh down 停止
# ./preview.sh reset 停止并清空预览数据
# =============================================================================
name: gitea-preview
services:
gitea:
image: docker.gitea.com/gitea:${GITEA_VERSION:-1.27.3}
container_name: gitea-preview
restart: unless-stopped
environment:
# 与宿主当前用户对齐, 让 ./data 的属主正确(见 preview.sh)
USER_UID: ${PREVIEW_UID:-1001}
USER_GID: ${PREVIEW_GID:-1001}
TZ: ${TZ:-Asia/Shanghai}
APP_NAME: 同济高程-答疑平台(预览)
# dev(默认): 语言文件改动自动热加载(实测), 模板报错也不致命 —— 改文案方便;
# prod: 与生产完全一致, 任何改动都要 ./preview.sh reload。
# 注意: 模板是启动时编译的, dev 下改模板同样要重启(官方文档也是这么说的)。
RUN_MODE: ${PREVIEW_RUN_MODE:-dev}
# --- 数据库: sqlite(预览专用) -------------------------------------
GITEA__database__DB_TYPE: sqlite3
GITEA__database__PATH: /data/gitea/gitea.db
# --- 服务地址 ------------------------------------------------------
GITEA__server__PROTOCOL: http
GITEA__server__DOMAIN: 127.0.0.1
GITEA__server__ROOT_URL: http://127.0.0.1:${PREVIEW_PORT:-2081}/
GITEA__server__HTTP_ADDR: 0.0.0.0
GITEA__server__HTTP_PORT: "3000"
GITEA__server__DISABLE_SSH: "true"
GITEA__server__LFS_START_SERVER: "true"
GITEA__server__OFFLINE_MODE: "false"
# --- 安全: 跳过安装向导; 密钥不在这里指定 -------------------------
# LFS_JWT_SECRET / INTERNAL_TOKEN / JWT_SECRET 留空时 Gitea 会自己生成
# 并写回 /data/gitea/conf/app.ini(可写), 重启后保持不变。
GITEA__security__INSTALL_LOCK: "true"
# --- 注册 / 登录 ---------------------------------------------------
GITEA__service__DISABLE_REGISTRATION: "false"
GITEA__service__ENABLE_CAPTCHA: "false"
GITEA__service__REQUIRE_SIGNIN_VIEW: "false"
# 不做通行密钥(WebAuthn): 上游登录页那块只有 tw-hidden 元素, 浏览器不支持条件中介时
# 会留下一个空的方框; 关掉后区块不再渲染, 登录页也不会出现 passkey 入口。
GITEA__service__ENABLE_PASSKEY_AUTHENTICATION: "false"
GITEA__mailer__ENABLED: "false"
# --- 出站代理: 显式给值挡掉自动注入, 默认不用代理 ---------------------
# compose 会把宿主 shell 的 http_proxy(本机是 127.0.0.1:7890, 在容器里指向
# 容器自己)自动注入; 生产上这会直接让 OIDC discovery 失败(登录 404)。
# 容器直连外网本身是通的(实测), 不需要代理; 理由见 deploy/compose.yaml 同位置注释。
HTTP_PROXY: ${GITEA_HTTP_PROXY:-}
HTTPS_PROXY: ${GITEA_HTTPS_PROXY:-}
http_proxy: ${GITEA_HTTP_PROXY:-}
https_proxy: ${GITEA_HTTPS_PROXY:-}
NO_PROXY: ${GITEA_NO_PROXY:-localhost,127.0.0.1,::1,10.80.42.185,.local,.internal}
no_proxy: ${GITEA_NO_PROXY:-localhost,127.0.0.1,::1,10.80.42.185,.local,.internal}
# --- 站点元信息与页脚: 去掉 Gitea 自我推销 -------------------------
# 段名里的点要写成 _0X2E_ (Gitea 的 GITEA__section__KEY 编码规则)
GITEA__ui_0X2E_meta__AUTHOR: 同济大学高级语言程序设计课程
GITEA__ui_0X2E_meta__DESCRIPTION: 同济大学高级语言程序设计课程答疑平台
GITEA__ui_0X2E_meta__KEYWORDS: 同济大学,高级语言程序设计,答疑,Issue
GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
GITEA__other__SHOW_FOOTER_VERSION: "false"
GITEA__log__MODE: console
GITEA__log__LEVEL: ${GITEA_LOG_LEVEL:-info}
volumes:
- ./data:/data
# ★ 官方镜像里 GITEA_CUSTOM=/data/gitea, 所以定制文件对应
# /data/gitea/{templates,public,options}, 而不是 /data/gitea/custom
# (后者是源码/二进制安装时 WorkPath/custom 的习惯写法)。
# 分开挂三个子目录: 既只读覆盖定制内容, 又不遮住同级的 conf/、log/。
- ../custom/templates:/data/gitea/templates:ro
- ../custom/public:/data/gitea/public:ro
- ../custom/options:/data/gitea/options:ro
- /etc/localtime:/etc/localtime:ro
ports:
# 只绑定回环, 预览实例不对内网/外网暴露
- "127.0.0.1:${PREVIEW_PORT:-2081}:3000"
healthcheck:
test: ["CMD", "curl", "-fsS", "http://127.0.0.1:3000/api/healthz"]
interval: 10s
timeout: 5s
retries: 10
start_period: 60s