Mac/Linux 下 Jupyter Notebook 安装、配置与远程访问指南

晚来风
晚来风
发布时间:2026-10-13| 6人浏览过
原创

本文详细介绍在 Mac 和 Linux 系统中安装 Jupyter Notebook 的方法,重点讲解如何生成配置文件、设置访问密码以及解决远程访问时的端口占用和 Root 权限问题,帮助用户实现通过浏览器远程安全使用 Jupyter。

Jupyter Notebook 已逐渐取代传统 IDE,成为在多个平台上编写简单 Python 脚本或应用的热门选择之一。

可以通过 pip 或 pip3 命令来安装 Jupyter Notebook。

pip3 install jupyter

安装完成后,在目标文件夹目录下运行指令 jupyter notebook 即可启动服务。此时,你可以在浏览器地址栏输入 localhost:8888 来访问 Jupyter Notebook 的主页。

配置允许远程访问

在本地环境中,直接访问 localhost:8888 即可看到 Jupyter Notebook 的主页。然而,若需从远程设备访问,则不能直接沿用此方式,需要进行以下额外配置:

第一步:生成 Notebook 配置文件

默认情况下,配置文件 ~/.jupyter/jupyter_notebook_config.py 并不存在,需要手动创建。可以使用以下命令来生成该配置文件:

jupyter notebook --generate-config

如果以 root 用户身份执行上述命令,系统会提示一个安全警告:

Running as root it not recommended. Use --allow-root to bypass.

提示信息非常明确:root 用户执行时必须添加 --allow-root 选项才能绕过限制。

jupyter notebook --generate-config --allow-config

成功执行后,终端会显示如下信息:

Writing default config to: /root/.jupyter/jupyter_notebook_config.py

第二步:生成访问密码

从 Jupyter Notebook 5.0 版本开始,官方提供了一个专门用于设置密码的命令:jupyter notebook password。设置生成的密码将存储在 jupyter_notebook_config.json 文件中。

$ jupyter notebook password
Enter password: ****
Verify password: ****
[NotebookPasswordApp] Wrote hashed password to /Users/you/.jupyter/jupyter_notebook_confi

第三步:实现远程访问

完成上述设置后,即可在服务器上启动 Jupyter Notebook。普通用户直接运行 jupyter notebook,而 root 用户需使用 jupyter notebook --allow-root 启动。随后,在浏览器中打开服务器 IP 及指定端口(默认为 8888),输入之前设置的密码即可访问。

如果默认的 8888 端口被其他进程占用,导致浏览器无法通过 IP:8888 访问,可以通过以下方式指定其他端口启动 Jupyter Notebook:

jupyter notebook --no-browser --port 6000 --ip=192.168.1.103

即通过命令行指定端口号和 IP 地址。配置完成后,在浏览器中输入 ip:端口号,即可看到对应的 Jupyter 界面。

总结

以上就是本文的全部内容,希望这些内容能对您的学习或工作有所帮助。感谢大家对本站的支持。如果您想了解更多相关信息,请查阅下方的相关链接。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。