在Qidi Tech Q1 Pro上设置 SimplyPrint

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

Qidi Tech Q1 Pro image
返回Qidi Tech

提示：此设置包含一个技术性步骤

您需要使用一种名为“SSH”的工具来运行一些命令。

我们知道—我们也希望能跳过这部分。但您的设备并未提供更简单的方式。好消息是，这只是复制粘贴而已。只要您能按照说明操作，就能完成。

为什么需要SSH？

您打印机的制造商未提供更简单的方式供 SimplyPrint 等平台连接。SSH 是我们用来绕过此限制、为您提供所需功能的方法。

您打算用SSH做什么？

您将运行我们提供的几条命令，大多只需复制粘贴，无需编写代码。

初次接触SSH？没问题！

SSH：它是什么，如何使用

我们会为您提供需要运行的确切命令。

风险自负：此脚本已在多款打印机上测试，会在您现有设置的基础上安装一个独立的Moonraker实例，不会修改您的Klipper配置或固件。但是，对打印机软件进行任何修改都存在一定风险。我们无法保证与每种打印机或配置兼容，也不对可能出现的任何问题负责。如果出现问题，您通常可以移除已安装的文件并重启打印机，以恢复到原始状态。

1. 查找您打印机的 IP 地址

您需要知道打印机的IP地址才能连接到它。

查找 IP 地址
  • IP 地址通常会显示在打印机屏幕上，或在其网络设置中显示
  • 找不到？请在路由器设置中查看已连接的设备
  • 或使用网络扫描工具，例如Angry IP Scanner

2. 通过 SSH 连接

通过 SSH，您可以在打印机的内置电脑上运行命令。

是的，这确实是令人厌烦的技术环节。很抱歉，我们已经尝试了一切方法来避免它，但您的设备就是没有其他选择。

但事实是：这比看起来简单得多。您只需要复制粘贴几条命令，仅此而已。请在下方选择您的电脑类型并按步骤操作—我们会引导您完成每一步。

重要提示：IP地址只能是数字（例如192.168.1.42），不要包含http://、斜杠或端口号。
Windows 10 / 11
  1. 按 Win + X，然后选择“终端”或“PowerShell”
  2. 输入SSH命令（替换占位符）：
    ssh username@ip-address
    示例：ssh [email protected]
  3. 如果系统提示“您确定要继续连接吗？”，请输入yes并按Enter键
  4. 出现提示时输入密码
    输入密码时不会显示—这是正常现象！直接输入并按回车即可。
macOS
  1. 按 Cmd + Space 打开 Spotlight，输入“终端”，然后按 Enter
  2. 输入SSH命令（替换占位符）：
    ssh username@ip-address
    示例：ssh [email protected]
  3. 如果系统提示“您确定要继续连接吗？”，请输入yes并按Enter键
  4. 出现提示时输入密码
    输入密码时不会显示—这是正常现象！直接输入并按回车即可。
Linux
  1. 打开终端（通常是Ctrl + Alt + T，或在应用程序菜单中查找）
  2. 输入SSH命令（替换占位符）：
    ssh username@ip-address
    示例：ssh [email protected]
  3. 如果系统提示“您确定要继续连接吗？”，请输入yes并按Enter键
  4. 出现提示时输入密码
    输入密码时不会显示—这是正常现象！直接输入并按回车即可。
Chromebook
首次设置：您需要在Chromebook上启用Linux（仅需一次）。
  1. 启用Linux（如已完成请跳过）：
    • 打开设置
    • 前往高级→开发者
    • 开启“Linux开发环境”
    • 按照设置向导操作（需要几分钟）
  2. 从应用程序启动器中打开“终端”应用
  3. 输入SSH命令（替换占位符）：
    ssh username@ip-address
    示例：ssh [email protected]
  4. 如果系统提示“您确定要继续连接吗？”，请输入yes并按Enter键
  5. 出现提示时输入密码
    输入密码时不会显示—这是正常现象！直接输入并按回车即可。
常见故障
  • "Connection refused"—请确保您与打印机处于同一网络，并且IP地址正确无误。
  • "Permission denied"—请仔细检查您的用户名和密码。
  • "Host key verification failed"—说明设备已被重置或重新安装。请使用以下命令删除旧密钥：ssh-keygen -R <ip-address>
使用平板电脑或手机？

虽然 Android 和 iOS 都有可用的 SSH 应用，但我们建议使用电脑进行 SSH 连接。合适的键盘和屏幕能让输入命令容易得多。

打开终端后，连接到打印机：

ssh mks@YOUR_IP_ADDRESS

将 YOUR_IP_ADDRESS 替换为您打印机的 IP 地址，例如 ssh [email protected]

系统提示输入密码时，请输入 makerbase 并按 Enter 键。输入时密码不会显示，这是正常现象。

3. 如遇到 SSL 错误,请修正日期

sudo date -s '2026-08-07'

复制粘贴上面的命令，其中已包含今天的日期。系统可能会提示您输入密码，请使用makerbase。

4. 安装 SimplyPrint

现在我们将下载并运行安装脚本。

该脚本需要打印机上安装bash、git和Python 3.7+，几乎所有Klipper打印机都已预装这些组件。

步骤1：下载安装脚本： 

wget -O moonraker-sp.sh https://download.simplyprint.io/klipper/moonraker-sp.sh && chmod +x moonraker-sp.sh

步骤2：运行安装程序： 

./moonraker-sp.sh --install

系统可能会提示您输入密码，请使用 makerbase。

5. 获取您的设置代码

脚本运行完成后，会显示打印机的设置代码。

使用此代码，在SimplyPrint面板中关联您的打印机，或查看您的打印机是否已自动显示在待处理打印机下。

此脚本的作用是什么？它会在您现有的打印机设置基础上，安装一个包含SimplyPrint组件的独立最新版Moonraker实例。您现有的Klipper配置和网页界面（Mainsail/Fluidd）不会被修改。新的Moonraker实例运行在不同的端口上，仅负责处理与SimplyPrint的连接。

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

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

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

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

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

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

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

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

创建您的免费账户
返回

常见问题

Makerbase（MKS）是一家 3D 打印机主板制造商。包括 Elegoo、Qidi Tech 和 Comgrow 在内的多个打印机品牌，其 Klipper 打印机使用的都是 Makerbase 主板。这些主板通常预装了过时或经过修改的 Moonraker 版本，并不包含对 SimplyPrint 的支持。
搭载 Makerbase 主板的打印机通常预装经过修改或过时版本的 Moonraker，缺少 [simplyprint] 组件。制造商提供的版本通常无法通过网页界面轻松更新，因此我们使用脚本在您现有设置的基础上安装一个全新的、最新版本的 Moonraker 实例。
该脚本会安装一个独立的、最新版本的Moonraker实例，并完整支持SimplyPrint。它与您现有的Klipper设置并行运行，不会修改打印机的配置。可以将其理解为在SimplyPrint与您的打印机之间新增了一座“桥梁”。
这在采用Makerbase主板的打印机（尤其是Qidi Tech机型）中较为常见，原因是系统时钟通常设置不正确。请运行以下命令进行修复：sudo date -s 'YYYY-MM-DD'（替换为今天的日期）。然后重试安装。
这是正常现象！打印机的主板性能有限，此步骤会在后台升级Python软件包，可能需要长达10分钟。请勿取消或重启，只需耐心等待其完成即可。
如果您可以在打印机上访问Mainsail或Fluidd，并且常规的Klipper设置对您有效，那太好了！本SSH指南专门用于常规方法因Moonraker版本过旧或缺少[simplyprint]组件而无法生效的情况。