实验室工作站jupyterhub安装笔记

本篇文章为实验室工作站的jupyterhub安装配置笔记，由于软硬件等各种区别，安装过程难免有所区别，仅供大家参考。

实验室新到一台深度学习工作站，原本想装一个juoyter notebook直接开干，但是突然想到jupyter不支持多用户同时使用，因此决定装一个jupyterhub方便大家使用（虽然目前只有我用）

参考文章：https://www.jianshu.com/p/0285feaa2ba2（文章所使用的命令有稍许拼写错误，以及路径改变，推荐按照本人笔记进行安装，若安装过程遇到其他问题，欢迎在本页面留言讨论）

机器环境：lsb_release -a

Distributor ID: Ubuntu
Description:    Ubuntu 18.04 LTS
Release:        18.04
Codename:       bionic

ubuntu源配置

首先将ubuntu源切换到速度较快的源，例如清华源

更新

$ sudo apt-get update #从软件源获取最新软件列表
$ sudo apt-get upgrade #根据软件列表更新本机软件

然后安装一下链接中提到的这些软件

$ sudo apt-get -y install git gcc g++ make openssl libssl-dev libbz2-dev libreadline-dev libsqlite3-dev python-dev libmysqlclient-dev

python环境的配置，首先进入root账户，以便之后配置的jupyter能够所有用户访问

$ sudo su

安装pyenv

$ cd /opt
$ git clone https://github.com/yyuu/pyenv.git pyenv

用vim打开`~/.bashrc`后（`vim ~/.bashrc`），添加如下的配置

export PYENV_ROOT="/opt/pyenv"
if [ -d "${PYENV_ROOT}" ]; then
    export PATH=${PYENV_ROOT}/bin:$PATH
    eval "$(pyenv init -)"
fi

然后读取新添加的配置

source ~/.bashrc

通过pyenv来安装anaconda

$ pyenv install anaconda3-5.3.0

然而由于网络环境原因，这一步始终无法下载，尝试使用替代方法，先手动从清华anaconda源下载anaconda-5.3.0的安装包，然后放入pyenv的根目录（上面配置过）/opt/pyenv，这样pyenv install就会自动识别到已经下载的安装包开始安装

$ cd /opt/pyenv
$ wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-5.3.0-Linux-x86_64.sh
$ pyenv install anaconda3-5.3.0
$ pyenv global anaconda3-5.3.0

利用conda安装jupyterhub和它使用的notebook

首先将conda切换为清华源（清华开源社区什么时候来把广告费结一下）

$ vim ~/.condarc

将内容修改为

channels:
  - defaults
show_channel_urls: true
default_channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
custom_channels:
  conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud

开始安装（强迫症表示必须加-v）

$ conda install -v -c conda-forge jupyterhub
$ conda install -v notebook

生成jupyter的配置文件

$ mkdir /etc/jupyterhub
$ cd /etc/jupyterhub
$ jupyterhub --generate-config

jupyter的启动配置

$ echo jupyterhub -f /etc/jupyterhub/jupyterhub_config.py > jupyterhub.sh 
$ echo su -l root /etc/jupyterhub/jupyterhub.sh & >> /etc/rc.local

配置jupyterhub用户

$ vim /etc/jupyterhub/jupyterhub_config.py #这一步大家注意，后续如果遇到http 500问题的话删除该jupyter_config.py文件或许会解决，目前我也不清楚是什么原因

普通用户

c.Authenticator.whitelist = {'testuser'}

管理员用户

c.JupyterHub.admin_users = { 'ubuntu' }

启动jupyterhub

接下来直接启动jupyterhub就可以使用了

$ jupyterhub

或者使用nphup在后台启动

$ nohup jupyterhub > jupyterhub.log &

至此安装完毕，在浏览器访问服务器ip+端口地址即可使用