Keycloak: 用 Quick Theme 可视化设计主题

本文件是自定义外观指南的一部分。您可以在这里查看完整指南:在 Stackhero 上轻松为您的 Keycloak 登录页面、账户控制台和邮件进行品牌化:设置您的颜色、Logo、文本,甚至可通过内置在线编辑器创建完整的自定义主题。

👋 欢迎来到 Stackhero 文档!

Stackhero 提供 Keycloak cloud 服务,让您仅需 2 分钟即可轻松部署可用于生产环境的身份认证服务:

  • 无限制的用户、realm 和 client
  • 支持 OpenID ConnectOAuth 2.0SAML 2.0、社交登录、LDAP 及 Active Directory 联邦
  • 自定义域名,内置 HTTPS,确保安全访问(例如,https://login.your-company.com
  • 自定义主题:通过内置在线编辑器,轻松定制您的登录页面、账户控制台和邮件内容
  • 专属 email 服务器,支持 SPF、DKIM 和 DMARC,自动处理账户确认和密码重置
  • 内置 PostgreSQL 数据库,管理控制台可通过独立端口访问并可关闭
  • 一键升级,让您的系统始终保持最新,无需手动操作

专注于开发,而不是配置:您可以在 5 分钟内体验 Stackhero 的 Keycloak cloud 解决方案

在 Keycloak 管理控制台中,您会找到 Quick Theme,即 Keycloak 的可视化主题设计器。上传 Logo,选择颜色,预览登录和账户控制台,最后可将主题下载为 .jar 文件。

安装方法:通过编辑器将该文件放入 themes/ 目录,然后重启服务。.jar 文件会被解压为主题目录,原归档文件会被删除:

themes/acme.jar        becomes     themes/acme/

新主题会出现在 Realm settings > Themes。如需,您可继续手动编辑其文件。

此方法同样支持用 Keycloakify 构建的主题或设计师提供的主题。任何包含主题的 .jar.zip 文件都可用此方式安装。如果已有同名主题,新主题会以 acme-1 安装,确保不会覆盖您的现有工作。如果文件不是主题,则会被忽略,Keycloak 正常启动。