最新Keycloak Docker镜像(v24.0.0)中自定义SPI JAR文件放置位置咨询

核心文件放置路径 #

在基于Quarkus的官方Keycloak 24.0.0 Docker镜像中，自定义SPI的jar文件需放置到容器内的以下路径：

• /opt/keycloak/providers/：Keycloak启动时会自动扫描该目录下的所有jar包，加载其中的SPI实现。

关于META-INF/services/org.keycloak.provider.Spi文件 #

该文件必须打包在你的自定义jar内部，无需单独放置到容器的其他位置。Keycloak会通过Java标准SPI机制自动识别jar内的此文件，从而加载对应的SPI实现类（文件内容需填写你的SPI实现类的全限定名）。

Docker部署方式 #

方式一：本地挂载（适用于开发调试） #

启动容器时通过-v参数将本地的自定义jar映射到容器的providers目录：

docker run -d -p 8080:8080 -v /本地磁盘路径/你的自定义SPI.jar:/opt/keycloak/providers/你的自定义SPI.jar quay.io/keycloak/keycloak:24.0.0 start-dev

方式二：构建自定义镜像（适用于生产环境） #

创建Dockerfile，将自定义jar复制到镜像内的providers目录：

FROM quay.io/keycloak/keycloak:24.0.0
COPY 你的自定义SPI.jar /opt/keycloak/providers/

执行构建命令后，运行生成的镜像即可。

加载验证 #

启动Keycloak后，可通过以下方式确认SPI是否加载成功：

• 登录管理控制台，进入Providers菜单查看是否存在你的SPI条目
• 调用Keycloak的REST API（如/admin/realms/master/providers）检查SPI列表

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