Tips：该文章面向Mac和centos用户，如果是Windows用户，请先安装虚拟机。

概述

Jupyter Notebook（此前被称为 IPython notebook）是一个交互式笔记本，支持运行 40 多种编程语言。

Jupyter Notebook 的本质是一个 Web 应用程序，便于创建和共享文学化程序文档，支持实时代码，数学方程，可视化和 markdown。 用途包括：数据清理和转换，数值模拟，统计建模，机器学习等等。

小试牛刀

如果之前你还不了解jupyter，我建议先在本地来一个全方位的体验！ (For Mac)

• 首先，保证你Mac应该已经安装了python(推荐python3，因为在不久的将来python2将被抛弃！)以及pip命令；
• 然后，安装jupyter：pip install jupyter (不同环境安装方法参考 安装jupyter ) ；
• 完成上面的操作就已经安装好了！
• 最后，启动jupyter：jupyter notebook
• 启动后会自动打开浏览器，进入首页：

在这里就可以尽情体验jupyter的所有功能了，详情参考 运行jupyter 。

书归正传

上面只是对jupyter的一个简单体验，但是为了方便在何时何地都能使用jupyter，在自己Mac上部署就不能完全满足咱们的需求了。接下来讲述如何在云主机(centos系统)上安装jupyter并通过nginx做代理提供服务。

先展示一下部署成果：

这是我自己的jupyter登录主页！其中，配置了用户认证、HTTPS。

开始部署

建议使用普通用户进行部署！

• 安装python3及pip

  yum install -y python36 python36-pip
  

• 安装jupyter

  pip install jupyter
  

• 生成jupyter配置文件

  jupyter notebook --generate-config
  

  会创建目录 ~/.jupyter 并且该目录下会有一个配置文件 jupyter_notebook_config.py 。

• 修改配置

  c.JupyterApp.config_file = '~/.jupyter/jupyter_notebook_config.py'
  c.NotebookApp.allow_remote_access = True  # 允许远程访问
  c.NotebookApp.base_url = '/jupyter'  # 设置jupyter的资源主页路径，即[jupyter主页] 
  c.NotebookApp.enable_mathjax = True  # 启用mathjax
  c.NotebookApp.ip = '127.0.0.1'  # 设置了访问该jupyter应用的来源机器只能是本机
  c.NotebookApp.notebook_dir = '/home/nginx/workspace/js_python' # jupyter工作目录，所有在jupyter创建的文件都会保存到这里
  c.NotebookApp.open_browser = False  # 禁止启动时自动开启浏览器
  c.NotebookApp.password = 'sha1:a937e51de9a1:a567707768cd50d0ac1d40a4fb739510ddb3d8cb'  # 用户认证密码
  c.NotebookApp.port = 8888  # 监听端口
  

• 上面设置了c.NotebookApp.password，通过以下方式获取加密后的密码：

  In [1]: from notebook.auth import passwd
  In [2]: passwd()
  Enter password: 
  Verify password: 
  Out[2]: 'sha1:a937e51de9a1:a567707768cd50d0ac1d40a4fb739510ddb3d8cb'
  

• 配置完成后，启动：jupyter notebook

• 为了方便管理，讲服务加入systemctl管理：

  # /usr/lib/systemd/system/jupyter.service
  [Unit]
  Description=Jupyter Management
  After=network.target
  
  [Service]
  User=nginx
  Group=nginx
  WorkDirectory=/home/nginx/workspace/js_python
  ExecStart=/usr/local/bin/jupyter notebook
  
  Restart=on-failure
  RestartSec=10
  
  [Install]
  WantedBy=multi-user.target
  

• 启动：

  $ systemctl daemon-reload
  $ systemctl start jupyter
  $ systemctl enable jupyter
  

配置nginx代理

nginx的安装过程在此不做赘述，参考 编译安装nginx 。

nginx配置如下：

• ssl.conf配置：

  ssl_session_timeout  10m;
  ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;
  
  ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
  ssl_prefer_server_ciphers   on;
  ssl_buffer_size 1400;
  ssl_session_tickets on;
  
  ssl_session_cache    shared:SSL:10m;
  
  ssl                  on;
  ssl_certificate      /usr/local/nginx/conf/www.xxxx.cn.crt;
  ssl_certificate_key  /usr/local/nginx/conf/www.xxxx.cn.key;
  client_max_body_size 10m;
  charset utf-8;
  

• site.conf

  server {
      listen 80;
      server_name www.xxxx.cn;
  
      rewrite ^/(.*)$  https://www.xxxx.cn/$1  permanent;
  }
  
  server {
      listen 443;
      server_name www.xxxx.cn;
  
      include /usr/local/nginx/conf/servers/common/ssl/www_ssl_config.conf;
  
      location /jupyter {
          proxy_pass http://jupyter;
          proxy_set_header        X-Real-IP $remote_addr;
          proxy_set_header        Host $host;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_http_version      1.1;
          # websocket support
          proxy_set_header        Upgrade $http_upgrade;
          proxy_set_header        Connection "Upgrade";
          proxy_read_timeout      86400;
          proxy_redirect          off;
  				# 白名单
          allow 121.xx.xx.xx;
          deny all;
      }
  
  }
  
  upstream jupyter {
      server 127.0.0.1:8888;
  }
  

配置完成后启动nginx，在浏览器访问www.xxxx.cn/jupyter 。

Completed！