Spoolman 主机
使用整洁的网络数据库和API跟踪3D打印灯丝线轴、使用情况和库存。
- 一键 部署
- 15 GB 所需磁盘空间
- 1 GB 内存 所需内存
- 来自 2 € 价格
您在 AvaHost 上获得的服务
一键部署、自定义域名、免费HTTPS、自动应用更新和定期备份是每个云应用的标准配置。您可以在一台服务器上运行多个应用,并且包括终端访问。
此模板不包含数据库容器。

技术
- Docker 镜像
- ghcr.io/donkie/spoolman:latest
- 默认端口
- 8000

Spoolman 的工作原理
Spoolman 在一个库存系统中集中管理制造商、耗材类型、单个线轴、存放位置、自定义字段和使用记录。Web 客户端允许操作员创建和编辑记录、搜索或分组集合、按材料或位置筛选,以及生成带有二维码的标签用于识别物理线轴。
REST API 和 WebSocket 更新让兼容的打印软件读取和更改库存数据。Moonraker、Klipper 前端、OctoPrint、Home Assistant 和其他集成可以在作业进行时报告消耗情况。这些集成保持为独立系统,用户必须将其指向托管的 Spoolman 地址。
Spoolman 的主要功能
目录包保持 Spoolman 数据目录的持久化,其中包括默认本地数据库和应用程序状态。不提供 PostgreSQL 或 MariaDB 服务。库存记录、使用历史、标签、自定义字段和集成设置因此依赖于附加应用程序卷在更新和恢复过程中保持可用。
Spoolman 没有内置用户身份验证。其上游安全指南指出,任何能够访问该服务的人都可以读取和更改库存。HTTPS 保护传输中的流量,但不提供账户门禁,因此托管页面不应将公共 URL 呈现为私有多用户工作区。

自托管 Spoolman:要求和成本
资源使用随着线轴和耗材记录、使用历史、标签资产、API 流量、WebSocket 活动、集成、同时打印机和并发浏览器的增加而增长。目录将 PostgreSQL 和 MariaDB 记录为不需要,并保持应用程序数据目录的持久化,因此本地数据库和库存文件必须被视为一个恢复集合。
在 AvaHost 上,Spoolman 使用方案 1,价格为 €2。托管的 Spoolman 包包括一键部署、带自动 HTTPS 的自定义域、自动应用程序更新和定时备份。Spoolman 本身不提供身份验证层。任何能够访问分配域的人都可以查看或修改库存,AvaHost 不声称提供额外的访问控制代理。仅连接受信任的集成、将 API 使用者保持在您的控制下,并避免在公开可访问的实例中放置敏感的操作数据。
Spoolman 的使用者
家庭打印机使用 Spoolman 来记住安装了哪个线轴、剩余多少材料以及替换品存放在哪里。共享工作室可以标记架子和线轴,而小型生产团队可以将多台打印机连接到一个库存,这样消耗更新就不会分散在不同的电子表格中。
该应用程序围绕耗材管理而非打印机控制设计。它不调度作业、切片模型、操作打印机,也不作为托管包的一部分提供 OctoPrint、Moonraker、Klipper、Home Assistant、Prometheus、标签硬件或扫描设备。
F.A.Q
Spoolman 在方案 1 上起价 €2。入门方案适合中等规模的耗材目录和轻量级 API 活动。线轴数量、使用历史、标签数据、WebSocket 流量、连接的打印机服务和并发浏览器是决定安装是否需要更多处理能力或存储空间的实际指标。
Spoolman 不包含内置身份验证,托管模板也不添加单独的访问控制层。任何能够访问该域名的人都可以检查或更改库存记录。仅在受信任的访问路径下使用该服务,不要将 HTTPS 本身视为防止未授权库存更改的保护措施。
兼容软件可以通过 Spoolman 的文档化 API 进行连接,但打印机服务、插件、凭证和网络配置不包含在内。将每个受信任的集成指向最终的 HTTPS 地址,使用非关键假脱机文件测试读写行为,并确认没有不受信任的系统能够访问同一端点。
AvaHost 应用程序更新并保持持久化的 Spoolman 数据目录附加到该服务。托管安装包括计划备份。本地数据库、自定义字段、标签和使用记录应视为一个数据集,因此在进行重大上游更改后,应审查重要的集成和库存总数。
