OpenSource-Hub
C

copyparty

SHA-256
44.8k stars·파일 관리·SHA-256 체크섬 확인됨

어떤 브라우저로든 모든 기기를 파일 서버로 만들 수 있으며, 이어받기를 지원합니다.

컴퓨터/휴대폰을 순식간에 파일 서버로 바꿔주는 작고 가벼운 Python 도구입니다.

주요 기능

  • HTTP/WebDAV/SFTP/FTP/TFTP/SMB 6가지 프로토콜 지원
  • 모든 브라우저에서 업로드/다운로드, 이어받기 지원
  • Android 앱 및 iPhone 단축어 지원
  • 파일 관리, 검색, 썸네일, 미디어 플레이어 내장
  • 공유 링크 생성, RSS 구독, OPDS 전자책

할 수 없는 것

  • •SFTP 성능이 느림(약 700MB/s); SMB 서버는 안전하지 않으므로 WAN에서 사용하는 것을 권장하지 않음; 기본적으로 암호화가 없으며 HTTPS가 필요한 경우 리버스 프록시를 직접 구성해야 함.

사용 사례

  • 홈 네트워크 파일 공유
  • 임시 파일 전송(클라이언트 설치 불필요)
  • 서버 파일 관리(다중 프로토콜 액세스)

상세 설명

copyparty는 가볍고 다중 프로토콜을 지원하는 파일 서버로, Python 환경(2 또는 3)만 있으면 어떤 기기에서든 실행할 수 있습니다. HTTP, WebDAV, SFTP, FTP, TFTP, SMB 여섯 가지 프로토콜을 지원하며, Raspberry Pi, 오래된 PC 또는 클라우드 서버에서 파일을 공유할 수 있습니다. 핵심 기능으로는 웹 이어받기, 내장 파일 관리자, 썸네일 미리보기, 미디어 플레이어, 전체 텍스트 검색, zip/tar 묶음 다운로드, RSS 구독, OPDS 전자책 읽기, Android 클라이언트 및 iOS 단축어가 있습니다. 설정은 매우 간단합니다. Python 스크립트 하나만 실행하면 됩니다. 또한 업로드 중복 제거, 이벤트 훅, 폴더별 권한 관리도 지원합니다.

문제 해결 & FAQ (1)

문제 해결
copyparty가 traceback 없이 조용히 종료될 때, 어떤 signal이 copyparty를 종료시키는지 어떻게 확인할 수 있나요?

strace로 copyparty를 실행하면 SIGKILL처럼 잡을 수 없는 시그널을 포함하여 시그널 전달을 캡처할 수 있습니다:

strace -Tttyyvfesignal -o /home/yourname/strace.strace python3 copyparty-sfx.py -c your.conf

설정 파일 경로와 인수는 평소에 사용하는 copyparty 명령에 맞게 바꾸세요. 프로세스가 사라진 후 로그를 확인합니다:

tail -n 100 /home/yourname/strace.strace
grep -E 'SIG(KILL|TERM|INT|HUP|QUIT)' /home/yourname/strace.strace | tail -n 50

마지막 시그널 항목에 종료를 일으킨 시그널이 표시되며, 보낸 측의 PID가 포함될 수도 있습니다. Python은 SIGKILL을 로깅할 수 없으므로, 트레이스백 없이 조용히 종료되는 것이 정상적인 동작입니다.

Raspberry Pi 전체가 재부팅되거나 종료 시그널이 기록되지 않는 경우, 먼저 외부 원인을 확인하세요. 충분한 출력을 제공하는 공식 PSU를 사용하고, 외부 전원 방식의 USB 드라이브/허브를 사용하며, 의심되는 USB 케이블은 교체하세요. 예기치 않은 재부팅이 발생한 후에는 다음 명령으로 이전 커널 로그를 확인하세요:

journalctl -b -1 -k --no-pager | tail -n 100
vcgencmd get_throttled

종료 시에만 나타나는 ProgrammingError: Recursive use of cursors not allowed 메시지는 표면적인 문제일 뿐이며, 종료의 원인이 아닙니다.

원본 Issue #1507

태그

file-serverwebdavsftpftpsmbpythonresumable-uploadself-hosted

시작하기

1

설치 프로그램 다운로드

위 버튼을 클릭하여 시스템에 맞는 설치 프로그램을 다운로드

2

소프트웨어 설치

다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요

3

1단계: GitHub Releases에서 copyparty-sfx.py 다운로드

4

2단계: 터미널에서 python3 copyparty-sfx.py 실행

5

3단계: 브라우저에서 표시된 주소를 열면 바로 사용할 수 있습니다

설치 가이드
  1. 1단계: GitHub Releases에서 copyparty-sfx.py 다운로드
  2. 2단계: 터미널에서 python3 copyparty-sfx.py 실행
  3. 3단계: 브라우저에서 표시된 주소를 열면 바로 사용할 수 있습니다
파일 무결성

SHA-256 체크섬 확인됨

GitHub 공식 Release 페이지에서 추출된 체크섬

SHA256 체크섬

c3b6a32123c8b3df782cf9a35c36bdb91213ad332f17e3144ec5c9f376560dd0

이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.

이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.

오픈소스 투명성

GitHub 소스 보기
환경 가이드

제거 정보

다운로드한 파일과 구성 파일을 삭제하면 되며, 시스템에 잔여물이 남지 않습니다.

추가 의존성 없음

다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.

프로젝트 정보
라이선스MIT
마지막 업데이트2026-10-15 07:45:11
GitHub 저장소공식 웹사이트

문제 발생? 아래 FAQ 확인

1 FAQ

유사한 프로젝트