Repository navigation
pt ARCHITECTURE
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
O VD Dropbear é um módulo KernelSU / APatch / Magisk que executa exatamente um daemon SSH Dropbear, controlado inteiramente por configuração. Nada no servidor SSH está fixado no código para um único dispositivo; tudo o que é específico é configuração de execução ou um segredo.
-
module/common/vddropbear.sh: a biblioteca central: carregar a configuração (com padrões internos seguros), resolver o cofre de segredos, garantir uma chave de host, montar o vetor de argumentos do Dropbear e gerenciar uma única instância do daemon (start / stop / status / restart). -
module/service.sh: entrada de boot. Respeita a política de início BFU/AFU; no modo AFU, aguarda o armazenamento criptografado por credencial desbloquear sem travar o boot. -
module/action.sh: o botão Action do gerenciador: (re)iniciar o daemon. Ele nunca lê o stdin e desacopla o daemon em sua própria sessão, para que o gerenciador não trave. -
module/common/vddb-webui.sh+module/webroot/index.html: o backend e a página da WebUI. -
patches/: patches pequenos e auditáveis aplicados ao Dropbear upstream no momento da compilação. -
scripts/build.sh,scripts/build-bundles.sh,.github/workflows/build.yml: a compilação.
vddb_start carrega a configuração, para qualquer instância em execução, garante que exista uma chave
de host e então inicia um daemon. O binário é distribuído como vddropbear, de modo que seu nome de
processo corresponde exatamente a pgrep -x (o mksh do Android não tem exec -a). Ele é iniciado
com setsid para se desacoplar do grupo de processos do chamador: é isso que impede que o botão
Action do gerenciador bloqueie.
As configurações não são segredo e ficam no armazenamento criptografado por dispositivo
(/data/adb/vddropbear), legível no boot. Os segredos (chave de host, authorized_keys, hashes de
senha) por padrão vão para o armazenamento criptografado por credencial
(/data/misc_ce/0/vddropbear), que só desbloqueia depois que o usuário se autentica. Ativar
START_IN_BFU move os segredos para o armazenamento criptografado por dispositivo, para que o daemon
possa rodar antes do primeiro desbloqueio, ao custo de esses segredos ficarem legíveis mais cedo. O
módulo calcula qual cofre usar em cada etapa do boot.
O servidor SSH continua sendo o Dropbear upstream; nossas mudanças são alguns patches revisáveis (veja patches/README.md):
- um banner de identidade neutro e configurável em tempo de execução;
-
authorized_keyslido de um caminho definido por ambiente (para que as chaves fiquem no cofre de segredos); - autenticação por senha contra um arquivo de hash PBKDF2 em vez do
crypt()/shadow do sistema, que o Android não possui (veja BUILDING.md).
Uma página estática na WebUI do gerenciador (KernelSU / APatch / WebUI-X). Ela controla
module/common/vddb-webui.sh por meio da ponte ksu.exec: status, start/stop/restart, leitura/escrita
de configuração e gerenciamento de chaves e contas de senha. Todos os dados cruzam a ponte codificados
em base64, de modo que o shell nunca os interpreta; os hashes de senha são calculados no navegador com
WebCrypto, de modo que a senha em texto claro nunca sai da página.
Esta documentação foi gerada com o Claude (Anthropic) e é mantida por VD171. Correções e melhorias são bem-vindas; veja CONTRIBUTING.md.