Singularity

将已知恶意域名拉入黑洞列表的命令行工具。主要目的是与PDNS Recursor一起使用。该工具可以从多个adlist源拉入黑洞域名，并以各种格式输出到多个位置。

相关博客文章。

安装

需要Rust的稳定构建版本，最好是最新版本。最低支持版本：1.52.0。

• 来自crates.io：cargo install singularity
• 从源：cargo install --path .

用法

• 基本用法：singularity

CLI选项

可以使用--help标志查看所有CLI选项。选项有

• -v，--verbose：启用额外的调试输出到stdout
• -c，--config：使用自定义配置文件而不是默认配置文件
• -t，--timeout：等待每个HTTP请求成功的超时时间（以毫秒为单位）（默认：1000）

配置文件

默认情况下，工具将使用当前系统依赖位置的配置文件。在Linux上，这是$HOME/.config/singularity/singularity.conf。如果不存在，则会创建该文件并包含空值。

完整的配置文件示例

whitelist = ["my-cool-domain.com"]

[[adlist]]
source = "https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts"
format = "hosts"

[[adlist]]
source = "file:/absolute/path"
format = "domains"

[[adlist]]
source = "https://raw.githubusercontent.com/notracking/hosts-blocklists/master/dnsmasq/dnsmasq.blacklist.txt"
format = "dnsmasq"

[[output]]
type = "hosts"
destination = "/etc/powerdns/hosts"
blackhole_address = "0.0.0.0"
include = ["extra-hosts"]

[[output]]
type = "hosts"
destination = "/etc/hosts"
deduplicate = true

[[output]]
type = "pdns-lua"
destination = "/etc/powerdns/blackhole.lua"
blackhole_address = "::"
output_metric = true
metric_name = "blocked-queries"

白名单

一个域名数组，您希望不包括在最终输出中。这些匹配是精确的，因此google.com只会匹配google.com，但不会匹配其任何子域名。配置选项可以完全省略，以使用默认空白名单。

广告列表

一个描述广告列表源的数组。它们有两个键

• source：广告列表源URL。URL方案可以是 http、https 或 file。如果是一个 file URL，则其路径将在本地系统中解释为绝对文件系统路径。
• format：广告列表条目所在的格式。对于默认的 hosts 值，可以省略此选项。值可以是以下之一：
  • hosts：标准的 /etc/hosts 风格的条目；0.0.0.0 malicious.domain。假设每个条目中的地址是不指定的 0.0.0.0 IP 地址。具有不同IP地址或以IP地址作为域名的条目将被忽略。
  • domains：每行只是一个域名：malicious.domain。
  • dnsmasq：每行是dnsmasq的 address 或 server 配置行；address=/example.com/#