Spoolman
스풀 사용량을 실시간으로 추적하는 자체 호스팅 3D 프린터 필라멘트 관리 서비스.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
3D 프린팅 소모품 재고 관리자, 사용량 자동 동기화.
주요 기능
- 필라멘트 브랜드, 유형 및 스풀별 사용량 추적
- WebSocket을 통해 스풀 무게를 실시간으로 업데이트하여 수동 기록이 필요 없음
- 내장 웹 관리 인터페이스로 추가, 삭제, 수정, 조회 및 사용자 정의 필드 지원
- OctoPrint, Klipper/Moonraker 등 주요 프린터 소프트웨어와 원활하게 통합
- SQLite, PostgreSQL, MySQL, CockroachDB 등 다양한 데이터베이스 지원
할 수 없는 것
- •기본적으로 SQLite를 사용하며, 프로덕션 환경에서는 더 나은 동시성 성능을 위해 PostgreSQL 또는 MySQL로 변경하는 것이 좋습니다. 2. 처음 사용 시 소모품을 수동으로 추가하거나 커뮤니티 데이터베이스에서 가져와야 하며, 커뮤니티 데이터베이스는 불완전할 수 있습니다. 3. QR 코드 라벨은 감열식 프린터 또는 라벨 프린터가 필요하며, 그렇지 않으면 수동으로만 관리할 수 있습니다. 4. 인쇄 소프트웨어에서 WebSocket이 올바르게 구성되지 않은 경우 실시간 업데이트가 지연될 수 있으므로 네트워크 연결 상태를 확인해야 합니다.
사용 사례
- 개인 3D 프린팅 애호가가 집에서 다양한 필라멘트를 관리
- 3D 프린팅 팜 또는 스튜디오에서 여러 프린터의 필라멘트 재고를 중앙 집중 관리
- 비용 통계 및 재고 보충을 위해 인쇄 사용량을 자동으로 기록해야 하는 경우
상세 설명
Spoolman은 3D 프린팅 애호가와 제작자들이 필라멘트 재고를 효율적으로 관리할 수 있도록 돕는 경량의 셀프 호스팅 웹 서비스입니다. 중앙 데이터베이스 역할을 하며 제조업체, 필라멘트 유형 및 개별 스풀 정보를 기록하고, 내장된 웹 클라이언트를 통해 생성, 삭제, 수정, 조회를 지원합니다. 이 서비스는 OctoPrint, Klipper/Moonraker 등과 원활하게 통합되며, 인쇄 과정에서 WebSocket을 통해 실시간으로 동기화하고 스풀 무게를 자동으로 업데이트합니다. SQLite, PostgreSQL, MySQL, CockroachDB 등 다양한 데이터베이스를 지원하고, 여러 대의 프린터를 동시에 관리할 수 있으며, 모니터링 데이터를 Prometheus로 전송하여 이력 분석을 수행할 수 있습니다. Spoolman에는 커뮤니티에서 유지 관리하는 필라멘트 데이터베이스(SpoolmanDB)와 QR 코드 라벨 인쇄 기능도 포함되어 있습니다. 설치가 간단하며 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의 보안을 낮추지 않고도 연결이 성공합니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
방법 1(권장): Docker를 사용하여 실행: docker run -d --name spoolman -p 7912:7912 -v $(pwd)/data:/app/data ghcr.io/donkie/spoolman:latest
방법 2: GitHub Releases에서 해당 시스템에 맞는 바이너리 파일을 다운로드하고 압축을 푼 후 바로 실행 (먼저 데이터베이스를 설치하고 구성해야 함)
시작 후 브라우저에서 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에서 해당 시스템에 맞는 바이너리 파일을 다운로드하고 압축을 푼 후 바로 실행 (먼저 데이터베이스를 설치하고 구성해야 함)
- 시작 후 브라우저에서 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
유사한 프로젝트
Visual Studio Code (Code - OSS)
Microsoft가 만든 무료 오픈 소스 코드 편집기로, 지능형 자동 완성, 디버깅, Git 및 확장 기능을 지원하는 전 세계에서 가장 인기 있는 편집기입니다.
opencode
오픈소스 AI 코딩 에이전트로, 코드 작성, 리팩토링 및 분석을 지원하며, '빌드(Build)'와 '플랜(Plan)' 이중 에이전트 모드가 내장되어 있습니다.
scrcpy
USB 또는 무선 TCP/IP를 통해 컴퓨터에서 Android 기기로 화면 미러링 및 제어를 지원하며, 루팅 불필요, 고성능 저지연, 오디오 전달 지원.