更新日志 2025-11-18

# 更新内容
 - 完成本地交叉编译：在 packages/gitea-service-v125/gitea 里用 GOOS=linux GOARCH=amd64 TAGS="bindata" make build 生成 Linux/amd64 版 Gitea 1.25.0，并校验产物为静态 ELF。
  - 传输与备份：上传新二进制至 /data/gitea-backups/gitea-1.25.0，停机后将旧可执行文件挪至 /data/gitea-backups/gitea-old-20251118-090113；执行 pg_dump 与 tar，生成 /data/
    gitea-backups/20251118-085842/{giteadb.dump,gitea-files.tar.gz} 作为数据库及 custom/data/log/cert 目录的备份。
  - 服务切换与权限：停止 gitea.service、cf-gitea.service，替换 /data/gitea/gitea，并设置 setcap cap_net_bind_service=+ep /data/gitea/gitea 以继续监听 80/443；重新启动
    gitea，确认 ss -tulpn 显示端口正常。
  - Cloudflared 清理：停止并 systemctl disable cf-gitea.service，确保目前只有 gitea 监听外部端口。
  - 配置调整：更新 custom/conf/app.ini:84 的 DEFAULT_ACTIONS_URL = github（旧值 https://gitea.com），再次重启服务，启动日志不再提示回退。
  - 功能验证：curl https://gitea.ktyun.cc/api/v1/version 返回 {"version":"1.25.0"}；从 https://gitea.ktyun.cc/Kysion/test-runner.git 成功克隆仓库，确认基本 Git/HTTP 功能
    正常。

# 部署过程
准备情况

- 已确认服务器 gitea.service 由 systemd 管理，命令 ExecStart=/data/gitea/gitea web --config /data/gitea/custom/conf/app.ini，运行用户 gitea，监听 HTTPS 443（/data/gitea/
    custom/conf/app.ini:1-40），与现网端口一致。
  - 服务器为 x86_64 Linux 6.8，Go 进程 PID 121936，数据、仓库、日志、证书等都集中在 /data/gitea/{data,custom,log,cert}（ls /data/gitea 输出）。这些目录将作为备份重点，确保
    所有数据仍驻留在数据盘。
  - 数据库仍是本机 PostgreSQL（app.ini [database]），凭证和端口均在该文件中；升级时会复用原配置，不改端口、DB 信息。
  - 需要执行的验证仓库为 https://gitea.ktyun.cc/Kysion/test-runner.git，升级完成后可用其脚本对 API/CI/CD 做快速回归。

部署要点

- 本地环境具备 Go 1.25.x 与 Node 24，可通过 GOOS=linux GOARCH=amd64 TAGS="bindata" make build 交叉编译，生成与服务器兼容的新二进制。
  - 部署流程拟定：
      1. 预编译并校验新版本 gitea 二进制（含 commit 信息）。
      2. 服务器上依次备份 /data/gitea/gitea、/data/gitea/custom/conf/app.ini、/data/gitea/{custom,data,log,cert}（打包 gz+保留 SQL dump）。
      3. systemctl 停止 gitea.service，替换二进制与必要的静态资源（保持 custom/ 不变）。
      4. 启动服务并观察日志，确认自动迁移完成、端口仍为 443。
      5. 使用 test-runner 仓库及基本 UI/API 手动验证（登录、仓库克隆、Project API、新建 Issue 等）。
      6. 恢复 Cloudflared/外部代理依赖（已看到 cloudflared tunnel run gitea 进程，需确保其继续运行）。

# 部署结果
  - 已在本地通过 GOOS=linux GOARCH=amd64 TAGS="bindata" make build 交叉编译了新版二进制，上传到 /data/gitea-backups/gitea-1.25.0，并替换 /data/gitea/gitea；旧版备份保存在 /
  - 停止并禁用了 cf-gitea.service（Cloudflared 隧道），仅保留 gitea 服务；由于新二进制缺乏低端口权限，已执行 setcap cap_net_bind_service=+ep /data/gitea/gitea，随后

- curl -sk https://gitea.ktyun.cc/api/v1/version 返回 {"version":"1.25.0"}，说明外部入口已切换到新版本。
  - 成功克隆 https://gitea.ktyun.cc/Kysion/test-runner.git 至 /tmp/test-runner（仓库仅含 test.txt），验证基本 Git 读操作可用。
  - journalctl -u gitea 当前只剩 [actions] DEFAULT_ACTIONS_URL 的提示，其余未见异常；如需更深层 API/项目功能验证，需要提供可用的访问令牌。