소개
OpenDirectoryDownloader는 KoalaBear84가 개발한 오픈 디렉토리 인덱싱 도구입니다. C#과 .NET(Core)로 작성되어 Windows, Linux, macOS 등 여러 운영체제에서 실행할 수 있으며, FTP(S), Google Drive, Dropbox, GitHub, pCloud, HFS 등 130여 가지 형식의 디렉토리 목록을 색인합니다. 이 프로그램 자체의 파일 다운로드 기능은 아직 구현되어 있지 않지만, 생성된 URL 목록을 wget, aria2c 등 외부 다운로더와 함께 사용해 실제 다운로드를 수행할 수 있습니다.
상세정보
다양한 소스 지원
FTP(S), Google Drive, AList, Directory Lister, HFS, Bhadoo, GoIndex, Go2Index, Mediafire, GoFile, GitHub, pCloud, Dufs 등 130여 가지의 디렉토리 형식을 인식하고 인덱싱합니다.
URL 목록 및 통계 저장
스캔 결과를 TXT와 JSON, aria2용 URL 파일 형태로 저장할 수 있으며, Reddit 통계 마크다운 출력과 업로드 기능을 지원합니다.
크로스 플랫폼 실행
C#과 .NET(Core)로 작성되어 Windows, Linux, macOS에서 동일하게 동작하며, ARM/ARM64 빌드는 라즈베리 파이용으로도 제공됩니다.
외부 다운로더 연동
생성된 URL 목록은 명령행 옵션을 통해 wget, aria2c 등 별도 다운로더로 바로 전달해 사용할 수 있습니다.
Cloudflare 및 프록시 지원
실험적으로 Chromium을 이용한 Cloudflare 우회 기능을 포함하며, socks5 기반 Tor 프록시를 통한 .onion 주소 스캔이 가능합니다.
설치 및 시작
기본 설치는 winget을 사용해 다음 명령으로 진행할 수 있습니다.
- winget install –id KoalaBear84.OpenDirectoryDownloader –exact
또한 GitHub 릴리스 페이지에서 Windows, Linux, macOS용 64비트 빌드와 ARM/ARM64 빌드를 내려받을 수 있으며, 자체 포함(self-contained) 빌드는 .NET 런타임을 별도로 설치하지 않아도 됩니다.
기본 사용 흐름
- 실행 파일을 다운로드하여 압축을 해제합니다.
- 명령행에서 스캔 대상 URL을 –url 옵션으로 지정해 프로그램을 실행합니다.
- 색인이 완료되면 결과 폴더에 theurlsfile.txt, theurlsfile-aria2.txt, JSON 파일 등이 생성됩니다.
- 필요 시 –quit 옵션으로 자동 종료하거나, 실행 중 표시되는 키 안내를 이용해 추가 작업을 수행합니다.
대표적인 명령행 예시
- Windows: OpenDirectoryDownloader.exe –url “https://myopendirectory.com”
- Linux/macOS: ./OpenDirectoryDownloader –url “https://myopendirectory.com”
- Docker: docker run –rm -v c:/Scans:/app/Scans -it koalabear84/opendirectorydownloader –quit –speedtest
외부 다운로더 연계
- wget: wget -x -i theurlsfile.txt
- aria2c(디렉터리 구조 포함): aria2c -i theurlsfile-aria2.txt
- aria2c(구조 미보존): aria2c -i theurlsfile.txt
활용 예시
- 공개 FTP(S) 서버의 디렉터리 목록을 빠르게 수집해 wget, aria2c로 일괄 다운로드
- Google Drive의 공유 폴더 구조를 색인해 URL 목록 생성
- GitHub 저장소 트리를 스캔해 파일 위치와 통계를 정리
- Tor(socks5) 프록시를 지정해 .onion 오픈 디렉터리를 색인
- Docker 컨테이너로 실행해 스캔 결과를 호스트 폴더에 저장
제한 및 라이선스
- 프로그램 자체의 다운로드 기능은 구현되어 있지 않으며, 별도 다운로더와의 연동이 필요합니다.
- Google Drive 스캔을 사용하려면 Google Drive API 자격 증명 파일을 발급받아 프로그램 폴더에 배치해야 합니다.
- Cloudflare 우회 기능은 실험적이며, 항상 성공하는 것은 아닙니다.
- 소스 코드는 GPL-3.0 라이선스로 배포됩니다.
화면으로 보는 주요 기능
OpenDirectoryDownloader 실행 화면

OpenDirectoryDownloader 1.0.0.0 버전이 시작되었으며, URL 입력을 요청하는 화면입니다. 지정된 URL은 https://hdpro1.com/samples/. 'I'를 누르면 정보, 'S'를 누르면 통계, 'T'를 누르면 스레드 정보, 'U'를 누르면 TXT 저장, 'J'를 누르면 JSON 저장이 가능합니다. ESC 또는 X를 누르면 종료할 수 있습니다. 인덱싱이 완료되었으며, .mov, .pdf, .wav 파일과 디렉토리가 목록에 표시되어 있습니다. 인덱싱은 2021-04-05 11:50:03에 완료되었으며, 총 1.1 MiB의 데이터가 처리되었습니다. 하단에는 'Saving URL list to file..' 메시지가 표시되어 있습니다.
시스템 요구사항
.NET 9 Runtime (자체 포함 릴리스 사용 시 설치 불필요), Linux Alpine 등 일부 배포판의 추가 의존성, 클립보드 복사 시 Linux의 xclip, Windows 10에서 TLS 오류 발생 시 레지스트리 적용, Google Drive 스캔용 API 자격 증명 파일, GitHub 스캔 시 선택적 GitHub 토큰, Tor 지원 시 Tor 프라이언트


