IronFox

IronFox ist ein Fork des Mull Browser der Divested Computing Group, basierend auf Mozilla Firefox. Unser Ziel ist es, das Erbe von Mull fortzuführen, indem wir einen freien und quelloffenen, auf Privatsphäre und Sicherheit ausgerichteten Webbrowser für den täglichen Gebrauch bereitstellen.

[!TIP] Einen Fehler gefunden? Auf ein lästiges Problem gestoßen? Einen Tipp, eine Idee oder einen Vorschlag, den du teilen möchtest? Bitte melde alle Probleme, Fehlerberichte und Vorschläge in unserem einheitlichen Issue-Tracker!

[!IMPORTANT] ⚠️ Allen Benutzern wird dringend empfohlen, einen Blick in unsere Dokumentation zu werfen, insbesondere auf die Seiten Einschränkungen und Häufig gestellte Fragen!

Während IronFox' Zuhause GitLab ist, wird dieses Repository auch auf Codeberg und GitHub gespiegelt.

Möchtest du der IronFox-Community beitreten?

Wir würden uns freuen, dich auf Matrix (Empfohlen) und Discord zu sehen!

App-Installation

Details und Schritt-für-Schritt-Anleitungen zur Installation von IronFox findest du auf unserer Download-Seite.

App-Verifizierung

Paket-ID: org.ironfoxoss.ironfox

Paket-ID (Nightly): org.ironfoxoss.ironfox.nightly

SHA-256-Hash des Signaturzertifikats:

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

Erstellen

IronFox macht es einfacher (und schneller), das Projekt lokal zu erstellen. So werden beispielsweise vorgefertigte Versionen von wasi-sdk sysroot und llvm-project verwendet, anstatt sie lokal zu erstellen. F-Droid-Builds erstellen diese weiterhin aus dem Quellcode.

Es wird empfohlen, das Docker-Image zum Erstellen von IronFox zu verwenden.

Mit Docker erstellen

Ziehe das Docker-Image mit:

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

Du kannst auch das main-Tag verwenden, um das Image zu ziehen, das zum Erstellen der neuesten IronFox-Version verwendet wurde. Oder du kannst exakte Versionsnamen verwenden, um Images für diese Versionen zu ziehen.

Zum Beispiel:

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

Danach musst du die Quelldateien einrichten.

Ohne Docker erstellen

HINWEIS: Derzeit werden Builds auf den neuesten Versionen von Fedora, macOS, secureblue und Ubuntu-Systemen unterstützt. Für andere Betriebssysteme/Umgebungen gilt YMMV.

HINWEIS: macOS-Benutzer müssen Homebrew installieren (falls noch nicht geschehen), bevor sie die folgenden Schritte ausführen.

Zuerst solltest du, falls noch nicht installiert, git für deine Plattform installieren:

Fedora:

sudo dnf install git

macOS:

brew install git

secureblue:

git ist auf secureblue standardmäßig bereits installiert, hier ist also nichts zu tun.

Ubuntu:

sudo apt install git

Nachdem du git erfolgreich installiert hast, musst du als Erstes IronFox' Quell-Repository klonen:

(--depth=1 wird unten angegeben, um die Größe des geklonten Repositorys zu reduzieren; es kann entfernt werden, falls bevorzugt)

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

Du solltest nun zum Stammverzeichnis von IronFox' Quellverzeichnis navigieren und das bootstrap-Skript ausführen:

(Das bootstrap-Skript richtet Abhängigkeiten ein und installiert sie, die zum Erstellen von IronFox auf deinem System erforderlich sind)

cd IronFox
./scripts/bootstrap.sh

Quellen abrufen

Weiterhin vom Stammverzeichnis von IronFox' Quellverzeichnis aus solltest du nun das get_sources-Skript ausführen, um die externen Quellen herunterzuladen, die zum Erstellen von IronFox erforderlich sind:

HINWEIS: Wenn du Quellen für eine andere Version einer Abhängigkeit abrufen musst als die Version, die IronFox derzeit verwendet, musst du scripts/versions.sh VOR dem Ausführen des get_sources-Skripts ändern.

Dies kann je nach Netzwerkgeschwindigkeit einige Zeit in Anspruch nehmen...

