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

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

👋 欢迎查阅 Stackhero 文档！

Stackhero 提供 Keycloak 云服务，让您仅需 2 分钟即可轻松部署一套可用于生产环境的身份认证服务：

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

专注于开发，而非配置：您可以在 5 分钟内体验 Stackhero 的 Keycloak 云解决方案。

在 Keycloak 管理控制台中，您可以找到 Quick Theme，这是 Keycloak 的可视化主题设计器。上传 Logo，选择配色，预览登录和账户控制台页面，并将最终主题下载为 .jar 文件。

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

themes/acme.jar        becomes     themes/acme/

新主题会出现在 Realm settings > Themes 中。您也可以继续手动编辑其文件。

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