开源项目 `whitelist` 使用教程

开源项目 whitelist 使用教程

whitelistA simple tool to add commonly white listed domains to your Pi-Hole setup. 项目地址:https://gitcode.com/gh_mirrors/wh/whitelist

1. 项目的目录结构及介绍

whitelist/
├── blacklist
│   ├── ads-hostnames.txt
│   ├── ads-ips.txt
│   ├── facebook.txt
│   ├── smart-tv.txt
│   └── tracking-aggressive-extended.txt
├── whitelist
│   ├── domains.txt
│   ├── referral-sites.txt
│   └── windows-telemetry.txt
├── scripts
│   ├── ads.py
│   ├── referral.py
│   └── update-lists.sh
├── LICENSE
├── README.md
└── update.json

• blacklist: 包含广告、追踪和特定服务的黑名单文件。
• whitelist: 包含域名和推荐站点的白名单文件。
• scripts: 包含用于更新和管理列表的脚本。
• LICENSE: 项目的许可证文件。
• README.md: 项目说明文档。
• update.json: 更新配置文件。

2. 项目的启动文件介绍

项目的主要启动文件是 scripts 目录下的脚本文件，例如 update-lists.sh。这个脚本用于更新黑名单和白名单文件。

#!/bin/bash

# 更新黑名单和白名单文件
python3 scripts/ads.py
python3 scripts/referral.py

3. 项目的配置文件介绍

项目的配置文件主要是 update.json，它包含了更新列表的配置信息。

{
  "blacklist": {
    "ads-hostnames": "https://example.com/ads-hostnames.txt",
    "ads-ips": "https://example.com/ads-ips.txt"
  },
  "whitelist": {
    "domains": "https://example.com/domains.txt",
    "referral-sites": "https://example.com/referral-sites.txt"
  }
}

• blacklist: 配置黑名单文件的更新源。
• whitelist: 配置白名单文件的更新源。

通过这些配置，可以自动从指定的URL更新黑名单和白名单文件。

whitelistA simple tool to add commonly white listed domains to your Pi-Hole setup. 项目地址:https://gitcode.com/gh_mirrors/wh/whitelist