Keycloak主题文件夹无核心文件，如何为注册页添加自定义属性？

你碰到的问题是因为默认主题文件夹不会直接提供可修改的模板文件，Keycloak推荐通过复制默认主题来创建自定义主题，再进行修改，具体步骤如下：

• 定位Keycloak的主题目录：找到你的Keycloak安装路径，进入themes文件夹，里面的keycloak是官方默认主题，base是基础主题模板。
• 创建自定义主题：在themes下新建一个文件夹（比如my-custom-login-theme），然后把keycloak/login目录完整复制到my-custom-login-theme下，此时你就能看到register.ftl、messages等文件了。
• 后台配置自定义主题：登录Keycloak管理控制台，进入你正在使用的Realm，点击「Realm设置」→「主题」，把「登录主题」选项改成你刚创建的my-custom-login-theme，保存配置。
• 添加自定义用户属性：
  1. 先在管理控制台的「Realm」→「用户」→「属性」页面，添加你需要的自定义属性（比如nickname）。
  2. 打开my-custom-login-theme/login/register.ftl，在合适的位置（比如邮箱输入框下方）添加对应的输入框代码：

  <div class="form-group">
      <label for="nickname" class="col-md-2 control-label">${msg("nickname")}</label>
      <div class="col-md-10">
          <input type="text" class="form-control" id="nickname" name="user.attributes.nickname" value="${(register.formData['user.attributes.nickname']!'')}" />
      </div>
  </div>
  

• 补充翻译文案：进入my-custom-login-theme/login/messages文件夹，修改messages_en.properties和messages_zh_CN.properties，添加nickname=昵称（英文对应nickname=Nickname），确保前端显示正确的文本。
• 重启Keycloak（开发模式下修改模板可能自动生效，生产环境建议重启服务）。

另外注意：不要直接修改keycloak或base主题，下次Keycloak升级时这些修改会被覆盖，自定义主题是更安全的方式。

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