ubuntu 16.04安装jupyter notebook使用与进阶
一、Jupyter Notebook简介
Jupyter Notebook(此前被称为 IPython notebook)是一个交互式笔记本,支持运行 40 多种编程语言。
Jupyter Notebook 的本质是一个 Web 应用程序,便于创建和共享文学化程序文档,支持实时代码,数学方程,可视化和 markdown。 用途包括:数据清理和转换,数值模拟,统计建模,机器学习等等;
是一款非常好用的基于web方式使用python的工具;
支持windows 与linux系统,本次以ubuntu 16.04 python3.5.2为例,安装演示;
相关配置及更高级的玩法请参考官方文档
以上的操作是针对本机的python3操作,如果想在虚拟的python环境中操作请参考搭建python虚拟环境
其他的步骤是 一样的;
二、安装
1、pip安装
sudo python3 -m pip install --upgrade pip
sudo python3 -m pip install jupyter
2、简单使用
默认安装好后直接在命令行里输入$ jupyter notebook
类似如下图:
如上图,新建-->Python3 创建如下图交互式带提示的python命令行
输入print("Hellow world") 点运行即可执行看到效果;
新建终端时,直接以登录系统身份登录系统终端如图:
至次jupyter notebook的简单安装使用就完成了,没错就是这么简单~
然而这么好的工具,这么方便的操作只能运行在本地?如果在局域网或端口映射后能在外面操作,通过密码登录;岂不是很完美?查看了官方网站教程,别说还真有;下面就配置下把jupyter notebook开放在本地的任何接口上,并且配置https形式,这样传输就安全啦~
三、jupyter notebook使用进阶
1、配置密码
$ jupyter notebook password
Enter password: ****
Verify password: ****
以上操作会在我的家目录下生成 /home/san/.jupyter/jupyter_notebook_config.json
文件,密码以hash保存如下:
$ /home/san/.jupyter/jupyter_notebook_config.json
{
"NotebookApp": {
"password": "sha1:74432c61ae9b:26c35e70239jfe7e3dc4b177d140d4ac7f560e1f"
}
}
些时结束之前的jupyter notebook实例再次运行,会提示输入密码,如图:
此时只有输入正确的密码后才能正常登录使用jupyter 啦!
2、侦听非本地接口
默认出于安全jupyter只运行侦听在本地,想把这么好的功能放在网络上使用需要生成添加配置文件
$ jupyter notebook --generate-config
运行后会在家目录.jupyter/下生成jupyter_notebook_config.py文件
修改内容如下:
c.NotebookApp.ip = '0.0.0.0'
c.NotebookApp.open_browser = False
c.NotebookApp.password = "sha1:74432c61ae9b:26c35e70239jfe7e3dc4b177d140d4ac7f560e1f"
c.NotebookApp.port = 8888
注意:按官方的c.NotebookApp.ip = '*' 报错,换成0.0.0.0则可以
可以看到不仅可以自定义侦听地址,还可以修改侦听端口;
$ netstat -ntpul |grep python3
tcp 0 0 0.0.0.0:8888 0.0.0.0:* LISTEN 2403/python3
此时就可以通过本地的ip或loclahost :8888访问啦
3、jupyter配置https
创建私钥并自签:
$ openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout mykey.key -out mycert.pem
运行以上命令如下需要填写相关信息如图:
以https方式启动:
$ jupyter notebook --certfile=mycert.pem --keyfile mykey.key
[I 13:30:22.165 NotebookApp] 启动notebooks 在本地路径: /home/dongyc/ipython
[I 13:30:22.165 NotebookApp] 本程序运行在: https://(san-Vostro-3660 or 127.0.0.1):8888/
[I 13:30:22.165 NotebookApp] 使用control-c停止此服务器并关闭所有内核(两次跳过确认).
注意:证书文件需要绝对路径;
此时可以使用https://10.8.11.65:8888 或https://localhost:8888进行访问啦 如图:
到这里jupyter notebook基本配置完成了,但有一个问题,每次启动jupyter都要切换到一个指定目录(就是上图中文件列出来的内容所在目录);而且还要占用一个终端;
还是搞一个后台服务,开机自动运行吧,以下的内容是官方没有的,本人自己捣鼓的;
4、jupyter服务
#!/bin/bash
# author: by san at 20180929
### BEGIN INIT INFO
# Provides: jupyter
# Required-Start: $syslog $remote_fs
# Required-Stop: $syslog $remote_fs
# Should-Start: $local_fs
# Should-Stop: $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: jupyter notebook deamon
# Description: jupyter notebook with https deamon
### END INIT INFO
. /home/san/functions # 这个类似redhat系列上的/etc/init.d/functions shell库 你的系统自行找,如找不到请联系我
prog=jupyter
pidfile=${PIDFILE-/tmp/jupyter.pid}
lockfile=${LOCKFILE-/tmp/jupyter}
jupyter="/usr/local/bin/jupyter" # 如果是虚拟python环境请填写正确的路径
RETVAL=0
START(){
if [ ! -f ${pidfile} ]; then
cd /home/san/ipython
echo -n $"Stopping jupyter notebook:"
nohup ${jupyter} notebook --certfile=/home/san/mycert.pem --keyfile /home/san/mykey.key >/tmp/jupyter.log 2>&1 &
[ "$?" -eq 0 ] && success $"$base startup" || failure $"$base startup"
jupyter_pid=$(ps aux |grep jupyter |grep -v grep|awk '{print $2}')
echo $jupyter_pid >$pidfile
RETVAL=$?
echo
[ $RETVAL = 0 ] && touch ${lockfile}
return $RETVAL
else
status -p ${pidfile}
exit 0
fi
}
STOP(){
echo -n $"Stopping jupyter notebook:"
nohup kill -15 $(ps aux |grep jupyter |grep -v grep|awk '{print $2}') >/dev/null 2>&1 &
[ "$?" -eq 0 ] && success $"$base startup" || failure $"$base startup"
echo
[ -f ${pidfile} ] && rm -rf ${pidfile}
[ -f ${lockfile} ] && rm -rf ${lockfile}
}
case $1 in
start)
START
;;
stop)
STOP
;;
restart)
STOP
START
;;
status)
status -p ${pidfile} $prog
${jupyter} notebook list
RETVAL=$?
;;
*)
echo "USAGE:start|stop|restart"
;;
esac
添加可执行权限
$ chmod +x /etc/init.d/jupyter
测试脚本 如图:
可以发现脚本可以执行;会自动读取当前登录系统用户的家目录下.jupyter下的配置文件;官方说把密钥和签名证书配置到配置文件中,但我测试下来找不到证书,所以把证书当启动参数放到,服务脚本中了,这是正常的;
系统重启会自动启动jupyter notebook 侦听在8888上,系统关闭时,会自动关闭jupyter服务; upyter notebook可以运行多实例;即默认随机启动侦听在8888 再次在终端上执行时会侦听在8889端口 如图:
此时你会发现 一台服务器可以开多个实例,给多个人测试使用~是不是很方便很好用?赶紧试试吧~