Repository navigation
ru BUILDING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
VD Dropbear поставляет Dropbear upstream (тег, закреплённый в
UPSTREAM_VERSION) плюс небольшой проверяемый набор патчей в
patches/. CI собирает его; вы можете воспроизвести это локально.
# один раз: Android NDK (r27 или новее)
export NDK=/path/to/android-ndk
# собрать каждый ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# или только один, чтобы итерировать быстро
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh клонирует закреплённый upstream-тег, применяет patches/*.patch и localoptions.h, а
затем кросс-компилирует vddropbear и dropbearkey в module/bin/<abi>/. Результат это
динамический ELF (file сообщает dynamically linked, interpreter /system/bin/linker64 … for Android 24), слинкованный с libc bionic, которая уже есть на каждом устройстве Android. libtomcrypt остаётся
встроенным в бинарник; динамической является только библиотека C. См. Динамический, не static-PIE.
Бинарники не коммитятся; их собирает CI при каждом теге и прикрепляет к релизу. См.
.gitignore.
Аутентификация по паролю в Dropbear написана для обычного Unix-хоста с crypt() и /etc/shadow. В
Android нет ни того, ни другого, и это сталкивается со сборкой в трёх отдельных местах. Этот раздел
документирует каждое из них, потому что это именно тот тип вещей, который больно открывать заново. Всё
это обрабатывает патч 0003-password-file.patch; ничто ниже не
оставлено на волю случая во время выполнения.
Библиотека C в Android (bionic) не предоставляет ни crypt(), ни crypt_r(), ни базу shadow. NDK не
предоставляет никакого <crypt.h>. Поэтому стандартный путь пароля в Dropbear, который вызывает
crypt(password, salt) и сравнивает с /etc/shadow, просто невозможно собрать или запустить на Android.
Нет также никакой libcrypt для линковки, а тянуть libcrypto из OpenSSL только ради хеша пароля было
бы крупной, неуклюжей зависимостью для статического бинарника.
Наш ответ: вообще не использовать crypt(). Аутентификация по паролю проверяет предъявленный пароль
с помощью PBKDF2-HMAC-SHA256 против файла хешей (DROPBEAR_PASSWD_FILE), публичной, стандартной, с
солью, итеративной KDF. Формат файла задокументирован в patches/README.md.
Ещё до того, как выполнится какой-либо код, Dropbear отказывается собираться:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifПри неопределённом HAVE_CRYPT (всегда, на bionic) и включённой аутентификации по паролю это жёсткий
#error. Поскольку наш верификатор никогда не вызывает crypt(), патч 0003 удаляет эту защиту.
(Он оставляет нетронутой проверку «должен быть включён хотя бы один метод аутентификации».)
Dropbear встраивает урезанный libtomcrypt, который действительно содержит PBKDF2 (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). Очевидное решение это вызвать его. Оно не работает, по двум усиливающим
друг друга причинам:
-
Прототип скрыт.
pkcs_5_alg2объявлен только внутри#ifdef LTC_PKCS_5вtomcrypt_pkcs.h. Собственные исходные файлы Dropbear не компилируются с определённымLTC_PKCS_5, поэтому объявление невидимо, и компилятор падает с implicit function declaration. -
Символа не существует. Хуже того, само тело
pkcs_5_alg2тоже находится за#ifdef LTC_PKCS_5. Сборка libtomcrypt в Dropbear его не определяет, поэтомуpkcs_5_2.oкомпилируется в пустой объект: он есть вlibtomcrypt.a, но не содержит символаpkcs_5_alg2. Линковка падает сundefined symbol: pkcs_5_alg2.
Вы можете убедиться в этом сами:
# объект существует, но пуст (нет T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> только маркер данных, нет pkcs_5_alg2
# HMAC, напротив, скомпилирован полностью (Dropbear использует его для MAC в SSH):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> определяет hmac_memoryНаш ответ: собрать PBKDF2 самим поверх примитивов, которые Dropbear действительно компилирует.
hmac_memory и зарегистрированный хеш sha256 оба присутствуют и линкуются, поэтому патч 0003
реализует PBKDF2-HMAC-SHA256 напрямую (RFC 2898; один 32-байтовый выходной блок, поскольку dkLen == hLen для SHA-256). Мы объявляем hmac_memory сами (та же проблема скрытого прототипа, что и выше), и
объект вытягивается из libtomcrypt.a при линковке. Результат это стандартный PBKDF2, а значит
совместимый: хеш, который WebUI вычисляет с помощью WebCrypto deriveBits браузера, побайтово
идентичен тому, что вычисляет сервер, проверено против hashlib.pbkdf2_hmac из Python как третьей,
независимой реализации.
Коротко: Android не даёт вам никакого
crypt(), а встроенный PBKDF2 Dropbear компилируется в ничто. Аутентификация по паролю здесь это PBKDF2-HMAC-SHA256 с нуля поверх HMAC из libtomcrypt, с удалённой защитой сборки crypt(). Без OpenSSL/libcrypto, без обфускации, без системного shadow.
Бинарники динамические (слинкованы с системным bionic через /system/bin/linker64), не статические.
Это важно, и это было усвоено трудным путём, на реальном устройстве, а не в CI:
- Сборка static-PIE выглядит нормально (
fileсообщает чистыйstatic-pie executable) и линкуется без ошибок, но выдаёт SIGSEGV в тот же миг, как запускается на устройстве (проверено на телефоне arm64 с Android 16, exit 139, без полезного tombstone). Статические исполняемые файлы на Android хрупки; надёжная форма это обычный динамический бинарник, и именно так поставляется каждый устоявшийся dropbear для Android. - Сборка статическая, non-PIE даже не запускается: bionic отклоняет её с
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Поэтому сборка динамическая (
makeбезSTATIC=1;-pie), линкующая только libc bionic, присутствующую на каждом устройстве. libtomcrypt по-прежнему статически встроен в бинарник, так что нет никакой дополнительной библиотеки для поставки.
Урок для тестирования: qemu-aarch64 (qemu-user) здесь не является корректным smoke-тестом (он тоже
падает с segfault на этих бинарниках), как и успешная компиляция+линковка. Запускайте бинарник на
реальном устройстве arm64 Android. (Это было проверено именно так: демон был запущен на альтернативном порту на живом устройстве, и вход по паролю
был подтверждён как успешный, а неверный пароль отклонён.)
Сервер собран с --disable-syslog, поэтому он всегда логирует в stderr, и upstream-опция -E ("log to
stderr") отсутствует в этом бинарнике; её передача печатает Invalid option -E, и демон никогда не
запускается. Поэтому построитель аргументов модуля не передаёт -E.
Интерактивные сессии PTY используют openpty(). bionic объявляет его в <pty.h>, а кросс-configure
Dropbear обнаруживает его с помощью NDK (HAVE_OPENPTY устанавливается, HAVE_PTY_H 1), поэтому
никакой патч не нужен; PTY работают сразу. (Неинтерактивное использование вроде exec, SFTP, rsync и
проброса портов от него всё равно не зависит.)
scripts/build-bundles.sh кросс-компилирует инструменты передачи файлов как динамические бинарники в
module/bin/<abi>/. CI запускает его сразу после build.sh.
-
rsync (со встроенными popt + zlib) компилируется чисто, как только вы сообщаете его configure, что
в bionic нет
lutimes(ac_cv_func_lutimes=no). -
sftp-server и scp берутся из OpenSSH portable, собранных с
--without-openssl(встроенной криптографии OpenSSH достаточно для этих двух), с небольшим статическим zlib, который этот скрипт собирает первым.
OpenSSH на Android так же капризен, как история crypt() выше, потому что его configure неправильно
определяет несколько функций libc при кросс-компиляции. Скрипт кодирует исправление; для протокола,
части таковы:
-
Seed кеша функций, которых нет в bionic, но которые configure считает имеющимися, чтобы вместо
них компилировались compat-версии:
recallocarray,close_range,getentropy,getrandom,nl_langinfo,setpwent/getpwent/endpwent,crypt,futimes,lutimes,strtonum,pledge,explicit_bzero. -
-DHAVE_ATTRIBUTE__SENTINEL__=1 -DHAVE_ATTRIBUTE__NONNULL__=1. Без нихdefines.hOpenSSH делает#define __sentinel__(пусто), что затем портит собственный__attribute__((__sentinel__(1)))bionic в<unistd.h>, и каждая компиляция падает сexpected ')'. -
compat
explicit_bzero, использующийmemset.bzeroв bionic это функциеподобный макрос (не настоящий символ), поэтому стандартный compat OpenSSH, берущий&bzeroкак указатель на функцию, не компилируется. В bionic нет собственногоexplicit_bzero. -
Отбрасывание
xcrypt.oиgetrrsetbyname.oиз библиотеки compat.xcrypt.cбезусловно вызываетgetpwent()/crypt()(в bionic нет ни того, ни другого), аgetrrsetbyname.cиспользует внутренние части резолвера, которые bionic не предоставляет. Ни то, ни другое не используетсяsftp-serverилиscp. -
-Wl,--allow-multiple-definition.reallocarrayэто зеркальное отражение функций из (1): bionic не объявляет её в API 24, поэтому OpenSSH компилирует собственный compat, но символ всё же есть вlibc.a, так что при линковке они сталкиваются. Разрешение дубликата берёт вариант из bionic, что нормально. -
Защита
pw_gecosот NULL вpwcopy().getpwuid()из bionic возвращаетNULL-овыйpw_gecos(Android не хранит поле GECOS).pwcopy()из OpenSSH защищаетpw_passwdотNULL, но неpw_gecos, поэтомуsftp-serverдоходит доxstrdup(NULL)и выдаёт SIGSEGV при старте, в тот миг, когда открывается сессия. (scpпо устаревшему протоколу никогда не вызываетpwcopy, поэтому он работал, пока SFTP нет.) Сборка патчитpwcopy(), чтобы свестиpw_gecosк"".
Закреплённые версии находятся вверху scripts/build-bundles.sh (ZLIB_VERSION, RSYNC_VERSION,
OPENSSH_VERSION).
git clone --depth 1 --branch "$(cat UPSTREAM_VERSION)" https://github.com/mkj/dropbear /tmp/db
cp patches/localoptions.h /tmp/db/localoptions.h
for p in patches/*.patch; do patch -p1 -d /tmp/db < "$p"; done
cd /tmp/db
TC="$NDK/toolchains/llvm/prebuilt/linux-x86_64/bin"
./configure --host=aarch64-linux-android --disable-zlib --disable-syslog \
CC="$TC/aarch64-linux-android24-clang"
make PROGRAMS="dropbear dropbearkey" -j"$(nproc)"
file ./dropbear # -> dynamically linked, interpreter /system/bin/linker64, for Android 24Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.