用 Jupyter 管理树莓派 5 上的 Python 程序核心方案是在树莓派端部署 JupyterLab 服务电脑通过浏览器远程访问全程图形化操作无需给树莓派接显示器即可完成代码编写、文件管理、依赖安装、硬件调试等全流程操作。以下是完整的部署与使用教程基于树莓派官方系统 Raspberry Pi OSBookworm 及以上版本。一、树莓派端安装并配置 JupyterLab1. 基础环境准备先通过 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. 设置登录密码配置远程访问密码避免每次复制 tokenbash运行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按CtrlO保存CtrlX退出编辑器。二、启动 Jupyter 服务推荐开机自启方式 1临时启动测试用直接执行命令服务会在当前终端运行关闭终端则服务停止bash运行jupyter lab方式 2配置开机自启长期使用推荐通过 systemd 配置系统服务树莓派开机后自动运行 JupyterLab创建服务文件bash运行sudo nano /etc/systemd/system/jupyterlab.service粘贴以下内容默认用户名为pi若修改过用户名请同步替换ini[Unit] DescriptionJupyterLab Server Afternetwork.target [Service] Userpi WorkingDirectory/home/pi ExecStart/home/pi/.local/bin/jupyter lab --config/home/pi/.jupyter/jupyter_server_config.py Restartalways RestartSec10 [Install] WantedBymulti-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在树莓派终端执行以下命令获取局域网 IPbash运行hostname -I2. 浏览器访问确保电脑和树莓派在同一个局域网下打开浏览器输入plaintexthttp://树莓派IP:8888输入之前设置的密码即可进入 JupyterLab 网页界面。3. 核心管理功能文件可视化管理左侧文件浏览器可直接新建文件夹、创建.py脚本 /.ipynb笔记本支持拖拽上传本地文件、右键下载 / 重命名 / 删除树莓派内的项目文件无需命令行操作。代码编辑与运行双击打开 Python 文件网页内直接编辑代码支持语法高亮、自动补全可右键选择「在终端中运行脚本」或通过 Notebook 分块调试代码实时查看输出。硬件程序调试针对 GPIO、传感器、摄像头等树莓派硬件程序可通过 Notebook 逐行运行代码实时查看变量和硬件反馈比纯命令行调试效率更高。内置终端左侧启动器打开「Terminal」直接在网页内操作树莓派命令行安装 pip 依赖、查看进程、执行系统命令均可完成无需额外 SSH 工具。多环境隔离可在终端内创建venv虚拟环境为不同项目隔离依赖安装内核后还可在 Jupyter 内直接切换不同虚拟环境运行代码。四、安全优化与常见问题1. 外网安全访问可选若需在外网访问不要直接映射 8888 端口推荐通过 SSH 隧道加密访问 在 Windows 电脑的 PowerShell 中执行powershellssh -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