Repository navigation
ar 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.shيستنسخ scripts/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.
الملفات الثنائية لا تُودع (commit)؛ يبنيها الـ 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. - بناء ساكن غير 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) ليس اختبار دخان صالحًا هنا (فهو أيضًا يُحدِث segfault على هذه
الملفات)، ولا الترجمة+الربط الناجحان. شغّل الملف الثنائي على جهاز Android arm64 حقيقي. (جرى التحقق من هذا بهذه الطريقة بالضبط: أُطلق الـ daemon على منفذ بديل على جهاز
حيّ وتأكّد نجاح تسجيل الدخول بكلمة المرور، مع رفض كلمة مرور خاطئة.)
يُبنى الخادم بـ --disable-syslog، فيسجّل دائمًا إلى stderr، وخيار upstream المسمّى -E («log to stderr»)
غير موجود في هذا الملف الثنائي؛ وتمريره يطبع Invalid option -E ولا يبدأ الـ daemon أبدًا. لذا فإن
بانيَ وسائط الوحدة لا يمرّر -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 بشكل
خاطئ عند الترجمة التقاطعية. يُرمِّز السكربت الإصلاح؛ وللتوثيق، القطع هي:
-
بذرة ذاكرة مؤقتة لدوال تفتقر إليها 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.hالخاص بـ OpenSSH#define __sentinel__(فارغ)، مما يُفسد بعدها__attribute__((__sentinel__(1)))الخاص بـ bionic في<unistd.h>وتفشل كل ترجمة بـexpected ')'. -
بديل
explicit_bzeroيستخدمmemset. إنbzeroفي bionic ماكرو شبيه بدالة (لا رمز حقيقي)، لذا فإن بديل OpenSSH الافتراضي، الذي يأخذ&bzeroكمؤشّر دالة، لا يُترجَم. ولا تملك bionicexplicit_bzeroخاصًا بها. -
إسقاط
xcrypt.oوgetrrsetbyname.oمن مكتبة compat. يستدعيxcrypt.cدالتَيgetpwent()/crypt()دون شرط (bionic لا تملك أيًّا منهما)، ويستخدمgetrrsetbyname.cبنى داخلية في الـ resolver لا تكشفها bionic. ولا يستخدم أيًّا منهماsftp-serverولاscp. -
-Wl,--allow-multiple-definition. إنreallocarrayهو الصورة المرآتية للدوال في (1): لا تُصرّح bionic عنه في API 24، فيُترجِم OpenSSH بديله الخاص، لكن الرمز موجود فعلًا فيlibc.a، فيتصادمان عند الربط. والسماح بالتكرار يأخذ نسخة bionic، وهذا جيّد. -
حماية
pw_gecosمن NULL فيpwcopy(). تُرجِعgetpwuid()في bionic قيمةpw_gecosتساويNULL(لا يحتفظ 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.