
차세대 DorX. Dorks에 의해, Dorks를 위해 만들어졌습니다. 🤓
Recon Village, DEF CON 31에서 소개된 바 있습니다
DorXNG는 여러 업스트림 검색 제공자를 통해 고급 검색 엔진 연산자를 사용하여 OSINT 데이터를 수집하는 현대적인 솔루션입니다. 백엔드에서는 자체 호스팅이 가능하고 해킹 가능하며 프라이버시에 중점을 둔 메타 검색 엔진인 SearXNG의 목적에 맞게 구축된 컨테이너화된 이미지를 활용합니다.
우리의 SearXNG 구현은 모든 검색 쿼리를 Tor 네트워크를 통해 라우팅하며, Tor의 MaxCircuitDirtiness 구성 지시문을 사용하여 10초마다 회로를 갱신합니다. 또한 SearXNG의 모든 클라이언트 측 타임아웃 기능을 비활성화했습니다. 이러한 설정을 통해 많은 반복 검색 쿼리를 발행할 때 흔히 발생하는 검색 엔진의 제한을 회피할 수 있습니다.
DorXNG 클라이언트 애플리케이션은 Python3로 작성되었으며, SearXNG API와 상호작용하여 검색 쿼리를 동시에 발행합니다. 여러 SearXNG 인스턴스에 걸쳐 요청을 발행할 수도 있습니다. 결과 검색 결과는 SQLite3 데이터베이스에 저장됩니다.

