IronFox

F-Droid 二维码：

IronFox 是 Divested Computing Group 的 Mull Browser 的一个分支，基于 Mozilla Firefox。我们的目标是延续 Mull 的传承，提供一个自由开源、注重隐私与安全、适合日常使用的网页浏览器。

[!TIP] 发现了 bug？遇到了烦人的问题？有想要分享的技巧、想法或建议？请通过我们的统一问题追踪器提交任何问题、bug 报告和建议！

[!IMPORTANT] ⚠️ 强烈建议所有用户查看我们的文档，尤其是局限性和常见问题页面！

IronFox 的主仓库位于 GitLab，但本仓库也镜像到了 Codeberg 和 GitHub。

想加入 IronFox 社区吗？

我们期待在 Matrix （推荐） 和 Discord 上见到你！

应用安装

有关如何安装 IronFox 的详细信息和分步说明，请参阅我们的下载页面。

应用验证

包 ID：org.ironfoxoss.ironfox

包 ID （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 构建仍然从源码构建这些。~~

建议使用 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 系统上构建。其他操作系统/环境的情况可能有所不同。

注意：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 当前使用的版本不同的依赖项版本，你需要在运行 get_sources 脚本之前修改 scripts/versions.sh。

这可能需要一些时间，具体取决于你的网络速度……

./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 - 包含所有受支持 ABI 的 Android App Bundle（AAB）

除了 AAB 之外，bundle 目标还会为每种架构*（arm、arm64 和 x86_64）*生成 APK，以及一个包含所有架构的通用 APK。

代码检查

IronFox 主要由 shell 脚本驱动，这些脚本使用 shellcheck *（静态分析）*和 shfmt *（格式化）进行检查。这些检查在 CI 中自动运行（lint-scripts 任务）*并在那里强制执行——检查失败会在任何构建开始之前停止流水线。

./scripts/get_sources.sh 会安装这两个工具，并启用一个 git pre-commit 钩子*（通过 core.hooksPath）*，在每次提交前对暂存的脚本进行检查。该钩子只是一个便利工具，可以通过 git commit --no-verify 绕过；CI 仍然是权威来源。

如果你提供自己的 shellcheck 和 shfmt 副本*（而不是从 ./scripts/get_sources.sh 获取）*，在将 IRONFOX_SHELLCHECK_DIR 和 IRONFOX_SHFMT_DIR 设置为相应的目录后，你可以通过运行以下命令直接设置 pre-commit 钩子：

./scripts/lint-hook.sh

要手动运行代码检查：

./scripts/lint.sh

要自动修复格式：

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

代码检查工具的配置位于 .shellcheckrc *（检查）*和 .editorconfig *（格式化）*中。

翻译

IronFox 使用 Weblate 进行翻译。请访问 Weblate 项目来帮助翻译。

许可

这些脚本根据 GNU Affero 通用公共许可证第 3 版或更高版本授权。

对补丁的更改根据该补丁添加或修改的文件中的头部进行授权（Apache 2.0 或 MPL 2.0）。

Phoenix 在适用的情况下根据 GNU 通用公共许可证 v3.0 或更高版本 （GPL-3.0-or-later） 授权。参见 COPYING。

a-c-liberate.patch、a-s-localize-maven.patch 和 fenix-liberate.patch 改编自 Fennec F-Droid。参见 COPYING。

IronFox v152.0.6