本页内容

  • 准备工作
  • 步骤 1 - 配置防火墙
  • 步骤 2 - 安装 Nginx
  • 步骤 3 - 安装 JupyterLab
  • 步骤 4 - 配置 JupyterLab
  • 步骤 5 - 创建 JupyterLab 服务文件
  • 步骤 6 - 安装 SSL
  • 步骤 7 - 配置 Nginx
  • 总结

JupyterLab 是 Project Jupyter 的新一代基于 Web 的开发环境。Project Jupyter 的开发目标是为跨多种编程语言的交互式计算开发开源、开放标准以及服务。JupyterLab 提供了灵活的界面,允许开发者以灵活、集成且可扩展的方式处理 Jupyter notebooks、文本编辑器、终端以及自定义组件等文档和活动。JupyterLab 是 Jupyter Notebook 的下一代产品,并终将取代它。它支持超过 40 种编程语言,包括 R、Python、Scala 和 Julia。

本教程将教你如何在 Rocky Linux 9 服务器上安装并配置 JupyterLab。

准备工作

  • 运行 Rocky Linux 9 的服务器。
  • 具有 sudo 权限的非 root 用户。
  • 指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 jupyterlab.example.com 作为域名。
  • SELinux 已禁用。
  • 确保系统已更新。$ sudo dnf update
  • 安装基础工具包。其中部分可能已经安装。$ sudo dnf install wget curl nano unzip yum-utils -y

运行 Rocky Linux 9 的服务器。

具有 sudo 权限的非 root 用户。

指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 jupyterlab.example.com 作为域名。

SELinux 已禁用。

确保系统已更新。

$ sudo dnf update

安装基础工具包。其中部分可能已经安装。

$ sudo dnf install wget curl nano unzip yum-utils -y

步骤 1 - 配置防火墙

第一步是配置防火墙。Rocky Linux 使用 Firewalld 防火墙。检查防火墙的状态。

$ sudo firewall-cmd --state
running

防火墙通过不同的区域(zone)工作,public 区域是我们将使用的默认区域。列出防火墙上所有处于活动状态的服务和端口。

$ sudo firewall-cmd --permanent --list-services

它应该显示如下输出。

cockpit dhcpv6-client ssh

Wiki.js 需要 HTTP 和 HTTPS 端口才能运行。开放这些端口。

$ sudo firewall-cmd --add-service=http --permanent
$ sudo firewall-cmd --add-service=https --permanent

重新加载防火墙以使更改生效。

$ sudo firewall-cmd --reload

步骤 2 - 安装 Nginx

Rocky Linux 9 自带较旧版本的 Nginx。你需要下载官方 Nginx 仓库以安装最新版本。

创建并打开 /etc/yum.repos.d/nginx.repo 文件,用于创建官方 Nginx 仓库。

$ sudo nano /etc/yum.repos.d/nginx.repo

在其中粘贴以下代码。

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

按 Ctrl + X 保存文件,并在提示时输入 Y。

安装 Nginx 服务器。

$ sudo dnf install nginx -y

验证安装。

$ nginx -v
nginx version: nginx/1.22.1

启用并启动 Nginx 服务器。

$ sudo systemctl enable nginx --now

检查服务器的状态。

$ sudo systemctl status nginx
? nginx.service - nginx - high performance web server
     Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; vendor preset: disabled)
     Active: active (running) since Tue 2022-12-13 06:07:05 UTC; 31s ago
       Docs: http://nginx.org/en/docs/
    Process: 146475 ExecStart=/usr/sbin/nginx -c /etc/nginx/nginx.conf (code=exited, status=0/SUCCESS)
   Main PID: 146476 (nginx)
      Tasks: 2 (limit: 5911)
     Memory: 1.9M
        CPU: 15ms
     CGroup: /system.slice/nginx.service
             ??146476 "nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf"
             ??146477 "nginx: worker process"

步骤 3 - 安装 JupyterLab

我们先检查一下 python 版本。

$ python -V
Python 3.9.14

安装 PIP 包管理器。

$ sudo dnf install python3-pip

为 JupyterLab 创建一个目录。

$ mkdir jupyterlab

切换到新创建的目录。

$ cd ~/jupyterlab

创建一个名为 jupyterlab_env 的虚拟环境。

$ python3 -m venv --system-site-packages jupyterlab_env

激活该环境。

$ source jupyterlab_env/bin/activate

升级 Pip 包管理器。

(jupyterlab_env) $ pip install --upgrade pip

安装 JupyterLab。

