Vagrant环境下JupyterHub对接Keycloak出现ERR_TOO_MANY_REDIRECTS报错
JupyterHub+Keycloak对接ERR_TOO_MANY_REDIRECTS问题排查
这个重定向死循环100%是你配置oauth_callback_url时概念混淆填错导致的,和Keycloak启动配置、Vagrant端口转发没有直接关系。
错误根源定位
- 你把Keycloak的授权端点地址,直接当成了
oauth_callback_url填进了JupyterHub配置,核心是没区分清楚OAuth2授权流程中两类地址的职责:- 授权端点(也就是你现在填到callback里的
.../openid-connect/auth):是JupyterHub需要把用户重定向过去的Keycloak登录页地址,属于授权流程的发起端,不是回调地址。GenericOAuthenticator会自动根据你配置的token、userdata地址推断出这个授权URL,不需要手动填写。 oauth_callback_url:是Keycloak完成用户身份校验、拿到授权码后,需要回跳访问的JupyterHub侧固定接口地址,格式永远是http://<JupyterHub的可访问地址>/hub/oauth_callback,路径里绝对不能出现Keycloak的相关路径。
- 授权端点(也就是你现在填到callback里的
- 错配callback后,授权流程会直接歪成死循环:JupyterHub收到未登录用户的访问请求→本应跳转到Keycloak登录页→却按照错配的callback值生成了跳转参数→最终形成"JupyterHub登录页→Keycloak授权页→再跳回JupyterHub登录页"的无限跳转,触发浏览器的重定向次数超限报错。从你贴的日志也能看到,连续三次302跳转的目标完全是同一个带Keycloak auth路径的地址,根本没有进入正常的Keycloak授权流程。
其他连带的配置问题
- 所有Keycloak服务地址都写了
0.0.0.0:这是服务端的网卡监听地址,不是可路由的访问地址。因为Keycloak和JupyterHub跑在同一个Vagrant虚拟机里,虚拟机内部服务互访应该用127.0.0.1作为地址。 client_secret配置为空:哪怕回调地址改对,这一项为空也会导致授权码换token失败,触发新的认证循环。- Vagrant端口转发遗漏:当前的转发规则只配了8000、8001、8081,没有转发Keycloak运行的8180端口,后续不管是宿主机访问Keycloak管理后台,还是Keycloak回跳JupyterHub的连通性校验都可能出问题。
修正后的配置参考
调整后的jupyterhub_config.py
c.Authenticator.admin_users = {'vagrant'} from oauthenticator.generic import GenericOAuthenticator c.JupyterHub.authenticator_class = GenericOAuthenticator # 修正为JupyterHub侧的回调地址,对应Vagrant转发的宿主机8000端口(映射guest的8000端口运行JupyterHub) c.GenericOAuthenticator.oauth_callback_url = 'http://127.0.0.1:8000/hub/oauth_callback' c.GenericOAuthenticator.client_id = 'oauth-secret' # 替换为Keycloak客户端配置页生成的实际密钥值 c.GenericOAuthenticator.client_secret = '你的Keycloak客户端对应密钥值' # 虚拟机内部互访Keycloak服务使用127.0.0.1地址,替换原来的0.0.0.0 c.GenericOAuthenticator.token_url = 'http://127.0.0.1:8180/auth/realms/testrealm/protocol/openid-connect/token' c.GenericOAuthenticator.userdata_url = 'http://127.0.0.1:8180/auth/realms/testrealm/protocol/openid-connect/userinfo'
配套调整项
- Keycloak侧:找到realm下对应的
oauth-secret客户端,把Valid Redirect URIs配置为和JupyterHub callback完全一致的http://127.0.0.1:8000/hub/oauth_callback,不能有路径、端口的偏差。 - Vagrantfile里补充Keycloak端口转发规则:
config.vm.network "forwarded_port", guest: 8180, host: 8180
内容的提问来源于stack exchange,提问作者freir96
相关产品推荐
相关产品推荐

