在Flashforge AD5X上设置 SimplyPrint

只需几个简单步骤，即可将您的Flashforge AD5X 3D 打印机连接到 SimplyPrint。

Flashforge AD5X image
返回打印机兼容性页面
返回Flashforge
  • 1 AD5X ZMOD 固件
  • 2 启用SimplyPrint

开始之前：自定义固件

您的Flashforge Adventurer 5X需要自定义固件才能与SimplyPrint配合使用。

我们知道这听起来很技术性，而且这也是较为复杂的设置之一，但我们已尽力让它变得尽可能简单。

为什么需要定制固件？

部分打印机制造商并未为SimplyPrint等平台提供便捷的通信方式。社区因此开发了替代固件，以解锁这些功能。

这样安全吗？

是的！该固件由活跃的社区开发，通常可以移除，并保留打印机的核心功能。如有需要，您通常可以回滚或恢复出厂设置。

关于保修的说明

部分制造商可能会将自定义固件视为一种保修变更。这种风险很低，迄今为止，我们尚未发现任何 SimplyPrint 用户因这种设置而损坏打印机或被拒绝保修维修的已知案例。

不过，是否继续最终由您决定。

预计时间：15至30分钟

我们将指导您完成每一步。

欢迎使用SimplyPrint的Flashforge AD5X设置指南（通过ZMOD）。

本指南将引导您安装ZMOD，这是一款社区固件改装，可为您的AD5X带来Fluidd/Mainsail + Moonraker。ZMOD运行后，SimplyPrint即可通过标准Moonraker流程连接打印机。ZMOD wiki始终是最权威的信息来源，以下链接均以其为准保持更新。

开始之前

您需要准备：

  • 一个已格式化为 FAT / FAT16 / FAT32 的 USB 闪存驱动器
  • 一台运行兼容官方固件的 AD5X（1.0.2 至 1.1.7，推荐使用 1.1.7）

重要提示： 在 AD5X 上安装 ZMOD 最长可能需要 40 分钟。安装过程中请勿拔出 USB 驱动器或关闭打印机电源，您会看到“Installation in progress”（安装中）画面，完成后显示“Installation is complete”（安装完成）。

1. 安装 ZMOD

请按照 ZMOD wiki 上官方的安装 mod说明操作，该 wiki 是权威信息来源，且每个步骤都配有截图：

https://wiki.zmod.link/Setup/#installing-the-mod

简要版本：

  1. 如果您的AD5X尚未使用兼容的原厂固件，请先使用wiki中链接的Native Firmware .tgz文件进行恢复。
  2. 从https://github.com/ghzserg/zmod/releases/下载最新的AD5X ZMOD发布版（AD5X-zmod-*.tgz）。
  3. 验证 MD5 校验和，并与 ZMOD 发布页面上列出的值进行比对。
  4. 将 .tgz 文件复制到 FAT32 U 盘的根目录下。
  5. 关闭打印机电源，插入 U 盘，然后重新开机。
  6. 等待安装完成（最长可能需要 40 分钟），请勿中断。
  7. 当出现"安装完成"界面时，取出 U 盘并重启打印机电源。

安装后，ZMOD 会在您的打印机上提供 Fluidd/Mainsail 网页界面和 Moonraker API。

2. 打开网页界面

直接在触摸屏上查找您打印机的 IP 地址：主页 → 信息 (i) 按钮 → 查找IP 地址。

然后在浏览器中打开网页界面：

  • Fluidd / Mainsail： http://[printer-ip]/（端口 80）
  • Moonraker API： http://[printer-ip]:7125

将 [printer-ip] 替换为您的 AD5X 打印机的 IP 地址。

如果网页界面无法打开，原装固件可能已禁用该改装。请将AD5X-ENABLE-zmod.tgz复制到USB驱动器并从中启动以重新启用，详情请参见ZMOD wiki。

3. 更新 ZMOD 组件

进入 Fluidd/Mainsail 后：

  1. 前往设置 → 软件更新。
  2. 点击检查更新，然后点击全部更新，这会将Fluidd、Mainsail、Klipper、Moonraker和ZMOD更新到最新版本。
  3. 如果部分插件显示为无效/"仓库已损坏"，请对每个插件点击恢复。这是全新安装时的正常现象，插件与固件是分开下载的。

