IronFox

IronFox هو تفرّع من متصفح Mull التابع لمجموعة 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**. قد تختلف النتائج (YMMV) بالنسبة للأنظمة/البيئات الأخرى.

ملاحظة: يجب على مستخدمي 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 - حزمة تطبيق أندرويد (AAB) مع جميع معماريات ABI المدعومة

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

فحص الكود (Linting)

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

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

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

./scripts/lint-hook.sh

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

./scripts/lint.sh

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

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

توجد إعدادات أداة lint في .shellcheckrc (الفحوصات) و.editorconfig (التنسيق).

الترجمة

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

الترخيص

السكربتات مرخّصة بموجب رخصة جنو أفيرو العمومية العامة، الإصدار 3 أو الأحدث.

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

Phoenix مرخّص بموجب رخصة جنو العمومية العامة الإصدار 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-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 من مشروع تور. راجع LICENSE.

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

إشعارات

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

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

IronFox غير مدعوم أو مصادق عليه من Mozilla.

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

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