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或手动部署。
문제 해결 & FAQ (1)
문제 해결Docker에서 MySQL 8.x에 연결할 때 'cryptography package is required' 오류를 해결하는 방법
Python 환경에 cryptography 패키지를 설치하거나 PyMySQL[rsa]/aiomysql[rsa]를 사용하십시오. Docker 배포의 경우 entrypoint나 Dockerfile에 pip install cryptography를 추가하십시오. 이 문제는 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