Spoolman
自托管的3D打印机耗材管理服务，实时跟踪线轴用量。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
3D打印耗材库存管家，自动同步用量。
核心功能
- 追踪耗材品牌、类型和每个线轴的用量
- 通过WebSocket实时更新线轴重量，无需手动记录
- 内置网页管理界面，支持增删改查和自定义字段
- 与OctoPrint、Klipper/Moonraker等主流打印软件无缝集成
- 支持SQLite、PostgreSQL、MySQL和CockroachDB多种数据库
避坑指南
- •默认使用SQLite，生产环境建议改用PostgreSQL或MySQL以获得更好并发性能。2. 首次使用需手动添加耗材或从社区数据库导入，社区数据库可能不完整。3. 二维码标签需要热敏打印机或标签打印机，否则只能手动管理。4. 如果打印软件未正确配置WebSocket，实时更新可能延迟，需检查网络连通性。
适用场景
- 个人3D打印爱好者管理家中多种耗材
- 3D打印农场或工作室集中管理多个打印机的耗材库存
- 需要自动记录打印用量以便统计成本和补货
详细介绍
Spoolman 是一个轻量级、自托管的Web服务，专门帮助3D打印爱好者和制造商高效管理耗材库存。它作为中央数据库，记录制造商、耗材类型和单个线轴信息，内置网页客户端支持增删改查。该服务与OctoPrint、Klipper/Moonraker等无缝集成，在打印过程中通过WebSocket实时同步并自动更新线轴重量。支持多种数据库（SQLite、PostgreSQL、MySQL、CockroachDB），可同时管理多台打印机，并能将监控数据发送至Prometheus进行历史分析。Spoolman还包含社区维护的耗材数据库（SpoolmanDB）以及二维码标签打印功能。安装简单，支持Docker或手动部署。
常见问题与排障 (1)
故障排除如何解决在Docker中连接MySQL 8.x时出现的“cryptography package is required”错误？
在你的 Python 环境中安装 cryptography 包，或者使用 PyMySQL[rsa]/aiomysql[rsa]。对于 Docker 部署，请将 pip install cryptography 添加到你的 entrypoint 或 Dockerfile 中。此问题出现的原因是 MySQL 8.x 默认使用 caching_sha2_password，这需要 cryptography 库。在默认的 Spoolman 设置中缺少该依赖项。添加后，连接将成功建立，而无需降低 MySQL 的安全性。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
方式一（推荐）：使用Docker运行：docker run -d --name spoolman -p 7912:7912 -v $(pwd)/data:/app/data ghcr.io/donkie/spoolman:latest
方式二：从GitHub Releases下载对应系统的二进制文件，解压后直接运行（需要先安装并配置数据库）
启动后浏览器访问http://localhost:7912，按照向导初始化管理员账户和数据库
- 方式一（推荐）：使用Docker运行：docker run -d --name spoolman -p 7912:7912 -v $(pwd)/data:/app/data ghcr.io/donkie/spoolman:latest
- 方式二：从GitHub Releases下载对应系统的二进制文件，解压后直接运行（需要先安装并配置数据库）
- 启动后浏览器访问http://localhost:7912，按照向导初始化管理员账户和数据库
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
若使用Docker：docker stop spoolman && docker rm spoolman && rm -rf ./data 若手动安装：删除解压目录及相关数据库文件即可。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