RatOS安装与配置指南

RatOS安装与配置指南

RatOS The preconfigured Raspberry Pi image that makes it easy to run Klipper + Moonraker + Mainsail on your printer. 项目地址: https://gitcode.com/gh_mirrors/rat/RatOS

1. 项目基础介绍

RatOS是一个为Raspberry Pi量身定制的预配置操作系统镜像。它旨在简化在3D打印机上运行Klipper、Moonraker和Mainsail的流程。RatOS由Mikkel Schmidt维护，并与社区协作开发。该系统基于Raspbian，是一款适用于Raspberry Pi的操作系统。

主要编程语言：

• MDX (43.4%)
• Shell (35.8%)
• TypeScript (17.3%)
• CSS (2.8%)
• JavaScript (0.7%)

2. 项目使用的关键技术和框架

• Klipper：一个3D打印机的开源嵌入式软件。
• Moonraker：一个基于Python的3D打印机服务器。
• Mainsail：一个基于Web的3D打印机界面。

3. 项目安装和配置的准备工作

在开始安装RatOS之前，请确保您已准备好以下环境和工具：

• Raspberry Pi设备（推荐Raspberry Pi 3或4）。
• microSD卡（至少16GB）。
• 读取microSD卡的适配器或设备。
• 互联网连接。
• 以下软件：
  • qemu-arm-static（用于在PC上模拟Raspberry Pi环境）。
  • CustomPiOS（用于构建自定义Raspberry Pi操作系统镜像）。
  • Bash（用于运行Shell脚本）。
  • Git（用于克隆和更新项目代码）。
  • Docker和Docker-Compose（用于容器化应用）。
  • Yarn & Docusaurus（用于文档构建，如果需要的话）。

安装步骤

1. 克隆项目仓库： 将RatOS项目的代码克隆到您的计算机上：

   git clone https://github.com/Rat-OS/RatOS.git
   

2. 准备构建环境： 根据您的操作系统，安装上述所需的工具。具体安装方法请参考各个工具的官方文档。

3. 构建RatOS镜像： 进入项目目录，并运行构建脚本。构建过程可能需要一些时间，具体命令如下：

   cd RatOS
   ./build-pi64.sh  # 如果您使用的是64位Raspberry Pi
   # 或者
   ./build-pi32.sh  # 如果您使用的是32位Raspberry Pi
   

4. 写入microSD卡： 使用适当的方法将构建好的RatOS镜像写入microSD卡。您可以使用如Balena Etcher等工具来完成这一步。

5. 启动Raspberry Pi： 将microSD卡插入Raspberry Pi，并连接电源和网络。RatOS将自动启动并配置网络。

6. 访问Web界面： 在Raspberry Pi启动后，您可以通过浏览器访问Mainsail界面来配置和控制您的3D打印机。

请按照以上步骤进行操作，您应该能够成功安装和配置RatOS。如果在安装过程中遇到问题，请查阅项目文档或向社区寻求帮助。

RatOS The preconfigured Raspberry Pi image that makes it easy to run Klipper + Moonraker + Mainsail on your printer. 项目地址: https://gitcode.com/gh_mirrors/rat/RatOS