AdGuard 如何通过 GitHub 实现透明化并与用户共创

在 AdGuard,我们每天都在为打造一个更安全、更舒适、更透明的互联网而奋斗。这一承诺不仅体现在我们的产品功能和严格的隐私政策中,也体现在我们尽可能保持工作开放透明这一点上,这包括与我们的社区积极互动。

正因如此,我们所有的产品都拥有公共代码库(Repository),在线空间让任何人都可以查看我们的工作内容、直接向 AdGuard 开发者报告问题,甚至为我们的开源项目做贡献。这些代码库包括我们的广告拦截应用、过滤器、浏览器扩展、DNS 解决方案、VPN 工具、开发者实用程序等等。提供此类功能的平台有很多,但迄今为止最流行的是 GitHub,所有 AdGuard 项目都存储于此。

本文按类别列出最重要的代码库,总结每个代码库的用途,并简要说明用户可以在其中做些什么。

💡
专业提示:在 GitHub 上创建问题(Issue)是让 AdGuard 开发者关注到某个问题的最有效方式。请确保检查类似问题是否已存在,并以全面但简洁的方式描述问题。如果已存在,您可以为其点赞(Upvote)以表示关注。

什么是 Github 及代码库

简单来说,用户可以将 GitHub 视为代码版的「Google 文档」,多个人可以在同一个项目上协作、跟踪更改并查看是谁进行了更新。它提供一个集中的、基于云的场所来存储代码,因此可以从任何地方访问。GitHub 还具备用于审查更改、修复问题和顺利合并每个人工作的团队协作工具。

GitHub 广泛用于开源项目,允许任何人查看代码、提出改进建议并做出贡献。

代码库(Repository,常简称为 “repo”)是 GitHub 最基本的元素。它是一个可以存储代码、文件及每个文件修订历史的地方。代码库可以有多个协作者,可以是公开的,也可以是私有的。

如何开始?

您可以在下文找到关键代码库的链接,或访问 AdGuardTeam GitHub 主页查看完整列表。在大多数代码库中,您可以:

  • 查看主页上的 README 文件:介绍产品及其代码库。

    README 文件 *border

  • 查看现有的错误报告或功能请求,进行评论和点赞。

    查看问题记录 *border

  • 创建问题(Issue) 以报告错误或请求功能。

    创建问题 *border

  • 检查发布版本(Releases) 以了解不同版本及其更新日志(如有需要,也可安装旧版本)。

    查看更新版本 *border

  • 安装任何旧版或测试版(如有需要)。

    下载软件 *border

温馨提示:如果您是 GitHub 新手,则需要创建一个 GitHub 账户才能创建新问题或评论现有问题。

在开源代码库中,高级用户还可以进行以下操作:

  • 浏览代码以了解产品逻辑、使用的技术及其实现方式。
  • 复刻(Fork)并贡献代码(通过拉取请求 Pull Request)。

无论您是普通用户、技术专家还是开发者,AdGuard 都欢迎所有社区成员通过其 GitHub 代码库参与进来。

AdGuard 广告拦截产品

在这些代码库中,用户可以:

  • 通过 GitHub Issues 查看和报告错误或功能请求
  • 检查更新日志、跟踪发布历史、监控更新
  • 下载最新、以往和测试版本(iOS 除外)

AdguardForAndroid

AdGuard Android 版的代码库,一款提供系统级广告拦截的应用。

AdguardForiOS

AdGuard iOS 版的代码库,带有 DNS 和自定义过滤器的 Safari 内容拦截器。用户还可以查看其开源代码。

AdguardForWindows

AdGuard Windows 版的代码库。非开源,GitHub 用作公开的错误追踪器。

AdguardForMac

AdGuard Mac 版的代码库,macOS 独立内容拦截器。仅用作错误追踪器。

AdguardBrowserExtension

AdGuard 浏览器扩展的代码库,为 Chrome、Firefox、Opera、Edge 提供广告拦截和增强隐私保护的扩展。

AdguardForSafari

AdGuard Safari 版的代码库,适用于 Mac 的 Safari 广告拦截扩展。用户还可以查看其开源代码。

AdGuardCLI

AdGuard Linux 版的代码库,用于管理广告拦截的命令行界面。

AdGuard VPN 产品

在这些代码库中,用户可以执行以下操作:

  • 通过 GitHub Issues 查看和报告错误或功能请求
  • 检查更新日志、跟踪发布历史、监控更新
  • 下载最新、以往和测试版本(iOS 除外)

AdGuardVPNForiOS

AdGuard VPN iOS 版的代码库。用作公开的错误追踪器。

AdGuardVPNForAndroid

AdGuard VPN Android 版的代码库。用作公开的错误追踪器。

AdGuardVPNForWindows

AdGuard VPN Windows 版的代码库。用作公开的错误追踪器。

AdGuardVPNForMac

AdGuard VPN Mac 版的代码库,专为 macOS 设计的应用程序。

AdGuardVPNExtension

AdGuard VPN 浏览器扩展的代码库。