./scripts/get_sources.sh

Quellen vorbereiten

Du musst nun deine neu heruntergeladenen Quellen mit dem prebuild-Skript patchen/vorbereiten:

Dies muss einmal nach dem Abrufen deiner Quellen ausgeführt werden.

./scripts/prebuild.sh

Erstellen

Schließlich kannst du den Build-Prozess mit folgendem Befehl starten:

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

Wobei <build-variante> die zu erstellende Variante angibt und eine der folgenden ist:

• arm - 32-Bit-ARM (armeabi-v7a)
• arm64 - 64-Bit-ARM (arm64-v8a)
• x86_64 - 64-Bit-x86
• bundle - Android App Bundle (AAB) mit allen unterstützten ABIs

Zusätzlich zum AAB erzeugt das bundle-Ziel auch APKs für jede Architektur (arm, arm64 und x86_64) sowie ein universelles APK, das alle Architekturen enthält.

Linting

IronFox wird weitgehend von Shell-Skripten gesteuert, die mit shellcheck (statische Analyse) und shfmt (Formatierung) geprüft werden. Diese laufen automatisch in CI (der lint-scripts-Job) und werden dort erzwungen — ein Lint-Fehler stoppt die Pipeline, bevor ein Build beginnt.

./scripts/get_sources.sh installiert beide Tools und aktiviert einen Git-Pre-Commit-Hook (über core.hooksPath), der deine gestagten Skripte vor jedem Commit lintet. Der Hook ist eine Annehmlichkeit und kann mit git commit --no-verify umgangen werden; CI bleibt die maßgebliche Quelle.

Wenn du eigene Kopien von shellcheck und shfmt bereitstellst (anstatt sie von ./scripts/get_sources.sh zu beziehen), kannst du nach dem Setzen von IRONFOX_SHELLCHECK_DIR und IRONFOX_SHFMT_DIR auf die entsprechenden Verzeichnisse den Pre-Commit-Hook direkt einrichten, indem du Folgendes ausführst:

./scripts/lint-hook.sh

Um die Lint-Prüfungen manuell auszuführen:

./scripts/lint.sh

Um die Formatierung automatisch zu korrigieren:

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

Die Linter-Konfiguration befindet sich in .shellcheckrc (Prüfungen) und .editorconfig (Formatierung).

Übersetzung

IronFox wird mit Weblate übersetzt. Besuche das Weblate-Projekt, um bei Übersetzungen zu helfen.

Lizenzierung

Die Skripte sind unter der GNU Affero General Public License, Version 3 oder später lizenziert.

Änderungen an Patches sind gemäß dem Header in den Dateien lizenziert, die dieser Patch hinzufügt oder ändert (Apache 2.0 oder MPL 2.0).

Phoenix ist unter der GNU General Public License v3.0 oder später (GPL-3.0-or-later) lizenziert, soweit anwendbar. Siehe COPYING.

a-c-liberate.patch, a-s-localize-maven.patch und fenix-liberate.patch sind von Fennec F-Droid adaptiert. Siehe COPYING.

gecko-configure-ublock-origin.patch, gecko-devtools-bypass.patch, gecko-fix-rfphelper-import.patch, gecko-prevent-exposing-name-and-vendor-to-extensions.patch und gecko-rs-blocker.patch sind von LibreWolf adaptiert. Siehe LibreWolf-Lizenz und Haftungsausschlüsse.

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 und glean-noop.patch sind vom Tor Project adaptiert. Siehe LICENSE.

Unser aktueller Satz an Standard-Hintergrundbildern stammt von Fennec F-Droid und ist unter der Unsplash-Lizenz verfügbar.

Hinweise

Mozilla Firefox ist eine Marke der Mozilla Foundation.

Dies ist kein offiziell unterstütztes Mozilla-Produkt. IronFox ist in keiner Weise mit Mozilla verbunden.

IronFox wird von Mozilla weder gesponsert noch unterstützt.

IronFox ist in keiner Weise mit DivestOS, Divested Computing Group oder Mull verbunden.

Der Firefox-Quellcode ist verfügbar unter https://github.com/mozilla-firefox/firefox.