pointaction/adguard-lists
GitHub: pointaction/adguard-lists
一套自托管的 AdGuard 格式 DNS 白名单与黑名单规则集,涵盖广告、遥测、赌博及 NSFW 等多分类域名拦截,通过 GitHub Actions 自动同步与验证。
Stars: 0 | Forks: 0
# adguard-lists
[](https://github.com/pointaction/adguard-lists/actions/workflows/validate-lists.yml)
[](https://github.com/pointaction/adguard-lists/actions/workflows/sync-allowlists.yml)
[](https://github.com/pointaction/adguard-lists/actions/workflows/sync-blocklists.yml)
[](https://github.com/pointaction/adguard-lists/actions/workflows/check-sources.yml)
为我网络准备的 DNS 白名单和黑名单。
这个仓库以 **AdGuard / Adblock Plus 格式** 托管我的允许/拦截列表
(`@@||domain^` 表示允许,`||domain^` 表示拦截)。该格式同时适用于 AdGuard
Home 和 **Technitium DNS Server**,这也是我正在运行的工具。所有内容都托管在
GitHub 上。
欢迎复制、使用或贡献。
## 我的网络
```
📺💻📱 Clients
│
▼
🖥️ Technitium DNS Server (Webmin + Configserver Firewall on Ubuntu 24.04) loads the lists in this repo
│
▼
☁️ DNSSEC + DNS-over-TLS (Cloudflare)
│
▼
🛜 TP-Link Omada ER605 Gateway + Smart Switch (VLANs)
│
▼
🌐 Internet
```
## 当前统计
_最后更新:2026-07-12 01:44 UTC_
| 列表 | 允许规则 | 拦截规则 |
|------|------------:|------------:|
| `pasallow-h12-whitelist.txt` | 5,635 | — |
| `pasallow-referral.txt` | 1,542 | — |
| `pasblacklist.txt` | 11 | 176 |
| `pasblock-amazon.txt` | — | 360 |
| `pasblock-apple.txt` | — | 106 |
| `pasblock-dandelion-sprout.txt` | — | 11,519 |
| `pasblock-gambling.txt` | — | 147,809 |
| `pasblock-haGeZi-pro.txt` | — | 231,556 |
| `pasblock-huawei.txt` | — | 135 |
| `pasblock-lgwebos.txt` | — | 340 |
| `pasblock-microsoft.txt` | — | 370 |
| `pasblock-native-oppo.txt` | — | 465 |
| `pasblock-nsfw.txt` | — | 107,836 |
| `pasblock-osid.txt` | — | 502,823 |
| `pasblock-roku.txt` | — | 71 |
| `pasblock-samsung.txt` | — | 189 |
| `pasblock-shadow-whisper.txt` | — | 43,201 |
| `pasblock-tif.txt` | — | 540,491 |
| `pasblock-tiktok.txt` | — | 424 |
| `pasblock-urlhaus.txt` | — | 12,512 |
| `pasblock-vivo.txt` | — | 227 |
| `pasblock-xiaomi.txt` | — | 347 |
| `paswhitelist.txt` | 98 | — |
| **总计(总和)** | **7,286** | **1,600,957** |
| **总计(唯一域名)** | **7,264** | **1,210,090** |
## 这个仓库里有什么
### 允许列表(`@@||domain^`)
| 文件 | 内容 | 来源 |
|------|------------|--------|
| `paswhitelist.txt` | 我的白名单 — 我永远不希望被拦截的受信任服务(WGU / 远程监考、Roku Channel、个人域名、开发工具)。 | 手动维护 |
| `pasreferral-whitelist.txt` | 保持生效的推广 / 引荐 / 追踪域名,以确保邮件和搜索中的链接能正常解析。 | 每日从 HaGeZi 自动同步,并转换为允许格式 |
### 拦截列表(`||domain^`)
| 文件 | 内容 | 来源 |
|------|------------|--------|
| `pasblacklist.built.txt` | 我的黑名单(流媒体广告、遥测数据),其中包含一些内嵌的 `@@` 允许规则以保障播放。 | 根据我自己的规则构建 |
| `pasblock-*.txt` | 分类黑名单 — 每个上游来源一个文件(tif、rebind、amazon、apple、gambling、huawei、lgwebos、microsoft、native-oppo、nsfw、roku、tiktok、vivo、xiaomi、samsung)。 | 每日自动同步,并经过清理与去重 |
### 脚本与配置
| 文件 | 用途 |
|------|---------|
| `validate_lists.py` | 验证每个 `.txt` 列表:语法、文件内重复项以及实时 DNS 解析。 |
| `build_blocklist.py` | 将原始的上游列表(hosts / adblock / 纯文本)标准化为干净的 `||domain^` 规则,进行去重,并减去我的白名单。 |
| `build_lists.py` | 根据我的个人规则构建 `pasblacklist.built.txt`。 |
| `blocklist-sources.txt` | 黑名单同步的控制面板 — 每行对应一个来源 `name url`。 |
## 自动化(GitHub Actions)
所有内容都会自动刷新和自我检查:
- **`validate-lists.yml`** — 在每次推送/PR 时以及每周运行。自动发现所有 `.txt`
列表,如果文件中有任何格式错误或重复的规则,则会运行失败。
- **`sync-referral-whitelist.yml`** — 每天。获取 HaGeZi 的引荐白名单,将
纯域名转换为 `@@||domain^`,并提交 `pasreferral-whitelist.txt`。
- **`sync-blocklists.yml`** — 每天。对于 `blocklist-sources.txt` 中的每个来源,获取它,
将其标准化为 `||domain^`,进行去重,减去我已添加到白名单的域名,并提交
`pasblock-.txt`。仅时间戳的更改将被跳过,因此不会产生空提交。
## 添加新列表
**新的拦截来源:** 在 `blocklist-sources.txt` 中添加一行 —
```
name https://example.com/somelist.txt
```
提交它,然后运行 **Actions → Sync blocklists → Run workflow**。一个清理过的
`pasblock-name.txt` 就会生成,可以随时使用。
## 在 Technitium(或 AdGuard Home)中使用它们
将每个列表的 **raw** URL 添加到 Technitium 的 *Block List URLs* 框中 — **它们之中没有任何一个带有 `!`
前缀**。由于这些是 adblock 格式,Technitium 会自动检测
每条规则中的 `@@||domain^` 为允许,以及 `||domain^` 为拦截。示例:
```
https://raw.githubusercontent.com/pointaction/adguard-lists/main/paswhitelist.txt
https://raw.githubusercontent.com/pointaction/adguard-lists/main/pasreferral-whitelist.txt
https://raw.githubusercontent.com/pointaction/adguard-lists/main/pasblacklist.built.txt
https://raw.githubusercontent.com/pointaction/adguard-lists/main/pasblock-samsung.txt
...
```
然后点击 **Settings → Blocking → Update Now**,并在仪表板上确认 Allow List / Block List 的
数量。
标签:AdGuard, DNS过滤, 广告拦截, 网络防护, 运维配置, 逆向工具, 黑白名单