AdGuardVPNCLI

AdGuard VPN Linux 版的代码库,用于管理 VPN 连接的命令行界面。该代码库用作错误追踪器。

基于 DNS 的产品

AdGuardDNS

开源代码库,也用于跟踪与 AdGuard DNS 服务相关的错误和问题。用户可以执行以下操作:

  • 查看和报告 DNS 问题
  • 提出改进建议

AdGuardHome

AdGuard Home 的代码库,免费的全网络软件,通过 DNS 拦截广告和跟踪器。用户可以执行以下操作:

  • C检查并提交错误报告或功能请求
  • 审查或贡献代码
  • 下载并安装发布版本

文档与知识库

知识库旨在帮助用户更好地理解和使用 AdGuard 服务。它们详细描述每个 AdGuard 产品:从功能概述和问题解决指南到高级设置手册和 API 文档。在代码库中,用户可以执行以下操作:

  • 对知识库文章提出修正或编辑建议
  • 提议新文章
  • 测试或运行本地版本

KnowledgeBase

AdGuard 广告拦截程序及相关技术的核心文档。

KnowledgeBaseDNS

AdGuard DNS(公共和私人)、AdGuard Home 及相关一切功能的详细功能概述、故障排除指南和文档。

KnowledgeBaseVPN

AdGuard VPN 的详细功能概述和故障排除指南。

KnowledgeBaseMail

AdGuard Mail 的详细功能概述和故障排除指南。

核心库

AdGuardCoreLibs

AdGuard 的跨平台核心过滤引擎。用于 Android、Windows 和 Mac 产品。用户可以执行以下操作:

  • 探索过滤逻辑和 DNS 处理方式
  • 通过 Issues 报告错误和提出功能建议,通过 Pull requests 贡献代码

DNSLibs

被 CoreLibs 和 AdGuardHome 使用的 DNS 库。用户可以执行以下操作:

  • 审查并贡献于底层 DNS 实现
  • 提出优化建议

VPNLibs

AdGuard VPN 产品跨平台共享的代码库,用于实现 AdGuard VPN 协议。用户可以执行以下操作:

  • 为 VPN 协议栈行为做贡献
  • 报告或查看性能问题和错误

核心广告拦截与过滤技术

AdguardFilters

包含 AdGuard 的核心过滤器列表。用户可以执行以下操作:

  • 查看和下载过滤器列表
  • 创建 Issue 以报告误报或建议新规则
  • 监控过滤器逻辑的更新

AdGuardSDNSFilter

AdGuard DNS 过滤器的代码库,用于 AdGuard DNS 和 DNS 过滤功能的主要 DNS 级别拦截列表。用户可以执行以下操作:

  • 检查当前规则集
  • 提议更改或添加

AGLint

用于 adblock 过滤器列表语法的 linter 工具。用户可以执行以下操作:

  • 安装 AGLint 来检查其项目的规则问题
  • 为 lint 规则做贡献

Scriptlets

在过滤规则中使用的 JavaScript 辅助脚本。用户可以执行以下操作:

  • 探索可用的 Scriptlets
  • 提交新 Scriptlets 的 Pull Request

tsurlfilter

用于浏览器扩展的 TypeScript 内容拦截库。用户可以执行以下操作:

  • 探索过滤逻辑的实现方式
  • 贡献修复和功能

还有更多

以上,我们列出了总共 96 个公共代码库中的 27 个主要 AdGuard 代码库。如果您想深入探索,可以在 AdGuardTeam GitHub 页面找到其余代码库

期待大家的反馈意见!祝您使用愉快,一切顺遂。

喜欢这篇文章吗?
20,825 20825 用户评论
完美!

AdGuard Windows版

Windows 版 AdGuard 不只是广告拦截程序,它是集成所有让您享受最佳网络体验的主要功能的多用途工具。其可拦截广告和危险网站,加速网页加载速度,并且保护儿童的在线安全。
下载本程序表示您接受 许可协议 的条款
阅读更多
AdGuard Windows版 7.22 版本,14 天的试用期
20,825 20825 用户评论
完美!

AdGuard Mac版

Mac 版 AdGuard 是一款独一无二的专为 MacOS 设计的广告拦截程序。除了保护用户免受浏览器和应用程序里恼人广告的侵扰外,应用程序还能保护用户免受跟踪、网络钓鱼和诈骗。
下载本程序表示您接受 许可协议 的条款
阅读更多
AdGuard Mac版 2.17 版本,14 天的试用期
20,825 20825 用户评论
完美!

AdGuard Android版

安卓版的 AdGuard 是一个用于安卓设备的完美解决方案。与其他大多数广告拦截器不同,AdGuard 不需要 Root 权限,提供广泛的应用程序管理选项。
下载本程序表示您接受 许可协议 的条款
阅读更多
扫码下载
可以使用任何一款 QR 码阅读器
AdGuard Android版 4.12 版本,14 天的试用期
20,825 20825 用户评论
完美!

AdGuard iOS版