(jupyterlab_env) $ pip install jupyterlab

步骤 4 - 配置 JupyterLab

默认情况下,JupyterLab 每次启动时都会生成一个新 token,用于授予对界面的访问权限。让我们用密码认证来替换它。

生成一个密码哈希。将 YOUR_PASSWORD 替换为你自己设置的强密码。

(jupyterlab_env) $ python3 -c "from jupyter_server.auth import passwd; print(passwd('YOUR_PASSWORD'))"

以上命令会生成一个较长的密码哈希。它使用 Argon2 密码哈希函数。请记下该哈希。

创建 JupyterLab 配置文件。

(jupyterlab_env) $ jupyter lab --generate-config

以上命令会生成一个带有默认值的配置文件,并将其保存在 ~/.jupyter 目录中。

打开该文件进行编辑。

(jupyterlab_env) $ nano ~/.jupyter/jupyter_lab_config.py

找到以下变量,取消注释并按下述修改其值。将 PASSWORD_HASH 替换为上面生成的哈希。

c.ServerApp.allow_remote_access = True

c.ServerApp.password = 'PASSWORD_HASH'

按 Ctrl + X 保存文件,并在提示时输入 Y。

在防火墙中开放 8888 端口。

$ sudo firewall-cmd --add-port=8888/tcp --permanent
$ sudo firewall-cmd --reload

运行 JupyterLab 服务器。--ip 0.0.0.0 参数使其能够监听任意 IP 地址,而不仅仅是 localhost。

$ jupyter lab --ip 0.0.0.0

以上命令会在我们已开放的默认端口 8888 上启动一个 JupyterLab 服务器。在浏览器中打开 URL http://:8888/,你将看到如下界面。

在 Rocky Linux 9 上安装并配置 JupyterLab 数据科学环境

输入你的密码并点击 Login 按钮以打开 JupyterLab 界面。

在 Rocky Linux 9 上安装并配置 JupyterLab 数据科学环境

既然访问已确认,按 Ctrl + C 停止服务器,并在提示时输入 y 确认停止。

步骤 5 - 创建 JupyterLab 服务文件

退出虚拟环境。

(jupyterlab_env) $ deactivate

为 JupyterLab 创建一个新的服务文件。

$ sudo nano /lib/systemd/system/jupyterlab.service

在其中粘贴以下代码。

[Unit]
Description=JupyterLab Server

[Service]
User=USER
Group=USER
Type=simple
WorkingDirectory=/home/USER/jupyterlab
ExecStart=/home/USER/jupyterlab/jupyterlab_env/bin/jupyter-lab --config=/home/USER/.jupyter/jupyter_lab_config.py
StandardOutput=null
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

按 Ctrl + X 保存文件,并在提示时输入 Y。

将 USER 替换为当前登录系统的用户。

初始化 JupyterLab 服务。

$ sudo systemctl daemon-reload

启用并启动 JupyterLab 服务。

$ sudo systemctl enable jupyterlab --now

检查服务的状态。

$ sudo systemctl status jupyterlab
? jupyterlab.service - JupyterLab Server
     Loaded: loaded (/usr/lib/systemd/system/jupyterlab.service; disabled; vendor preset: disabled)
     Active: active (running) since Tue 2022-12-13 11:45:26 UTC; 5s ago
   Main PID: 151675 (jupyter-lab)
      Tasks: 1 (limit: 5911)
     Memory: 59.0M
        CPU: 1.943s
     CGroup: /system.slice/jupyterlab.service
             ??151675 /home/navjot/jupyterlab/jupyterlab_env/bin/python3 /home/navjot/jupyterlab/jupyterlab_env/bin/jupyter-lab --config=/home/navjot/.jupyter/jupyter_lab_config.py

Dec 13 11:45:26 jupyter.example.com systemd[1]: Started JupyterLab Server.

步骤 6 - 安装 SSL

在继续之前,我们需要为域名安装 Certbot 工具以及 SSL 证书。

要安装 Certbot,我们将使用 Snapd 包安装器。Snapd 始终提供最新稳定版本的 Certbot,你应该使用它。

Snapd 工具需要 Epel 仓库才能工作。

$ sudo dnf install epel-release -y

我们将使用 Snapd 来安装 Certbot。安装 Snapd。

$ sudo dnf install snapd -y

启用并启动 Snap 服务。

$ sudo systemctl enable snapd.socket --now

创建 Snapd 工作所需的链接。

$ sudo ln -s /var/lib/snapd/snap /snap
$ echo 'export PATH=$PATH:/var/lib/snapd/snap/bin' | sudo tee -a /etc/profile.d/snapd.sh

