Jupyter Notebook 服务器安装配置详解
Jupyter Notebook 服务器安装配置详解
一、开机配置
1. 更新系统包列表
sudo apt update
- sudo：以超级用户（管理员）权限执行命令
- apt：Advanced Package Tool，Ubuntu/Debian 系统的包管理工具
- update：从软件源服务器获取最新的软件包列表信息，不实际更新软件
2. 升级系统软件
sudo apt upgrade
- upgrade：根据
apt update获取的最新列表，升级系统中已安装的所有软件包到最新版本 - 执行此命令时可能需要输入
Y确认安装
3. 安装 Python 包管理工具
sudo apt install python3-pip
- install：apt 的安装命令
- python3-pip：Python 3 的包管理工具，用于安装和管理 Python 库
4. 升级 pip 版本
sudo pip3 install --upgrade pip
- pip3：Python 3 的 pip 命令
- install --upgrade：升级指定的软件包，这里是升级 pip 自身
- 注：高版本 Linux 系统可能会因系统保护机制报错，可尝试不加
sudo或使用--user参数
二、安装和配置 Jupyter Notebook
1. 安装 Jupyter Notebook
sudo pip3 install notebook
- notebook：Jupyter Notebook 的 Python 包名称
- 此命令会安装 Jupyter Notebook 及其所有依赖组件
2. 尝试启动 Jupyter Notebook
jupyter notebook --allow-root
- jupyter notebook：启动 Jupyter Notebook 服务的命令
- –allow-root：允许以 root 用户身份运行 Jupyter（不推荐在生产环境使用）
- 注意：直接在服务器上启动无法在本地浏览器访问，需要进行端口配置
3. 防火墙配置
安装并启用防火墙
sudo apt-get install ufw
- ufw：Uncomplicated Firewall，简化的防火墙管理工具
sudo ufw enable
- enable：启用 ufw 防火墙，系统重启后会自动生效
开放 8888 端口
sudo ufw allow 8888/tcp
- allow 8888/tcp：允许 TCP 协议通过 8888 端口（Jupyter 默认端口）
重载防火墙规则
sudo ufw reload
- reload：重新加载防火墙规则，使配置的端口生效
4. Jupyter 配置文件生成
jupyter notebook --generate-config
- –generate-config：生成 Jupyter Notebook 的配置文件
- 配置文件默认路径：
/root/.jupyter/jupyter_notebook_config.py
5. 设置访问密码
启动 IPython 交互环境
ipython
- IPython：增强版的 Python 交互式解释器，提供更丰富的功能
生成密码哈希（旧版本 Jupyter）
from notebook.auth import passwd
hashed_password = passwd()
print(hashed_password)
- from notebook.auth import passwd：导入密码处理函数
- passwd()：交互式创建密码并返回加密后的哈希值
- 执行后会提示输入并确认密码，然后生成类似
argon2:$argon2id$...的加密字符串
生成密码哈希（新版本 Jupyter）
from jupyter_server.auth import passwd
hashed_password = passwd()
print(hashed_password)
- 新版本中密码认证模块移到了
jupyter_server.auth下，用法相同
退出 IPython 环境
quit() # 或 exit()
6. 编辑 Jupyter 配置文件
sudo vim /root/.jupyter/jupyter_notebook_config.py
- vim：Linux 系统下的文本编辑器，用于修改配置文件
7. 添加配置内容
在配置文件末尾添加以下内容：
c.NotebookApp.ip='*'
c.NotebookApp.password =u'之前复制的字符串'
c.NotebookApp.open_browser = False
c.NotebookApp.port =8888
c.NotebookAPP.allow_root = True
- c.NotebookApp.ip=‘*’：允许任何 IP 地址访问
- c.NotebookApp.password：设置之前生成的密码哈希值
- c.NotebookApp.open_browser = False：启动时不自动打开浏览器
- c.NotebookApp.port =8888：设置服务端口为 8888
- c.NotebookAPP.allow_root = True：允许 root 用户运行
8. 访问 Jupyter Notebook
完成配置后，通过 服务器IP:8888 即可在浏览器中访问 Jupyter Notebook，输入设置的明文密码即可登录使用。
注：不同云服务器厂商还需要在控制台的安全组设置中开放 8888 端口，具体操作因厂商而异。
