首先,打开官网帮助文档:
JupyterHub 官方安装帮助文档
一般安装都是参考官方最新版安装文档。
本次安装 JupyterHub的软件环境:
安装 nodejs/npm:
如果使用conda:conda 将为您安装 nodejs 和 npm 依赖项。
如果您正在使用pip,请安装最新版本的 nodejs/npm。
例如,使用以下命令在 Linux 上安装:
sudo apt-get install nodejs npm
也可以yum安装
sudo yum install npm nodejs
安装完成后, 通过 node -v
和 npm -v
来查看是否安装成功。
JupyterHub安装可以用pip命令(和代理npm)或conda命令:
pip命令:npm:
python3 -m pip install jupyterhub
npm install -g configurable-http-proxy
python3 -m pip install jupyterlab notebook
conda命令:
conda install -c conda-forge jupyterhub
conda install jupyterlab notebook
安装完成后执行 jupyterhub --version
来查看是否安装成功。
按照官方配置文档一步一步配置即可:
JupyterHub 官方环境配置帮助
首先通过jupyterhub --generate-config命令生成配置文件jupyterhub_config.py,下面的配置参数都是写在jupyterhub_config.py文件中的:
import sys
# configurable_http_proxy 代理设置
c.ConfigurableHTTPProxy.should_start = True #允许hub启动代理 可以不写,默认的,为False 就需要自己去 启动configurable-http-proxy
c.ConfigurableHTTPProxy.api_url = 'http://127.0.0.1:8001' # proxy与hub与代理通讯,这应该是默认值不行也行
# 对外登录设置的ip
c.JupyterHub.ip = '0.0.0.0'
c.JupyterHub.port = 8000
c.PAMAuthenticator.encoding = 'utf8'
# 用户名单设置,默认身份验证方式PAM与NUIX系统用户管理层一致,root用户可以添加用户test1,test2等等,非root用户,sudo useradd test1/test2 不起作用,目前我不知道sudo useradd 和 root下 useradd本质区别*(没有特意学过linux,一切只靠用时百度)
# c.Authenticator.allowed_users = {'test1', 'test2'}
c.Authenticator.admin_users = {'jupyterhub'} # 管理员用户
c.DummyAuthenticator.password = "123456" # 初始密码设置
c.JupyterHub.admin_access = True # 则管理员有权在各自计算机上以其他用户身份登录,以进行调试
c.LocalAuthenticator.create_system_users=True # 此选项通常用于 JupyterHub 的托管部署,以避免在启动服务之前手动创建所有用户c.JupyterHub.authenticator_class = 'jupyterhub.auth.PAMAuthenticator' #解决Centos下用户认证问题
# 设置每个用户的 book类型 和 工作目录(创建.ipynb文件自动保存的地方)
c.Spawner.notebook_dir = '~'
c.Spawner.default_url = '/lab'
c.Spawner.args = ['--allow-root']
c.Spawner.cmd ='jupyter-labhub'
# 为jupyterhub 添加额外服务,用于处理闲置用户进程。使用时不好使安装一下:pip install jupyterhub-ilde-culler
c.JupyterHub.services = [
{
'name': 'idle-culler',
'command': ['python3', '-m', 'jupyterhub_idle_culler', '--timeout=3600'],
'admin':True # 1.5.0 需要服务管理员权限,去kill 部分闲置的进程notebook, 2.0版本已经改了,可以只赋给 idel-culler 部分特定权限,roles
}
]
将jupyterhub所在的目录加入系统环境变量。添加方法是:在/etc/profile.d/目录下新建jupyterhub.sh文件并写入下面两行代码
export JUPYTERHUB_HOME=/usr/local/bin
export PATH=$JUPYTERHUB_HOME:$PATH
然后执行
source /etc/profile.d/jupyterhub.sh
这样可以防止报错 Error in Authenticator.pre_spawn_start: FileNotFoundError [Errno 2] No such file or directory: 'jupyterhub-singleuser': 'jupyterhub-singleuser'
先切换到root用户, 再启动jupyterhub, 否则会出现权限不足和有些用户无法登录的情况。
root将用户‘jupyterhub’添加到系统:
useradd jupyterhub
passwd jupyterhub
根据提示输入密码‘123456’即可!
在系统中输入
jupyterhub -f jupyterhub_config.py
即可启动。
后台运行启动命令:
nohup jupyterhub -f jupyterhub_config.py >nohup.out &
查看启动的进程:
ps -aux | grep jupyterhub
访问安装http://ip:8000/hub/login
登录完成后的页面:
选择:文件->HUB控制面板,点击即可:
点击:Admin