# Gitea + PostgreSQL(Docker Compose) 用 `docker compose` 运维 TJHLP 答疑平台的 Gitea 与 PostgreSQL。 本文档是唯一的部署与运维手册, 覆盖 **部署 / 备份 / 恢复 / 升级** 四条主流程。 ``` ┌──────────────────────────────────────────┐ 学生/助教 ──https──▶│ Apache httpd (宿主机, 已有) │ │ ProxyPass /QA → 127.0.0.1:2080 │ └───────────────┬──────────────────────────┘ │ 只绑回环 ┌───────────────▼──────────────────────────┐ │ docker compose 项目 "gitea" │ │ │ │ gitea (docker.gitea.com/gitea:1.27.3) │ │ │ /data ← ${GITEA_DATA_DIR} │ │ │ │ │ db (postgres:18.6 + zh_CN locale) │ │ /var/lib/postgresql │ │ ← ${POSTGRES_DATA_DIR} │ │ (PG18 实际数据在 18/docker/) │ └──────────────────────────────────────────┘ PostgreSQL 只在 compose 内部网络暴露, 不发布到宿主机 ``` --- ## 0. 快速索引 | 我要做什么 | 节 | 命令 | |---|---|---| | 在新主机上从零部署 | §4 | 见 §4 | | 看状态 / 日志 / 重启 | §8 | `docker compose ps` · `logs` | | **备份** | §5 | `sudo ./scripts/backup.sh --quiesce` | | **恢复**(含演练) | §6 | `sudo ./scripts/restore.sh <时间戳> --apply` | | **升级** Gitea / PostgreSQL | §7 | 备份 → 改 `.env` → `up -d` | | 改首页 / 中文术语 / 去 Gitea 化 | [`../customization/README.md`](../customization/README.md) | `python3 customization/build.py` → `docker compose restart gitea` | | main 推送后自动部署(方案) | [`ci-cd.md`](ci-cd.md) | Gitea Actions + 宿主 act_runner(host 模式) | | 出问题了 | §12 | — | | 退回二进制部署 | §9 | `docker compose down && sudo systemctl start gitea` | 三条铁律: 1. **任何升级 / 迁移 / 改动前先备份** —— `sudo ./scripts/backup.sh --quiesce`。 2. **没演练过的备份不算备份** —— 定期照 §6 在测试机上恢复一次。 3. **配置只改 `compose.yaml` 与 `.env`**, 不要手工编辑容器里的 `app.ini` (它是启动时按 env 生成的派生产物, 下次重建就被覆盖)。 --- ## 1. 关键设计决策 | 决策 | 理由 | |---|---| | 版本全部锁定 (`GITEA_VERSION`, `POSTGRES_VERSION`) | 可复现、升级/回滚是改一行 `.env` | | Gitea 只发布 `127.0.0.1:2080` | Apache 反代配置**无需改动**; 同时消除"直连 2080 绕过 TLS"的暴露面 | | PostgreSQL 不发布端口 | 只走 compose 内部网络; 外部无法直连数据库 | | 配置全部用 `GITEA__section__KEY` 环境变量 | 官方镜像支持的机制; 不把宿主绝对路径写进 `app.ini` | | 数据用 bind mount 而非 named volume | 备份/检查/回滚路径明确, 源数据可直接比对 | | 自建 `db` 镜像补 `zh_CN.UTF-8` | 官方 postgres 镜像只生成 `en_US.UTF-8`, 而现有集群 collation 是 `zh_CN.UTF-8` | | 关闭容器内 Gitea SSH | 现有部署的 git 用户没有 `.ssh/authorized_keys`, SSH 实际未使用 | | `db` 挂到 `/var/lib/postgresql`(而非 `.../data`) | postgres:18 把 `PGDATA` 改成 `/var/lib/postgresql/18/docker`, `VOLUME` 也上移了一层 | | 两个服务都 `restart: unless-stopped` | 开机自动恢复, 不依赖宿主的 gitea unit | --- ## 2. 已知陷阱(本机踩过的坑, 改配置前先读) > **⚠️ 1. postgres:18 的挂载点。** > 若沿用 18 之前的老写法把数据目录挂到 `/var/lib/postgresql/data`, 容器**不会启动**, > 入口脚本会打印 > `there appears to be PostgreSQL data in: /var/lib/postgresql/data (unused mount/volume)` > 然后 `exit 1` —— 它通过 `mountpoint` 加 `/proc/self/mountinfo` 把该路径判定为 > "未被使用的挂载点"。正确做法是挂父目录 `/var/lib/postgresql`, 数据落在 > `${POSTGRES_DATA_DIR}/18/docker`。这个新布局的用意是让将来 `pg_upgrade --link` > 不撞上挂载点边界。 > **⚠️ 2. s6 `setup` 的 chown 守卫 —— 会让 Gitea 以 `[F]` 崩溃。** > 镜像里的 `/etc/s6/gitea/setup` 以 **root** 身份、在 Gitea 启动之前运行: > ```bash > if [ ! -d /data/git/.ssh ]; then mkdir -p /data/git/.ssh; fi # ← 以 root 建 > chmod 700 /data/git/.ssh # ← 700 root:root > # only chown if current owner is not already the gitea ${USER}. No recursive check to save time > if ! [[ $(ls -ld /data/git | awk '{print $3}') = ${USER} ]]; then chown -R ${USER}:git /data/git; fi > ``` > 那个递归 chown 有守卫:**只有当 `/data/git` 的属主不是 `git` 时才执行**。如果 `/data/git` > 已经是 `git` 而里面某个文件(如刚被 root 建出来的 `.ssh`)是 `root:root`, 守卫为假 → > **递归 chown 被跳过** → `.ssh` 永久留在 `root:root 700`。Gitea 以 `git` 运行, 写不进去: > ``` > [F] gitea.dev/services/asymkey.RewriteAllPublicKeys(ctx) failed: > open /data/git/.ssh/authorized_keys.tmp: permission denied > ``` > 后果是容器 `Restarting` 死循环、`/api/healthz` 无响应、Apache `/QA` 返回 503。 > 同样的守卫也作用于 `/data/gitea`, 所以 `conf`、`log` 也可能变成 `root:root`。 > > **体检与修复**(迁移后 / 恢复后建议各跑一次): > ```bash > sudo docker compose exec -T gitea ls -ld /data/git /data/git/.ssh /data/gitea/conf /data/gitea/log > # 期望属主全是 git(git)。若出现 root: > sudo chown -R 982:982 /srv/gitea/git /srv/gitea/gitea/conf /srv/gitea/gitea/log > sudo docker compose restart gitea > ``` > **⚠️ 3. 定制覆盖层的文件权限 —— 又一次让 Gitea 以 `[F]` 崩溃。** > `customization/custom/*` 是**只读**挂载进容器的, 容器里 Gitea 以 `git`(982) 运行。 > 如果这些文件是 `600`(只读挂载不影响权限检查!), 启动时就报: > ```text > [F] processStartupTemplateError() Gitea can't run with template errors: > open home.tmpl: permission denied > ``` > 容器 `Restarting` 死循环。**预览环境不会暴露这个问题** —— 预览容器用 `PREVIEW_UID` > (默认宿主 uid 1001), 恰好就是文件属主, 所以 600 也读得到。 > ```bash > # 体检: 容器用户能否读到 > docker compose exec -T -u git gitea head -c1 /data/gitea/templates/home.tmpl > # 修复(会遍历 custom/ 补齐 g+r / o+r, 目录补 o+x) > python3 ../customization/build.py > python3 ../customization/build.py --check # 部署前也会校验, 不可读直接报错退出 > ``` > 编辑器/工具写文件常带 `600`; `git` 只记录可执行位, 所以**新克隆下来一般是 644**, > 偏偏本地改过的文件会中招。 > **⚠️ 4. 站点名 `APP_NAME` 只能用裸变量, `GITEA__DEFAULT__APP_NAME` **无效**。** > 镜像的 `/etc/s6/gitea/setup` 用 `envsubst` 渲染 `/etc/templates/app.ini`, 而模板第一行是 > `APP_NAME = $APP_NAME` —— 来源是**裸环境变量** `APP_NAME`。为什么 `GITEA__*` 那条路走不通: > `modules/setting/config_env.go` 会把段名小写化(`section = strings.ToLower(section)`), > 而 ini 库(`gopkg.in/ini.v1`)的默认段名常量是 `"DEFAULT"`(大写, 且默认区分大小写), > 所以 `GITEA__DEFAULT__X` 只会新建一个没用的 `[default]` 段, 顶层键纹丝不动。 > 症状: 页面标题变成 `Gitea: Git with a cup of tea`。 > > 而且模板**只在 `app.ini` 不存在时**渲染, 所以对已经生成过 `app.ini` 的部署, 光改 env > 不够, 必须让容器重新生成一次: > ```bash > sudo rm -f /srv/gitea/gitea/conf/app.ini > sudo docker compose up -d --force-recreate gitea > ``` > **⚠️ 5. 用 `curl` 验证本机服务时会被 HTTP 代理接管。** > 本机 shell 里设了 `http_proxy=127.0.0.1:7890`, 而 `no_proxy` 不覆盖 `127.0.0.1` 时, > 连 `curl http://127.0.0.1:2080/...` 都会走 mihomo, 而 **mihomo 对回环代理请求返回 > `502 Bad Gateway`**(响应头带 `Proxy-Connection: keep-alive`, 是代理在答而不是 Gitea)。 > 表现为"经 Apache 200、直连 502"的假故障。 > > 所有脚本(`verify.sh` / `restore.sh`)内部都已 `--noproxy '*'`; 手工验证时也要加: > ```bash > curl -sS --noproxy '*' http://127.0.0.1:2080/api/healthz > ``` > **⚠️ 6. compose 会把 shell 的 `http_proxy` 注入容器 —— 会让 OIDC 登录整条 404。** > `docker compose up` 会自动把**运行它的那个 shell** 里的 `HTTP_PROXY`/`HTTPS_PROXY`/ > `NO_PROXY`(大小写都算)注入容器。本机登录 shell 里是 > `http_proxy=http://localhost:7890`,而 **`localhost`/`127.0.0.1` 在容器里指向容器自己**, > 于是 Gitea 启动时拉 OIDC discovery 失败: > ```text > initOAuth2Sources() [E] Unable to register source: 高程统一身份认证 due to > Error: Failed to initialize OpenID Connect Provider ... proxyconnect tcp: > dial tcp 127.0.0.1:7890: connect: connection refused > ``` > 认证源注册不上 → 登录页的按钮还在(它来自数据库), 但点下去 > `/QA/user/oauth2/...` 返回 **404**, 统一身份认证**完全无法登录**。 > 这个坑很隐蔽: 容器是健康的、健康检查 `200`、登录页 `200`, 只有真正点登录才炸。 > > `compose.yaml` 现在**显式**给出这几个变量、且默认**空值**(= 容器内不用代理), > 显式赋值可以挡住自动注入。**默认不用代理的依据**(2026-09-13 实测): > * 容器**直连外网是通的**: `dl.gitea.com`、`api.github.com`、`codeload.github.com` > 在容器里直接 curl 分别是 `200/200/301`(`github.com` 主站直连会超时, 但平台不依赖它); > * 与功能相关的出站只有 OIDC, 目标是 `10.80.42.185`, 容器内直连即 `200`; > * 宿主 `7890` 那个代理是 **ssh 转发的开发用代理**, `ss -ltn` 显示只监听 > `127.0.0.1:7890`/`[::1]:7890` —— 在容器里 `127.0.0.1` 是容器自己, > `10.80.42.185:7890` 也不可达(实测 `curl -x` 直接 `Could not connect`), > 所以这个代理配进容器只会让出站先绕一圈再失败。 > > 将来真要给容器配代理, 必须是**容器可达**的地址(把隧道绑到 LAN 口, 或让容器用 > host 网络), 再在 `.env` 里给 `GITEA_HTTP_PROXY`(见 `.env.example`)。 > **每次 `up -d` 后建议验一次** OIDC 入口是否还通: > ```bash > curl -sS --noproxy '*' -o /dev/null -w '%{http_code} %{redirect_url}\n' \ > 'http://127.0.0.1:2080/user/oauth2/%E9%AB%98%E7%A8%8B%E7%BB%9F%E4%B8%80%E8%BA%AB%E4%BB%BD%E8%AE%A4%E8%AF%81' > # 期望: 307 + Location: http://10.80.42.185/oidc/auth?... (404 = 认证源没注册上) > ``` > > **⚠️ 7. 全新克隆 + compose: docker 会以 root 创建不存在的挂载源目录。** > `compose.yaml` 把 `customization/custom/{options,public,templates}` 逐个挂进容器。 > 其中 `options/` 里只有生成出来的 `locale_zh-CN.json`, 而它是 gitignore 的 —— 于是 > 全新克隆里这个目录不存在, **docker 会以 root 创建它**, 之后普通用户跑 > `customization/build.py` 就写不进去: > ``` > PermissionError: [Errno 13] Permission denied: .../custom/options/locale > ``` > 后果不是报错那么明显: 语言文件生成失败 → 中文界面退回上游文案(「工单」又回来了), > 而首页/登录页看起来一切正常。2026-09-13 第一次把生产切到部署克隆(CI 用的那份)时踩到。 > > 现在有两道防线: ①仓库里 `customization/custom/options/.gitkeep` 让目录随 checkout 就存在 > 且属于当前用户; ②`deploy/scripts/auto-deploy.sh` 在部署前检查三个目录存在且**可写**, > 不满足就明确报错。若已经中招: > ```bash > sudo rm -rf customization/custom/options # 空的 root 目录, 删掉即可 > ``` > > **⚠️ 8. `docker.sock` 怎么挂:`docker_host: "-"` 与"job 自己申报"是配套的一对。** > 默认行为是 act_runner 把 docker daemon socket **自动**挂进 job 容器 —— 等于这个 runner 上的 > **每个** job 都白拿 docker(= root 等价)。现在把这份能力收窄成"要用 docker 的 job 自己申报": > ```yaml > # deploy/runner/config.yaml —— runner 侧: 不自动挂, 并给申报加白名单 > container: > docker_host: "-" # 自动找 daemon, 但不挂进 job 容器 > valid_volumes: [...] # job 申报的挂载必须在这个表里 > ``` > ```yaml > # .gitea/workflows/deploy.yml —— job 侧: 只给需要它的那个 job > container: > volumes: > - /var/run/docker.sock:/var/run/docker.sock > ``` > ⚠️ **两者必须成对**: 只写 `volumes` 而没有 `docker_host: "-"`, 就会和自动挂载撞成 > ``` > failed to create container: 'Duplicate mount point: /var/run/docker.sock' > ``` > (2026-09-13 用 `act_runner exec` 预演时第一次踩到。注意 `exec` 有自己的 > `--container-daemon-socket` 默认值、**不读**配置里的 `docker_host`, 所以用 exec 预演时 > 这个错会一直出现 —— 它验证不了这一项。) > > **⚠️ 10. `valid_volumes` 会静默丢掉挂载。** > job 申报的 `container.volumes`(以及全局 `options` 里的 `--volume`)都必须出现在 > `container.valid_volumes` 里, 否则 act_runner 只打一行 > `... is not a valid volume, will be ignored` 就把它丢掉, **job 照常往下跑** —— 现象是容器里 > 少了个目录, 而不是报错。2026-09-21 就因此让部署 job 的 > `cd /home/ymy/deploy/tjhlp-gitea` 失败。排查两行命令: > ```bash > docker exec gitea-runner sed -n '/valid_volumes/,+6p' /config/config.yaml > docker inspect $(docker ps -q --filter name=GITEA-ACTIONS) \ > --format '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' > ``` > > **⚠️ 9. 宿主 `/usr/bin/python3` 是 3.6, 别让它排到 PATH 前面。** > `customization/build.py` 用了 `from __future__ import annotations`, 需要 ≥3.7。 > 宿主上正确的解释器是 `~/.local/bin/python3`(3.14), 但 `/usr/bin/python3` 是 Rocky 8 的 > 3.6 —— 只要 PATH 被改成 `/usr/bin` 优先, 就会看到 > `SyntaxError: future feature annotations is not defined`, 而且**语言文件静默地不再更新**。 > `auto-deploy.sh` 现在自己挑一个 ≥3.7 的解释器(并用它跑 build.py), 不依赖 PATH 顺序。 --- ## 3. 本机关键事实 | 项目 | 实测值 | |---|---| | 系统 / 架构 | Rocky Linux 8.10 / **aarch64** | | 对外地址 | `http://10.80.42.185/QA`(Apache `ProxyPass /QA http://localhost:2080`) | | 数据目录 | `/srv/gitea`(Gitea)、`/srv/pgdata/18/docker`(PG) | | git 用户 | uid/gid = **982:982**(容器内 `USER_UID`/`USER_GID` 必须对齐) | | 库属性 | `UTF8` / `zh_CN.UTF-8` | | 防火墙 | firewalld 已装但**未运行**; SELinux **Disabled** | | Docker | CE **29.8.0**(rhel/8 源), compose 插件 5.5.1 | > ⚠️ **Docker 源必须用 `linux/rhel/8`。** `linux/centos/8` 源在 CentOS 8 EOL 后已冻结在 > `docker-ce 26.1.3`(2024-04), 照抄 CentOS 教程会装到三年前的老引擎。 --- ## 4. 部署(全新主机) ### 4.1 前置条件 - Rocky Linux 8(aarch64), 有 `sudo` / root; - 宿主机已有 Apache 反代到 `127.0.0.1:2080`(本方案不改 Apache); - 规划好数据目录(默认 `/srv/gitea`、`/srv/pgdata`), 确保有空间。 ### 4.2 安装 Docker CE ```bash sudo dnf install -y dnf-plugins-core sudo dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo sudo dnf install -y --allowerasing \ docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin sudo systemctl enable --now docker docker --version && docker compose version ``` **`--allowerasing` 是必需的, 不是可选项。** 首次按常规方式安装会失败: ``` package containerd.io-2.3.5-1.el8.aarch64 conflicts with runc provided by runc-4:1.2.9-6.module+el8.10.0+40310... package containerd.io-2.3.5-1.el8.aarch64 obsoletes runc provided by runc-4:1.2.9-6.module+el8.10.0+40310... package podman-4:4.9.4-37... requires runc >= 1.0.0-57, but none of the providers can be installed ``` 根因(已逐个版本核对 Docker 源的 `primary.xml`): Docker 源内**全部 30 个版本**的 `containerd.io` 都 `Obsoletes` + `Conflicts: runc`, 而 Rocky 8 的 `runc` 被 `containers-common`、`podman`、`buildah` 依赖。**所以这不是版本问题 —— 换老版本 Docker 一样冲突。Docker CE 与系统 podman 只能二选一。** `--allowerasing` 会由 `containerd.io` 取代 `runc`(它自带 runc 二进制), 连带移除 6 个包: `runc` `podman` `podman-catatonit` `buildah` `containers-common` `cockpit-podman`。 > 执行前先确认这些包没在承载东西: `podman ps -a` 为空、无镜像、无 Quadlet 单元, > `cockpit.socket` inactive + disabled。装完 docker-ce 后 podman 与 docker > **不能再共存**; 想要回 podman 必须先卸载 docker-ce。不接受移除的, 见附录 A。 ### 4.3 配置外网代理(dockerd **不**继承 shell 变量) 本机访问 docker.io 必须走代理(7890), 但 **`dockerd` 由 systemd 启动, 不会继承你 shell 里的 `http_proxy`/`https_proxy`** —— 所以 `curl` 能通、`docker build` 却报 `dial tcp ...: i/o timeout`。 雪上加霜的是本机对 `registry-1.docker.io` 的 **DNS 被污染**(实测解析到 `2a03:2800:f10f:83:face:b00c:...`, Facebook 地址段), 直连必然超时; 走 HTTP 代理时由代理 负责解析域名, 反而正常: | 目标 | 直连 | 经代理 `127.0.0.1:7890` | |---|---|---| | `registry-1.docker.io` | `000`(15s 超时) | `401`(0.9s, 正常响应) | | `docker.gitea.com` | `200` | `200` | 代理要配到**三个互相独立**的地方, 缺一个就有一类操作不生效: | 层 | 文件 | 作用 | |---|---|---| | `dockerd` | `/etc/systemd/system/docker.service.d/http-proxy.conf` | 镜像拉取 | | `containerd` | `/etc/systemd/system/containerd.service.d/http-proxy.conf` | 兜底 | | CLI / BuildKit | `~/.docker/config.json` 的 `proxies` 段 | 自动给 `RUN` 步骤注入代理参数 | ```bash # 1) dockerd sudo mkdir -p /etc/systemd/system/docker.service.d sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf >/dev/null <<'EOF' [Service] Environment="HTTP_PROXY=http://127.0.0.1:7890" Environment="HTTPS_PROXY=http://127.0.0.1:7890" Environment="NO_PROXY=localhost,127.0.0.1,::1,.local,.internal" EOF # 2) containerd sudo mkdir -p /etc/systemd/system/containerd.service.d sudo tee /etc/systemd/system/containerd.service.d/http-proxy.conf >/dev/null <<'EOF' [Service] Environment="HTTP_PROXY=http://127.0.0.1:7890" Environment="HTTPS_PROXY=http://127.0.0.1:7890" Environment="NO_PROXY=localhost,127.0.0.1,::1" EOF sudo systemctl daemon-reload sudo systemctl restart containerd docker # 3) CLI / BuildKit(当前用户; 用 sudo 跑 docker 时也要给 root 配一份) mkdir -p ~/.docker cat > ~/.docker/config.json <<'EOF' { "proxies": { "default": { "httpProxy": "http://127.0.0.1:7890", "httpsProxy": "http://127.0.0.1:7890", "noProxy": "localhost,127.0.0.1,::1" } } } EOF sudo cp ~/.docker/config.json /root/.docker/config.json 2>/dev/null || true # 端到端验证 docker pull hello-world ``` > **已知坑: BuildKit 解析 `FROM` 时不走这个代理。** > `docker pull postgres:18.6` 走 dockerd 自己的 registry 客户端, 会遵守上面的 drop-in; > 但 `docker compose build` 里 `[internal] load metadata` 那一步是 **BuildKit** 在解析 > `FROM docker.io/library/postgres:18.6`, 它会**绕过代理直连**, 对 `auth.docker.io` > 做本地 DNS 查询(报 `lookup auth.docker.io on 202.120.190.208:53: i/o timeout`)。 > 本机没有独立 `buildkitd`、没有自定义 builder、没有 `daemon.json`, BuildKit 内嵌在 > dockerd 里 —— 也就是说代理变量在场却未被采用, 属 BuildKit 解析器的行为, 不是配置写错。 > > **规避办法: 先用 `docker pull` 把基础镜像拉到本地**(见 4.5), 之后 BuildKit 直接命中 > 本地镜像, 不再访问 registry。 > 还有**第四件事**: 容器内部的代理(例如让 Gitea 去拉外部头像 / 发外部 webhook)。 > 那是 compose `environment:` 的事。当前 `GITEA_OFFLINE_MODE=true`, 暂不需要。 ### 4.4 配置 `.env` ```bash cd /home/ymy/tjhlp-gitea/deploy cp .env.example .env $EDITOR .env ``` 必须有值的键(其余有默认值): | 键 | 说明 | |---|---| | `GITEA_ROOT_URL` / `GITEA_DOMAIN` | 必须与 Apache 反代一致, 否则克隆地址与链接会错 | | `GITEA_HTTP_PORT` | 必须等于 Apache `ProxyPass` 的目标端口(本机 `2080`) | | `GITEA_APP_NAME` | 站点名, 走**裸变量**(陷阱 3) | | `GITEA_DATA_DIR` / `POSTGRES_DATA_DIR` | 数据落盘位置 | | `GITEA_UID` / `GITEA_GID` | 必须等于数据目录属主(本机 `982:982`) | | `POSTGRES_DB` / `POSTGRES_USER` / `POSTGRES_PASSWORD` | 数据库 | | `GITEA_INTERNAL_TOKEN` / `GITEA_LFS_JWT_SECRET` / `GITEA_OAUTH2_JWT_SECRET` | 密钥, 生成见下 | | `GITEA_SECRET_KEY` | 见 §11; 留空 = 用 Gitea 内置默认值 | ```bash # 生成密钥 docker run --rm docker.gitea.com/gitea:1.27.3 gitea generate secret INTERNAL_TOKEN docker run --rm docker.gitea.com/gitea:1.27.3 gitea generate secret LFS_JWT_SECRET docker run --rm docker.gitea.com/gitea:1.27.3 gitea generate secret JWT_SECRET # -> OAUTH2_JWT_SECRET docker run --rm docker.gitea.com/gitea:1.27.3 gitea generate secret SECRET_KEY ``` **校验配置**(取代了早先的 `preflight.sh`; 只读, 不需要 daemon): ```bash docker compose config --quiet && echo "compose 插值 OK" docker compose config | grep -E 'APP_NAME|ALLOWED_HOST|image:' # 抽查关键项 ``` ### 4.5 启动 ```bash cd /home/ymy/tjhlp-gitea/deploy # ★ 先预拉基础镜像, 绕开 BuildKit 的 FROM 解析(见 4.3) docker pull docker.io/library/postgres:18.6 docker pull docker.gitea.com/gitea:1.27.3 docker compose up -d --build docker compose ps ``` 首次启动 `db` 会 `initdb`(`UTF8` + `zh_CN.UTF-8`), `gitea` 会自动建表。 ### 4.6 验证 ```bash sudo ./scripts/verify.sh ``` 检查: 两个容器 `healthy`、`/api/healthz` 200、`/api/v1/version` 版本正确、经 Apache `/QA` 200。 站点名与登录源可以单独确认: ```bash curl -sS --noproxy '*' http://127.0.0.1:2080/user/login | grep -o '