Sobre o projeto

Posicionamento do Projeto: Este é um console de gerenciamento e escaneamento contínuo de "IPs otimizados" operando em torno do pool de endereços IP oficiais da Cloudflare. O motor de escaneamento central é a ferramenta de linha de comando cf_db.py, e o painel de gerenciamento Web cf_web.py chama internamente esse motor; ambos são implementados com a biblioteca padrão do Python 3.8+, sem dependência de pacotes de terceiros. Princípio de Escaneamento e Controle de Qualidade: Realiza sondagens de discagem concorrente em múltiplas portas e confirmação secundária via handshake TLS para filtrar IPs de borda CF utilizáveis. A amostragem utiliza uma estratégia de "ponderação de vizinhança", onde segmentos C que produziram IPs de alta qualidade são priorizados, com a proporção ajustável via --exploit. Os resultados são persistidos no SQLite, permitindo a retomada de escaneamentos interrompidos. O tamanho do banco de dados é limitado por teto superior e um mecanismo de "tumba", onde IPs mortos removidos ficam em silêncio por um período para evitar retestes imediatos. Painel de Gerenciamento Web: Após a inicialização, o controle de acesso é ativado por padrão, gerando nome de usuário e senha aleatória no cf_secret.json (permissão 600), com todas as páginas e APIs utilizando Basic Auth. Se o openssl estiver disponível no sistema, o HTTPS com certificado autoassinado é habilitado por padrão. O README observa que certificados autoassinados apenas criptografam a transmissão para evitar espionagem em rede local, não fornecendo autenticação de identidade; senhas fortes são necessárias para exposição à internet. A interface possui navegação lateral retrátil (estilo gaveta em dispositivos móveis) com cinco visualizações: - Dashboard Geral: Cartões de estatísticas (IPs testados como acumulado histórico) e gráficos de distribuição por data center, país, latência, largura de banda e rota. - Controle de Escaneamento: Fontes de endereço (rede global oficial, CF oficial, segmentos otimizados de operadoras), portas, número de amostras por rodada, concorrência, orçamento de verificação, número de testes de largura de banda por rodada, concorrência de teste de velocidade, domínio de teste, complementação de região, re-verificação, orçamento de detecção de rota e ciclo de reteste, proporção de segmentos C de qualidade, latência máxima, limite do banco de dados, além de chaves para confirmação TLS, classificação de rota e escaneamento simultâneo de IPv6. Os parâmetros entram em vigor imediatamente após salvos, permitindo iniciar ou parar o escaneamento a qualquer momento. - Lista de IPs: Filtros por data center (separado por vírgulas), largura de banda mínima, latência máxima, inclusão de IP, porta, apenas com largura de banda, apenas IPv6; ordenação por cabeçalho; seleção para copiar no formato ip:porta#região, exportar selecionados para txt ou limpar seleção, mantendo a seleção entre páginas; suporte a paginação e exportação de ADD.txt / CSV com base nos filtros atuais. - Efeitos de Clique: Chaves e controles deslizantes para efeitos de clique e rastro de cursor no estilo Blue Archive, com ajustes instantâneos salvos localmente no navegador, compatíveis com desktop e touch. - Papel de Parede: O servidor analisa e armazena em cache a imagem diária do NASA APOD; se o dia for um vídeo, recua para a imagem mais recente; em caso de falha na API, mantém a imagem antiga. Uma chave de API da NASA pode ser adicionada ao cf_settings.json para aumentar a cota. Otimização Manual: Sem aguardar o escaneamento em segundo plano, define-se a quantidade N, prioridade (largura de banda ou latência), filtro de região, apenas largura de banda ou apenas IPv6. O sistema extrai max(N×5, 20) candidatos do banco local (limite 150), retesta a conectividade, identifica a região e mede a largura de banda (concorrência 20), exibindo as N melhores entradas. Os dados de reteste são gravados no banco local como registros normais, mas a lista de otimização manual não é persistida. Detecção de Rota e Endpoints de Velocidade: O route_probe.py é um detector independente de classificação de rotas, realizando a determinação de ASN de ida e Traceroute salto a salto para distinguir rotas Premium/Comuns/Mistas (requer comando ping). O teste de velocidade utiliza por padrão o speed.cloudflare.com; para evitar limitação de taxa, o README sugere implantar o cf_speedtest_worker.js no Cloudflare Workers como domínio de teste próprio, utilizando fluxo de zeros para evitar limites de CPU da versão gratuita. Interfaces e Comandos: A API Web inclui GET / (interface), /api/status, /api/stats, /api/table, /api/optimize, /api/copy, /api/export, e POST /api/control, /api/settings, /api/test. Os parâmetros de linha de comando abrangem portas, candidatos por rodada, concorrência, orçamentos de verificação e banda, proporção de exploit, latência máxima, orçamento de detecção de rota e ciclo de reteste, IPv6, modo de rodada única/múltipla, intervalo de rodadas, re-verificação apenas de IPs de qualidade, importação de sementes, exportação por quantidade e região, limite de IPs no banco, etc. Além disso, suporta --stats para estatísticas do banco e cobertura. IPv6: Utiliza listas públicas de v6 otimizados (correspondência de operadora + fontes genéricas) para amostragem prioritária, integrando simultaneamente grandes blocos v6 oficiais da CF para descoberta aleatória, exigindo que a máquina possua conectividade IPv6. Os arquivos incluem cf_settings.json opcional (parâmetros de interface) e vendor/ba-click-fx.js (biblioteca de efeitos de clique estilo Blue Archive, MIT, auto-hospedada). O sistema gera automaticamente credenciais de login, certificados autoassinados, cache de papel de parede e arquivos de dados ASN. O projeto adota a licença MIT.