mirror of
https://github.com/wickedyoda/public-setupfiles.git
synced 2026-11-16 13:31:56 -06:00
84 lines
1.6 KiB
Markdown
84 lines
1.6 KiB
Markdown
# pihole
|
|||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
Pi-hole DNS blocking and domain list resources for ad-blocking and content filtering.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Files
|
||
|
|
|
||
|
|
| File | Description |
|
||
|
|
|------|-------------|
|
||
|
|
| `blocklist.txt` | Comprehensive domain blocklist |
|
||
|
|
| `whitelist.txt` | Domains to allow through |
|
||
|
|
| `combined_list.txt` | Merged block + allow lists |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Blocklist
|
||
|
|
|
||
|
|
### `blocklist.txt`
|
||
|
|
|
||
|
|
A comprehensive list of domains to block via DNS, including:
|
||
|
|
- Advertising networks
|
||
|
|
- Analytics trackers
|
||
|
|
- Social media domains
|
||
|
|
- Adult content sites
|
||
|
|
- Known malware domains
|
||
|
|
|
||
|
|
This is the primary source for Pi-hole's DNS blocking.
|
||
|
|
|
||
|
|
### `whitelist.txt`
|
||
|
|
|
||
|
|
Domains that should always resolve normally:
|
||
|
|
- Local services
|
||
|
|
- Required CDN domains
|
||
|
|
- Cloud services
|
||
|
|
|
||
|
|
### `combined_list.txt`
|
||
|
|
|
||
|
|
A ready-to-use combined list that can be imported directly.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Usage with Pi-hole
|
||
|
|
|
||
|
|
### Adding Blocklist
|
||
|
|
|
||
|
|
1. Open Pi-hole Admin Console
|
||
|
|
2. **Group Management** → **Adlists**
|
||
|
|
3. Add these URLs:
|
||
|
|
|
||
|
|
```
|
||
|
|
https://raw.githubusercontent.com/wickedyoda/public-setupfiles/main/pihole/blocklist.txt
|
||
|
|
https://raw.githubusercontent.com/wickedyoda/public-setupfiles/main/pihole/whitelist.txt
|
||
|
|
```
|
||
|
|
|
||
|
|
4. Update gravity: `pihole -g`
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Customizing
|
||
|
|
|
||
|
|
Edit the files to add/remove domains:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Edit blocklist
|
||
|
|
nano pihole/blocklist.txt
|
||
|
|
|
||
|
|
# Edit whitelist
|
||
|
|
nano pihole/whitelist.txt
|
||
|
|
|
||
|
|
# Regenerate combined list
|
||
|
|
cat pihole/blocklist.txt pihole/whitelist.txt > pihole/combined_list.txt
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Notes
|
||
|
|
|
||
|
|
- Whitelist domains should be a small, trusted list
|
||
|
|
- Too many whitelisted domains can create security issues
|
||
|
|
- Review lists periodically for accuracy
|
||
|
|
- Test new lists before deploying to production Pi-hole instances
|