iWant

CLI 기반 분산형 피어투피어 파일 공유

빌드 상태

무엇인가요?

LAN 네트워크에서 중앙 서버 없이 파일을 검색하고 다운로드할 수 있는 명령줄 도구입니다.

기능

• 분산형 : 파일을 호스팅하는 중앙 서버가 없습니다. 따라서 단일 장애점이 없습니다.
• 쉬운 파일 검색 : 구글에서 검색하는 것처럼 쉽습니다.
• 여러 피어에서 파일 다운로드 : 시더가 실패하거나 그룹을 떠나도, 리처는 네트워크의 다른 시더에서 계속 다운로드합니다.
• 디렉토리 다운로드 : 디렉토리 다운로드를 지원합니다.
• 다운로드 재개 : 중단된 지점에서 다운로드를 재개합니다.
• 일관된 데이터 : 공유 폴더 내 파일에 대한 모든 변경(수정, 삭제, 추가)이 네트워크에 즉시 반영됩니다.
• 크로스 플랫폼 : Linux/Windows/Mac에서 작동합니다. Mac에서는 추가 테스트가 필요합니다.

왜 만들었나요?

• 주변 사람들이 가지고 있는 파일을 터미널에 파일명을 입력해서 다운로드할 수 있다는 아이디어가 마음에 들었습니다.
• 제3자 등록이 필요 없습니다.
• 복잡한 설정이 없습니다.
• 크로스 플랫폼으로 만들고 싶었습니다.
• 가동 중단 시간이 없습니다.
• 브라우저 없이... 그냥 터미널만 있으면 됩니다.
• 재미로 ¯\(ツ)/¯

설치

pip install iwant

또는 소스에서 다운로드한 경우:

python setup.py install --user

시스템 종속성

다음 시스템 종속성이 설치되어 있는지 확인하세요:

• libffi-dev
• libssl-dev

사용법

iWant.

    LAN 네트워크에서 중앙 서버 없이 파일을 검색하고 다운로드하는 명령줄 도구입니다.


사용법:
    iwanto start
    iwanto search <name>
    iwanto download <hash>
    iwanto share <path>
    iwanto download to <destination>
    iwanto view config
    iwanto --version

옵션:
    -h --help                           이 화면을 표시합니다.
    --version                           버전을 표시합니다.
    start                               시스템에서 iwant 서버를 시작합니다.
    search <name>                       네트워크에서 파일을 검색합니다. 예: iwanto search batman
    download <hash>                     네트워크에서 파일을 다운로드합니다.
    share <path>                        공유 폴더를 변경합니다.
    view config                         공유 폴더와 다운로드 폴더를 봅니다.
    download to <destination>           다운로드 폴더를 변경합니다.

참고: 공유 폴더와 다운로드 폴더는 같을 수 없습니다.

실행 방법

iwanto start를 실행합니다 (iwant 서비스를 실행합니다).

클라이언트 실행

검색, 다운로드, 설정 보기, 설정 변경 같은 서비스를 실행하려면 다른 터미널을 열고 iwant 서버가 실행 중인지 확인하세요.

서버 실행

Windows에서는 서버를 실행하려면 관리자 권한이 필요합니다.

iwanto start

파일 검색

파일 이름을 입력하세요 ;) (참고: 정확한 이름이 아니어도 됩니다.)

iwanto search <filename>

예시:

iwanto search "slicon valey"

파일 다운로드

파일을 다운로드하려면 검색 후 얻은 파일의 해시값을 입력하세요.

iwanto download <hash of the file>

예시:

iwanto download b8f67e90097c7501cc0a9f1bb59e6443

공유 폴더 변경

언제든지 공유 폴더를 변경할 수 있습니다 (iwant 서비스가 실행 중일 때도 가능).

iwanto share <path>

예시:

iwanto share /home/User/Movies/

Windows에서는 따옴표를 사용하세요:

iwanto share "C:\Users\xyz\books\"

다운로드 폴더 변경

