Awesome-TTRSS项目数据库连接超时问题分析与解决方案

问题背景

在使用Awesome-TTRSS项目时，用户将PostgreSQL数据库从原有docker-compose配置中分离出来独立部署后，出现了TTRSS服务连接数据库超时的问题。具体表现为TTRSS容器持续输出"Operation timed out"错误日志，而直接进入PostgreSQL容器验证数据库服务却是正常的。

技术分析

1. 架构变化对比

原架构中，TTRSS和PostgreSQL在同一docker-compose文件中定义，共享默认网络，可以通过服务名直接通信。分离后，两个服务位于不同的docker-compose项目中，形成了网络隔离。

2. 根本原因

问题的核心在于Docker网络隔离机制：

• 不同docker-compose项目默认创建独立的网络命名空间
• 跨项目服务无法通过服务名称直接解析
• 虽然PostgreSQL容器暴露了5432端口，但TTRSS容器仍尝试通过服务名"postgres"连接

3. 解决方案验证

通过检查发现：

• 数据库容器内部服务正常
• 数据库表结构完整
• 连接凭据配置正确 确认问题确实出在网络连通性上

解决方案

方案一：使用外部网络（推荐）

1. 创建共享网络：

docker network create ttrss-network

2. 修改PostgreSQL的docker-compose：

services:
  postgres:
    networks:
      - ttrss-network
networks:
  ttrss-network:
    external: true

3. 修改TTRSS的docker-compose：

services:
  service.rss:
    networks:
      - ttrss-network
networks:
  ttrss-network:
    external: true

方案二：使用主机网络模式

修改TTRSS的DB_HOST指向宿主机IP：

environment:
  - DB_HOST=宿主机IP

方案三：使用links连接（旧版Docker）

services:
  service.rss:
    links:
      - postgres

最佳实践建议

1. 多容器协作时，建议使用自定义网络而非默认网络
2. 生产环境应考虑：
   • 网络安全性配置
   • 连接池优化
   • 超时参数调整
3. 变更架构时，建议先进行网络连通性测试

总结

Docker网络隔离是微服务架构中的常见问题。通过合理配置Docker网络，可以确保服务间可靠通信。本例展示了如何解决跨docker-compose项目的服务连接问题，该方案同样适用于其他需要服务分离的场景。