IronFox

IronFox هو فرع من Mull Browser الخاص بمجموعة Divested Computing Group، المبني على Mozilla Firefox. هدفنا هو مواصلة إرث Mull من خلال توفير متصفح ويب مجاني ومفتوح المصدر، موجّه نحو الخصوصية والأمان للاستخدام اليومي.

[!TIP] وجدت خطأً؟ واجهت مشكلة مزعجة؟ لديك نصيحة أو فكرة أو اقتراح تود مشاركته؟ يرجى تقديم أي مشكلات أو تقارير أخطاء أو اقتراحات على متتبع المشكلات الموحد لدينا!

[!IMPORTANT] ⚠️ يُنصح بشدة أن يطّلع جميع المستخدمين على وثائقنا، وخاصةً صفحتي القيود والأسئلة الشائعة!

بينما المقر الرئيسي لـ IronFox هو GitLab، فإن هذا المستودع مُعكَس أيضًا على كل من Codeberg وGitHub.

هل تريد الانضمام إلى مجتمع IronFox؟

يسعدنا رؤيتك على Matrix (موصى به) وDiscord!

تثبيت التطبيق

للحصول على التفاصيل والتعليمات خطوة بخطوة حول كيفية تثبيت IronFox، راجع صفحة التنزيل الخاصة بنا.

التحقق من التطبيق

معرّف الحزمة: org.ironfoxoss.ironfox

معرّف الحزمة (الليلي): org.ironfoxoss.ironfox.nightly

تجزئة SHA-256 لشهادة التوقيع:

C5:E2:91:B5:A5:71:F9:C8:CD:9A:97:99:C2:C9:4E:02:EC:97:03:94:88:93:F2:CA:75:6D:67:B9:42:04:F9:04

البناء

يجعل IronFox بناء المشروع محليًا أسهل (وأسرع). على سبيل المثال، تُستخدم إصدارات مُجمّعة مسبقًا من wasi-sdk sysroot وllvm-project بدلاً من بنائها محليًا. لا تزال إصدارات F-Droid تبني تلك من المصدر.

يُوصى باستخدام صورة Docker لبناء IronFox.

البناء باستخدام Docker

اسحب صورة Docker باستخدام:

docker pull registry.gitlab.com/ironfox-oss/ironfox:latest

يمكنك أيضًا استخدام وسم main لسحب الصورة التي استُخدمت لبناء أحدث إصدار من IronFox. أو يمكنك استخدام أسماء إصدارات دقيقة لسحب الصور لتلك الإصدارات.

على سبيل المثال:

docker pull registry.gitlab.com/ironfox-oss/ironfox:v135-0

بعد ذلك، تحتاج إلى إعداد ملفات المصدر.

البناء بدون Docker

ملاحظة: حاليًا، يتم دعم البناء على أحدث إصدارات أنظمة Fedora و**macOS** و**secureblue** و**Ubuntu**. قد تختلف النتائج على أنظمة/بيئات تشغيل أخرى.

ملاحظة: يجب على مستخدمي macOS تثبيت Homebrew (إذا لم يكن مثبتًا بالفعل) قبل اتباع الخطوات أدناه.

أولاً، إذا لم تكن قد قمت بتثبيته بالفعل، فستحتاج إلى تثبيت git لمنصتك المفضلة:

Fedora:

sudo dnf install git

macOS:

brew install git

secureblue:

git مثبت بالفعل على secureblue افتراضيًا، لذا لا يوجد شيء لفعله هنا.

Ubuntu:

sudo apt install git

بعد تثبيت git بنجاح، أول شيء ستحتاج إلى فعله هو استنساخ مستودع مصدر IronFox:

(تم تحديد --depth=1 أدناه لتقليل حجم المستودع المستنسخ، ويمكن إزالته إذا كان مفضلاً)

git clone --depth=1 [email protected]:ironfox-oss/IronFox.git IronFox

يجب عليك الآن الانتقال إلى جذر دليل مصدر IronFox، وتشغيل سكربت bootstrap:

(سيعمل سكربت bootstrap على إعداد وتثبيت التبعيات المطلوبة لبناء IronFox على نظامك)

cd IronFox
./scripts/bootstrap.sh

الحصول على المصادر

من جذر دليل مصدر IronFox، يجب عليك الآن تشغيل سكربت get_sources لتنزيل المصادر الخارجية المطلوبة لبناء IronFox:

ملاحظة: إذا كنت بحاجة إلى جلب مصادر لإصدار مختلف من تبعية عن الإصدار الذي يستخدمه IronFox حاليًا، فستحتاج إلى تعديل scripts/versions.sh قبل تشغيل سكربت get_sources.

