Skip to content

pt CONTRIBUTING

github-actions[bot] edited this page Nov 17, 2026 · 5 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


Contribuindo com o VD Dropbear

Obrigado pelo seu interesse. Este é um projeto pequeno e sensível à segurança (ele distribui root), então as mudanças são revisadas com isso em mente.

Organização do repositório

module/     the installable KernelSU / APatch / Magisk module (scripts, WebUI, config, installer)
patches/    the patch set applied on top of upstream Dropbear (the only changes to the SSH server)
src/        where CI unpacks upstream Dropbear to build (not committed)
scripts/    build and maintenance helpers
.github/    CI workflows and issue/PR templates
docs/       documentation (mirrored to the wiki)

Compilação

O binário é produzido pelo CI a partir do upstream mkj/dropbear mais os patches em patches/. Para compilar localmente você precisa do Android NDK:

scripts/build.sh            # fetches the tracked upstream, applies patches, builds arm64 + arm32

O conjunto de patches é intencionalmente mínimo e auditável: uma string de identidade neutra/configurável, caminhos definidos por configuração para o authorized_keys e o arquivo de senha, a correção do openpty do Android e a configuração em tempo de execução. Por favor, mantenha os novos patches pequenos, documentados e justificados no PR.

Pull requests

  • Uma mudança lógica por PR; descreva a motivação e o impacto na segurança.
  • Siga o estilo de shell existente (POSIX sh / Android mksh; sem bashisms).
  • Todo arquivo carrega um cabeçalho SPDX curto. Mantenha-o.
  • Atualize o CHANGELOG.md sob [Unreleased] para qualquer mudança real e visível ao usuário.
  • Ao enviar um PR você concorda em licenciar sua contribuição sob a licença Apache-2.0 do projeto.

Traduções

O README e a documentação são mantidos em vários idiomas (README.<lang>.md). O inglês é a fonte da verdade; as traduções o seguem. Se você melhorar uma tradução ou adicionar um idioma, mantenha a estrutura e as âncoras de seção idênticas às da versão em inglês.

Relatando bugs e problemas de segurança

Use os templates de issue para bugs e pedidos de recurso. Para qualquer coisa que possa comprometer um dispositivo, siga o SECURITY.md e relate em privado em vez de abrir uma issue pública.


Esta documentação foi gerada com o Claude (Anthropic) e é mantida por VD171. Correções e melhorias são bem-vindas; veja CONTRIBUTING.md.

Clone this wiki locally