Repolode
提交项目
Donkie

Donkie/Spoolman

自托管的 3D 打印耗材线轴管理服务，可记录库存并随打印自动更新用量。

在 GitHub 查看
Star
2,989
Fork
320
未关闭 Issue
171
最近提交
3天前

这是什么？

Spoolman 是一个自托管的 Web 服务，用于管理 3D 打印机的耗材线轴库存，并跟踪耗材用量。它作为集中式数据库，与 OctoPrint、Klipper/Moonraker 等打印软件对接，打印时自动更新线轴剩余重量。

项目自带 Web 客户端，可以增删改耗材类型、品牌和单个线轴，支持按品牌、材质、存放位置等字段搜索、分组和筛选，也可以添加自定义字段。内置标签设计器，可生成带二维码的线轴标签。REST API 和 WebSocket 实时更新便于其他软件读写数据。数据库支持 SQLite、PostgreSQL、MySQL 和 CockroachDB。

同一个实例可以同时处理多台打印机的用量更新，并可接入 Prometheus 做历史用量分析。新增耗材时可以借助社区维护的 SpoolmanDB 中的品牌和耗材数据。

核心功能

  • 01记录耗材类型、品牌和单个线轴的重量
  • 02打印时从 OctoPrint 和 Klipper/Moonraker 自动更新线轴重量
  • 03内置 Web 客户端，支持搜索、分组、筛选和自定义字段
  • 04标签设计器可生成带二维码的线轴标签
  • 05提供 REST API 和 WebSocket 实时更新，便于集成其他软件
  • 06支持 SQLite、PostgreSQL、MySQL 和 CockroachDB 数据库

适用场景

  • 在工作室或创客空间中跟踪多台 3D 打印机的耗材用量
  • 开始打印前确认每卷线轴的剩余耗材
  • 为线轴贴上二维码标签，便于快速识别和扫码
  • 将耗材数据接入 Home Assistant 等自动化工具

快速上手

  1. 1

    按照 Wiki 上的安装页面进行安装

使用前须知

  • 主要开发者利用业余时间维护该项目。
  • 新版网页客户端在某些环境中可能出现问题；可通过设置 SPOOLMAN_LEGACY_CLIENT=TRUE 切换回旧版客户端。

收录于专题

自托管应用数据库与 SQL 工具

标签

#3d-printing#inventory#filament#self-hosted#klipper#octoprint#rest-api#fastapi#database#service

常见问题

Spoolman 是什么？
自托管的 3D 打印耗材线轴管理服务，可记录库存并随打印自动更新用量。 Spoolman 是一个自托管的 Web 服务，用于管理 3D 打印机的耗材线轴库存，并跟踪耗材用量。它作为集中式数据库，与 OctoPrint、Klipper/Moonraker 等打印软件对接，打印时自动更新线轴剩余重量。
Spoolman 可以免费使用吗？用的什么许可证？
Spoolman 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
Spoolman 还在维护吗？
活跃维护中。Spoolman 最近一次提交是在 2026年11月4日。
Spoolman 适合用来做什么？
在工作室或创客空间中跟踪多台 3D 打印机的耗材用量 开始打印前确认每卷线轴的剩余耗材 为线轴贴上二维码标签，便于快速识别和扫码 将耗材数据接入 Home Assistant 等自动化工具
Spoolman 怎么安装和运行？
按照 Wiki 上的安装页面进行安装
在哪里获取 Spoolman？
源代码和安装说明在 GitHub 上：https://github.com/Donkie/Spoolman

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目