JupyterHub(支持课程管理)

[JupyterHub](https://jupyterhub.readthedocs.io/en/stable/) 是为多个用户提供 Jupyter notebook 的最佳方式，也支持 JupyterLab

[知乎大佬教程](https://zhuanlan.zhihu.com/p/450744191)

## JupyterHub(Docker)
```bash
mkdir {srv,home}		#快速创建所需文件夹

docker run -d -p 8000:8000 -v /home/docker/jupyterhub/srv:/srv/jupyterhub -v /home/docker/jupyterhub/home:/home --name jupyterhub jupyterhub/jupyterhub jupyterhub		#创建并运行容器
```
- /srv/jupyterhub，适用于所有安全和运行时文件
- /etc/jupyterhub，对于所有配置文件
- /home，所有用户的home文件夹
- /var/log，用于日志文件

### 设置用户
```bash
#创建用户，默认没有管理用户
docker exec -it jupyterhub bash		#进入容器
adduser wj		#创建用户并根据提示设置好密码
usermod -g root wj		#强制修改用户组为root，防止后面权限不够
```
这时候可以通过：http:[IP]:[端口] 进行访问web并登录(仅限登录，启动会失败)

### 安装环境
```bash
apt-get update		# 更新，方便安装其他软件
pip install nbgrader jupyterhub notebook jupyterlab -i https://pypi.tuna.tsinghua.edu.cn/simple		# 安装运行环境，nbgrader一定要最最最先装！！！
	# nbgrader 是 Jupyter 笔记本的一个扩展，用于创建和评估课程作业。它使教师能够创建自动评分的作业，管理学生提交的作业，并提供反馈。nbgrader 在教育环境中很有用。
	# jupyterhub 是一个用于管理和运行 Jupyter 笔记本的多用户服务器。它允许多个用户通过浏览器访问 Jupyter 笔记本，并提供了用户认证、资源隔离等功能，适用于教育、研究等场景。
	# notebook是 Jupyter 笔记本的核心包。它提供了交互式计算环境，支持多种编程语言。用户可以创建、编辑和运行代码单元，同时添加文本、图像和其他富媒体内容。
	# jupyterlab 是 Jupyter 笔记本的下一代用户界面。它提供了更强大的交互式环境，支持多标签、扩展等特性，使用户可以更方便地组织和管理笔记本。
```
这时候访问web，就可以正常启动
![](/media/202204/2022-04-12_124245_067891.png)
如果只是简单使用，现在已经可以了
![](/media/202204/2022-04-12_124452_498914.png)

### 添加课程
[nbgrader_Doc](https://nbgrader.readthedocs.io/en/stable/index.html)
```bash
#添加课程功能
jupyter nbextension install --sys-prefix --py nbgrader --overwrite
jupyter nbextension enable --sys-prefix --py nbgrader
jupyter serverextension enable --sys-prefix --py nbgrader

#创建课程
mkdir -p /srv/nbgrader/ && cd /srv/nbgrader/		#创建存储课程文件夹
nbgrader quickstart python #添加一个名为 python 的课程

#设置课程共享目录
mkdir -p /srv/nbgrader/exchange		#创建一个目录
chmod ugo+rw /srv/nbgrader/exchange		#将这个目录的读写权改为全部用户可读写

#修改配置文件
nano /srv/nbgrader/python/nbgrader_config.py		#编辑课程目录下的配置文件，没有可以使用 'nbgrader generate_config' 生成
	c = get_config()
	c.CourseDirectory.course_id = "python"		#课程id
	c.Exchange.root = '/srv/nbgrader/exchange'		#课程文件夹
```

## JupyterHub(Ubuntu)
[百度文库教程](https://wenku.baidu.com/view/2c07d8cc82c758f5f61fb7360b4c2e3f572725a8.html)，有点不一样，使用Anaconda(conda)进行安装
[JupyterHub 部署与应用指南](https://sthsf.github.io/wiki/Linux%20Tricks/JupyterHub%20%E9%83%A8%E7%BD%B2%E4%B8%8E%E5%BA%94%E7%94%A8%E6%8C%87%E5%8D%97.html)

```bash
docker run -itd -p 8000:8000 --name jupyterhub -v /home/jupyterhub:/home ubuntu
docker exec -it jupyterhub bash		#进入容器
apt -y update		#更新
apt install -y python3 python3-pip wget libffi-dev nano		#安装环境
wget https://npmmirror.com/mirrors/node/v16.14.2/node-v16.14.2-linux-x64.tar.xz		#下载node，在这获取最新版本，http://nodejs.cn/download/
tar -xvf node-v16.14.2-linux-x64.tar.xz		#解压
mv node-v16.14.2-linux-x64 node		#修改名称为node，便于使用
ln -s /node/bin/node /usr/bin/		#创建软连接来搭建环境，有的系统映射地址是 /usr/local/bin/
ln -s /node/bin/npm /usr/bin/
	node -v		#测试环境是否有效
	npm -v
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple		#设置pip源
npm config set registry https://registry.npm.taobao.org		#设置npm源
npm install -g configurable-http-proxy		#安装configurable-http-proxy
pip3 install nbgrader jupyterhub notebook jupyterlab		#安装jupyterhub相关环境
mkdir /home/jupyterhub		#创建jupyterhub文件夹，用于存储相关配置
cd /home/jupyterhub/		#进入jupyterhub文件夹
jupyterhub --generate-config		#生成配置文件
adduser wj		#创建用户
nano jupyterhub_config.py		#编辑配置文件(可用其他方式修改)
	#配置文件的相关介绍在下方
jupyterhub --ip 0.0.0.0 --port 8000 -f /home/jupyterhub/jupyterhub_config.py		#运行测试
```

开机自启
`nano /etc/systemd/system/jupyterhub.service  `
```bash
[Unit]
Description=Jupyterhub
After=syslog.target network.target

[Service]
User=root
ExecStart=/home/xyq/.jupyter/run_hub

[Install]
WantedBy=multi-user.target
```
- sudo systemctl enable jupyterhub # 开机自启动
- sudo systemctl daemon-reload     # 加载配置文件
- sudo systemctl start jupyterhub  # 启动
- sudo journalctl -u jupyterhub    # 查看log

## jupyterhub_config 配置
`jupyterhub --generate-config`生成配置文件`jupyterhub_config.py`
```bash
c.JupyterHub.admin_users = {'wj','jun'}		#管理员账户(需linux中创建相应用户)
c.JupyterHub.ip = '0.0.0.0'		#允许任何地址访问
c.JupyterHub.port = 8888		#设定端口
c.JupyterHub.proxy_cmd = ['/node/bin/configurable-http-proxy']		#configurable-http-proxy的安装路径

c.Spawner.cmd = ['jupyter-labhub']		#设置为lab版本
c.Spawner.default_url = '/lab'		#设置为lab版本
c.Spawner.notebook_dir = '/home'		#设置所有用户访问根目录为home(不推荐)
```
注意，配置文件是 python文件，对缩进相当敏感，注释启用时 #后面的空格也要删除

npm 源
- npm -------- https://registry.npmjs.org/
- yarn ------- https://registry.yarnpkg.com/
- cnpm ------- http://r.cnpmjs.org/
- taobao ----- https://registry.npm.taobao.org/
- nj --------- https://registry.nodejitsu.com/
- npmMirror -- https://skimdb.npmjs.com/registry/
- edunpm ----- http://registry.enpmjs.org/

pip 源
- 阿里云 http://mirrors.aliyun.com/pypi/simple/
- 中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/
- 豆瓣(douban) http://pypi.douban.com/simple/
- 清华大学 https://pypi.tuna.tsinghua.edu.cn/simple/
- 中国科学技术大学 http://pypi.mirrors.ustc.edu.cn/simple/