Blocky: Difference between revisions
imported>TAKYON Blocky is a DNS proxy and ad-blocker for the local network written in Go. |
m Update to current blocky config format |
||
(8 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
Blocky is a DNS proxy and ad-blocker for the local network written in Go. | [https://github.com/0xERR0R/blocky Blocky] is a DNS proxy and ad-blocker for the local network written in Go. | ||
It provides network wide adblocking similar to Pi-hole while offering additional features (and it's in nixpkgs). | It provides network wide adblocking similar to Pi-hole while offering additional features (and it's in nixpkgs). | ||
== Configuration Examples == | == Configuration Examples == | ||
< | <syntaxHighlight lang=nix> | ||
services.blocky = { | |||
enable = true; | enable = true; | ||
settings = { | settings = { | ||
ports.dns = 53; # Port for incoming DNS Queries. | |||
upstreams.groups.default = [ | |||
"https://one.one.one.one/dns-query" # Using Cloudflare's DNS over HTTPS server for resolving queries. | "https://one.one.one.one/dns-query" # Using Cloudflare's DNS over HTTPS server for resolving queries. | ||
]; | ]; | ||
# For initially solving DoH/DoT Requests when no system Resolver is available. | # For initially solving DoH/DoT Requests when no system Resolver is available. | ||
bootstrapDns = { | |||
upstream = "https://one.one.one.one/dns-query"; | upstream = "https://one.one.one.one/dns-query"; | ||
ips = [ "1.1.1.1" "1.0.0.1" ]; | ips = [ "1.1.1.1" "1.0.0.1" ]; | ||
}; | }; | ||
#Enable Blocking of | #Enable Blocking of certain domains. | ||
blocking = { | blocking = { | ||
denylists = { | |||
#Adblocking | #Adblocking | ||
ads = ["https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts"]; | ads = ["https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts"]; | ||
Line 24: | Line 25: | ||
adult = ["https://blocklistproject.github.io/Lists/porn.txt"]; | adult = ["https://blocklistproject.github.io/Lists/porn.txt"]; | ||
#You can add additional categories | #You can add additional categories | ||
}; | |||
#Configure what block categories are used | |||
clientGroupsBlock = { | |||
default = [ "ads" ]; | |||
kids-ipad = ["ads" "adult"]; | |||
}; | |||
}; | }; | ||
}; | }; | ||
};</ | }; | ||
</syntaxHighlight> | |||
== Adding Additional Functionality == | == Adding Additional Functionality == | ||
To add a cache of DNS Requests and Prefetching add: | To add a cache of DNS Requests and Prefetching add: | ||
< | <syntaxHighlight lang=nix> | ||
caching = { | |||
minTime = "5m"; | minTime = "5m"; | ||
maxTime = "30m" | maxTime = "30m" | ||
prefetching = true; | prefetching = true; | ||
};</ | }; | ||
</syntaxHighlight> | |||
[[Category:Server]] | |||
[[Category:Cookbook]] |
Latest revision as of 16:39, 12 September 2024
Blocky is a DNS proxy and ad-blocker for the local network written in Go. It provides network wide adblocking similar to Pi-hole while offering additional features (and it's in nixpkgs).
Configuration Examples
services.blocky = {
enable = true;
settings = {
ports.dns = 53; # Port for incoming DNS Queries.
upstreams.groups.default = [
"https://one.one.one.one/dns-query" # Using Cloudflare's DNS over HTTPS server for resolving queries.
];
# For initially solving DoH/DoT Requests when no system Resolver is available.
bootstrapDns = {
upstream = "https://one.one.one.one/dns-query";
ips = [ "1.1.1.1" "1.0.0.1" ];
};
#Enable Blocking of certain domains.
blocking = {
denylists = {
#Adblocking
ads = ["https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts"];
#Another filter for blocking adult sites
adult = ["https://blocklistproject.github.io/Lists/porn.txt"];
#You can add additional categories
};
#Configure what block categories are used
clientGroupsBlock = {
default = [ "ads" ];
kids-ipad = ["ads" "adult"];
};
};
};
};
Adding Additional Functionality
To add a cache of DNS Requests and Prefetching add:
caching = {
minTime = "5m";
maxTime = "30m"
prefetching = true;
};