Jupyter

安装


x
# 在线安装 jupyter, 在线安装有一部分包的版本不兼容，一般使用低版本的包能解决
pip install jupyter

# 离线安装
pip3 install --no-index --find-links=. -r requirements.txt
pip2 install --no-index --find-links=. -r requirements.txt

配置


xxxxxxxxxx
# 生成配置
jupyter notebook --generate-config
# Windows 在 %USERPROFILE%\.jupyter\jupyter_notebook_config.py
# Linux 在 ~/.jupyter/jupyter_notebook_config.py

c.NotebookApp.allow_root = True
c.NotebookApp.base_project_url = '/toolclis'
c.NotebookApp.notebook_dir = '/jupyter_notebook/'
c.NotebookApp.terminado_settings = {'shell_command': ['/bin/bash']}

启动


x
jupyter notebook

python2 -m jupyter notebook
python3 -m jupyter notebook

# linux默认不允许root运行jupyter notebook
# [C 16:38:27.845 NotebookApp] Running as root is not recommended. Use --allow-root to bypass.

# linux 创建jupyter用户运行，允许外网访问
useradd jupyter
su - jupyter
mkdir jupyter_notebook

# 前台运行 # windows
jupyter notebook --notebook-dir=./jupyter_notebook/ --ip=0.0.0.0
# 后台运行
nohup jupyter notebook --notebook-dir=./jupyter_notebook/ --ip=0.0.0.0 &

# 后台root身份运行
nohup jupyter notebook --notebook-dir=./jupyter_notebook/ --allow-root --ip=0.0.0.0 &

# 后台root身份运行，指定--NotebookApp.token无法修改密码
nohup jupyter notebook --notebook-dir=./jupyter_notebook/ --allow-root --ip=0.0.0.0 --NotebookApp.token=${xxx} &

重置Token


xxxxxxxxxx
# 手动设置Token，保存在jupyter_notebook_config.json文件中
jupyter notebook password

# 无缝重启
kill -9 $(ps -ef | grep jupyter-notebook | grep -v grep | awk '{print $2}'); nohup jupyter notebook --notebook-dir=./jupyter_notebook/ --allow-root --ip=0.0.0.0 &

WEB

复制这三个网址其中一个到浏览器


xxxxxxxxxx
    To access the notebook, open this file in a browser:
        file:///C:/Users/%E9%99%88%E5%85%A8%E5%BA%94/AppData/Roaming/jupyter/runtime/nbserver-8436-open.html
    Or copy and paste one of these URLs:
        http://localhost:8888/?token=2deffc2981725d4a808fc8e1e0689d53048bf95f2f22e04c
     or http://127.0.0.1:8888/?token=2deffc2981725d4a808fc8e1e0689d53048bf95f2f22e04c

jupyter状态


xxxxxxxxxx
# 查看当前在运行的jupyter
[jupyter@VM-4-6-centos ~]$ jupyter notebook list
Currently running servers:
http://0.0.0.0:8888/?token=3f5cc71aa2d1cda4c836df036e619ffd8b490e199171c272 :: /home/jupyter/jupyter_notebook

# 查看本机已安装的 jupyter 内核版本
[jupyter@VM-4-6-centos ~]$ jupyter-kernelspec list
Available kernels:
  python3    /usr/local/share/jupyter/kernels/python3
  python2    /usr/share/jupyter/kernels/python2

# python3的jupyter notebook 使用python2，需安装 python2内核，否则python2无法正常执行
python2 -m ipykernel install --user
python3 -m ipykernel install --user

# 查看 jupyter 内核版本
[jupyter@VM-4-6-centos jupyter_notebook]$ jupyter-kernelspec list
Available kernels:
  python2    /home/jupyter/.local/share/jupyter/kernels/python2
  python3    /home/jupyter/.local/share/jupyter/kernels/python3

快捷键

菜单 - Help - Keyboard Shortcuts 可以查看快捷键。

ctrl+enter：在执行完当前cell后光标仍然处于当前cell
shift+enter：执行完之后则自动跳转到下一个cell
alt+enter：执行之后插入新的cell并跳转
A：在当前cell的前面增加一个cell
B：在当前cell的后面增加一个cell
DD：删除当前cell
Z：恢复最近删除的cell
Esc, Ctrl+M：将光标从cell内切换到cell外，用于后续执行cell级别的控制
Enter：将光标从cell外切换到cell内，用于后续执行代码编辑
shift+M：将选中的多个cell合并为一个cell（选中多个cell类似于windows下连选文件，即在按住shift的状态下通过光标控制即可）
ctrl+shift+-：将一个cell内的代码段落，依据光标所在行拆分为两个cell
M：将当前cell切换为markdown，而后即可按照markdown语法来编辑文本了
Y：将当前cell切换为代码，这也是cell的默认状态。
ctrl+/：注释或者解注释，与众多IDE功能相同
tab：增加缩进
shift+tab：这个快捷键比较常用，如果在代码前方，则用于减少缩进；如果在代码之间的某个函数则可悬浮显示函数提示。这也算是弥补了jupyter不具备函数跳转的一个小功能吧。

调整页面宽度

调整 Jupyter 的 Notebook/Terminals 页面宽度，只要将以下内容放入文件 .jupyter/custom/custom.css 。


xxxxxxxxxx
mkdir -p .jupyter/custom/
cat > .jupyter/custom/custom.css <<EOF
/* # the note book page */
.notebook_app .container {
    width:98%; !important
}
/* # the terminal page */
.terminal-app .container {
    width:98%; !important
}
EOF

需要重启 jupyter

问题排查

web上新建python文件时报错


xxxxxxxxxx
[I 21:25:21.379 NotebookApp] Creating new notebook in Bad file descriptor (C:\projects\libzmq\src\epoll.cpp:100)

原因分析：安装的 pyzmq 库版本过高,为 22.3.0,故我们降低版本即可,降低至 19.0.2

解决方案： pip uninstall pyzmq # 卸载当前 pyzmq pip install pyzmq==19.0.2 # 安装版本为 19.0.2 的 pyzmq

ipaddress

ERROR: Cannot uninstall 'ipaddress'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall. ERROR: Cannot uninstall 'enum34'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall. 系统自带了低版本的 ipaddress enum34，不安装新版本即可