---
title: Blocky
created: 2026-06-06
updated: 2026-06-06
type: app
tags: [catalogue, ad-block, dns, auto-hebergement, go, lightweight]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Ad+Block, https://github.com/0xERR0R/blocky]
---
# 🛡️ Blocky

> **DNS proxy et ad-blocker ultra-léger** écrit en Go. Idéal pour Raspberry Pi, machines peu puissantes, ou simplement pour les amateurs de performance.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [0xerr0r.github.io/blocky](https://0xerr0r.github.io/blocky/) |
| **GitHub** | [0xERR0R/blocky](https://github.com/0xERR0R/blocky) |
| **License** | Apache-2.0 |
| **Langage** | Go |
| **Étoiles GitHub** | 7k ⭐ |
| **Dernière MAJ** | 2026-06-05 |
| **Catégorie** | [[cat-ad-block|Ad Block]], DNS |

## 📝 Description

**Blocky** est un **DNS proxy moderne et ultra-rapide** qui combine :

- ✅ **Blocage de publicités et trackers** (listes personnalisables)
- ✅ **Redirection de domaines** (ex: `*.google.com` → DNS interne)
- ✅ **Conditional forwarding** (différentes règles par client)
- ✅ **Configuration 100% fichier** (YAML), pas de DB
- ✅ **Metrics Prometheus** intégrées
- ✅ **Hot reload** : recharge la config sans redémarrer
- ✅ **Binaire unique** : ~20 Mo, ultra-léger
- ✅ **Multi-platform** : Linux, macOS, Windows, Docker, ARM

**Pour qui** : utilisateurs qui veulent **un fichier de config simple**, pas de base de données, et qui aiment la **philosophie Unix** (un outil, un job, bien fait).

## 🚀 Installation

### Option 1 : Docker Compose

```yaml
# docker-compose.yml
version: '3.8'
services:
  blocky:
    container_name: blocky
    image: spx01/blocky:latest
    restart: unless-stopped
    ports:
      - "53:53/tcp"
      - "53:53/udp"
    environment:
      - TZ=Europe/Paris
    volumes:
      - ./config.yml:/app/config.yml
      - ./lists:/app/lists
```

### Option 2 : Binaire natif

```bash
# Télécharger depuis GitHub releases
wget https://github.com/0xERR0R/blocky/releases/latest/download/blocky_linux_amd64.tar.gz
tar -xzf blocky_linux_amd64.tar.gz
sudo mv blocky /usr/local/bin/

# Configuration
sudo mkdir /etc/blocky
sudo nano /etc/blocky/config.yml
```

## ⚙️ Configuration Initiale

Créer un `config.yml` :

```yaml
upstream:
  default:
    - 1.1.1.1
    - 9.9.9.9
  conditional:
    # Rediriger les requêtes pour *.lan vers le DNS interne
    - hostname: lan
      upstream: 192.168.1.1

blocking:
  blacklists:
    ads:
      - https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts
      - https://oisd.nl/full
  clientGroupsBlock:
    default:
      - ads

ports:
  dns: 53
  http: 4000  # API + metrics

# Metrics Prometheus
prometheus:
  enable: true
  path: /metrics
```

## 🔄 Alternatives

### Open Source
- [[app-pihole]] — Plus populaire, UI plus complète
- [[app-adguard-home]] — Plus moderne
- [[app-technitium-dns]] — Plus complet (DHCP, DoH)

### Avantages Blocky vs Pi-hole
- **Plus léger** (binaire Go ~20 Mo)
- **Config en YAML** (pas de DB)
- **Hot reload** sans redémarrage
- **Metrics Prometheus natives**
- **Moins de features UI** (plus orienté "CLI-friendly")

## Pages Liées
- [[cat-ad-block]] — Catégorie Ad Block
- [[observabilite]] — Metrics Prometheus
- [[dns-server]] — Concepts