언제든지 다운로드 폴더를 변경할 수 있습니다.

iwanto download to <path>

예시:

iwanto download to /home/User/Downloads

Windows에서는 따옴표를 사용하세요:

iwanto download to "C:\User\Downloads"

공유/다운로드 폴더 보기

iwanto view config

어떻게 작동하나요?

프로그램이 시작되면 선출 데몬, 폴더 모니터링 데몬, __서버 데몬__을 생성합니다.

1. __선출 데몬__은 다음 활동을 담당합니다.

   • 합의(consensus)를 관리합니다.
   • 리더가 변경되면 즉시 __서버 데몬__에 알립니다.
   • 선거 참여, 리더 사용 불가, 네트워크 장애, 분할 브레인(split brain) 상황 등에 대해 네트워크의 다른 피어와 조정합니다.
   • 피어 발견을 위해 __멀티캐스트__를 사용합니다. 합의에 대한 설명은 여기에 있습니다.

2. __폴더 모니터링 데몬__이 시작되면 다음 단계를 수행합니다.

   • 공유 폴더의 모든 파일을 인덱싱합니다.
   • 데이터베이스의 항목을 업데이트합니다.
   • 인덱싱된 파일과 폴더를 서버에 알립니다.
   • 공유 폴더에 변경이 발생하면 __폴더 모니터링 데몬__이 수정된 파일을 인덱싱하고, 데이터베이스를 업데이트한 다음 서버에 변경 사항을 알립니다.

3. __iwant 클라이언트__는 사용자가 다음을 원할 때 __서버 데몬__과 통신합니다:

   • 파일 검색
   • 파일 다운로드
   • 공유 폴더 변경
   • 다운로드 폴더 변경

4. __서버 데몬__은 __iwant 클라이언트__로부터 명령을 받고, __파일 모니터링 데몬 및 선출 데몬__으로부터 업데이트를 받습니다.

   • __폴더 모니터링 데몬__으로부터 받은 업데이트는 리더에게 전달됩니다. 예: 인덱싱된 파일/폴더 정보.
   • __선출 데몬__으로부터 리더 변경 이벤트 같은 업데이트를 받으면 서버가 인덱싱된 파일/폴더 정보를 새 리더에게 전달하도록 트리거합니다.
   • __iwant 클라이언트__로부터 파일 검색 같은 쿼리를 받으면 리더에게 전달되고, 리더는 다른 피어로부터 받은 메타데이터에 대해 퍼지 검색(fuzzy search)을 수행한 후 (파일명, 크기, 체크섬) 목록을 반환합니다.
   • __iwant 클라이언트__로부터 파일 다운로드 같은 쿼리를 받으면 리더에게 전달되고, 리더는 파일/폴더의 루트 해시와 해당 파일을 가진 피어 목록을 함께 전달합니다. 그러면 __서버 데몬__이 피어 목록에 있는 피어들과 다운로드 프로세스를 시작합니다.
   • __iwant 클라이언트__로부터 공유 폴더 변경 같은 업데이트를 받으면 __서버 데몬__이 __폴더 모니터링 데몬__이 새 폴더를 인덱싱하도록 하고, 인덱싱이 완료되면 __서버 데몬__이 새로 인덱싱된 파일/폴더 메타 정보로 리더를 업데이트합니다.

할 일

• 강력한 보안 메커니즘 통합
• Python3 지원 추가
• 비디오 미리보기 추가
• 스트리밍 기능 추가
• 기본 NAT 트래버설 추가
• 테스트 모듈 생성
• 파일/폴더 다운로드 진행률 표시줄 UI 개선

왜 작동하지 않을 수 있나요?

• 방화벽
• 라우터에서 멀티캐스트를 지원하지 않음

오류

모든 로그는 ~/.iwant/.iwant.log 또는 AppData\Roaming\.iwant\.iwant.log에 있습니다.

프로젝트가 마음에 드셨나요?

아이디어, 버그 또는 수정 사항이 있으시면 언제든지 PR을 보내주세요 :)