【亲测免费】 MainsailOS 项目安装与使用教程

1. 项目的目录结构及介绍

MainsailOS 是一个基于 Raspberry Pi OS 的预构建镜像，专为 3D 打印机管理而设计。以下是 MainsailOS 项目的主要目录结构及其介绍：

MainsailOS/
├── config/
│   ├── mainsail/
│   ├── moonraker/
│   └── klipper/
├── scripts/
│   ├── install.sh
│   └── update.sh
├── services/
│   ├── mainsail.service
│   ├── moonraker.service
│   └── klipper.service
├── README.md
└── LICENSE

目录结构介绍

• config/: 该目录包含 Mainsail、Moonraker 和 Klipper 的配置文件。

  • mainsail/: Mainsail 的配置文件。
  • moonraker/: Moonraker 的配置文件。
  • klipper/: Klipper 的配置文件。

• scripts/: 该目录包含安装和更新脚本。

  • install.sh: 用于安装 MainsailOS 的脚本。
  • update.sh: 用于更新 MainsailOS 的脚本。

• services/: 该目录包含 Mainsail、Moonraker 和 Klipper 的服务文件。

  • mainsail.service: Mainsail 的服务文件。
  • moonraker.service: Moonraker 的服务文件。
  • klipper.service: Klipper 的服务文件。

• README.md: 项目的介绍和使用说明。

• LICENSE: 项目的许可证文件。

2. 项目的启动文件介绍

MainsailOS 的启动文件主要位于 services/ 目录下，这些文件定义了如何启动 Mainsail、Moonraker 和 Klipper 服务。

启动文件介绍

• mainsail.service: 该文件定义了 Mainsail Web 界面的启动方式。通常，它会启动一个 Nginx 服务器来托管 Mainsail 的 Web 界面。
• moonraker.service: 该文件定义了 Moonraker API 服务的启动方式。Moonraker 是 Klipper 的 API 服务器，负责与 Mainsail 和其他客户端通信。
• klipper.service: 该文件定义了 Klipper 固件的启动方式。Klipper 是一个用于 3D 打印机的固件，负责控制打印机的硬件。

3. 项目的配置文件介绍

MainsailOS 的配置文件主要位于 config/ 目录下，这些文件定义了 Mainsail、Moonraker 和 Klipper 的行为和设置。

配置文件介绍

• mainsail/: 该目录包含 Mainsail 的配置文件。主要文件包括：

  • config.json: 定义 Mainsail 的界面设置和行为。
  • theme.json: 定义 Mainsail 的主题和样式。

• moonraker/: 该目录包含 Moonraker 的配置文件。主要文件包括：

  • moonraker.conf: 定义 Moonraker API 服务的行为和设置。

• klipper/: 该目录包含 Klipper 的配置文件。主要文件包括：

  • printer.cfg: 定义 Klipper 固件的设置和打印机的硬件配置。

通过这些配置文件，用户可以自定义 MainsailOS 的行为和界面，以满足特定的 3D 打印需求。