Repository navigation
CHANGELOG
github-actions[bot] edited this page Nov 17, 2026
·
2 revisions
Languages: English
All notable, real and significant changes to VD Dropbear are recorded here.
The format follows Keep a Changelog; versions are tagged in the
module (module.prop) and on GitHub Releases.
-
Choose which networks the flashless updater may download on. A new
net_policysetting (and a selector in the WebUI Updates tab) decides when the updater is allowed to fetch:any(Wi-Fi or mobile, the default and the previous behaviour),wifi(only on Wi-Fi), ormobile(only on mobile data). It classifies the active route with a kernel routing-table lookup, so it costs no packet and wakes no radio, and it gates only the download (and the boot retry probe); checking for a new version still works on any network, and a fetch on a disallowed network is simply deferred and resumed later.
-
net_policyreplacesallow_metered. The oldallow_meteredflag was never actually consulted by the updater;net_policyis the real, three-way control that supersedes it.
-
The boot update retry is now patient and battery-friendly. When the device boots offline, the flashless
updater waits for the network without holding anything: no lock (a manual check or update stays unblocked)
and no wakelock, so it costs essentially no battery while it waits. It only spends a fetch once a cheap
routing-table probe shows the network is actually up (no blind radio wake-ups), and a connect timeout keeps
it from hanging on a captive portal. Because nothing is pinned, the cap is now generous:
boot_retry_minutesdefaults to 1440 (24 hours of awake-time, so it simply catches you the next time you connect;0still turns it off).boot_retry_intervalstays 30s.
-
Public-key login now works in the default (AFU) mode. Dropbear checks the ownership and permissions of
every parent directory of
authorized_keysand rejects any that is group-writable or not owned by root; Android's/datatree is system-owned and group-writable (0771), so a keys file stored there (where the module keeps its secrets, on credential- or device-encrypted storage) was rejected and every key was refused withPermission denied (publickey), while password login still worked. The daemon now reaches the keys through a root-owned,0700shim on/dev(tmpfs), so the directory chain Dropbear walks is clean while the real key file's own ownership and permissions are still enforced. Reported in #1; thanks for the precise diagnosis and the minimal reproducer.
-
Boot update retry-until-online. If the device boots offline, the flashless updater keeps retrying the
update check instead of giving up until the next boot. It only retries a genuine network failure (never a
bad manifest, signature or downgrade), sleeps between tries so it never busies the CPU, and runs in the
background so boot is never delayed. Two new options on the Updates tab set the pace: Boot retry every
(seconds between tries, default 30) and Boot retry up to (minutes, default 15;
0turns it off).
- The WebUI is organised into tabs. Status, Settings, Keys, Passwords and Updates each live on their own tab instead of one long scroll, so the page is easier to read on a phone. The root-shell warning stays pinned above the tabs.
- The Updates panel no longer gets stuck on "preparing updater". A finished update run that left no terminal journal entry kept the progress toast spinning; the updater widget now detects a stalled run and clears it or offers to resume.
- A check no longer reports "check failed" when the device is newer than the feed. Being ahead of the published update is a benign state; the updater now shows "newer than the feed" instead of an error (more visible now that the open-the-WebUI check is on by default).
-
Checking for updates when the WebUI opens is now on by default. New installs enable
auto_on_webui_open, so the module looks for a flashless update each time you open its WebUI; existing installs keep whatever they had. Turn it off in the config if you prefer manual checks.
-
Flashless incremental updates (VD Live Update). Between releases the module can update itself by
fetching only the files that changed, each verified against a signed manifest, without reflashing the
full zip. The signature check uses a tiny vendored
ed25519-miniverifier (TweetNaCl); blobs are decompressed with the device's toyboxgzip; the one network tool, a staticcurl, is fetched on demand from a signed tools-feed rather than shipped. The flashable zip stays the install and fallback path, so the updater is always optional.
- The README set is paired across all 22 languages. The Documentation section now links the wiki (translations point at their language-prefixed pages) instead of the in-repo markdown, with a top navigation bar and a bold language switcher, matching the layout of the other modules.
- The bundled components' license texts now ship inside the flashable module (
module/licenses/), along with the module'sLICENSE,NOTICEandTHIRD-PARTY-NOTICES.md, so the GPL-3.0rsyncbinary travels with its license as the GPL requires.
-
SFTP no longer crashes the session (the bundled
sftp-serverSIGSEGV'd at startup). On Android, bionic'sgetpwuid()returns aNULLpw_gecos, and OpenSSH'spwcopy()guardspw_passwdbut notpw_gecos, sosftp-serverhitxstrdup(NULL)the moment a session opened. (scpover the legacy protocol was unaffected: its path never callspwcopy.) The bundle build now patchespwcopy()to null-coalescepw_gecos. -
The public-key login toggle now takes effect. With
PUBKEY_AUTHoff, noauthorized_keysfile is exported, so no key authenticates; before, the toggle did nothing. -
Config values are validated before they reach the daemon.
HOSTKEY_TYPEandRECEIVE_WINDOWare checked (type against the allowed set, window numeric), so a value with a space can no longer split into extra daemon flags. - The manager Action and the daemon log now print a real listen summary, and
add-keykeeps only the first line of a pasted key.
-
Login privilege is a choice. A session runs as the account you authenticate as: root by default,
or a lower-privilege Android account (
shell,system). The README set (22 languages), the docs, the WebUI and the release notes now say so, instead of claiming that every login is root. -
WebUI: simpler, safer credential forms. The PBKDF2 iteration count is no longer a user field. It
is fixed at a safe 600000 (OWASP 2023 floor for PBKDF2-HMAC-SHA256), computed in the page as before;
older hashes keep verifying because the server reads the iteration count stored in each hash. The
password-account User is now a dropdown of the accounts Android resolves (
root,shell,system, defaultroot) instead of free text.
-
LOGIN_USERsetting. It never reached the daemon (the session account follows the SSH login name the client presents, resolved viagetpwnam), so it was a no-op knob. Removed from the config, the WebUI and the docs; the account is set by the password/key entry and the username on connection.
-
SFTP, sftp-based scp and rsync now work over the connection. The server pointed its SFTP
subsystem at
/usr/libexec/sftp-server(which does not exist on Android), and the bundled tools were not on the sessionPATH, soscp/sftpfailed. The build now compilesSFTPSERVER_PATHand the module's ownbindir into bothDEFAULT_PATHandDEFAULT_ROOT_PATH(every login here is root, so the root path is the one that applies), and the launcher symlinks the ABI'ssftp-server/scp/rsyncthere at start.
First public release.
- Initial module scaffold: a config-driven, single-daemon launcher, independent of any other module.
- Core library (
common/vddropbear.sh): configuration load with safe built-in defaults; secret-store resolution (credential-encrypted/data/misc_ceby default, device-encrypted/data/adbonly in the opt-in BFU mode); single-instance daemon lifecycle (start / stop / status / restart); and a Dropbear argument vector built entirely from the configuration. -
service.sh: boot entry that honours the BFU/AFU start policy and, in AFU mode, waits for the user's credential-encrypted storage to unlock without stalling boot. -
action.sh: manager "Action" (re)launch that never blocks on stdin and spawns the daemon in its own session so the manager returns. - Installer (
customize.sh+META-INF),uninstall.sh, and a fully documented default config. - Public-repository scaffolding: family-format
README, Apache-2.0LICENSE, this changelog,SECURITY.md,CONTRIBUTING.md, and an SPDX header on every file. -
Four-ABI support:
arm64-v8a,armeabi-v7a,x86,x86_64, covering every device and emulator. - Build pipeline:
scripts/build.shandscripts/build-bundles.shcross-compile dynamic binaries (linked against bionic) for all ABIs; a CI workflow rebuilds, packages the module zip, names the artifact with the version, publishes a GitHub Release on av*tag (with a per-file sha256 list), and tracks upstream. The auditable patch set is documented inpatches/. - Composable listen/bind model: loopback, all interfaces, IPv4/IPv6 family filters and specific addresses (each with an optional per-bind port) can be mixed freely; a safety net binds loopback rather than every interface if the user clears all options.
-
Bundled file-transfer tools:
sftp-server,scpandrsync, so SFTP, sshfs, GUI clients and backups work over the same connection. -
THIRD-PARTY-NOTICES.mddocumenting every bundled component's license and the GPL-3.0 compliance for rsync (mere aggregation: the Apache-2.0 module is unaffected). -
Auditable patch set against upstream Dropbear:
-
0001: neutral, configurable SSH identity (DROPBEAR_IDENT), so scanners cannot fingerprint the exact server or version. -
0002: readauthorized_keysfromDROPBEAR_AUTHKEYS, decoupling keys from Android's account model and letting them live on CE or DE storage. -
0003: password auth against a hash file (DROPBEAR_PASSWD_FILE) using PBKDF2-HMAC-SHA256 (Dropbear's own libtomcrypt), replacing the systemcrypt()/shadow that bionic lacks, a public, documented format with no obfuscation.
-
-
WebUI (
module/webroot/index.html+common/vddb-webui.shbackend): live status and daemon start / stop / restart, the BFU/AFU start toggle, every setting, authorized-key management, and password accounts whose PBKDF2 hashes are computed in the page with WebCrypto; the clear-text password never leaves the browser. Data crosses theksu.execbridge base64-encoded. - AI-agents use case documented: a standing SSH root endpoint lets an autonomous agent operate the device over the network, with none of ADB's tether or self-exposing debug flags.
- Project logos (
webroot/assets/logo-{icon,wordmark}.svg). -
Documentation: a
docs/set (User guide, Configuration, Architecture, File structure, AI agents, Building), a Code of Conduct and GitHub issue/PR templates; the README and docs are translated into 21 languages, and the project wiki is kept in sync fromdocs/automatically.
- Password login is disabled at runtime by default; keys are the default. When enabled, only a salted, high-iteration PBKDF2 hash is stored, never the password.
- Secrets default to credential-encrypted storage; the device-encrypted fallback is opt-in (BFU) and documented as an exposure trade-off.
- Runs on KernelSU, APatch and Magisk.
- Binaries are dynamic (linked against bionic); static-PIE binaries SIGSEGV on-device. Interactive
PTYs need no patch (
openptyis auto-detected), and the-Eflag is dropped (the server is built--disable-syslog). Validated end-to-end on a real arm64 device: password login succeeds and a wrong password is rejected.
This documentation was generated with Claude (Anthropic) and is maintained by VD171. Corrections and improvements are welcome; see CONTRIBUTING.md.