提示:此设置包含一个技术性步骤
您需要使用一种名为“SSH”的工具来运行一些命令。
我们知道—我们也希望能跳过这部分。但您的设备并未提供更简单的方式。好消息是,这只是复制粘贴而已。只要您能按照说明操作,就能完成。
您打印机的制造商未提供更简单的方式供 SimplyPrint 等平台连接。SSH 是我们用来绕过此限制、为您提供所需功能的方法。
您将运行我们提供的几条命令,大多只需复制粘贴,无需编写代码。
本指南的作用
您打印机上的 Moonraker 安装版本已过时,或使用的是不包含 SimplyPrint 支持的厂商修改版本。
本指南使用脚本安装一个内置 SimplyPrint 的全新、最新的 Moonraker 实例,并与您现有的设置并行运行。您的 Klipper 配置不会被修改。
您能访问 Mainsail 或 Fluidd 吗?
如果您可以访问打印机的网页界面(Mainsail或Fluidd),但无法通过SSH登录,请改为尝试常规Klipper设置,您的打印机可能可以通过标准设置正常工作。我们无法百分之百确定此处列出的每台打印机都存在Makerbase问题;有些打印机使用常规方法也可能运行良好。
风险自负:此脚本已在多款打印机上测试,会在您现有设置的基础上安装一个独立的Moonraker实例,不会修改您的Klipper配置或固件。但是,对打印机软件进行任何修改都存在一定风险。我们无法保证与每种打印机或配置兼容,也不对可能出现的任何问题负责。如果出现问题,您通常可以移除已安装的文件并重启打印机,以恢复到原始状态。
1. 查找您打印机的 IP 地址
您需要知道打印机的IP地址才能连接到它。
查找 IP 地址
- IP 地址通常会显示在打印机屏幕上,或在其网络设置中显示
- 找不到?请在路由器设置中查看已连接的设备
- 或使用网络扫描工具,例如Angry IP Scanner
2. 通过 SSH 连接
通过 SSH,您可以在打印机的内置电脑上运行命令。
是的,这确实是令人厌烦的技术环节。很抱歉,我们已经尝试了一切方法来避免它,但您的设备就是没有其他选择。
但事实是:这比看起来简单得多。您只需要复制粘贴几条命令,仅此而已。请在下方选择您的电脑类型并按步骤操作—我们会引导您完成每一步。
192.168.1.42),不要包含http://、斜杠或端口号。
Windows 10 / 11
- 按 Win + X,然后选择“终端”或“PowerShell”
-
输入SSH命令(替换占位符):
示例:
ssh username@ip-addressssh [email protected] -
如果系统提示“您确定要继续连接吗?”,请输入
yes并按Enter键 -
出现提示时输入密码
输入密码时不会显示—这是正常现象!直接输入并按回车即可。
macOS
- 按 Cmd + Space 打开 Spotlight,输入“终端”,然后按 Enter
-
输入SSH命令(替换占位符):
示例:
ssh username@ip-addressssh [email protected] -
如果系统提示“您确定要继续连接吗?”,请输入
yes并按Enter键 -
出现提示时输入密码
输入密码时不会显示—这是正常现象!直接输入并按回车即可。
Linux
- 打开终端(通常是Ctrl + Alt + T,或在应用程序菜单中查找)
-
输入SSH命令(替换占位符):
示例:
ssh username@ip-addressssh [email protected] -
如果系统提示“您确定要继续连接吗?”,请输入
yes并按Enter键 -
出现提示时输入密码
输入密码时不会显示—这是正常现象!直接输入并按回车即可。
Chromebook
-
启用Linux(如已完成请跳过):
- 打开设置
- 前往高级→开发者
- 开启“Linux开发环境”
- 按照设置向导操作(需要几分钟)
- 从应用程序启动器中打开“终端”应用
-
输入SSH命令(替换占位符):
示例:
ssh username@ip-addressssh [email protected] -
如果系统提示“您确定要继续连接吗?”,请输入
yes并按Enter键 -
出现提示时输入密码
输入密码时不会显示—这是正常现象!直接输入并按回车即可。
常见故障
- "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 错误,请修正日期
SSL 证书错误?
大多数搭载Makerbase的打印机,尤其是Qidi Tech型号,系统时钟设置不正确。这会导致下载文件时发生SSL证书错误。
如果您看到类似ERROR: The certificate of 'download.simplyprint.io' is not trusted的错误,请先运行以下命令:
sudo date -s '2026-10-27'
复制粘贴上面的命令,其中已包含今天的日期。系统可能会提示您输入密码,请使用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。
这可能需要一些时间,请耐心等待!
当脚本显示“正在安装 moonraker 依赖项…”时,可能需要最长 10 分钟。打印机主板性能不高,正在后台升级 Python 软件包。请勿取消或重启,耐心等待其完成即可。
5. 获取您的设置代码
脚本运行完成后,会显示打印机的设置代码。
使用此代码,在SimplyPrint面板中关联您的打印机,或查看您的打印机是否已自动显示在待处理打印机下。
就这样!
您的打印机现在运行的是全新的 Moonraker 实例,并已启用 SimplyPrint。您可以照常使用打印机的触摸屏和现有的 Klipper 设置。
此脚本的作用是什么?它会在您现有的打印机设置基础上,安装一个包含SimplyPrint组件的独立最新版Moonraker实例。您现有的Klipper配置和网页界面(Mainsail/Fluidd)不会被修改。新的Moonraker实例运行在不同的端口上,仅负责处理与SimplyPrint的连接。