vastsa/FileCodeBox

文件快递柜-匿名口令分享文本，文件，像拿快递一样取文件（FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files）

FileCodeBox — 택배 받듯 파일 받기

한 줄 요약: 가볍고 현대적이며 자체 호스팅이 가능한 파일 공유 도구입니다. 파일을 업로드하면 "수령 비밀번호"가 발급되고, 상대방이 비밀번호를 입력하면 다운로드할 수 있습니다. 회원가입은 전혀 필요 없습니다.

핵심 메커니즘

업로드 즉시 비밀번호 획득: 파일이나 텍스트를 업로드하면 시스템이 수령 코드를 생성합니다.
코드로 수령: 수신자는 비밀번호를 입력하기만 하면 파일을 받을 수 있습니다. 마치 택배함에서 소포를 꺼내는 것처럼.
회원가입 불필요: 업로더와 수신자 모두 계정을 만들 필요가 없습니다.

주요 기능

기능	설명
즉시 업로드·즉시 수령	파일과 텍스트를 통합 공유하며, 드래그 앤 드롭, 붙여넣기, 일괄 업로드, 분할 업로드 지원
필요에 따른 만료	시간 경과, 수령 횟수, 또는 영구 보존 설정 가능. 만료된 콘텐츠는 자동 정리
데이터 자율성	스토리지 백엔드는 로컬 디스크, S3, OneDrive, WebDAV, OpenDAL 중 선택 가능. 데이터는 자신의 인프라에 유지
관리 백엔드	로그인, 파일 관리, 시스템 설정 등 관리 기능 제공
AI 클라이언트 연동	MCP Streamable HTTP 프로토콜 지원. 호환되는 AI 클라이언트는 `share_text` 및 `share_file` 도구로 공유 생성 가능

배포 방법

Docker 명령 한 줄로 시작할 수 있습니다:

docker run -d --restart unless-stopped \
  -p 12345:12345 \
  -v ./data:/app/data \
  -e APP_ENV=production \
  -e LOG_LEVEL=warning \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  --name filecodebox \
  lanol/filecodebox:2.8.3

시작 후 http://localhost:12345에 접속하여 초기 설정을 완료합니다. 프로덕션 환경에서는 버전 번호(예: 2.8.3)를 고정하는 것을 권장합니다. latest 태그는 최신 정식 버전을 가리킵니다.

기술 스택

백엔드: FastAPI
프론트엔드: Vue 3 (다크 모드 지원)
데이터베이스: SQLite
배포: Docker
스토리지 프로토콜: S3, WebDAV 등

라이선스 및 고지

오픈소스 라이선스: LGPL-3.0
프로젝트는 합법적인 파일 및 텍스트 공유 시나리오만을 대상으로 하며, 사용자는 배포, 데이터 규정 준수 및 콘텐츠 관리에 대한 책임을 스스로 져야 합니다.