# ============================================================================= # 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