确保你安装的 snapd 版本是最新的。

$ sudo snap install core 
$ sudo snap refresh core

安装 Certbot。

$ sudo snap install --classic certbot

使用以下命令,通过创建指向 /usr/bin 目录的符号链接,确保可以运行 Certbot 命令。

$ sudo ln -s /snap/bin/certbot /usr/bin/certbot

生成 SSL 证书。

$ sudo certbot certonly --nginx --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m 
[email protected]
 -d jupyterlab.example.com

以上命令会将证书下载到服务器上的 /etc/letsencrypt/live/jupyterlab.example.com 目录。

生成 Diffie-Hellman 组证书。

$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096

对该过程进行一次试运行(dry run),以检查 SSL 续期是否正常工作。

$ sudo certbot renew --dry-run

如果没有看到错误,你就已全部准备就绪。你的证书将自动续期。

步骤 7 - 配置 Nginx

创建并打开文件 /etc/nginx/conf.d/jupyterlab.conf 进行编辑。

$ sudo nano /etc/nginx/conf.d/jupyterlab.conf

在 jupyterlab.conf 文件中粘贴以下代码。将所有 jupyterlab.example.com 替换为你自己的域名。

## enforce HTTPS
server {
  listen 80;
  listen [::]:80;
  server_name jupyterlab.example.com;
  return 301 https://$server_name$request_uri;
}

server {
  listen 443 ssl http2;
  listen [::]:443 ssl http2;
  server_name jupyterlab.example.com;

  access_log /var/log/nginx/jupyterlab.access.log;
  error_log /var/log/nginx/jupyterlab.error.log;
  client_max_body_size 20m;

  http2_push_preload on; # Enable HTTP/2 Server Push

  ssl_certificate     /etc/letsencrypt/live/jupyterlab.example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/jupyterlab.example.com/privkey.pem;
  ssl_trusted_certificate /etc/letsencrypt/live/jupyterlab.example.com/chain.pem;
  ssl_session_timeout 1d;

  # Enable TLS versions (TLSv1.3 is required upcoming HTTP/3 QUIC).
  ssl_protocols TLSv1.2 TLSv1.3;

  # Enable TLSv1.3's 0-RTT. Use $ssl_early_data when reverse proxying to
  # prevent replay attacks.
  #
  # @see: https://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_early_data
  ssl_early_data on;

  ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384';
  ssl_prefer_server_ciphers on;
  ssl_ecdh_curve X25519:prime256v1:secp384r1:secp521r1;
  ssl_session_cache shared:SSL:50m;
  ssl_session_tickets off;

  # OCSP Stapling ---
  # fetch OCSP records from URL in ssl_certificate and cache them
  ssl_stapling on;
  ssl_stapling_verify on;
  ssl_dhparam /etc/ssl/certs/dhparam.pem;

  add_header X-Early-Data $tls1_3_early_data;

  location / {
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header X-Scheme $scheme;
    proxy_buffering off;
    proxy_set_header X-Forwarded-Proto https;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass http://127.0.0.1:8888;
  }
}

# This block is useful for debugging TLS v1.3. Please feel free to remove this
# and use the `$ssl_early_data` variable exposed by NGINX directly should you
# wish to do so.
map $ssl_early_data $tls1_3_early_data {
  "~." $ssl_early_data;
  default "";
}
map $http_upgrade $connection_upgrade {
  default upgrade;
  '' close;
}

以上配置会将所有 HTTP 请求重定向到 HTTPS,并作为 JupyterLab 服务的代理,通过你的域名提供访问。

按 Ctrl + X 保存文件,并在提示时输入 Y。

打开文件 /etc/nginx/nginx.conf 进行编辑。

$ sudo nano /etc/nginx/nginx.conf

在 include /etc/nginx/conf.d/*.conf; 这一行之前添加以下行。

server_names_hash_bucket_size  64;

按 Ctrl + X 保存文件,并在提示时输入 Y。

验证你的 Nginx 配置。

$ sudo nginx -t

如果没有看到错误,说明一切就绪。重新加载 Nginx 服务器。

$ sudo systemctl reload nginx

现在你可以在浏览器中访问 URL https://jupyterlab.example.com 来使用 JupyterLab。

总结

本教程到此结束,我们介绍了如何在 Rocky Linux 9 服务器上安装并配置 JupyterLab,并使用 Nginx 代理服务器对外提供服务。如果你有任何问题,请在下方评论中留言。