Linux部署jupyterlab

1、准备

​       本教程是适用于Linux操作系统的jupyterlab部署教程，需要提前安装Python3运行环境，可以是基本的Python3、Anaconda和MiniConda等Python3环境，需要有良好的网络环境。

2、安装jupyterlab

pip install jupyterlab # 安装jupyter
pip install jupyterlab-language-pack-zh-CN # 安装汉化包，需要自己选择语言

3、生成配置文件

jupyter lab --generate-config

上面命令会生成jupyterlab配置文件，路径为~/.jupyter/jupyter_lab_config.py

4、创建密码

jupyter lab password

填写密码并确认密码，会生成~/.jupyter/jupyter_server_config.json

查看文件内容，如下图，复制password后的一串字符

5、修改配置文件

vim  ~/.jupyter/jupyter_lab_config.py

追加以下内容：

c.ServerApp.allow_remote_access = True  # 允许远程访问
c.ServerApp.allow_root = True           # 允许root运行
c.ServerApp.notebook_dir = u'工作文件夹'  # 设置工作目录，默认为用户家目录
c.ServerApp.ip = '*'                    # 监听地址
c.ServerApp.port = 8888                 # 运行端口，默认8888
c.ServerApp.password = '刚复制的字符串'    # 密码
c.ServerApp.open_browser = False        # 不打开浏览器

6、后台启动

nohup python -m jupyterlab --allow-root > ~/.jupyter/jupyter.log 2>&1 &

​ ​      此处利用nohup命令让jupyterlab在后台执行，并输出日志到~/.jupyter/jupyter.log文件中，该串代码运行后会输出jupyterlab的进程号，通过进程号，可以使用kill -9 进程号来终止项目，如下图，4094即是此次jupyterlab的进程号，使用kill -9 4094即可停止后台运行的jupyterlab。

启动后，通过IP:端口号即可进行访问，访问后需要输入之前设置的密码，然后进入的主页面如图所示：

7、终止后台运行的jupyterlab

​      使用ps -al命令查看进程号，即PID，然后使用kill命令终止。若想重新启动，再重新运行命令
即可。

(base) [root@0ca82869d78e ~]# ps -al #查看进程
F S   UID    PID   PPID  C PRI  NI ADDR SZ WCHAN  TTY          TIME CMD
4 S     0 184175 184005  1  80   0 - 90168 ep_pol pts/2    00:00:03 python
0 R     0 184429 184005  0  80   0 - 12402 -      pts/2    00:00:00 ps

kill -9 184175 # 结束进程

8、切换中文界面

若需中文，使用以下命令安装中文包后，在jupyterlab界面中切换

9、安装扩展

​       jupyterlab相比于传统的jupyter notebook，最大的变化在于支持安装扩展，但很多扩展的安装需要先安装node.js和npm，以下介绍如何安装，若需求较少，可以跳过此步骤。

（1）下载并安装Nodejs

① 下载

node.js中文官网：下载 | Node.js 中文网 (nodejs.cn)

访问界面，选择Linux 二进制文件 (x64)，右键复制链接

返回终端，下载：

wget https://nodejs.org/dist/v16.17.0/node-v16.17.0-linux-x64.tar.xz

解压：

tar -xvf ./node-v16.17.0-linux-x64.tar.xz

移动并重命名

mv node-v16.17.0-linux-x64/ /opt/nodejs

② 配置环境变量

vim /etc/profile

追加以下内容：

#set for nodejs
export NODE_HOME=/opt/nodejs
export PATH=$NODE_HOME/bin:$PATH

使环境变量立即生效

source /etc/profile

③ 验证

nodejs和npm安装完成，使用以下命令进行验证

node -v # 查看node.js版本
npm -v  # 查看npm版本

④ 换源

若按照速度较慢，可进行换源，此处换成了淘宝源

npm config set registry http://registry.npmmirror.com

若想换回官方源：

npm config set registry https://registry.npmjs.org/

清除缓存

npm cache clean --force

（2）安装扩展

如图所示，在jupyterlab界面的右侧即可进行扩展安装

9、其他问题解决

问题描述

ImportError: IProgress not found. Please update jupyter and ipywidgets. 
See https://ipywidgets.readthedocs.io/en/stable/user_install.html

（1）安装依赖

pip install ipywidgets widgetsnbextension pandas-profiling

（2）启动​​jupyterlab​​相应的插件

jupyter nbextension enable --py widgetsnbextension