-
1 5M Klipper 固件
-
2 启用SimplyPrint
开始之前：自定义固件
您的Flashforge Adventurer 5M (Pro)需要自定义固件才能与SimplyPrint配合使用。
我们知道这听起来很技术化，这也是较复杂的设置之一，但我们已尽力让它尽可能简单直接。
部分打印机制造商并未为SimplyPrint等平台提供便捷的通信方式。社区因此开发了替代固件，以解锁这些功能。
是的！该固件由活跃的社区开发，通常可以移除，并保留打印机的核心功能。如有需要，您通常可以回滚或恢复出厂设置。
关于保修的说明
部分制造商可能将自定义固件视为影响保修的改动。风险很低，至今我们尚未发现任何SimplyPrint用户因这种设置而损坏打印机，或被拒绝保修维修的案例。
不过，是否继续最终由您决定。
预计时间：15至30分钟
我们将指导您完成每一步。
欢迎使用SimplyPrint的**Flashforge Adventurer 5M (Pro)**设置指南！
本指南将带您逐步了解如何使用Klipper Mod（一款可在您的打印机上运行Moonraker、Klipper、Mainsail和Fluidd的非官方改装）将您的Flashforge Adventurer 5M或5M Pro连接到SimplyPrint。
本指南基于xblax的出色工作。如需了解最新动态和详细信息，请访问官方Klipper Mod GitHub仓库。
备选方案：ZMOD固件 - 也支持AD5X型号。如果您使用AD5X或更倾向于ZMOD，请参阅我们的AD5X指南和ZMOD项目。
什么是 Klipper Mod？
Klipper Mod 旨在充分释放 Flashforge AD5M（Pro）上开源软件的全部潜力，同时保持完全可移除，不会破坏原厂软件的任何功能。
功能包括：
- Klipper 0.13，配置有所改进
- Moonraker、Mainsail 和 Fluidd 网页界面
- 支持摄像头串流
- 通过以太网和 WiFi 联网
- SSH root访问权限（登录名：
root，密码：klipper） - 可与原厂 Flashforge 软件组成“双系统启动”
注意： 该模组目前处于测试阶段。虽然稳定性表现良好，但仍需长期测试验证。
支持的打印机
本指南支持：
- Flashforge Adventurer 5M
- Flashforge Adventurer 5M Pro
- 不支持：
- 据我们所知，截至2025年10月，AD5X打印机尚不受“flashforge_ad5m_klipper_mod”社区固件支持
- 另一款社区制作的固件 GitHub 上的 ZMOD 项目同时支持 5M、5M Pro 以及 AD5X
- 据我们所知，截至2025年10月，AD5X打印机尚不受“flashforge_ad5m_klipper_mod”社区固件支持
重要提示： Mod 安装程序要求您的打印机已更新至官方 Flashforge 固件的 2.4.5 版或更高版本。请查看版本发布页面以了解已知可用的版本。
开始之前
您需要准备：
- 一个 USB 闪存驱动器（已格式化为 FAT32）
- 打印机已更新至固件版本2.4.5或更高
选择您的版本： Klipper Mod 有三个版本：
- 默认（无图形界面模式）： 没有屏幕端图形界面控制程序
- KlipperScreen： 具有完整 KlipperScreen 安装的 Beta 版本
- GuppyScreen： 轻量级界面的 Alpha 版本
对于大多数用户，我们建议从默认变体开始。
安装步骤
- 下载Klipper Mod：
- 访问Klipper Mod发布页面。
- 为您的打印机下载最新的
Adventurer5M-KlipperMod*.tgz文件。 - 5M Pro 用户须知： 请将文件重命名为
Adventurer5MPro-*.tgz（压缩包内容相同，但 5M Pro 要求使用此命名）。
- 准备U盘：
- 将您的 USB 驱动器格式化为 FAT32。
- 不确定如何格式化？ 在 Windows 上，右键点击该驱动器并选择**“格式化”。在 macOS 上，使用磁盘工具并选择“抹掉”**，格式选择 MS-DOS（FAT）。
- 将下载的
.tgz文件直接复制到 USB 驱动器的根目录。
- 在打印机上安装：
- 如果打印机当前处于开机状态，请关闭打印机。
- 启动打印机之前，先将U盘插入打印机。
- 打开打印机电源。
- 打印机将自动检测并安装Klipper Mod。
- 安装过程中，MCU 固件将更新以匹配 Klipper 版本。
- 完成后，屏幕上会显示成功字样。
- 查看安装日志（如有需要）：
- 安装完成后，系统会将日志文件
klipper_mod_install.log写入 USB 驱动器。 - 如果安装失败，请查看此文件以获取错误详情。
初始网络设置
安装后，该模组已预先配置为 DHCP（自动 IP 分配）。
查找您打印机的 IP 地址：
- 通过以太网线将打印机连接到您的网络。
- 请在家庭路由器的网页管理界面中查找分配给打印机的 IP 地址。
可选：WiFi 设置
- 如需配置 WiFi，请访问 Klipper Mod WiFi 文档。
- 安装过程中，您还可以安装自定义WiFi配置文件。详情请参阅安装文档。
访问您打印机的网页界面
安装完成且打印机已连接到网络后，您可以访问：
- Mainsail：
http://[printer-ip]:4000 - Fluidd：
http://[printer-ip]:4001 - Moonraker： 端口 7125
- 摄像头串流：
http://[printer-ip]:8080（如已配置）
将 [printer-ip] 替换为您打印机的实际 IP 地址。
与原厂固件双系统启动
即使安装了改装模块，您仍然可以启动 Flashforge 原厂软件：
- U盘方法： 将名为
klipper_mod_skip的文件放到U盘中，并在打印机启动前插入U盘。 - SSH 方法： 通过 SSH 登录并运行
reboot-stock-system。 - Klipper 宏： 执行
REBOOT_STOCK_SYSTEM宏。
使用双系统启动时，MCU 固件会在原厂版本和 Klipper 版本之间自动切换。
重要提示
- 更新 mod： 下载新版本并按照相同的安装步骤操作。更新过程中大多数本地更改都会丢失，因此请先备份重要文件。
- 卸载： 请按照卸载指南移除该 mod 并恢复原厂功能。
- 帮助与支持： 如遇到问题，请访问 GitHub Discussions 或提交一个 Issue。
现在，请继续进行下一步，我们将把您的打印机连接到SimplyPrint！
