
TunnelX는 네트워크 트래픽을 라우팅하기 위한 보안 SOCKS5 프록시 서버를 생성하도록 설계된 경량 인그레스 터널링 도구입니다.
TunnelX는 네트워크 트래픽 라우팅을 위한 보안 SOCKS5 프록시 서버를 생성하도록 설계된 경량 인그레스 터널링 도구입니다. TunnelX는 ProjectDiscovery 플랫폼에서 내부 네트워크 스캐닝을 가능하게 하여 원활하고 격리된 연결을 보장하기 위해 만들어졌습니다.
TunnelX는 ProjectDiscovery API 키를 사용하여 보안 인그레스 터널을 생성하며, SOCKS5 프록시를 통해 격리된 내부 스캐닝을 가능하게 합니다.
고유한 네트워크 이름을 지정하여 다른 네트워크에서 TunnelX를 실행할 수 있습니다. 이렇게 하면 여러 네트워크를 독립적으로 스캔할 수 있으며, 각 연결은 ProjectDiscovery Scans 페이지의 네트워크 드롭다운 메뉴에서 선택 가능한 옵션으로 표시됩니다.
Docker 이미지 실행:
docker run --network host -d -e PDCP_API_KEY="your_api_key" projectdiscovery/tunnelx:latest
your_api_key를 사용자의 ProjectDiscovery API 키로 교체하세요.
또는 로컬에서 빌드 및 실행:
docker build . -t tunnelx
docker run --network host -d -e PDCP_API_KEY="your_api_key" tunnelx
설치 및 실행:
go install github.com/projectdiscovery/tunnelx@latest
export PDCP_API_KEY="your_api_key"
tunnelx
소스에서 직접 실행:
git clone https://github.com/projectdiscovery/tunnelx.git
cd tunnelx
export PDCP_API_KEY="your_api_key"
go run .
systemd 서비스로 실행: TunnelX를 systemd에서 실행하려면:
sudo cp deployment/systemd/tunnelx.service /etc/systemd/system/tunnelx.service
sudo systemctl daemon-reload
sudo systemctl enable tunnelx
sudo systemctl start tunnelx
sudo systemctl status tunnelx
연결이 성공하면 ProjectDiscovery Scans로 이동하여 설정된 연결을 사용하여 스캔을 생성하고 관리하세요.

| 플래그 | 설명 |
|---|---|
-auth | 사용자의 ProjectDiscovery API 키 (필수). |
-name | (선택 사항) 사용자 지정 네트워크 이름을 지정합니다. 기본값은 사용자 머신의 호스트 이름입니다. |
예시:
tunnelx -auth <your_api_key> -name <custom_network_name>
출력 예시:
tunnelx -auth <your_api_key>
[INF] Session established. Leave this terminal open to enable continuous discovery and scanning.
[INF] Your network is protected—connection isolated and not exposed to the internet.
[INF] To create a scan, visit: https://cloud.projectdiscovery.io/scans
[HELP] To terminate, press Ctrl+C.
백그라운드 실행
tunnelx를 백그라운드에서 계속 실행하려면 운영 체제에 따라 다음 지침을 따르세요:
# Linux & MacOS
nohup tunnelx -auth <your_api_key>
# Windows
start /B tunnelx -auth <your_api_key>