Linux：Jupyterhub多用户远程登录安装、使用经验

素颜马尾好姑娘i 2023-10-15 14:01 46阅读 0赞

# 1、安装 #

首先，打开官网帮助文档：

[JupyterHub 官方安装帮助文档][JupyterHub]

一般安装都是参考官方最新版安装文档。

## 1.1环境条件 ##

本次安装 JupyterHub的软件环境：

*  基于 Linux Centos系统；
 *  Python 3.9或更高版本；
 *  安装 nodejs/npm ；

安装 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`来查看是否安装成功。

## 1.2安装 ##

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`**来查看是否安装成功。

##    1.3配置 ##

按照官方配置文档一步一步配置即可：

[JupyterHub 官方环境配置帮助][JupyterHub 1]

首先通过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  
> \}  
> \]

## 1.4启动 ##

### 1.4.1添加环境变量 ###

将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'

### 1.4.2使用root权限启动 ###

先切换到root用户, 再启动jupyterhub, 否则会出现权限不足和有些用户无法登录的情况。

### 1.4.3添加用户 ###

root将用户‘jupyterhub’添加到系统：

useradd jupyterhub
    passwd jupyterhub

根据提示输入密码‘123456’即可！

### 1.4.4启动命令 ###

在系统中输入

jupyterhub -f jupyterhub_config.py

即可启动。

后台运行启动命令：

nohup jupyterhub -f jupyterhub_config.py >nohup.out &

查看启动的进程：

ps -aux | grep jupyterhub

# 2、使用 #

## 2.1用户登录 ##

访问安装[http://ip:8000/hub/login][http_ip_8000_hub_login]

![2971b9ddb23944afaa5ba5d6cd39aa60.png][]

登录完成后的页面：

![04632ffc8b854b559ff84cb20043831d.png][]

## 2.2用户管理 ##

选择：文件->HUB控制面板，点击即可：

![e95159aa0ad54b93a87c09435b07df35.png][]

点击：Admin

![c66f3ec1025e45f6b88b82e2f1aa31f4.png][]

![aa8493e3bdc243ff807bed5be84366a3.png][] 即可对用户进行管理，包括用户新建、编辑、删除，不过用户的密码不能在此进行操作，还需要参考1.4.3中进行操作！

[JupyterHub]: https://jupyterhub.readthedocs.io/en/stable/quickstart.html
[JupyterHub 1]: https://jupyterhub.readthedocs.io/en/stable/getting-started/index.html
[http_ip_8000_hub_login]: http://192.168.254.206:8000/hub/login
[2971b9ddb23944afaa5ba5d6cd39aa60.png]: https://img-blog.csdnimg.cn/2971b9ddb23944afaa5ba5d6cd39aa60.png
[04632ffc8b854b559ff84cb20043831d.png]: https://img-blog.csdnimg.cn/04632ffc8b854b559ff84cb20043831d.png
[e95159aa0ad54b93a87c09435b07df35.png]: https://img-blog.csdnimg.cn/e95159aa0ad54b93a87c09435b07df35.png
[c66f3ec1025e45f6b88b82e2f1aa31f4.png]: https://img-blog.csdnimg.cn/c66f3ec1025e45f6b88b82e2f1aa31f4.png
[aa8493e3bdc243ff807bed5be84366a3.png]: https://img-blog.csdnimg.cn/aa8493e3bdc243ff807bed5be84366a3.png