Ghostfolio自托管部署中PostgreSQL认证失败的解决方案

在自托管部署Ghostfolio时，许多用户遇到了PostgreSQL数据库认证失败的问题。本文将深入分析该问题的成因，并提供完整的解决方案。

问题现象

当用户尝试通过Docker Compose部署Ghostfolio时，容器日志中会出现以下关键错误信息：

Error: P1000: Authentication failed against database server at `postgres`

同时PostgreSQL容器的日志会显示：

FATAL: password authentication failed for user "user"

根本原因分析

1. 环境变量配置问题：在.env文件中配置的数据库凭证与实际创建的数据库不匹配
2. 数据卷残留问题：之前部署残留的PostgreSQL数据卷保留了旧的认证信息
3. 网络连接问题：容器间网络通信配置不当导致连接失败

完整解决方案

第一步：彻底清理环境

# 停止所有相关容器
docker compose down

# 删除可能残留的数据卷
docker volume rm ghostfolio_postgres

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

确保.env文件包含以下关键配置且各参数一致：

POSTGRES_DB=ghostfolio-db
POSTGRES_USER=user
POSTGRES_PASSWORD=your_secure_password

第三步：验证Docker Compose配置

检查docker-compose.yml中的数据库连接URL格式应为：

DATABASE_URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB}

第四步：顺序启动服务

1. 先启动PostgreSQL容器并等待健康检查通过
2. 再启动Ghostfolio应用容器

docker compose up -d postgres
# 等待postgres健康状态变为healthy
docker compose up -d ghostfolio

高级排查技巧

如果问题仍然存在，可以尝试以下方法：

1. 手动验证数据库连接：

docker exec -it ghostfolio-postgres-1 psql -U user -d ghostfolio-db

2. 检查网络连通性：

docker exec ghostfolio-ghostfolio-1 ping postgres

3. 查看PostgreSQL用户列表：

docker exec ghostfolio-postgres-1 psql -U postgres -c "\du"

最佳实践建议

1. 首次部署时建议使用全新的数据卷
2. 密码应包含大小写字母、数字和特殊字符
3. 考虑使用docker-compose的depends_on条件确保服务启动顺序
4. 生产环境建议配置PostgreSQL的持久化存储

通过以上步骤，大多数认证问题都能得到解决。如果仍有问题，建议检查PostgreSQL的pg_hba.conf文件配置是否正确。