Keycloak容器化连接Postgres套接字失败问题求助

核心结论 #

Keycloak支持通过Unix套接字连接PostgreSQL，但你的环境变量配置方式有误，DB_ADDR无法直接指定套接字路径，需要手动配置JDBC URL。

问题原因 #

Keycloak的DB_ADDR环境变量是用于指定数据库的主机名/IP地址，并非Unix套接字路径。当你设置DB_ADDR=/var/run/postgresql/.s.PGSQL.5432时，Keycloak会尝试将其作为主机名去解析，直接导致连接失败。

正确配置方式 #

PostgreSQL JDBC驱动（Keycloak底层依赖）支持通过URL参数指定Unix套接字目录，你需要放弃自动构建JDBC URL的方式，手动指定JDBC_URL环境变量：

Keycloak环境变量调整 #

DB_VENDOR=POSTGRES
JDBC_URL=jdbc:postgresql:///keycloak?host=/var/run/postgresql
DB_USER=postgres
DB_PASSWORD=postgres
DB_SCHEMA=public

• jdbc:postgresql:///keycloak中的///表示本地连接，省略主机名
• host=/var/run/postgresql指定PostgreSQL套接字所在的目录（驱动会自动查找目录下的.s.PGSQL.5432套接字文件）

额外注意事项 #

1. 套接字路径挂载：确保Keycloak容器能访问到PostgreSQL的套接字目录。如果PostgreSQL也是容器，需要将Postgres容器的/var/run/postgresql目录通过卷或绑定挂载共享给Keycloak容器，例如：

   # 创建共享卷
   docker volume create postgres-socket
   # 启动Postgres容器时挂载卷
   docker run -v postgres-socket:/var/run/postgresql ... postgres
   # 启动Keycloak容器时挂载同一份卷
   docker run -v postgres-socket:/var/run/postgresql ... keycloak
   

2. 权限问题：Keycloak容器的运行用户（通常是keycloak或jboss）需要拥有读取套接字目录及文件的权限。可以：
   • 调整Postgres容器的套接字目录权限为777（仅测试环境建议使用）
   • 确保两个容器的运行用户UID一致，避免权限拒绝

内容的提问来源于stack exchange，提问作者somerandomguyontheinternet