版本兼容性： 打印机的操作系统版本（系统 → 发行版）必须与 ZMOD 版本的前两位数字一致（设置 → 更新 → ffm5/zmod）。版本不匹配可能导致系统不稳定。

摄像头修复（推荐）

如果原装摄像头无法稳定推流，或未在SimplyPrint中显示，请切换到ZMOD的替代摄像头实现：

替代摄像头方案占用资源更少，并支持更改分辨率。

注意事项和限制

  • 界面语言： 可通过 LANG 宏更改（例如英语使用 LANG LANG=en，此外还有 DE、IT、FR、ES、ZH、JA、KO）。
  • 通过 ZMOD 在 SimplyPrint 中对 AD5X 的材料映射支持情况目前尚不明确，我们尚未在内部进行验证。
  • 如果您遇到问题，请查看 ZMOD wiki 以及本页顶部链接的 SimplyPrint 讨论区。

现在，请继续进行下一步，在您的AD5X上启用SimplyPrint。下一步会要求您将[simplyprint]添加到**/mod_data/user.moonraker.conf**，而不是moonraker.conf，后者由ZMOD自行管理。

需要帮助？
Claude 向 Claude 提问 ChatGPT 向 ChatGPT 提问 Perplexity 向 Perplexity 提问 Grok 向 Grok 提问

每周都有数千人完成此设置。请仔细按步骤操作，大多数问题都是因为跳过步骤所致。

为什么某些设置比较棘手：部分制造商会锁定其打印机，需要通过自定义固件等方式变通处理。如果列出了必需硬件，就没有捷径可走。

关于支持：企业版和学校版套餐可享受直接设置支持。我们的AI支持机器人也能同样有效地帮助其他所有用户。

社区帮助：加入我们的Discord，获取社区支持和其他用户的经验分享。

本指南的 Markdown 版本，可粘贴到任意 AI 助手中

就这样！一切都已准备就绪

您现在可以连接打印机并开始使用SimplyPrint了。

创建您的免费账户
返回 下一步

常见问题

ZMOD是Flashforge AD5X的一个社区固件修改版，用Fluidd/Mainsail和Moonraker替换了官方的网页控制系统。AD5X官方固件未开放Moonraker接口，因此没有ZMOD，SimplyPrint便无法与其连接。安装ZMOD后，您的打印机的使用方式将与其他Klipper/Moonraker打印机相同。
目前这仍属于实验性功能。已有部分用户确认可以完整运行，但我们尚未在内部进行测试。部分功能（例如材料映射）的效果尚不明确。如果遇到问题，请在设置指南中链接的SimplyPrint讨论区分享详细信息。
在 ZMOD 上，您必须将 [simplyprint] 部分添加到 user.moonraker.conf 中，而不是 moonraker.conf。ZMOD 会自行管理 moonraker.conf，并会覆盖您在其中所做的任何更改。该文件位于打印机上的 /mod_data/user.moonraker.conf，在 Fluidd/Mainsail 的配置文件视图中显示为 user.moonraker.conf，下一步设置已经会为您指向正确的文件。
ZMOD支持AD5X官方固件版本1.0.2至1.1.7，推荐使用1.1.7。如果您的打印机使用其他版本，请先通过ZMOD wiki中链接的原厂固件.tgz文件将其恢复到兼容版本。
最长约需 40 分钟。屏幕会先显示“正在安装”，然后显示“安装完成”。安装过程中请勿关闭打印机电源或拔出 U盘。
请先在触摸屏上确认打印机的 IP（主页 → 信息 (i) 按钮 → IP 地址），然后尝试访问 http://[printer-ip]/。如果仍然无法加载，可能是原厂固件已禁用该 mod。将 AD5X-ENABLE-zmod.tgz 复制到 FAT32 格式的 U 盘并从中启动即可重新启用它，具体步骤请参阅AD5X wiki 页面。
通过在 Fluidd/Mainsail 控制台中运行 CAMERA_ON 宏，切换到 ZMOD 的替代摄像头实现。它占用资源更少，并支持更改分辨率。详情请见：https://wiki.zmod.link/Zmod/#camera_on。
目前未知。尚未经过内部验证。多材料功能可能无法正常工作，如果您尝试过，请在SimplyPrint 讨论区分享您的使用体验。