企业官网建设流程全解析

Bambuddy零门槛安装：Windows原生安装器完整教程（无需Python和Docker）

【免费下载链接】bambuddyYour Bambu Lab. No Cloud. Your Rules. Self-hosted command center for Bambu Lab — from one A1 to an entire print farm.项目地址: https://gitcode.com/gh_mirrors/ba/bambuddy

Bambuddy 是一款自托管的 Bambu Lab 3D 打印机管理中心，让你脱离 Bambu Lab 官方云服务，完全掌控自己的打印机。本文是面向新手的Windows 原生安装器完整教程：一个自包含的.exe安装包，内置 Python 运行时、前端界面和所需工具，无需在电脑上预装 Python、Node.js 或 Docker，几分钟即可把 Bambuddy 装成 Windows 服务并自动开机启动。

为什么选择 Windows 原生安装器？

很多 3D 打印新手看到 "self-hosted（自托管）" 就觉得门槛高。Bambuddy 的 Windows 安装器 installers/windows/README.md 正是为此设计：

安装器内嵌了 Python 3.13、构建好的 React 前端、ffmpeg 和 NSSM 服务管理器，安装位置在C:\Program Files\Bambuddy\，数据统一放在C:\ProgramData\Bambuddy\——程序与数据分离，是典型的"像普通 Windows 软件一样"的体验。

💡 安装细节（目录结构、服务命令、端口）可参考安装器脚本 installers/windows/bambuddy.iss 与服务注册脚本 installers/windows/service/install-service.bat。

安装前检查清单（1分钟）

在开始安装前，请确认以下条件，避免装完却连不上打印机：

• ✅Windows 10/11 x64系统（管理员权限，用于注册服务）
• ✅ 电脑与 Bambu Lab 打印机在同一局域网
• ✅ 打印机已开启Developer Mode（开发者模式）：
  1. 打印机屏幕：设置→网络→仅局域网模式（LAN Only Mode）→ 开启
  2. 开启Developer Mode（仅局域网模式下才会出现）
  3. 记下屏幕显示的Access Code（访问码）
  4. 在网络设置中找到打印机IP 地址，在设备信息中找到序列号
• ✅ （可选但推荐）在 Bambu Studio 或 OrcaSlicer 中开启"Store sent files on external storage"，这样 3MF 文件会存入打印机卡，Bambuddy 才能提取缩略图和 3D 预览

四步完成 Bambuddy Windows 原生安装

第 1 步：下载最新安装器

前往 Bambuddy 项目的 Releases 发布页，下载最新的 Windows 安装文件bambuddy-windows-x64-setup.exe（文件名以-windows-x64-setup.exe结尾的都是 Windows 安装器）。建议同时记住当前版本号，方便日后核对。

第 2 步：运行安装器，通过 SmartScreen 提示

双击运行安装器。首次运行会弹出一次UAC 管理员确认（因为需要注册 Windows 服务），点击"是"即可。

由于官方代码签名仍在认证流程中，首次运行可能出现"Windows 已保护你的电脑"（SmartScreen）警告——这是预期行为，安全无碍：点击更多信息（More info）→ 仍要运行（Run anyway）继续。

安装过程中可以按需勾选两个附加项：

• 创建桌面快捷方式：在桌面生成打开面板的快捷方式
• 添加 Windows 防火墙规则：为 8000 端口放行入站连接，方便局域网内其他设备访问面板

第 3 步：等待服务自动注册并启动

安装脚本会自动完成（对应 install-service.bat）：

1. 通过 NSSM 注册名为Bambuddy的 Windows 服务
2. 配置为自动启动（开机自启），以 LocalSystem 身份运行
3. 启动服务后，Web 服务监听8000端口
4. 安装结束时自动用默认浏览器打开http://localhost:8000

如果浏览器没有自动打开，手动访问上面的地址即可看到 Bambuddy 面板。开始菜单中还有三个入口：Open Bambuddy Dashboard、Bambuddy Logs（直达日志目录）、Uninstall Bambuddy。

第 4 步：添加第一台打印机

在面板的 Add Printer 对话框中填入：

• 打印机IP 地址（同一局域网下可尝试自动发现）
• Access Code（开发者模式屏幕上显示的访问码）
• 序列号

连接成功后，打印机卡片会实时显示状态、温度、耗材与摄像头画面：

安装完成后：常用操作速览

把打印任务加入队列

上传切片文件后，可以从文件管理器、MakerWorld 导入或直接选择打印机发起打印，所有任务都会进入统一的打印队列，支持定时、批量、多机派发：

查看日志与更新 Bambuddy

• 日志位置：C:\ProgramData\Bambuddy\logs\，其中service-stdout.log/service-stderr.log由 NSSM 自动滚动（10MB 轮转）
• 数据位置：C:\ProgramData\Bambuddy\data\，数据库与打印档案都保存在这里

升级只需下载新版安装器覆盖安装即可——安装脚本会先停止旧服务再替换文件，数据库和档案完整保留。面板的设置页也会检测到新版时显示"下载 Windows 安装器"按钮（更新逻辑见 backend/app/api/routes/updates.py）：

卸载通过控制面板或开始菜单的 Uninstall 入口执行，卸载脚本（uninstall-service.bat）会先停止并注销服务再删除程序文件，而C:\ProgramData\Bambuddy下的数据默认保留，重装后自动恢复。

常见问题（FAQ）

Q1：安装后浏览器打不开 localhost:8000？打开services.msc检查 "Bambuddy" 服务是否处于运行状态；再看C:\ProgramData\Bambuddy\logs\下的 stderr 日志。若端口被其他程序占用，服务会启动但无法监听，先释放 8000 端口。

Q2：SmartScreen 警告还能放心装吗？能。这是未签名软件的常规提示，从官方 Releases 页面下载的安装器可放心选择"仍要运行"；后续官方签名生效后该提示会消失。

Q3：打印机发现不了怎么办？确认电脑和打印机在同一局域网、防火墙未拦截，并已在打印机上开启"仅局域网模式 + Developer Mode"；也可以直接手动输入 IP 添加。

Q4：能装到 Windows Server 或旧版 Windows 吗？安装器要求 Windows 10/11 x64（安装脚本限制x64compatible架构），32 位系统不受支持。

Q5：和 Docker 安装冲突吗？可以共存吗？不推荐在同一台机器上对同一台打印机同时跑两套 Bambuddy，会造成 MQTT 连接冲突。

总结

Bambuddy Windows 原生安装器把"自托管"的门槛降到了最低：下载 → 运行 → 点"仍要运行" → 浏览器自动打开面板，全程不碰命令行、不装 Python 和 Docker。程序装在C:\Program Files\Bambuddy\，数据独立存放在C:\ProgramData\Bambuddy\，服务随系统自启，更新只需覆盖安装。安装完成后，你拥有的就是一个完全私有的 Bambu Lab 打印农场指挥中心——从一台 A1 到整个打印车间，都由你说了算。

更多功能与安装方式（Docker、Linux/macOS 手动安装）请参考 README.md。

【免费下载链接】bambuddyYour Bambu Lab. No Cloud. Your Rules. Self-hosted command center for Bambu Lab — from one A1 to an entire print farm.项目地址: https://gitcode.com/gh_mirrors/ba/bambuddy