直接用 octoprint_deploy.sh 脚本可在类 Debian/Ubuntu 系统(如 OctoPi)上轻量部署 OctoPrint 多实例,全程命令行操作;需确保 SSH、网络、git、curl、sudo、Python 3.7+ 和 pip3 可用,首次运行选“准备系统”,再选“添加实例”配置名称与模板,实例自动绑定稳定 USB 设备链接并分配独立端口(如 :5001),摄像头流需手动配置,升级前须备份。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

直接用 octoprint_deploy.sh 脚本在本地 Linux 系统(如树莓派上的 OctoPi)安装 OctoPrint 多实例,是目前最轻量、可复用的方式。它不依赖桌面环境或复杂配置,全程命令行完成。
确认系统与基础依赖
脚本仅支持类 Debian/Ubuntu 的 Linux 系统(包括官方 OctoPi 镜像)。需确保:
- 已启用 SSH 并能以
pi@octopi.local(或其他用户)登录 - 系统已联网,且
git、curl、sudo可用 - Python 3.7+ 和
pip3已预装(OctoPi 默认满足)
拉取并运行部署脚本
在终端中依次执行:
git clone https://github.com/paukstelis/octoprint_deploysudo octoprint_deploy/octoprint_deploy.sh
首次运行会进入交互式菜单。选择 “准备系统” —— 这一步会自动注册当前 OctoPi 默认实例,并为后续多实例打下基础(比如 udev 规则、流服务适配等)。
添加第一个(或更多)OctoPrint 实例
回到菜单,选 “添加实例”:
- 输入新实例名称(如
printer2),不重复即可 - 提示是否使用现有实例作模板时,选
yes可复制配置(含插件、API 密钥、切片设置等) - 若打印机无 USB 序列号(如大多数 Creality 设备),脚本会自动基于物理 USB 路径生成稳定设备链接
- 完成后,新实例将运行在独立端口(如
:5001、:5002),可通过浏览器直接访问
注意事项与常见调整
该脚本不是“开箱即用”的黑盒工具,有些细节需手动配合:
- 摄像头流:新实例默认不继承原摄像头配置;若用新版 OctoPi 摄像头堆栈,建议选“跳过/无”流工具,再进新实例的 设置 → Webcam & Timelapse 手动填入
mjpg-streamer地址 - 旧版升级:v1.0.0+ 不兼容旧部署结构;升级前务必用
sudo octoprint_deploy.sh --backup=实例名备份,再用--remove清理后重建 - 服务管理:每个实例作为独立 systemd 服务运行(如
octoprint-printer2),可用sudo systemctl status octoprint-printer2查看状态











