PanSalut/Koffan

어떤 프로젝트인가요?

핵심 기능

• 01WebSocket을 통한 기기 간 공유 목록 실시간 동기화
• 02오프라인 상태에서 목록을 만들고 수정하며, 다시 연결되면 자동 동기화
• 03섹션, 사용자 지정 목록 아이콘, 여러 개의 목록
• 04구매 기록을 바탕으로 한 자동 완성
• 05선택적으로 사용할 수 있는 개인 계정과 별도 워크스페이스
• 06REST API 및 서명된 아웃바운드 웹훅

활용 사례

• 커플이나 가족이 각자 다른 휴대폰에서 하나의 장보기 목록을 함께 작성
• 여러 가구가 목록을 따로 관리하면서 하나의 셀프 호스팅 서버 공유
• 웹훅을 통해 n8n이나 Zapier 같은 자동화 도구에 장보기 항목 동기화
• 통신 상태가 좋지 않은 매장에서 오프라인으로 목록 사용

빠른 시작

1. 1

   README의 빠른 시작 명령어를 사용해 Docker로 Koffan을 시작하세요

   docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest
2. 2

   브라우저에서 http://localhost:3000을 열고 비밀번호로 로그인하세요

사용 전 알아둘 점

• !README에 명확한 오픈소스 라이선스가 명시되어 있지 않으므로, 재사용하기 전에 저장소의 라이선스 조건을 확인하세요.
• !오프라인 지원을 사용하려면 Koffan을 HTTPS로 제공해야 합니다. 홈 네트워크에서 일반 HTTP를 사용하는 경우에는 지원되지 않습니다.
• !2.16.0으로 업그레이드하면 데이터베이스가 마이그레이션되며 이전 버전으로 되돌릴 수 없습니다. 먼저 데이터베이스를 백업하세요.

포함된 컬렉션

토픽

자주 묻는 질문

Koffan은(는) 무엇인가요?

가족과 가구가 함께 쓰는 셀프 호스팅 장보기 목록 웹 앱으로, 실시간 동기화와 오프라인 모드를 지원합니다. Koffan은 장보기 목록을 함께 관리할 수 있는 가벼운 웹 애플리케이션입니다. 여러 사람이 서로 다른 기기에서 같은 목록을 편집할 수 있으며, 변경 사항은 WebSocket을 통해 실시간으로 동기화되어 필요한 물건과 이미 장바구니에 담은 물건을 모두 확인할 수 있습니다.

Koffan은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Koffan은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Koffan은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Koffan의 마지막 커밋은 2026년 10월 16일입니다.

Koffan은(는) 어디에 사용할 수 있나요?

커플이나 가족이 각자 다른 휴대폰에서 하나의 장보기 목록을 함께 작성 여러 가구가 목록을 따로 관리하면서 하나의 셀프 호스팅 서버 공유 웹훅을 통해 n8n이나 Zapier 같은 자동화 도구에 장보기 항목 동기화 통신 상태가 좋지 않은 매장에서 오프라인으로 목록 사용

Koffan는 어떻게 설치하나요?

README의 빠른 시작 명령어를 사용해 Docker로 Koffan을 시작하세요: docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest 브라우저에서 http://localhost:3000을 열고 비밀번호로 로그인하세요

Koffan은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/PanSalut/Koffan