使用Keycloak Docker镜像时，如何设置PostgreSQL数据库模式？

我来帮你搞定这个问题——完全可以让Keycloak把表放到你指定的PostgreSQL模式里，核心是通过配置Hibernate的参数来实现，下面给你两种实用的方法：

方法一：通过环境变量快速配置（推荐） #

Keycloak支持直接通过环境变量传递Hibernate的配置属性，这是最简单的方式：

1. 先在PostgreSQL中准备好目标模式
   先登录你的PostgreSQL数据库，创建自定义模式并给Keycloak使用的数据库用户授权（必须确保用户有该模式的读写、建表权限）：

   -- 创建你的自定义模式，比如叫keycloak_schema
   CREATE SCHEMA IF NOT EXISTS keycloak_schema;
   -- 给Keycloak用户授予该模式的所有权限
   GRANT ALL PRIVILEGES ON SCHEMA keycloak_schema TO keycloak_db_user;
   

2. 启动Keycloak容器时添加模式配置
   在docker run命令里加入KC_HIBERNATE_ORM_DEFAULT_SCHEMA环境变量，指定你的目标模式：

   docker run -d \
     --name keycloak \
     -e KC_DB=postgres \
     -e KC_DB_URL=jdbc:postgresql://your-postgres-host:5432/keycloak_db \
     -e KC_DB_USERNAME=keycloak_db_user \
     -e KC_DB_PASSWORD=your_db_password \
     -e KC_HIBERNATE_ORM_DEFAULT_SCHEMA=keycloak_schema \
     -e KC_BOOTSTRAP_ADMIN_USERNAME=admin \
     -e KC_BOOTSTRAP_ADMIN_PASSWORD=admin \
     -p 8080:8080 \
     quay.io/keycloak/keycloak:latest start
   

   这样启动后，Keycloak就会自动把所有表创建在keycloak_schema模式下，而不是默认的public。

方法二：自定义Hibernate配置文件（适合复杂需求） #

如果需要更精细的Hibernate配置，可以挂载自定义的配置文件到容器中：

1. 创建自定义的hibernate.cfg.xml
   在本地创建一个配置文件，添加模式指定的属性：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE hibernate-configuration PUBLIC
           "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
           "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
   <hibernate-configuration>
       <session-factory>
           <!-- 指定目标模式 -->
           <property name="hibernate.default_schema">keycloak_schema</property>
           <!-- 其他你需要的Hibernate配置可以加在这里 -->
       </session-factory>
   </hibernate-configuration>
   

2. 挂载配置文件到Keycloak容器
   启动容器时，把本地的配置文件挂载到Keycloak的配置目录（最新版本的路径是/opt/keycloak/conf/）：

   docker run -d \
     --name keycloak \
     -e KC_DB=postgres \
     -e KC_DB_URL=jdbc:postgresql://your-postgres-host:5432/keycloak_db \
     -e KC_DB_USERNAME=keycloak_db_user \
     -e KC_DB_PASSWORD=your_db_password \
     -e KC_BOOTSTRAP_ADMIN_USERNAME=admin \
     -e KC_BOOTSTRAP_ADMIN_PASSWORD=admin \
     -p 8080:8080 \
     -v ./hibernate.cfg.xml:/opt/keycloak/conf/hibernate.cfg.xml \
     quay.io/keycloak/keycloak:latest start
   

注意事项 #

• 如果是已经运行过的Keycloak实例，想要迁移到自定义模式：需要先把public模式下的表迁移到目标模式，再修改配置重启，否则会出现表找不到的错误。
• 旧版本Keycloak（17.x之前）的环境变量名不同，比如用DB_SCHEMA代替KC_HIBERNATE_ORM_DEFAULT_SCHEMA，如果用的是旧版本请对应调整。
• 始终确保数据库用户对目标模式有足够的权限，否则Keycloak启动时会抛出权限不足的异常。

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