Remotely项目PostgreSQL连接字符串配置问题解析

问题背景

在使用Remotely项目时，许多开发者在配置PostgreSQL数据库连接时遇到了"Name or service not known"的错误。这个问题主要出现在Docker容器环境中，当尝试通过容器名称连接PostgreSQL服务时，系统无法解析主机名。

错误现象

当使用类似以下的Docker Compose配置时，Remotely服务启动时会抛出SocketException异常，提示无法解析主机名：

environment:
  - Remotely_ConnectionStrings__PostgreSQL=Server=Host=remotely.postgres;Port=5501;Database=remotely;Username=postgres;Password=test123!!@@~~;

错误堆栈显示系统在尝试解析主机名时失败，导致无法建立数据库连接。

问题根源

经过分析，这个问题源于连接字符串格式的错误配置。在Npgsql（PostgreSQL的.NET数据提供程序）中，连接字符串的正确格式应该是：

Host=服务器地址;Port=端口号;Database=数据库名;Username=用户名;Password=密码;

而许多开发者错误地使用了SQL Server风格的连接字符串格式，在前面加上了"Server="前缀，这会导致Npgsql无法正确解析连接参数。

解决方案

正确的PostgreSQL连接字符串配置应该是：

environment:
  - Remotely_ConnectionStrings__PostgreSQL=Host=remotely.postgres;Port=5501;Database=remotely;Username=postgres;Password=test123!!@@~~;

安全增强建议

为了增强连接安全性，建议在生产环境中添加SSL加密选项：

environment:
  - Remotely_ConnectionStrings__PostgreSQL=Host=remotely.postgres;Port=5501;Database=remotely;Username=postgres;Password=test123!!@@~~;SSL Mode=Require;

完整Docker Compose示例

以下是经过验证的正确配置示例：

version: '3.4'

services:
  remotely:
    image: immybot/remotely:latest
    restart: unless-stopped
    volumes:
      - ../data:/app/AppData
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_HTTP_PORTS=5000
      - Remotely_ApplicationOptions__DbProvider=PostgreSQL
      - Remotely_ConnectionStrings__PostgreSQL=Host=remotely.postgres;Port=5432;Database=remotely;Username=postgres;Password=test123!!@@~~;SSL Mode=Require;
    depends_on:
      - remotely.postgres

  remotely.postgres:
    image: postgres:16.2
    restart: unless-stopped
    environment:
      - POSTGRES_DB=remotely
      - POSTGRES_PASSWORD=test123!!@@~~
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

技术要点总结

1. PostgreSQL连接字符串格式与SQL Server不同，不应包含"Server="前缀
2. 在Docker环境中，可以使用容器名称作为主机名进行服务发现
3. 端口配置应与PostgreSQL容器内部端口(5432)一致，外部映射端口仅用于主机访问
4. SSL加密是生产环境中的推荐配置
5. 确保网络配置正确，相关服务在同一个Docker网络中

通过遵循这些配置原则，可以避免PostgreSQL连接问题，确保Remotely项目能够正常访问数据库服务。