IronFox

IronFox est un fork du Mull Browser du Divested Computing Group, basé sur Mozilla Firefox. Notre objectif est de poursuivre l'héritage de Mull en fournissant un navigateur web gratuit et open source, axé sur la confidentialité et la sécurité, pour un usage quotidien.

[!TIP] Vous avez trouvé un bug ? Vous rencontrez un problème gênant ? Vous avez une astuce, une idée ou une suggestion à partager ? Veuillez signaler tout problème, rapport de bug et suggestion sur notre suivi de problèmes unifié !

[!IMPORTANT] ⚠️ Il est FORTEMENT recommandé à tous les utilisateurs de consulter notre documentation, en particulier les pages Limitations et Foire aux questions !

Bien que la maison d'IronFox soit GitLab, ce dépôt est également mis en miroir sur Codeberg et GitHub.

Vous souhaitez rejoindre la communauté IronFox ?

Nous serions ravis de vous voir sur Matrix (Recommandé) et Discord !

Installation de l'application

Pour plus de détails et des instructions étape par étape sur l'installation d'IronFox, consultez notre page Téléchargement.

Vérification de l'application

Identifiant du paquet : org.ironfoxoss.ironfox

Identifiant du paquet (Nightly) : org.ironfoxoss.ironfox.nightly

Empreinte SHA-256 du certificat de signature :

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

Compilation

IronFox facilite (et accélère) la compilation du projet localement. Par exemple, des versions précompilées de wasi-sdk sysroot et de llvm-project sont utilisées au lieu de les compiler localement. Les builds F-Droid compilent toujours ces éléments à partir des sources.

Il est recommandé d'utiliser l'image Docker pour compiler IronFox.

Compiler avec Docker

Tirez l'image docker avec :

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

Vous pouvez également utiliser le tag main pour tirer l'image qui a été utilisée pour compiler la dernière version d'IronFox. Ou vous pouvez utiliser des noms de version exacts pour tirer les images de ces versions.

Par exemple :

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

Ensuite, vous devez configurer les fichiers sources.

Compiler sans Docker

REMARQUE : Actuellement, les compilations sur les dernières versions des systèmes Fedora, macOS, secureblue et Ubuntu sont prises en charge. Les résultats peuvent varier pour d'autres systèmes d'exploitation/environnements.

REMARQUE : Les utilisateurs de macOS doivent installer Homebrew (s'il n'est pas déjà installé) avant de suivre les étapes ci-dessous.

Tout d'abord, si vous ne l'avez pas déjà installé, vous voudrez installer git pour votre plateforme de choix :

Fedora :

sudo dnf install git

macOS :

brew install git

secureblue :

git est déjà installé par défaut sur secureblue, donc rien à faire ici.

Ubuntu :

sudo apt install git

Après avoir installé git avec succès, la première chose à faire est de cloner le dépôt source d'IronFox :

(--depth=1 est spécifié ci-dessous pour réduire la taille du dépôt cloné, il peut être supprimé si vous le préférez)

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

Vous devez maintenant naviguer vers la racine du répertoire source d'IronFox et exécuter le script bootstrap :

(Le script bootstrap configurera et installera les dépendances requises pour compiler IronFox sur votre système)

cd IronFox
./scripts/bootstrap.sh

Obtenir les sources

Toujours depuis la racine du répertoire source d'IronFox, vous devez maintenant exécuter le script get_sources pour télécharger les sources externes requises pour compiler IronFox :

REMARQUE : Si vous devez récupérer les sources d'une version différente d'une dépendance par rapport à la version qu'IronFox utilise actuellement, vous devrez modifier scripts/versions.sh AVANT d'exécuter le script get_sources.

Cela peut prendre un certain temps selon votre vitesse de réseau...

./scripts/get_sources.sh

Préparation des sources

Vous devez maintenant patcher/préparer vos sources nouvellement téléchargées avec le script prebuild :

Cela doit être exécuté une fois après avoir obtenu vos sources.

./scripts/prebuild.sh

Compilation

Enfin, vous pouvez démarrer le processus de compilation avec :

./scripts/build.sh <variante-de-compilation>

Où <variante-de-compilation> spécifie la variante à compiler, et est une des suivantes :

• arm - ARM 32 bits (armeabi-v7a)
• arm64 - ARM 64 bits (arm64-v8a)
• x86_64 - x86 64 bits
• bundle - Android App Bundle (AAB) avec tous les ABI pris en charge

En plus de l'AAB, la cible bundle produit également des APK pour chaque architecture (arm, arm64 et x86_64), ainsi qu'un APK universel contenant toutes les architectures.

Analyse statique (Linting)

IronFox est largement piloté par des scripts shell, qui sont vérifiés avec shellcheck (analyse statique) et shfmt (formatage). Ces vérifications s'exécutent automatiquement dans CI (le job lint-scripts) et y sont imposées — un échec de lint arrête le pipeline avant le démarrage de toute compilation.

./scripts/get_sources.sh installe les deux outils et active un hook git pre-commit (via core.hooksPath) qui analyse vos scripts mis en scène avant chaque commit. Le hook est une commodité et peut être contourné avec git commit --no-verify ; la CI reste la source de vérité.

Si vous fournissez vos propres copies de shellcheck et shfmt (au lieu de les obtenir via ./scripts/get_sources.sh), après avoir défini IRONFOX_SHELLCHECK_DIR et IRONFOX_SHFMT_DIR vers les répertoires appropriés, vous pouvez configurer le hook pre-commit directement en exécutant :

./scripts/lint-hook.sh

Pour exécuter les vérifications de lint manuellement :

./scripts/lint.sh

Pour corriger automatiquement le formatage :

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

La configuration du linter se trouve dans .shellcheckrc (vérifications) et .editorconfig (formatage).

Traduction

IronFox est traduit à l'aide de Weblate. Visitez le projet Weblate pour aider aux traductions.

Licences

Les scripts sont sous licence GNU Affero General Public License, version 3 ou ultérieure.

Les modifications apportées aux patches sont sous licence conformément à l'en-tête des fichiers que ce patch ajoute ou modifie (Apache 2.0 ou MPL 2.0).

Phoenix est sous licence GNU General Public License v3.0 ou ultérieure (GPL-3.0-or-later) lorsque cela s'applique. Voir COPYING.

a-c-liberate.patch, a-s-localize-maven.patch et fenix-liberate.patch sont adaptés de Fennec F-Droid. Voir COPYING.

gecko-configure-ublock-origin.patch, gecko-devtools-bypass.patch, gecko-fix-rfphelper-import.patch, gecko-prevent-exposing-name-and-vendor-to-extensions.patch et gecko-rs-blocker.patch sont adaptés de LibreWolf. Voir Licence et avertissements de 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 et glean-noop.patch sont adaptés du Tor Project. Voir LICENSE.

Notre ensemble actuel de fonds d'écran par défaut provient de Fennec F-Droid, et est disponible sous la licence Unsplash.

Avis

Mozilla Firefox est une marque déposée de The Mozilla Foundation.

Ceci n'est pas un produit officiellement pris en charge par Mozilla. IronFox n'est en aucun cas affilié à Mozilla.

IronFox n'est ni sponsorisé ni approuvé par Mozilla.

IronFox n'est associé à DivestOS, Divested Computing Group ou Mull d'aucune manière.

Le code source de Firefox est disponible sur https://github.com/mozilla-firefox/firefox.