https://github.com/gabs77u/darks
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.
https://github.com/gabs77u/darks
openvpn proxy proxychains python tor vpn wireguard
Last synced: about 1 month ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/gabs77u/darks
- Owner: Gabs77u
- Created: 2025-06-15T02:23:11.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-16T14:58:02.000Z (12 months ago)
- Last Synced: 2025-06-16T15:46:46.690Z (12 months ago)
- Topics: openvpn, proxy, proxychains, python, tor, vpn, wireguard
- Language: Python
- Homepage:
- Size: 258 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Darks: Plataforma de Segurança, Anonimato e Gerenciamento de VPN/Proxy
---
## ✨ Visão Geral
Darks é 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.
## 🚀 Funcionalidades
- 🖥️ Interface gráfica (GUI) moderna
- 🔒 VPN WireGuard
- 🌐 Proxies (SOCKS5, HTTP, FTPS, SFTP)
- 🕵️ Tor e DNS seguro
- 📊 Painel visual de status
- 🛡️ Criptografia avançada
- 🔄 Exportação/importação segura
- 📝 Auditoria e logging
- 🔗 Integração com APIs externas
- ✅ Testes unitários, integração e E2E
## 📦 Estrutura do Projeto
- `gui/`: Interface gráfica
- `crypto/`: Criptografia
- `wireguard/`: VPN WireGuard
- `proxies/`: Proxies e proxychains
- `integrations/`: APIs externas
- `ProxyList/`: Listas de proxies
- `tests/`: Testes unitários, integração e E2E
- `docs/`: Documentação detalhada
## 🛠️ Instalação
```bash
# Clone o repositório
git clone
cd Darks
# Instale as dependências
pip install -r requirements.txt
# Instale o WireGuard (https://www.wireguard.com/install/)
# (Opcional) Instale o Tor (https://www.torproject.org/download/)
```
## 💻 Uso
```bash
python run_gui.py
```
Para rodar a API Django:
```bash
cd integrations
python api_server.py
```
## 🔐 Segurança e Produção
- [Proteção de segredos e .env](docs/segredos.md)
- [Permissões mínimas de arquivos](docs/permissoes_arquivos.md)
- [SCA: análise de dependências](docs/sca.md)
- [Troubleshooting de escalabilidade](docs/troubleshooting_escalabilidade.md)
- [Exemplo de configuração segura](.env.example)
## 🧪 Testes e Qualidade
- Estrutura de testes granularizada por módulo em `tests/`
- Testes unitários, integração e E2E (pytest, pytest-qt, pytest-playwright)
- Benchmarks de performance (pytest-benchmark)
- Testes de carga/stress (locust)
- Cobertura de código (pytest-cov, coverage)
- Segurança de dependências (safety, pip-audit)
### Executando todos os testes
```bash
pytest --cov=gui --cov=crypto --cov=wireguard --cov=proxies --cov=integrations --cov-report=term --cov-report=html
```
### Instalando dependências
```bash
pip install -r requirements.txt
```
### Ambiente de produção
- Instale WireGuard e Tor no sistema (externo ao Python)
- Configure variáveis de ambiente sensíveis
### Ambiente de desenvolvimento/testes
- Use `pytest`, `pytest-qt`, `pytest-playwright` para rodar todos os testes
- Use `pytest-cov` para cobertura
- Use `locust` para stress/carga
## 📁 Estrutura de Diretórios
```
gui/ # Interface gráfica
crypto/ # Criptografia
wireguard/ # VPN WireGuard
proxies/ # Proxies
integrations/# APIs externas
ProxyList/ # Listas de proxies
tests/ # Testes
```
## 🚚 Deploy
- Remova arquivos não necessários para produção: `.env.example`, `.pytest_cache/`, `.vscode/`, `tests/`, etc.
- Mantenha apenas código-fonte, configs essenciais, `requirements.txt`, `README.md`, `docs/`
- Use ambiente virtual dedicado e proteja arquivos sensíveis
## 🤝 Contribuição
- Siga PEP8/Black
- Escreva testes para novas funcionalidades
- Documente métodos e módulos críticos
- Use branches para features/correções
## ❓ FAQ e Suporte
- [FAQ](docs/faq.md)
- Para dúvidas, abra uma issue ou entre em contato
---
Documentação profissional, badges reais e pronta para produção.