Spoolman

Spoolman 是一款自托管的耗材库存管理器，专为 3D 打印爱好者和打印农场打造。它用结构化、可搜索的数据库取代了临时电子表格和手写笔记，该数据库可跟踪每卷耗材从购买到最后一克的整个过程。材料配置文件存储制造商、颜色、材料类型、密度和温度设置，因此在设置新打印时，始终可以获得正确的数据。轻量级的 SQLite 后端无需任何外部依赖即可运行，使得 Spoolman 可以轻松地作为单个容器部署在任何 VPS 上——无需外部数据库设置或复杂的配置。

常见用例

家庭爱好者使用 Spoolman 跟踪数十个部分使用过的线轴上的剩余耗材，从而避免了因意外耗尽材料而导致的打印中断失败。打印农场将其用作中央库存中心——操作员在装载线轴前扫描其二维码标签，打印完成后 Moonraker 会自动记录估计消耗的重量。耗材经销商和工作室使用 Spoolman 的材料配置文件来维护所有库存材料和颜色的产品目录，从而在客户咨询期间轻松查找技术规格。创客空间在多台打印机和成员之间共享一个 Spoolman 实例，每个线轴都跟踪到特定的机器和用户，以便进行准确的成本核算和补货决策。

主要功能

• 线轴库存管理：记录每个线轴的制造商、材料、颜色、初始重量和剩余耗材
• 材料和制造商配置文件：存储适用于给定类型所有线轴的可重用温度、密度和颜色设置
• REST API：用于线轴、材料和制造商的完整 CRUD API，可通过 /api/v1 访问
• Klipper 和 Moonraker 集成：原生 API 支持让您的打印机在打印完成后自动记录线轴使用情况
• 二维码标签：为每个线轴生成可扫描的二维码标签，可在任何移动浏览器中打开完整配置文件
• WebSocket 实时更新：库存更改会立即推送到所有客户端，无需刷新页面
• 多种数据库后端：默认支持 SQLite；PostgreSQL、MariaDB 和 CockroachDB 支持多用户或高写入工作负载
• 自动 SQLite 备份：数据库文件的计划备份可防止意外数据丢失
• Prometheus 指标端点：通过 /metrics 将库存统计信息暴露给 Grafana 和其他监控工具
• 以非 root 用户运行：容器进程以受限应用程序用户身份运行，无需额外配置即可提高容器安全性

为何在 Hostinger VPS 上部署 Spoolman

在 Hostinger VPS 上运行 Spoolman 可为您的工作室或打印农场提供一个持久、始终在线的库存服务器，可从您网络或互联网上的任何设备访问——无需依赖一台会 关闭，无需云订阅。所有库存数据都保留在您的服务器上，没有任何第三方服务会看到您使用了哪些材料或打印了多少。轻量级的 SQLite 后端意味着即使是小型 VPS 方案也能处理大型线轴目录，而无需担心性能问题，Traefik HTTPS 路由为您提供了一个安全的、浏览器可访问的 URL，无需任何手动证书管理。当您的“农场”规模扩大时，切换到 PostgreSQL 或 MariaDB 只需更改几个环境变量并进行数据迁移。