58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
# CamFinder
|
|
|
|
Scanner TCP em Rust para descobrir hosts em CIDRs internos, testar a porta `554` e salvar progresso e endpoints abertos em PostgreSQL.
|
|
|
|
O projeto tem três modos:
|
|
|
|
- `local`: roda o scan inteiro no processo atual.
|
|
- `coordinator`: recebe conexões de workers, distribui blocos e grava resultados no banco.
|
|
- `worker`: conecta ao coordenador, recebe blocos e testa os hosts.
|
|
|
|
O progresso é salvo por bloco, então o scan pode ser retomado sem repetir o que já foi concluído.
|
|
|
|
## Uso
|
|
|
|
1. Copie `.env.example` para `.env`.
|
|
2. Configure `DATABASE_URL` apontando para um Postgres acessível.
|
|
3. Rode `cargo run -- local`, `cargo run -- coordinator` ou `cargo run -- worker`.
|
|
|
|
## Docker Compose
|
|
|
|
O `docker-compose.yml` já sobe:
|
|
|
|
- `postgres` para persistência.
|
|
- `coordinator` exposto no host pela porta `666`.
|
|
- `worker` conectado ao coordenador na rede interna do compose.
|
|
|
|
Para escalar workers:
|
|
|
|
- `docker compose up --scale worker=3`
|
|
|
|
Para workers de outras máquinas, use `vps.valmo.dev:666` como endereço do coordenador.
|
|
|
|
## Scripts
|
|
|
|
- `cargo build`
|
|
- `cargo run`
|
|
- `npm run scan`
|
|
- `npm run coord`
|
|
- `npm run worker`
|
|
|
|
## Variáveis úteis
|
|
|
|
- `DATABASE_URL`
|
|
- `SCAN_CIDRS`
|
|
- `SCAN_CIDR`
|
|
- `SCAN_CIDR_FILE`
|
|
- `SCAN_CONCURRENCY`
|
|
- `SCAN_CHUNK_SIZE`
|
|
- `SCAN_TIMEOUT_MS`
|
|
- `SCAN_MODE`
|
|
- `COORDINATOR_BIND`
|
|
- `COORDINATOR_ADDR`
|
|
- `WORKER_NAME`
|
|
|
|
## Restrições
|
|
|
|
O projeto aceita somente redes privadas `10.0.0.0/8`, `172.16.0.0/12` e `192.168.0.0/16`.
|