قد يستغرق هذا بعض الوقت اعتمادًا على سرعة شبكتك...

./scripts/get_sources.sh

تحضير المصادر

تحتاج الآن إلى تصحيح/تحضير المصادر التي نزّلتها حديثًا باستخدام سكربت prebuild:

يجب تشغيل هذا مرة واحدة بعد الحصول على مصادرك.

./scripts/prebuild.sh

البناء

أخيرًا، يمكنك بدء عملية البناء باستخدام:

./scripts/build.sh <build-variant>

حيث يحدد <build-variant> النوع المراد بناؤه، وهو واحد مما يلي:

• arm - ARM 32-بت (armeabi-v7a)
• arm64 - ARM 64-بت (arm64-v8a)
• x86_64 - x86 64-بت
• bundle - حزمة تطبيق Android (AAB) مع جميع ABIs المدعومة

بالإضافة إلى AAB، ينتج هدف bundle أيضًا ملفات APK لكل بنية معمارية (arm وarm64 وx86_64)، بالإضافة إلى APK شامل يحتوي على جميع البنى.

الفحص (Linting)

يعتمد IronFox بشكل كبير على سكربتات shell، والتي يتم فحصها باستخدام shellcheck (التحليل الثابت) وshfmt (التنسيق). تعمل هذه تلقائيًا في CI (وظيفة lint-scripts) ويتم فرضها هناك — فشل الفحص يوقف خط الأنابيب قبل بدء أي بناء.

يقوم ./scripts/get_sources.sh بتثبيت كلتا الأداتين وتمكين خطاف git قبل الالتزام (عبر core.hooksPath) الذي يفحص سكربتاتك المرحّلة قبل كل التزام. الخطاف هو وسيلة راحة ويمكن تجاوزه باستخدام git commit --no-verify؛ يبقى CI هو مصدر الحقيقة.

إذا كنت توفر نسخك الخاصة من shellcheck وshfmt (بدلاً من الحصول عليها من ./scripts/get_sources.sh)، بعد تعيين IRONFOX_SHELLCHECK_DIR وIRONFOX_SHFMT_DIR إلى الدلائل المناسبة، يمكنك إعداد خطاف ما قبل الالتزام مباشرة عن طريق تشغيل:

./scripts/lint-hook.sh

لتشغيل فحوصات الفحص يدويًا:

./scripts/lint.sh

لإصلاح التنسيق تلقائيًا:

git ls-files 'scripts/*.sh' | xargs shfmt -w

يوجد تكوين الفاحص في .shellcheckrc (الفحوصات) و.editorconfig (التنسيق).

الترجمة

يتم ترجمة IronFox باستخدام Weblate. قم بزيارة مشروع Weblate للمساعدة في الترجمات.

الترخيص

السكربتات مرخصة بموجب رخصة GNU Affero العامة، الإصدار 3 أو الأحدث.

التغييرات على التصحيحات مرخصة وفقًا للترويسة الموجودة في الملفات التي يضيفها أو يعدلها هذا التصحيح (Apache 2.0 أو MPL 2.0).

Phoenix مرخص بموجب رخصة GNU العامة الإصدار 3.0 أو الأحدث (GPL-3.0-or-later) حيثما ينطبق ذلك. انظر COPYING.

a-c-liberate.patch وa-s-localize-maven.patch وfenix-liberate.patch مقتبسة من Fennec F-Droid. انظر COPYING.

gecko-configure-ublock-origin.patch وgecko-devtools-bypass.patch وgecko-fix-rfphelper-import.patch وgecko-prevent-exposing-name-and-vendor-to-extensions.patch وgecko-rs-blocker.patch مقتبسة من LibreWolf. انظر تراخيص وإخلاء مسؤولية LibreWolf.

fenix-disable-network-connectivity-monitoring.patch وgecko-disable-network-id.patch وgecko-prevent-fingerprinting-via-chrome-resources.patch وgeckoview-ironfox-settings-support-spoof-english.patch وglean-noop.patch مقتبسة من مشروع Tor. انظر LICENSE.

مجموعتنا الحالية من الخلفيات الافتراضية مأخوذة من Fennec F-Droid، وهي متاحة بموجب رخصة Unsplash.

إشعارات

Mozilla Firefox هي علامة تجارية لمؤسسة Mozilla Foundation.

هذا ليس منتج Mozilla مدعومًا رسميًا. IronFox ليس مرتبطًا بـ Mozilla بأي شكل من الأشكال.

IronFox غير مدعوم أو معتمد من قبل Mozilla.

IronFox غير مرتبط بـ DivestOS أو Divested Computing Group أو Mull بأي شكل من الأشكال.

كود مصدر Firefox متاح على https://github.com/mozilla-firefox/firefox.