{"id":28787977,"url":"https://github.com/gabs77u/darks","last_synced_at":"2026-04-29T15:02:24.765Z","repository":{"id":299441339,"uuid":"1002231939","full_name":"Gabs77u/Darks","owner":"Gabs77u","description":"Darks é uma solução completa para privacidade, anonimato e segurança digital, integrando VPN (WireGuard/OpenVPN), gerenciamento avançado de proxies, criptografia, monitoramento de rede e interface gráfica profissional. O projeto é modular, seguro , com foco em robustez, testes e facilidade de uso.","archived":false,"fork":false,"pushed_at":"2025-06-16T14:58:02.000Z","size":264,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-16T15:46:46.690Z","etag":null,"topics":["openvpn","proxy","proxychains","python","tor","vpn","wireguard"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Gabs77u.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-15T02:23:11.000Z","updated_at":"2025-06-16T14:58:05.000Z","dependencies_parsed_at":"2025-06-16T15:57:00.765Z","dependency_job_id":null,"html_url":"https://github.com/Gabs77u/Darks","commit_stats":null,"previous_names":["gabs77u/darks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Gabs77u/Darks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gabs77u%2FDarks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gabs77u%2FDarks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gabs77u%2FDarks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gabs77u%2FDarks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Gabs77u","download_url":"https://codeload.github.com/Gabs77u/Darks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gabs77u%2FDarks/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260439480,"owners_count":23009294,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["openvpn","proxy","proxychains","python","tor","vpn","wireguard"],"created_at":"2025-06-17T21:00:48.215Z","updated_at":"2026-04-29T15:02:24.753Z","avatar_url":"https://github.com/Gabs77u.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Darks: Plataforma de Segurança, Anonimato e Gerenciamento de VPN/Proxy\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/workflow/status/USUARIO/REPO/CI\" alt=\"Build Status\"/\u003e\n  \u003cimg src=\"https://codecov.io/gh/USUARIO/REPO/branch/main/graph/badge.svg\" alt=\"Coverage\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"MIT License\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.10%2B-blue\" alt=\"Python Version\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.icons8.com/fluency/96/lock-2.png\" alt=\"Segurança\" width=\"60\"/\u003e\n  \u003cimg src=\"https://img.icons8.com/fluency/96/anonymous-mask.png\" alt=\"Anonimato\" width=\"60\"/\u003e\n  \u003cimg src=\"https://img.icons8.com/fluency/96/vpn.png\" alt=\"VPN\" width=\"60\"/\u003e\n  \u003cimg src=\"https://img.icons8.com/fluency/96/proxy.png\" alt=\"Proxy\" width=\"60\"/\u003e\n  \u003cimg src=\"https://img.icons8.com/fluency/96/settings.png\" alt=\"Configuração\" width=\"60\"/\u003e\n\u003c/p\u003e\n\n---\n\n## ✨ Visão Geral\nDarks é uma solução completa para privacidade, anonimato e segurança digital, integrando VPN (WireGuard), gerenciamento avançado de proxies, criptografia, monitoramento de rede e interface gráfica profissional. Modular, seguro e pronto para produção.\n\n## 🚀 Funcionalidades\n- 🖥️ Interface gráfica (GUI) moderna\n- 🔒 VPN WireGuard\n- 🌐 Proxies (SOCKS5, HTTP, FTPS, SFTP)\n- 🕵️ Tor e DNS seguro\n- 📊 Painel visual de status\n- 🛡️ Criptografia avançada\n- 🔄 Exportação/importação segura\n- 📝 Auditoria e logging\n- 🔗 Integração com APIs externas\n- ✅ Testes unitários, integração e E2E\n\n## 📦 Estrutura do Projeto\n- `gui/`: Interface gráfica\n- `crypto/`: Criptografia\n- `wireguard/`: VPN WireGuard\n- `proxies/`: Proxies e proxychains\n- `integrations/`: APIs externas\n- `ProxyList/`: Listas de proxies\n- `tests/`: Testes unitários, integração e E2E\n- `docs/`: Documentação detalhada\n\n## 🛠️ Instalação\n```bash\n# Clone o repositório\n git clone \u003crepo_url\u003e\n cd Darks\n# Instale as dependências\n pip install -r requirements.txt\n# Instale o WireGuard (https://www.wireguard.com/install/)\n# (Opcional) Instale o Tor (https://www.torproject.org/download/)\n```\n\n## 💻 Uso\n```bash\npython run_gui.py\n```\nPara rodar a API Django:\n```bash\ncd integrations\npython api_server.py\n```\n\n## 🔐 Segurança e Produção\n- [Proteção de segredos e .env](docs/segredos.md)\n- [Permissões mínimas de arquivos](docs/permissoes_arquivos.md)\n- [SCA: análise de dependências](docs/sca.md)\n- [Troubleshooting de escalabilidade](docs/troubleshooting_escalabilidade.md)\n- [Exemplo de configuração segura](.env.example)\n\n## 🧪 Testes e Qualidade\n- Estrutura de testes granularizada por módulo em `tests/`\n- Testes unitários, integração e E2E (pytest, pytest-qt, pytest-playwright)\n- Benchmarks de performance (pytest-benchmark)\n- Testes de carga/stress (locust)\n- Cobertura de código (pytest-cov, coverage)\n- Segurança de dependências (safety, pip-audit)\n\n### Executando todos os testes\n```bash\npytest --cov=gui --cov=crypto --cov=wireguard --cov=proxies --cov=integrations --cov-report=term --cov-report=html\n```\n\n### Instalando dependências\n```bash\npip install -r requirements.txt\n```\n\n### Ambiente de produção\n- Instale WireGuard e Tor no sistema (externo ao Python)\n- Configure variáveis de ambiente sensíveis\n\n### Ambiente de desenvolvimento/testes\n- Use `pytest`, `pytest-qt`, `pytest-playwright` para rodar todos os testes\n- Use `pytest-cov` para cobertura\n- Use `locust` para stress/carga\n\n## 📁 Estrutura de Diretórios\n```\ngui/         # Interface gráfica\ncrypto/      # Criptografia\nwireguard/   # VPN WireGuard\nproxies/     # Proxies\nintegrations/# APIs externas\nProxyList/   # Listas de proxies\ntests/       # Testes\n```\n\n## 🚚 Deploy\n- Remova arquivos não necessários para produção: `.env.example`, `.pytest_cache/`, `.vscode/`, `tests/`, etc.\n- Mantenha apenas código-fonte, configs essenciais, `requirements.txt`, `README.md`, `docs/`\n- Use ambiente virtual dedicado e proteja arquivos sensíveis\n\n## 🤝 Contribuição\n- Siga PEP8/Black\n- Escreva testes para novas funcionalidades\n- Documente métodos e módulos críticos\n- Use branches para features/correções\n\n## ❓ FAQ e Suporte\n- [FAQ](docs/faq.md)\n- Para dúvidas, abra uma issue ou entre em contato\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.icons8.com/fluency/48/checked-checkbox.png\" alt=\"Pronto para produção\"/\u003e\n  \u003cb\u003eDocumentação profissional, badges reais e pronta para produção.\u003c/b\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabs77u%2Fdarks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabs77u%2Fdarks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabs77u%2Fdarks/lists"}