Jupyter 管理树莓派 5 上的 Python
用 Jupyter 管理树莓派 5 上的 Python 程序，核心方案是在树莓派端部署 JupyterLab 服务，电脑通过浏览器远程访问，全程图形化操作，无需给树莓派接显示器，即可完成代码编写、文件管理、依赖安装、硬件调试等全流程操作。
以下是完整的部署与使用教程，基于树莓派官方系统 Raspberry Pi OS（Bookworm 及以上版本）。
一、树莓派端：安装并配置 JupyterLab
1. 基础环境准备
先通过 SSH 连接树莓派（或直接在树莓派终端操作），执行系统更新并安装基础依赖：
bash
运行
sudo apt update && sudo apt upgrade -y sudo apt install python3-pip python3-venv -y2. 安装 JupyterLab
执行 pip 安装，安装完成后将可执行文件路径加入系统环境变量：
bash
运行
pip3 install jupyterlab echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc验证安装是否成功：
bash
运行
jupyter --version3. 设置登录密码
配置远程访问密码，避免每次复制 token：
bash
运行
jupyter server password按提示输入两次密码，配置会自动保存到用户目录。
4. 开启局域网远程访问
生成配置文件并修改权限，允许同局域网内的电脑访问：
- 生成默认配置文件：
bash
运行
jupyter server --generate-config- 编辑配置文件：
bash
运行
nano ~/.jupyter/jupyter_server_config.py- 在文件末尾添加以下内容（或搜索对应项修改）：
python
运行
# 监听所有IP地址，允许局域网访问 c.ServerApp.ip = '0.0.0.0' # 服务端口，默认8888，可自定义 c.ServerApp.port = 8888 # 允许远程访问 c.ServerApp.allow_remote_access = True # 禁止自动打开浏览器（树莓派无桌面环境时必设） c.ServerApp.open_browser = False按Ctrl+O保存，Ctrl+X退出编辑器。
二、启动 Jupyter 服务（推荐开机自启）
方式 1：临时启动（测试用）
直接执行命令，服务会在当前终端运行，关闭终端则服务停止：
bash
运行
jupyter lab方式 2：配置开机自启（长期使用推荐）
通过 systemd 配置系统服务，树莓派开机后自动运行 JupyterLab：
- 创建服务文件：
bash
运行
sudo nano /etc/systemd/system/jupyterlab.service- 粘贴以下内容（默认用户名为
pi，若修改过用户名请同步替换）：
ini
[Unit] Description=JupyterLab Server After=network.target [Service] User=pi WorkingDirectory=/home/pi ExecStart=/home/pi/.local/bin/jupyter lab --config=/home/pi/.jupyter/jupyter_server_config.py Restart=always RestartSec=10 [Install] WantedBy=multi-user.target- 启用并启动服务：
bash
运行
sudo systemctl daemon-reload sudo systemctl enable jupyterlab sudo systemctl start jupyterlab- 查看运行状态：
bash
运行
sudo systemctl status jupyterlab显示active (running)即为启动成功。
三、电脑端：访问并管理 Python 程序
1. 获取树莓派 IP
在树莓派终端执行以下命令，获取局域网 IP：
bash
运行
hostname -I2. 浏览器访问
确保电脑和树莓派在同一个局域网下，打开浏览器输入：
plaintext
http://树莓派IP:8888输入之前设置的密码，即可进入 JupyterLab 网页界面。
3. 核心管理功能
- 文件可视化管理：左侧文件浏览器可直接新建文件夹、创建
.py脚本 /.ipynb笔记本，支持拖拽上传本地文件、右键下载 / 重命名 / 删除树莓派内的项目文件，无需命令行操作。 - 代码编辑与运行：双击打开 Python 文件，网页内直接编辑代码（支持语法高亮、自动补全）；可右键选择「在终端中运行脚本」，或通过 Notebook 分块调试代码，实时查看输出。
- 硬件程序调试：针对 GPIO、传感器、摄像头等树莓派硬件程序，可通过 Notebook 逐行运行代码，实时查看变量和硬件反馈，比纯命令行调试效率更高。
- 内置终端：左侧启动器打开「Terminal」，直接在网页内操作树莓派命令行，安装 pip 依赖、查看进程、执行系统命令均可完成，无需额外 SSH 工具。
- 多环境隔离：可在终端内创建
venv虚拟环境，为不同项目隔离依赖；安装内核后还可在 Jupyter 内直接切换不同虚拟环境运行代码。
四、安全优化与常见问题
1. 外网安全访问（可选）
若需在外网访问，不要直接映射 8888 端口，推荐通过 SSH 隧道加密访问： 在 Windows 电脑的 PowerShell 中执行：
powershell
ssh -L 8888:localhost:8888 pi@树莓派公网IP保持窗口打开，浏览器访问
http://localhost:8888即可加密连接。
2. 常见问题排查
- 无法访问页面：检查树莓派防火墙是否放行 8888 端口（默认系统无防火墙，若开启执行
sudo ufw allow 8888），确认 IP 和端口正确、服务正常运行。 - 忘记登录密码：在树莓派终端重新执行
jupyter server password即可重置。 - pip 安装慢：树莓派端同样可配置清华镜像源加速：
bash
运行
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple