CSGHub项目中Gitea容器反复重启问题的分析与解决

问题现象

在部署CSGHub项目时，用户遇到了gitea容器反复重启的问题。容器每隔几秒就会自动重启一次，导致服务无法正常使用。通过查看容器日志，发现主要存在两个关键错误：一是服务器URL配置错误，二是数据库初始化问题。

根本原因分析

经过深入排查，发现该问题主要由以下两个因素共同导致：

1. 环境变量配置错误：SERVER_DOMAIN环境变量未正确设置，导致Gitea的ROOT_URL和SSH_DOMAIN配置异常，表现为URL路径中出现"http:///gitserver"这样的错误格式。

2. 数据持久化问题：Gitea容器没有配置持久化存储卷，导致每次容器重启时都会尝试重新初始化数据库。当检测到已有数据库存在时，会触发"existing Gitea database"错误，形成重启循环。

解决方案

第一步：正确配置环境变量

在启动容器前，必须设置SERVER_DOMAIN环境变量：

export SERVER_DOMAIN=${server_ip}

第二步：配置数据持久化

修改all-in-one.yml文件，为gitea服务添加持久化存储卷配置：

volumes:
  - ./data/gitea:/bitnami/gitea

然后为数据目录设置适当权限：

chmod -R 777 data

第三步：数据库修复流程

1. 备份现有数据：

pg_dump -U postgres gitea > gitea.pgsql

2. 清理并重建数据库：

psql -U postgres
DROP DATABASE gitea;
CREATE DATABASE gitea;
\q

3. 重启服务：

docker compose -f all-in-one.yml up -d

4. 恢复数据：

psql -U postgres gitea < gitea.pgsql

第四步：系统数据修复

进入csghub-server容器执行修复命令：

./starhub trigger fix-org-data

第五步：Gitea后台配置

访问Gitea管理界面（http://${server_ip}/gitserver），完成以下配置：

1. 创建管理员账户admin001
2. 创建必要的组织（datasets_admin001、modals_admin001等）

经验总结

1. 容器化部署注意事项：对于有状态服务如Gitea，必须配置持久化存储卷，否则容器重启会导致数据丢失。

2. 环境变量验证：在部署前应验证所有必需环境变量是否已正确设置，特别是涉及URL和域名的配置。

3. 数据库迁移策略：在容器化环境中，数据库迁移应采取"备份-清理-恢复"的标准流程，确保数据一致性。

4. 权限管理：容器挂载的宿主机目录需要设置适当权限，避免因权限问题导致服务异常。

通过以上步骤的系统性修复，可以彻底解决CSGHub项目中Gitea容器反复重启的问题，确保服务稳定运行。