宝塔通过docker部署JupyterHub指南【常见错误处理】

发布于:2025-07-26 ⋅ 阅读:(22) ⋅ 点赞:(0)

先贴一张成功的截图
在这里插入图片描述
大多数人会卡到两个地方

  • 安装成功之后登录不上去(无论什么账号密码均无效)
  • 登录上去发现服务无法启动(说是什么无响应就是连不上)

问题1

登录上去主要是因为配置文件中的配置和容器中的账号密码不对应
解决办法:

  • 进入容器,创建用户,并且设置密码
# useradd test
# passwd test
  • 去jupyterhub_config.py编写配置(密码要和你刚刚设置的密码一样,我这里是test)
# 管理员用户列表
c.Authenticator.admin_users = {'test'}

#c.Authenticator.admin_users = {'root'}  # 管理员用户
c.DummyAuthenticator.password = "test"  # 初始密码设置
c.Authenticator.allow_all = True
  • 设置完之后记得重启容器
    到此为止你会发现,使用你刚刚设置的test/test可以登录

问题2

无法创建服务的问题在于,三方库的缺失,如果你仔细观察安装日志的话,会发现有些包没有安装成功,因此绝大多数情况下,只需要执行以下命令即可

pip install jupyterhub --upgrade
pip install notebook --upgrade

安装的时候,为了速度和稳定,你可以使用国内源,怎么用国内源自行百度,可以换着试,知道安装成功为止,安装完了重启容器

最后

想用中文版的,在容器里面直接安装中文包就行,安装完了刷新浏览器即可,无需重启

pip install jupyterlab-language-pack-zh-CN

下面的AI生成的,喜欢那个看那个

成功安装截图:
JupyterHub安装成功截图

常见问题及解决方案:


问题1:登录失败

症状:安装完成后无法登录(任何账号密码均无效)

原因:配置文件与容器内账号密码不匹配

解决方案

  1. 进入容器创建用户并设置密码
useradd test
passwd test
  1. 修改jupyterhub_config.py配置(密码需与创建的用户密码一致)
# 管理员用户配置
c.Authenticator.admin_users = {'test'}
c.DummyAuthenticator.password = "test"  # 设置登录密码
c.Authenticator.allow_all = True
  1. 重启容器后即可使用test/test登录

问题2:服务启动失败

症状:登录后服务无响应

原因:第三方依赖包未完整安装

解决方案

# 升级必要组件
pip install jupyterhub --upgrade
pip install notebook --upgrade

# 建议使用国内镜像源加速安装(如清华源、阿里源等)

安装完成后务必重启容器


额外提示

如需切换中文界面,安装语言包后刷新浏览器即可:

pip install jupyterlab-language-pack-zh-CN

网站公告

今日签到

点亮在社区的每一天
去签到