IronFox

IronFox è un fork del Mull Browser del Divested Computing Group, basato su Mozilla Firefox. Il nostro obiettivo è continuare l'eredità di Mull fornendo un browser web gratuito e open source, orientato alla privacy e alla sicurezza, per l'uso quotidiano.

[!TIP] Hai trovato un bug? Hai riscontrato un problema fastidioso? Hai un suggerimento, un'idea o una proposta da condividere? Ti preghiamo di segnalare qualsiasi problema, bug report e suggerimento sul nostro issue tracker unificato!

[!IMPORTANT] ⚠️ Si consiglia VIVAMENTE a tutti gli utenti di consultare la nostra documentazione, in particolare le pagine Limitazioni e Domande frequenti!

Sebbene la sede principale di IronFox sia GitLab, questo repository è anche specchiato su Codeberg e GitHub.

Vuoi unirti alla community di IronFox?

Ci farebbe piacere vederti su Matrix (Consigliato) e Discord!

Installazione dell'app

Per dettagli e istruzioni passo-passo su come installare IronFox, consulta la nostra pagina Download.

Verifica dell'app

ID pacchetto: org.ironfoxoss.ironfox

ID pacchetto (Nightly): org.ironfoxoss.ironfox.nightly

Hash SHA-256 del certificato di firma:

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

Compilazione

IronFox rende più semplice (e veloce) compilare il progetto localmente. Ad esempio, vengono utilizzate versioni precompilate di wasi-sdk sysroot e llvm-project invece di compilarle localmente. Le build F-Droid compilano ancora quelle dal sorgente.

Si consiglia di utilizzare l'immagine Docker per compilare IronFox.

Compilazione con Docker

Scarica l'immagine docker con:

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

Puoi anche usare il tag main per scaricare l'immagine utilizzata per compilare l'ultima release di IronFox. Oppure puoi usare nomi di versione esatti per scaricare le immagini per quelle versioni.

Ad esempio:

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

Quindi, devi preparare i file sorgente.

Compilazione senza Docker

NOTA: Attualmente, sono supportate le build sui sistemi più recenti di Fedora, macOS, secureblue e Ubuntu. L'esperienza può variare su altri sistemi operativi/ambienti.

NOTA: Gli utenti macOS devono installare Homebrew (se non è già installato) prima di seguire i passaggi seguenti.

Innanzitutto, se non l'hai già installato, dovrai installare git per la tua piattaforma preferita:

Fedora:

sudo dnf install git

macOS:

brew install git

secureblue:

git è già installato su secureblue per impostazione predefinita, quindi non c'è nulla da fare qui.

Ubuntu:

sudo apt install git

Dopo aver installato correttamente git, la prima cosa che devi fare è clonare il repository sorgente di IronFox:

(--depth=1 è specificato di seguito per ridurre le dimensioni del repository clonato, può essere rimosso se preferito)

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

Ora dovresti navigare alla radice della directory sorgente di IronFox ed eseguire lo script bootstrap:

(Lo script bootstrap configurerà e installerà le dipendenze necessarie per compilare IronFox sul tuo sistema)

cd IronFox
./scripts/bootstrap.sh

Ottenere i sorgenti

Sempre dalla radice della directory sorgente di IronFox, ora dovresti eseguire lo script get_sources per scaricare i sorgenti esterni necessari per compilare IronFox:

NOTA: Se devi recuperare i sorgenti per una versione diversa di una dipendenza rispetto alla versione attualmente utilizzata da IronFox, dovrai modificare scripts/versions.sh PRIMA di eseguire lo script get_sources.

Questo potrebbe richiedere del tempo a seconda della velocità della tua connessione...

./scripts/get_sources.sh

Preparazione dei sorgenti

Ora devi applicare le patch/preparare i sorgenti appena scaricati con lo script prebuild:

Questo deve essere eseguito una volta dopo aver ottenuto i sorgenti.

./scripts/prebuild.sh

Compilazione

Infine, puoi avviare il processo di compilazione con:

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

Dove <build-variant> specifica la variante da compilare ed è uno dei seguenti:

• arm - ARM a 32 bit (armeabi-v7a)
• arm64 - ARM a 64 bit (arm64-v8a)
• x86_64 - x86 a 64 bit
• bundle - Android App Bundle (AAB) con tutte le ABI supportate

Oltre all'AAB, il target bundle produce anche APK per ciascuna architettura (arm, arm64 e x86_64), oltre a un APK universale contenente tutte le architetture.

Linting

IronFox è ampiamente basato su script shell, che vengono controllati con shellcheck (analisi statica) e shfmt (formattazione). Questi vengono eseguiti automaticamente in CI (il job lint-scripts) e sono applicati lì — un errore di lint ferma la pipeline prima che inizi qualsiasi build.

./scripts/get_sources.sh installa entrambi gli strumenti e abilita un hook git pre-commit (tramite core.hooksPath) che esegue il lint degli script in staging prima di ogni commit. L'hook è una comodità e può essere bypassato con git commit --no-verify; la CI rimane la fonte di verità.

Se fornisci le tue copie di shellcheck e shfmt (invece di ottenerle da ./scripts/get_sources.sh), dopo aver impostato IRONFOX_SHELLCHECK_DIR e IRONFOX_SHFMT_DIR sulle directory appropriate, puoi configurare l'hook pre-commit direttamente eseguendo:

./scripts/lint-hook.sh

Per eseguire manualmente i controlli di lint:

./scripts/lint.sh

Per correggere automaticamente la formattazione:

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

La configurazione del linter si trova in .shellcheckrc (controlli) e .editorconfig (formattazione).

Traduzione

IronFox viene tradotto utilizzando Weblate. Visita il progetto Weblate per aiutare con le traduzioni.

Licenze

Gli script sono concessi in licenza sotto la GNU Affero General Public License, versione 3 o successiva.

Le modifiche alle patch sono concesse in licenza secondo l'intestazione nei file che questa patch aggiunge o modifica (Apache 2.0 o MPL 2.0).

Phoenix è concesso in licenza sotto la GNU General Public License v3.0 o successiva (GPL-3.0-or-later) dove applicabile. Vedi COPYING.

a-c-liberate.patch, a-s-localize-maven.patch e fenix-liberate.patch sono adattati da Fennec F-Droid. Vedi COPYING.

gecko-configure-ublock-origin.patch, gecko-devtools-bypass.patch, gecko-fix-rfphelper-import.patch, gecko-prevent-exposing-name-and-vendor-to-extensions.patch e gecko-rs-blocker.patch sono adattati da LibreWolf. Vedi Licenze e dichiarazioni di non responsabilità di 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 e glean-noop.patch sono adattati dal Tor Project. Vedi LICENSE.

Il nostro attuale set di wallpaper predefiniti è tratto da Fennec F-Droid ed è disponibile sotto la licenza Unsplash.

Avvisi

Mozilla Firefox è un marchio di The Mozilla Foundation.

Questo non è un prodotto ufficialmente supportato da Mozilla. IronFox non è in alcun modo affiliato a Mozilla.

IronFox non è sponsorizzato o approvato da Mozilla.

IronFox non è associato in alcun modo a DivestOS, Divested Computing Group o Mull.

Il codice sorgente di Firefox è disponibile su https://github.com/mozilla-firefox/firefox.