우리는 고급 검색 연산자를 실제로 준수하는 업스트림 검색 엔진만 활성화합니다. SearXNG의 모든 일반 및 웹 엔진(91개)은 2026-11-01에 operators.lst를 대상으로 테스트되었으며, 이는 문서화된 모든 연산자를 다루는 57개 쿼리 모음으로 Tor를 통한 경우와 직접 연결한 경우 모두에서 테스트되었습니다. 연산자를 무시하거나 관련 없는 결과를 제공하는 엔진은 데이터베이스를 노이즈로 오염시키기 때문에 비활성화됩니다.
Tor를 통해 활성화됨 (기본값):
BraveDuckDuckGo (웹 엔드포인트)Google CSEGMXs1searchStartpageSwisscows--no-tor로 활성화됨 (직접 연결):
BraveDuckDuckGo (웹 엔드포인트)Google CSEs1searchSwisscowsYahoo이 엔진들은 site: 및 filetype: 덕(dork)에서 92~100%의 점수를 받았습니다. Yahoo는 직접 연결 전용입니다. Tor를 통해서는 쿼리와 무관한 결과를 반환합니다. Bing, Naver, Yandex 및 대부분의 소규모 엔진은 연산자를 무시하며, Google과 Qwant는 SearXNG를 완전히 차단하므로 모두 비활성화됩니다.
어떤 엔진도 inurl: 또는 allinurl:을 엄격히 준수하지 않으므로(순위 힌트로 처리됨), 해당 덕에서는 약간의 노이즈가 발생할 수 있습니다. site:, filetype:, intitle:은 신뢰할 수 있습니다.
SearXNG가 지원하는 검색 엔진에 대한 자세한 내용은 Configured Engines를 참조하십시오.
이를 가능하게 해준 Tor와 SearXNG 개발자들에게 감사를 표합니다. 두 프로젝트 모두에 기부해 주세요!
영감과 멋진 ghdb_scraper.py 스크립트를 제공한 pagodo 개발자에게 감사를 표합니다!
마지막으로, 결코 빠질 수 없는 j0hnny에게 감사를 표합니다. OG Dork. 🧠🏴☠
DorXNG 설치
git clone https://github.com/researchanddestroy/dorxng
cd dorxng
pip install -r requirements.txt
./DorXNG.py -h
커스텀 SearXNG Docker 컨테이너를 다운로드하고 실행하세요(최소 하나). 여러 SearXNG 인스턴스를 사용할 수 있습니다. DorXNG와 함께 --serverlist 옵션을 사용하세요. 참조: server.lst
docker run researchanddestroy/searxng:latest
컨테이너를 직접 빌드하려면:
git clone https://github.com/researchanddestroy/searxng # The URL must be all lowercase for the build process to complete
cd searxng
make container.build # Requires docker buildx (or podman)
docker run localhost/searxng/searxng:latest
buildx가 없나요? 버전을 고정하고 일반 docker build로 빌드하세요:
./manage pyenv.install
./local/py3/bin/python -m searx.version freeze
docker build -f container/Dockerfile -t localhost/searxng/searxng:latest .
기본적으로 DorXNG는 parse_args.py에 하드코딩된 server 변수를 가지고 있으며, 이는 Docker가 머신에서 실행하는 첫 번째 컨테이너에 할당할 IP 주소인 172.17.0.2로 설정되어 있습니다. 이는 변경할 수 있으며, --server 또는 --serverlist로 덮어쓸 수 있습니다.
검색 쿼리 발행 시작
./DorXNG.py -q 'search query'
DorXNG 데이터베이스 쿼리
./DorXNG.py -D 'regex search string'
업스트림 검색 제공자와 SearXNG는 빠르게 변화하며, 우리의 커스텀 컨테이너는 뒤처질 수 있습니다. 문제가 발생하면 이를 건너뛰고 공식 업스트림 SearXNG 컨테이너를 대신 실행할 수 있습니다. 이 모드에서는 Tor가 컨테이너 내부가 아닌 호스트 머신에서 실행됩니다.
호스트에 Tor를 설치하고 회로 갱신 간격을 설정하세요:
sudo pacman -S tor # or: sudo apt install tor
echo 'MaxCircuitDirtiness 10' | sudo tee -a /etc/tor/torrc
sudo systemctl enable --now tor
curl -x socks5h://127.0.0.1:9050 -s https://check.torproject.org/api/ip # Should return {"IsTor":true,...}
DorXNG 디렉터리에서 최신 업스트림 SearXNG 컨테이너를 실행하며, 우리의 settings.yml을 사용합니다:
docker pull searxng/searxng:latest
docker run --rm \
--network host \
-v "$(pwd)/settings.yml:/etc/searxng/settings.yml:ro" \
searxng/searxng:latest
--network host를 사용하면 컨테이너가 호스트의 Tor SOCKS 프록시(127.0.0.1:9050)에 접근할 수 있습니다. 제공된 settings.yml은 컨테이너 자체의 기본값 위에 계층적으로 적용됩니다. 모든 업스트림 요청을 Tor를 통해 라우팅하고, json 출력 형식을 활성화하며, SearXNG의 엔진 차단 및 일시 중단 타이머를 비활성화하고, 검증된 엔진만 활성화하며, --no-tor에서 사용되는 직접 엔진을 포함합니다. SearXNG는 Tor에 접근할 수 없으면 시작을 거부하므로, 먼저 호스트에서 Tor를 시작하십시오.
업스트림 컨테이너는 포트 8080에서 일반 HTTP를 제공합니다(settings.yml의 server.port 값은 무시됨). 따라서 --server를 사용하여 DorXNG가 해당 컨테이너를 가리키도록 하십시오:
./DorXNG.py -s 'http://127.0.0.1:8080/search' -q 'search query'
여러 인스턴스를 실행하려면 각 인스턴스에 -e SEARXNG_PORT=8081로 고유한 포트를 지정하고 --serverlist 파일에 나열하십시오. 이러한 인스턴스들은 모두 호스트의 단일 Tor 회로를 공유한다는 점을 유의하십시오. 반면 커스텀 컨테이너는 각자 자체 회로를 실행합니다.
settings.yml의 secret_key 값을 변경하십시오.Tor가 기본값입니다. SearXNG가 업스트림 검색 제공자에 직접 쿼리하도록 하려면 --no-tor를 추가하십시오:
./DorXNG.py -q 'site:example.com intext:example' --no-tor
이것은 사용자 정의 컨테이너와 위의 Host Tor Bypass 모두에서 작동합니다. 두 SearXNG 구성 모두 각 검증된 엔진의 Tor를 사용하지 않는 두 번째 사본(이름: <engine> direct, 기본적으로 비활성화됨)을 포함합니다. --no-tor를 사용하면 DorXNG는 서버에 직접 엔진을 요청하고 그것들만 사용합니다. 사용하지 않으면 아무것도 변경되지 않습니다.
--no-tor는 SearXNG를 실행하는 머신의 공인 IP 주소를 쿼리하는 모든 검색 제공자에게 노출합니다.직접 쿼리는 더 빠르고 일부 엔진(Yahoo)은 직접적으로만 작동하지만, 제공자들은 IP 주소로 속도 제한을 하므로 과도하게 사용하면 IP가 제한됩니다. SearXNG 자체의 !bang 단축키는 --no-tor를 재정의합니다. 이를 결합하려면 직접 단축키를 사용하세요: !brd (Brave), !ddgwd (DuckDuckGo), !gocd (Google CSE), !s1d (s1search), !swd (Swisscows), !yhd (Yahoo).
DorXNG는 MCP 서버(mcp_server.py)를 제공하므로 Claude Code, Claude Desktop 또는 모든 MCP 클라이언트와 같은 AI 에이전트가 덕 검색을 실행하고, 백그라운드에서 장시간 수집을 구동하며, 결과 데이터베이스를 쿼리할 수 있습니다. 이 서버는 CLI와 동일한 SearXNG 서버와 통신하며, 그 데이터베이스는 CLI의 -d, -D, -m 옵션과 호환됩니다.
pip install -r requirements.txt
Claude Code에 추가하세요:
claude mcp add dorxng -e DORXNG_SERVER=https://172.17.0.2/search -- python3 /path/to/DorXNG/mcp_server.py
또는 MCP 클라이언트 구성(Claude Desktop 등)에 추가하세요:
{
"mcpServers": {
"dorxng": {
"command": "python3",
"args": ["/path/to/DorXNG/mcp_server.py"],
"env": {
"DORXNG_SERVER": "https://172.17.0.2/search",
"DORXNG_DB_DIR": "/path/to/databases"
}
}
}
}
네트워크를 통해 연결하는 에이전트는 stdio 대신 Streamable HTTP를 사용할 수 있습니다. 기본적으로 127.0.0.1에 바인딩되며, 엔드포인트는 http://127.0.0.1:8765/mcp입니다:
python3 mcp_server.py --http --port 8765
환경 변수:
| 변수 | 기본값 | 설명 |
|---|---|---|
DORXNG_SERVER | https://172.17.0.2/search | SearXNG 서버, 또는 쉼표로 구분된 서버 목록 (--serverlist와 같음) |
DORXNG_DB_DIR | 현재 디렉터리 | 데이터베이스를 읽고 쓰는 위치. 도구는 그 안의 일반 .db 파일 이름만 허용함 |
DORXNG_DELAY | 4 | 수집 작업에서 요청 배치 사이의 초 단위 지연 (--timeout과 같음) |
DORXNG_MAX_JOBS | 4 | 동시에 실행되는 최대 수집 작업 수 |
도구:
| 도구 | 설명 |
|---|---|
server_status | 각 서버의 도달 가능성, 그리고 해당 서버의 Tor, 직접(--no-tor) 및 onion 엔진 |
search | 최대 10페이지까지 dork를 실행하고, 결과를 저장한 뒤, 데이터베이스에 새로 추가된 결과를 반환함 |
start_harvest | 여러 쿼리 또는 번들 dork 목록(ghdb / operators)의 백그라운드 수집. CLI와 동일한 페이지, 반복(0 = 중지할 때까지) 및 --nonewresults 동작을 사용함. job_id를 반환함 |
job_status / list_jobs / stop_job | 수집 작업의 진행 상황과 최신 결과를 추적하거나 작업을 중지함 |
query_database | 제목과 URL에 대한 정규식 검색 (-D와 같음) |
database_stats | 행 수, 쿼리별 결과 수, 상위 도메인 |
list_databases / merge_databases | 데이터베이스를 나열하거나, 하나를 다른 데이터베이스에 병합함 (-m과 같음) |
list_dorks | 번들 GHDB dork 목록과 operators.lst를 페이지 단위로 탐색하고 필터링함 |
또한 dorxng://operators 및 dorxng://readme 리소스와, 에이전트가 한 도메인에 대한 정찰을 수행하도록 안내하는 dork_recon 프롬프트를 제공함.
search와 start_harvest는 no_tor 인수를 받음. 기본값은 false이며, 이를 설정하면 --no-tor와 정확히 동일하게 SearXNG 호스트의 IP 주소가 검색 제공자에게 노출됨.