本项目已停止维护。

我们建议使用 Ghostery 跟踪器与广告拦截器搭配 Firefox。

Ghostery 隐私浏览器

Ghostery 桌面浏览器是 Firefox 的一个最小化分支，专为隐私优化。主要额外功能包括：

内置并默认启用 Ghostery 隐私拦截器扩展。
集成 Ghostery 隐私搜索。
Firefox 设置（遥测等）已调整为最大隐私保护。

下载

Ghostery 浏览器适用于以下平台：

每日构建频道

我们还提供每日构建版本，用于测试开发中的构建。获取方式如下：

从以上链接之一安装标准发布版。
打开浏览器，访问 about:config。
搜索 app.update.channel 首选项，将值改为 nightly。

本地构建

要构建浏览器，首先需要下载一份 Firefox 源代码，并应用我们的定制补丁。此过程通过 fern.js 处理，这是我们用于管理补丁工作流的工具。按以下步骤设置本地工作空间：

git clone https://github.com/ghostery/user-agent-desktop.git
cd user-agent-desktop
npm ci # Fern.js dependencies
./fern.js use # Pull the correct Firefox and Ghostery extension sources
./fern.js import-patches # Apply patches to Firefox

获取 Firefox 源代码后，需要配置构建环境。详细说明可参考 Firefox 文档，但大多数情况下，以下命令即可：

cd mozilla-release
./mach bootstrap

构建工具链配置完成后，可使用 Ghostery 的 mozconfig 文件进行构建：

cd mozilla-release
MOZCONFIG=/path/to/user-agent-desktop/brands/ghostery/mozconfig ./mach build # start build
./mach run # to launch the browser

跨平台构建

本地构建默认针对当前平台。如需为其他平台构建，我们提供了 Docker 化构建。可通过 fern.js build 命令运行：

./fern.js build -t mac

Windows 和 Mac 构建需要相应的平台框架。这些文件应放置在 build 目录下：

Mac：MacOSX14.4.sdk.tar.xz。可在 XCode 安装中找到。
Windows：vs.tar.zstd 和 Makecab.exe。参见本文档末尾以获取这些文件的来源。

开发工作流

克隆仓库后，运行以下命令开始（注意：系统需要安装 npm 和 node）：

./fern.js use # Setup 'mozilla-release' folder using information from '.workspace'
./fern.js import-patches
cd mozilla-release # Do some stuff... and commit your changes
./fern.js export-patches # Check 'patches' folder

升级 Ghostery

升级浏览器捆绑的 Ghostery 扩展，需执行以下操作：

./fern.js use --ghostery v8.5.2
./fern.js reset
./fern.js import-patches

升级 Firefox

每当有新版本发布，或者您想基于另一个 Firefox 版本进行开发，请运行以下命令：

./fern.js use --firefox 80.0.1
./fern.js reset # Needed if you already had this version locally.
./fern.js import-patches

构建

在任何环境中构建浏览器的任意变体，可按以下步骤操作：

# Prepare 'mozilla-release' folder with correct version and patches.
./fern.js use
./fern.js reset
./fern.js import-patches

# All three commands can be used from Linux and MacOS (except windows cross-build).
./fern.js build --target mac
./fern.js build --target linux
./fern.js build --target windows

然后检查 mozilla-release 文件夹中的构建产物。

设置开发环境

./mach bootstrap 需要 gecko 源码的版本控制检出才能正常运行。请使用 gecko-dev 仓库来运行 mach bootstrap 并配置本地构建环境：

git clone https://github.com/mozilla/gecko-dev.git
cd gecko-dev
./mach bootstrap

现在，您应该可以在本项目中使用 ./mach build 了。

或者，本仓库中的 build-* 脚本会为每个平台准备包含预配置构建环境的 Docker 镜像。脚本会将您带入一个 Docker 容器的命令行提示符，您可以直接在其中运行 ./mach build。

在 Windows 上构建

先决条件

VS Redist

在 Windows 上构建需要按照这些说明设置构建环境。您需要安装 Windows 11 SDK（版本 10.0.22621）。然后运行以下命令创建 vs.tar.zstd：

OUTPUT_DIR=PATH_TO_TEMP_FOLDER
./mach python --virtualenv build taskcluster/scripts/misc/get_vs.py ./build/vs/vs2022.yaml $OUTPUT_DIR
tar --zstd -cvSf vs.tar.zstd -C $OUTPUT_DIR .

Makecab.exe

该文件从 Windows 安装目录复制，位置为 C:\Windows\System32\makecab.exe。

社区

User Agent 项目旨在服务于大众利益。我们欢迎社区积极参与塑造浏览器的未来，并期待收集社区反馈和意见。

社区正在项目决策中发挥积极作用：

Better-Fox —— 维护了一份经过实践检验的 Firefox 偏好设置列表。

如果您有兴趣加入 User Agent 社区，欢迎在 GitHub 上发起讨论或加入我们的 Matrix 聊天室社区。

user-agent-desktop

最受欢迎