SHA256
forked from course-team/tjhlp-gitea
1) 出站代理 —— 这次实际踩到的故障:
docker compose 会把「运行 compose 的那个 shell」里的 http_proxy/https_proxy
自动注入容器。登录 shell 里是 127.0.0.1:7890, 而 127.0.0.1 在容器里指向容器自己,
于是 Gitea 启动时 OIDC discovery 失败:
initOAuth2Sources() [E] Unable to register source: 高程统一身份认证 due to
proxyconnect tcp: dial tcp 127.0.0.1:7890: connect: connection refused
认证源注册不上 -> 登录页按钮照旧显示(数据来自数据库), 但点下去
/QA/user/oauth2/... 返回 404, 统一身份认证完全无法登录。
现在两处 compose 都显式给出这四个变量(默认 = 改造前宿主机上的代理设置,
NO_PROXY 含 10.80.42.185 让 OIDC 直连), 显式赋值可挡住自动注入;
.env.example 说明如何覆盖/置空, README 记为新陷阱 6(含一行验证命令)。
2) 通行密钥: [service] ENABLE_PASSKEY_AUTHENTICATION=false(两处 compose)。
登录页此前那个"空方框"就是它: 上游该区块只有 tw-hidden 元素, 浏览器不支持
条件中介时 CSS 隐藏一切, 只剩一个带边框的 segment。关掉后连区块都不再输出。
实测: 生产 up -d 后 OIDC 入口 307 -> https://cpp.tongji.sh/oidc/auth?client_id=tjhlp-gitea...
(修复前是 404), 登录页 200 且两张卡片正常, healthz 200。
111 lines
5.4 KiB
YAML
111 lines
5.4 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 失败,
|
|
# 见 deploy/compose.yaml 同位置注释与 deploy/README.md 陷阱 6。
|
|
HTTP_PROXY: ${GITEA_HTTP_PROXY:-https://cpp.tongji.sh:7890}
|
|
HTTPS_PROXY: ${GITEA_HTTPS_PROXY:-https://cpp.tongji.sh:7890}
|
|
http_proxy: ${GITEA_HTTP_PROXY:-https://cpp.tongji.sh:7890}
|
|
https_proxy: ${GITEA_HTTPS_PROXY:-https://cpp.tongji.sh:7890}
|
|
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
|