如何在JBoss Keycloak Docker镜像中通过命令行启用token-exchange等功能

核心原因 #

你使用的jboss/keycloak是基于WildFly的旧版Keycloak，而官方文档里的kc.sh/kc.bat是Quarkus架构的新版Keycloak（如quay.io/keycloak/keycloak）专属命令，旧版镜像中根本不存在这个文件，所以找不到是正常的。

解决方案 #

方案一：改用新版Quarkus架构Keycloak镜像（推荐） #

新版Keycloak已停止维护旧版WildFly架构，建议直接切换到官方新版镜像，启动时可直接指定启用所需功能：

docker run -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin123 quay.io/keycloak/keycloak:latest start-dev --features=token-exchange,impersonation

注意：新版环境变量已变更，KEYCLOAK_USER改为KEYCLOAK_ADMIN，KEYCLOAK_PASSWORD改为KEYCLOAK_ADMIN_PASSWORD。

方案二：在旧版jboss/keycloak中启用Impersonation功能 #

如果暂时无法切换版本，可通过控制台配置启用功能：

• 访问Keycloak管理控制台：http://localhost:8080/auth/admin，用admin账号登录
• 进入目标Realm，点击左侧菜单的Realm Settings
• 切换到Features标签页
• 找到Impersonation选项并勾选，保存设置
• 若需要启用token-exchange功能，同样在该标签页找到对应选项勾选即可

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