Fluidd开源项目：Klipper 3D打印管理界面完全指南

Fluidd是一款免费开源的Klipper 3D打印机网页界面，专为管理和控制3D打印机而设计。它提供了现代化的用户界面，支持桌面、平板和移动设备，让用户能够轻松管理打印作业和配置。

项目概述与特性

Fluidd作为Klipper固件的配套网页客户端，具有以下核心特性：

• 响应式用户界面，完美适配各种屏幕尺寸
• 完全可定制的布局，用户可以自由拖拽面板到任意位置
• 内置多种色彩主题，满足个性化需求
• 单次安装即可管理多台3D打印机
• 实时监控和调整打印参数

安装方法详解

推荐安装方式：KIAUH

KIAUH（Klipper安装与更新助手）是安装Fluidd的首选方法。它能够简化安装和更新过程，无论是简单的单机安装还是需要测试多个用户界面的复杂设置，KIAUH都能轻松应对。

手动安装步骤

如果需要手动构建Fluidd项目，请确保系统已安装NodeJS（v24.x）和Git，然后按照以下步骤操作：

1. 克隆Fluidd源代码：git clone https://gitcode.com/gh_mirrors/fl/fluidd
2. 进入项目目录：cd fluidd
3. 安装项目依赖：npm ci
4. 构建打包项目：npm run build

构建完成后，所有文件将输出到dist目录中，可以使用NGINX等HTTP服务器进行部署。

项目架构分析

核心目录结构

Fluidd项目采用现代化的前端架构，主要包含以下关键目录：

• src/：源代码主目录，包含Vue组件和其他核心代码
• public/：静态资源目录，存放不经过打包处理的文件
• docs/：项目文档和帮助材料
• locales/：国际化语言包，支持多国语言

技术栈组成

项目基于Vue.js 2.7框架构建，使用TypeScript进行开发，主要依赖包括：

• Vue 2.7.16：核心框架
• Vuetify 2.7.2：Material Design组件库
• Vuex 3.6.2：状态管理
• Vue Router 3.6.5：路由管理
• ECharts 5.6.0：数据可视化
• Monaco Editor 0.54.0：代码编辑器

主要功能模块

打印控制与监控

Fluidd提供完整的打印控制功能，包括开始/暂停打印、温度调整、速度控制等。实时监控系统能够显示打印进度、温度和耗材使用情况。

配置文件管理

通过内置的代码编辑器，用户可以方便地查看和编辑Klipper配置文件，支持语法高亮和实时验证。

宏定义系统

支持自定义宏命令，用户可以创建常用操作的快捷方式，提高工作效率。

多打印机支持

单次安装即可管理多台3D打印机，支持快速切换和并行监控。

配置与定制

主题定制

Fluidd内置多种色彩主题，用户可以根据个人喜好选择或自定义界面外观。

布局调整

用户界面采用模块化设计，所有面板都可以自由拖拽和重新排列，实现完全个性化的操作界面。

开发与构建

开发环境启动

对于开发目的，可以运行npm run serve命令启动开发服务器，启用热重载功能。

生产环境构建

使用npm run build命令进行生产环境构建，生成优化后的静态文件。

注意事项

目前不支持在树莓派上直接构建Fluidd项目，建议在PC上构建完成后将dist目录复制到树莓派上部署。

通过Fluidd，3D打印爱好者可以获得更加流畅和高效的管理体验，充分利用Klipper固件的强大功能。