
ProjectDiscovery Cloud - Agent
pd-agent를 사용하면 ProjectDiscovery Cloud Platform에서 자신의 내부 네트워크를 스캔할 수 있습니다.
스캔하려는 네트워크 내의 머신(VM, 서버, 워크스테이션, Kubernetes 파드)에 에이전트를 설치하고 PDCP 팀에 연결하세요. 클라우드 UI에서 개인 IP, 내부 호스트명, VPC 범위 또는 Kubernetes 클러스터를 대상으로 스캔을 시작하면, 에이전트가 로컬에서 실행하고 결과를 스트리밍합니다. 네트워크의 어떤 것도 공개적으로 노출될 필요가 없습니다.
Nuclei, httpx, naabu, dnsx, tlsx가 모두 에이전트에 내장되어 있으므로 호스트에 추가로 설치할 것이 없습니다.
자격 증명 획득. https://cloud.projectdiscovery.io에 로그인하여 API 키와 팀 ID를 복사하세요.
에이전트 실행 — 스캔하려는 네트워크에 접근할 수 있는 머신에서 다음 명령을 실행하세요:
docker run -d --name pd-agent \
--network host --cap-add NET_RAW --cap-add NET_ADMIN \
-e PDCP_API_KEY=your-api-key \
-e PDCP_TEAM_ID=your-team-id \
ghcr.io/projectdiscovery/pd-agent:latest \
-agent-network prod-vpc
확인. 클라우드 UI의 Agents 탭을 열면 — 몇 초 내에 에이전트가 발견된 서브넷과 함께 나타납니다.
스캔. UI에서 스캔을 시작하고 에이전트의 네트워크(위의 prod-vpc)로 라우팅하세요. 에이전트가 로컬에서 실행하고 결과를 스트리밍합니다.
다른 설치 방법(Kubernetes, 네이티브 바이너리, systemd, launchd, Windows 서비스) → docs/install.md.
10.0.0.0/8, 192.168.0.0/16, 내부 DNS, VPN 전용 서비스.-agent-network)을 할당하여 스캔을 특정 사이트로 라우팅 — 예: 데이터 센터, 리전 또는 VPC당 하나 이상의 에이전트.| 주제 | 읽을 시점 |
|---|---|
| docs/install.md | Linux, macOS, Windows, Docker 또는 Kubernetes에 처음 설치할 때 |
| docs/configuration.md |
MIT 라이선스에 따라 배포됩니다. ProjectDiscovery가 ❤️로 만들었습니다.
| 에이전트가 허용하는 모든 환경 변수와 CLI 플래그 및 제어 항목 확인 시 |
| docs/scaling.md | 에이전트를 더 추가해야 할 때와 오토스케일링 기준이 되는 메트릭 확인 시 |