在Linux服务器通过docker-compose部署Keycloakify自定义主题Jar包

步骤1：配置持久化扩展目录（推荐） #

如果你的docker-compose.yaml未配置providers目录挂载，先完成以下操作：

• 在docker-compose.yaml所在目录创建本地目录：mkdir -p ./keycloak-providers
• 编辑docker-compose.yaml，找到Keycloak服务的volumes节点，添加挂载规则：

  services:
    keycloak:
      # 保留原有配置
      volumes:
        # 新增挂载项
        - ./keycloak-providers:/opt/keycloak/providers
  

步骤2：移动主题Jar到挂载目录 #

将已上传到服务器的自定义主题Jar文件，移动到刚才创建的keycloak-providers目录：

mv /path/to/your/custom-theme.jar ./keycloak-providers/

调整文件权限确保容器可读取：chmod 644 ./keycloak-providers/custom-theme.jar

步骤3：重启Keycloak容器 #

让Keycloak加载新的主题扩展：

docker-compose restart keycloak

若服务名不是keycloak，替换为实际名称：docker-compose restart <your-keycloak-service-name>

步骤4：验证主题生效 #

• 登录Keycloak管理后台，进入目标Realm的Realm Settings → Themes
• 在Login、Account等主题选项的下拉菜单中，确认是否出现你的自定义主题名称
• 若需排查问题，查看容器日志确认加载状态：

  docker-compose logs keycloak | grep "custom-theme"
  

临时方案（容器重建后失效） #

若不想修改docker-compose配置，可直接将Jar复制到容器内部：

1. 查找Keycloak容器名称：docker ps | grep keycloak
2. 复制Jar到容器providers目录：

   docker cp /path/to/custom-theme.jar <container-name>:/opt/keycloak/providers/
   

3. 重启容器：docker restart <container-name>

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