9.3. 配置数据库


对于每个支持的数据库,服务器提供了一些建议的默认值来简化数据库配置。您可以通过提供一些关键设置(如数据库主机和凭证)来完成配置。

可以在 构建 命令或 start 命令中设置配置:

  1. 使用 构建 命令,后跟一个优化的 start 命令(推荐)

    首先,在 conf/keycloak.conf 中指定连接到数据库所需的最小设置:

    # The database vendor.
    db=postgres
    
    # The username of the database user.
    db-username=keycloak
    
    # The password of the database user.
    db-password=change_me
    
    # Sets the hostname of the default JDBC URL of the chosen vendor
    db-url-host=keycloak-postgres
    Copy to Clipboard Toggle word wrap

    然后,以下命令会根据配置选项创建一个新的和优化的服务器镜像,并启动服务器。

    bin/kc.[sh|bat] build
    bin/kc.[sh|bat] start --optimized
    Copy to Clipboard Toggle word wrap
  2. 仅使用 start 命令(没有 优化的

    bin/kc.[sh|bat] start --db postgres --db-url-host keycloak-postgres --db-username keycloak --db-password change_me
    Copy to Clipboard Toggle word wrap
警告

上面的示例包括连接到数据库所需的最小设置,但它会公开数据库密码,我们不建议这样做。使用如上所示的 conf/keycloak.conf、环境变量或密钥存储(至少为密码)。

默认模式是 keycloak,但您可以使用 db-schema 配置选项更改它。

导入和导出域或 Bootstrapping 并在恢复管理员帐户 时,也可以配置数据库:

bin/kc.[sh|bat] import --help
bin/kc.[sh|bat] export --help
bin/kc.[sh|bat] bootstrap-admin --help
Copy to Clipboard Toggle word wrap

如需更多信息,请参阅配置红帽构建的 Keycloak

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat