IronFox

IronFox — это форк Mull Browser от Divested Computing Group, основанный на Mozilla Firefox. Наша цель — продолжить наследие Mull, предоставляя бесплатный браузер с открытым исходным кодом, ориентированный на конфиденциальность и безопасность, для повседневного использования.

[!TIP] Нашли ошибку? Столкнулись с раздражающей проблемой? Хотите поделиться советом, идеей или предложением? Пожалуйста, сообщайте о любых проблемах, ошибках и предложениях в наш единый трекер проблем!

[!IMPORTANT] ⚠️ Всем пользователям НАСТОЯТЕЛЬНО рекомендуется ознакомиться с нашей документацией, ОСОБЕННО со страницами Ограничения и Часто задаваемые вопросы!

Хотя основным домом IronFox является GitLab, этот репозиторий также зеркалируется на Codeberg и GitHub.

Хотите присоединиться к сообществу IronFox?

Будем рады видеть вас на Matrix (рекомендуется) и Discord!

Установка приложения

Подробные сведения и пошаговые инструкции по установке IronFox см. на нашей странице Загрузка.

Проверка приложения

Идентификатор пакета: org.ironfoxoss.ironfox

Идентификатор пакета (Nightly): 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 по-прежнему собирают их из исходного кода.

Для сборки IronFox рекомендуется использовать Docker-образ.

Сборка с 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 — 32-битный ARM (armeabi-v7a)
• arm64 — 64-битный ARM (arm64-v8a)
• x86_64 — 64-битный x86
• bundle — Android App Bundle (AAB) со всеми поддерживаемыми ABI

В дополнение к AAB, цель bundle также создаёт APK для каждой архитектуры (arm, arm64 и x86_64), а также универсальный APK, содержащий все архитектуры.

Линтинг

IronFox в значительной степени управляется shell-скриптами, которые проверяются с помощью shellcheck (статический анализ) и shfmt (форматирование). Они запускаются автоматически в CI (задание lint-scripts) и применяются там — сбой линтинга останавливает конвейер до начала любой сборки.

./scripts/get_sources.sh устанавливает оба инструмента и включает git pre-commit hook (через core.hooksPath), который проверяет ваши подготовленные скрипты перед каждым коммитом. Хук — это удобство, и его можно обойти с помощью git commit --no-verify; CI остаётся источником истины.

Если вы предоставляете собственные копии shellcheck и shfmt (вместо их получения из ./scripts/get_sources.sh), после установки IRONFOX_SHELLCHECK_DIR и IRONFOX_SHFMT_DIR в соответствующие каталоги вы можете настроить pre-commit hook напрямую, выполнив:

./scripts/lint-hook.sh

Для ручного запуска проверок линтинга:

./scripts/lint.sh

Для автоматического исправления форматирования:

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

Конфигурация линтера находится в .shellcheckrc (проверки) и .editorconfig (форматирование).

Перевод

IronFox переводится с помощью Weblate. Посетите проект Weblate, чтобы помочь с переводами.

Лицензирование

Скрипты лицензированы в соответствии с GNU Affero General Public License, версия 3 или более поздняя.

Изменения в патчах лицензированы в соответствии с заголовком в файлах, которые этот патч добавляет или изменяет (Apache 2.0 или MPL 2.0).

Phoenix лицензирован в соответствии с GNU General Public License v3.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 Project. См. LICENSE.

Наш текущий набор обоев по умолчанию взят из Fennec F-Droid и доступен в соответствии с лицензией Unsplash.

Уведомления

Mozilla Firefox является товарным знаком The Mozilla Foundation.

Это не официально поддерживаемый продукт Mozilla. IronFox никоим образом не связан с Mozilla.

IronFox не спонсируется и не одобряется Mozilla.

IronFox не связан с DivestOS, Divested Computing Group или Mull каким-либо образом.

Исходный код Firefox доступен по адресу https://github.com/mozilla-firefox/firefox.