polius/FileSync

어떤 프로젝트인가요?

핵심 기능

• 01암호화된 WebRTC를 통해 브라우저 간에 파일을 직접 전송합니다.
• 02수신 파일을 디스크에 스트리밍 저장하므로 대용량 파일도 메모리를 소진하지 않습니다.
• 03중단된 전송을 자동으로 이어서 진행합니다.
• 04공유 방 링크나 QR 코드를 통해 한 파일을 여러 기기에 전송합니다.
• 05직접 연결이 차단되면 TURN 릴레이를 사용합니다.
• 06수신자는 설치나 계정 생성이 필요 없으며, 방에 비밀번호를 설정할 수도 있습니다.

활용 사례

• 파일을 서드파티 클라우드에 업로드하지 않고 동료나 고객 그룹에 대용량 파일을 전송할 때.
• 셀프 호스팅 인스턴스를 통해 집이나 사무실 네트워크 안에서, 또는 네트워크 간에 파일을 공유할 때.
• 브라우저를 통해 자신의 휴대폰과 컴퓨터 간에 파일을 전송할 때.

빠른 시작

1. 1

   저장소에서 deploy/docker-compose.yml을 다운로드합니다

2. 2

   Docker Compose로 FileSync를 시작합니다

   docker compose up -d
3. 3

   Docker를 실행 중인 머신의 브라우저에서 http://localhost를 엽니다

사용 전 알아둘 점

• !HTTP 옵션은 로컬에서 빠르게 테스트하기 위한 용도이며, 프로덕션 환경용이 아닙니다.
• !일반 HTTP에서는 수신한 파일 전체가 메모리에 버퍼링되므로 대용량 전송 시 메모리 안전성이 보장되지 않습니다.
• !프로덕션에서 사용하려면 자체 도메인과 Caddy 설정을 사용한 HTTPS가 필요합니다.
• !방화벽에서 포트 80/443, 3478 및 UDP 포트 범위 50000–50100을 열어야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

FileSync은(는) 무엇인가요?

파일 크기 제한 없이 WebRTC로 브라우저 간 파일을 실시간 P2P 전송하는 셀프 호스팅 웹 앱입니다. FileSync를 사용하면 한 기기에서 여러 수신자에게 파일을 동시에 공유할 수 있습니다. 보낸 사람이 방을 만들고 링크나 QR 코드를 공유하면, 수신자는 설치하거나 계정을 만들 필요 없이 브라우저에서 링크를 열면 됩니다. 방에 비밀번호를 설정할 수도 있습니다.

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

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

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

활발히 유지보수 중. FileSync의 마지막 커밋은 2026년 11월 5일입니다.

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

파일을 서드파티 클라우드에 업로드하지 않고 동료나 고객 그룹에 대용량 파일을 전송할 때. 셀프 호스팅 인스턴스를 통해 집이나 사무실 네트워크 안에서, 또는 네트워크 간에 파일을 공유할 때. 브라우저를 통해 자신의 휴대폰과 컴퓨터 간에 파일을 전송할 때.

FileSync는 어떻게 설치하나요?

저장소에서 deploy/docker-compose.yml을 다운로드합니다 Docker Compose로 FileSync를 시작합니다: docker compose up -d Docker를 실행 중인 머신의 브라우저에서 http://localhost를 엽니다

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

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