OpenSource-Hub
S

Spoolman

2.4k stars·開発ツール·SHA-256 チェックサム確認済み

自托管的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或手动部署。

トラブルシューティング & FAQ (1)

トラブル対応
DockerでMySQL 8.xに接続する際の'cryptography package is required'エラーの修正方法

Python環境に cryptography パッケージをインストールするか、PyMySQL[rsa] / aiomysql[rsa] を使用してください。Dockerデプロイメントの場合、エントリーポイントまたはDockerfileに pip install cryptography を追加してください。この問題は、MySQL 8.x がデフォルトで caching_sha2_password を使用しているため発生します。この認証方式には cryptography ライブラリが必要です。この依存関係はデフォルトのSpoolman設定では不足しています。追加すれば、MySQLのセキュリティをダウングレードすることなく接続に成功します。

参照 Issue #330

タグ

3d-printingfilament-managementself-hostedinventoryoctoprintklipper

はじめ方

1

インストーラをダウンロード

上のボタンをクリックして、お使いのシステム用のインストーラをダウンロード

2

ソフトウェアをインストール

ダウンロードしたインストーラをダブルクリックし、指示に従ってください

3

方式一(推荐):使用Docker运行:docker run -d --name spoolman -p 7912:7912 -v $(pwd)/data:/app/data ghcr.io/donkie/spoolman:latest

4

方式二:从GitHub Releases下载对应系统的二进制文件,解压后直接运行(需要先安装并配置数据库)

5

启动后浏览器访问http://localhost:7912,按照向导初始化管理员账户和数据库

インストールガイド
  1. 方式一(推荐):使用Docker运行:docker run -d --name spoolman -p 7912:7912 -v $(pwd)/data:/app/data ghcr.io/donkie/spoolman:latest
  2. 方式二:从GitHub Releases下载对应系统的二进制文件,解压后直接运行(需要先安装并配置数据库)
  3. 启动后浏览器访问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 若手动安装:删除解压目录及相关数据库文件即可。

追加の依存関係なし

ダウンロード後すぐに使用可能。追加のランタイムは不要です。

プロジェクト情報
ライセンスMIT
最終更新2026-06-27 14:20:24
GitHub リポジトリ公式サイト

問題が発生?以下のFAQを確認

1 FAQ

類似プロジェクト