用于 iPhone 和 iPad 的最佳 iOS 广告拦截程序。AdGuard 可以清除 Safari 中的各种广告,保护个人隐私,并加快页面加载速度。iOS 版 AdGuard 广告拦截技术确保最高质量的过滤,并让用户同时使用多个过滤器。
下载本程序表示您接受 许可协议 的条款
阅读更多
扫码下载
可以使用任何一款 QR 码阅读器
AdGuard iOS版 版本 4.5
20,825 20825 用户评论
完美!

AdGuard 内容拦截程序

AdGuard 内容拦截器可以全面屏蔽所有支持内容拦截技术的移动浏览器中的广告,目前包括 Samsung Internet 浏览器和 Yandex 浏览器。虽然其功能相比 Android 版 AdGuard 有所限制,但它完全免费、安装简单且拦截高效。
下载本程序表示您接受 许可协议 的条款
阅读更多
AdGuard 内容拦截程序 版本 2.8
20,825 20825 用户评论
完美!

AdGuard 浏览器扩展

AdGuard 是快速的、小内存的广告拦截扩展,可高效拦截所有网页上的各种广告!选择所需的 AdGuard 浏览器扩展,您可进行无广告、快速、安全的浏览。
AdGuard 浏览器扩展 版本 5.2
20,825 20825 用户评论
完美!

AdGuard 助手

AdGuard 桌面应用 的配套浏览器扩展。它为浏览器提供了访问自定义元素阻止,将网站列入白名单或发送报告等功能
AdGuard 助手 版本 1.4
20,825 20825 用户评论
完美!

AdGuard Home

AdGuard Home 是一种基于网络的广告和跟踪器拦截解决方案。只需在您的路由器上安装一次,即可覆盖您家庭网络中的所有设备——无需额外的客户端软件。这对于各种经常威胁您隐私的物联网设备尤其重要。
AdGuard Home 版本 0.107
20,825 20825 用户评论
完美!

AdGuard Pro iOS 版

AdGuard Pro iOS 版预置全部高级广告拦截防护功能,提供与 AdGuard iOS 版付费版完全相同的工具集。其卓越之处在于:不仅能精准拦截 Safari 浏览器内的广告,更支持自定义 DNS 设置以精细化防护策略。该产品具备跨浏览器与应用的全方位广告拦截能力,有效防护儿童远离不良内容,并全面保障个人数据安全。
下载本程序表示您接受 许可协议 的条款
阅读更多
AdGuard Pro iOS 版 版本 4.5
20,825 20825 用户评论
完美!

AdGuard Safari 版

我们的 Safari 广告拦截程序已成功应对 Apple 强制采用新 SDK 的挑战。这款 AdGuard 扩展旨在让 Safari 重获高质量广告拦截体验。
AdGuard Safari 版 版本 1.11
20,825 20825 用户评论
完美!

AdGuard Android TV 版

Android TV版 AdGuard 是唯一一款能拦截广告、保护隐私并充当智能电视防火墙的应用程序。获取网络威胁警告,使用安全 DNS,并受益于加密流量。有了安全性和零广告的使用体验,用户就可以尽情享受最喜爱的节目了!
AdGuard Android TV 版 4.12 版本,14 天的试用期
20,825 20825 用户评论
完美!

AdGuard Linux版

AdGuard Linux 版是世界上第一个系统级广告拦截器。拦截广告和跟踪器,选择预设过滤器或添加自己的过滤器。管理流程通过命令行界面实现。
AdGuard Linux版 版本 1.1
20,825 20825 用户评论
完美!

AdGuard Temp Mail

免费的临时电子邮件地址生成器,保持匿名性并保护个人隐私。你的主收件箱中不会出现垃圾邮件!
20,825 20825 用户评论
完美!

AdGuard DNS

AdGuard DNS 是广告拦截、隐私保护及家长控制的简约三合一解决方案。其不但易于设置且免费,无论您使用的是何种平台或设备,都可以提供最基础的保护对抗在线广告、跟踪器及钓鱼。
20,825 20825 用户评论
完美!

AdGuard Mail

保护个人身份,避免垃圾邮件,并使用我们的别名和临时电子邮件地址保护收件箱。享受我们的免费电子邮箱转发服务和适用于所有操作系统的应用程序使用体验。
20,825 20825 用户评论
完美!

AdGuard Wallet

一个安全且私密的加密钱包,让您完全控制资产。管理多个钱包,发现数千种加密货币以存储、发送和兑换。
已开始下载 AdGuard 点击箭头指示的文件开始安装 AdGuard。 选择“打开”并点击“确定”,然后稍作等待直至文件加载完毕。在已经打开的窗口中,将 AdGuard 图标拖拽至“Applications”文件夹内即可完成安装。感谢您选择 AdGuard! 选择“打开”并点击“确定”,然后稍作等待直至文件下载完毕。然后,在打开的窗口中点击“安装”即可。感谢您选择 AdGuard!
将 AdGuard 安装到移动设备上