Sign inSign up

shedowe/eblocker

By shedowe

•Updated 9 months ago

eBlocker 4 Docker image for network-wide tracking and ad blocking.

Image
Security
0

10K+

shedowe/eblocker repository overview

⁠eBlocker 4 Docker (EN)

This image provides a full eBlocker 4 system (including systemd) packaged as a Docker container. The container is designed to run inside a macvlan network, so it appears in your LAN as a dedicated device with its own IP and MAC address. eBlocker then handles DNS/HTTPS filtering, tracking and ad blocking, and parental control features for your whole network.

The eBlocker root filesystem is stored persistently in a volume mounted at /eblocker-root, so updates and configuration changes survive container restarts.

⁠Docker Compose example

services:
  eblocker:
    image: shedowe/eblocker:latest
    container_name: eblocker-ct
    hostname: eblocker
    privileged: true

    # fixed, locally administered MAC address (example)
    mac_address: "02:EB:40:12:34:56"

    # Docker-Container gets a fixed IPv4 address inside your LAN
    networks:
      eblocker-macvlan:
        ipv4_address: 192.168.1.20

    # full eBlocker root filesystem is stored persistently here
    volumes:
      - eblocker-root:/eblocker-root

    restart: unless-stopped

volumes:
  eblocker-root:
    driver: local

networks:
  eblocker-macvlan:
    driver: macvlan
    driver_opts:
      # Name of the physical host NIC (e.g. eth0, enp3s0, ens18 …)
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24   # your LAN subnet
          gateway: 192.168.1.1     # your router/firewall in that LAN

⁠Docker Run equivalent

Using docker run with macvlan requires two steps: first creating the network, then running the container.

1. Create the Macvlan network: (Adjust parent=eth0, subnet, and gateway to your local network settings)

docker network create -d macvlan \
  -o parent=eth0 \
  --subnet=192.168.1.0/24 \
  --gateway=192.168.1.1 \
  eblocker-macvlan

2. Start the Container:

docker run -d \
  --name eblocker-ct \
  --hostname eblocker \
  --privileged \
  --restart unless-stopped \
  --mac-address "02:EB:40:12:34:56" \
  --net eblocker-macvlan \
  --ip 192.168.1.20 \
  -v eblocker-root:/eblocker-root \
  shedowe/eblocker:latest

⁠Notes (EN):

Set parent to the main interface on your host/VM/PC (e.g. eth0, ens18 …).

Adjust subnet, gateway and ipv4_address to match your own network.

Inside the eBlocker UI you can keep the network mode on Automatic/DHCP – the container itself still has a static IP via macvlan, so it remains reachable under a stable address.

⁠eBlocker 4 Docker (DE)

Dieses Image enthält ein vollständiges eBlocker-4-System (inkl. systemd), verpackt als Docker-Container. Der Container läuft ideal in einem macvlan-Netzwerk und verhält sich im LAN wie ein eigenes Gerät mit eigener IP und MAC. eBlocker übernimmt DNS/HTTPS-Filterung, Tracking- und Werbeblock sowie Jugendschutz-Funktionen für dein Netzwerk.

Der eBlocker-Root-Dateibaum wird persistent in einem Volume unter /eblocker-root gespeichert, sodass Updates und Einstellungen Container-Neustarts überleben.

⁠Docker Compose Beispiel

services:
  eblocker:
    image: shedowe/eblocker:latest
    container_name: eblocker-ct
    hostname: eblocker
    privileged: true

    # feste, lokal vergebene MAC-Adresse (Beispiel)
    mac_address: "02:EB:40:12:34:56"

    # Docker-Container bekommt im LAN eine feste IPv4-Adresse
    networks:
      eblocker-macvlan:
        ipv4_address: 192.168.1.20

    # gesamtes eBlocker-Rootfs bleibt in diesem Volume persistent
    volumes:
      - eblocker-root:/eblocker-root

    restart: unless-stopped

volumes:
  eblocker-root:
    driver: local

networks:
  eblocker-macvlan:
    driver: macvlan
    driver_opts:
      # Name des physischen Interfaces auf Host/VM/PC (z.B. eth0, enp3s0, ens18 …)
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24   # dein LAN-Subnetz
          gateway: 192.168.1.1     # dein Router/Firewall im LAN

⁠Docker Run Alternative

Die Nutzung von docker run mit macvlan erfordert zwei Schritte: Zuerst wird das Netzwerk erstellt, dann der Container gestartet.

1. Macvlan Netzwerk erstellen: (Passe parent=eth0, Subnetz und Gateway an dein lokales Netzwerk an)

docker network create -d macvlan \
  -o parent=eth0 \
  --subnet=192.168.1.0/24 \
  --gateway=192.168.1.1 \
  eblocker-macvlan

2. Container starten:

docker run -d \
  --name eblocker-ct \
  --hostname eblocker \
  --privileged \
  --restart unless-stopped \
  --mac-address "02:EB:40:12:34:56" \
  --net eblocker-macvlan \
  --ip 192.168.1.20 \
  -v eblocker-root:/eblocker-root \
  shedowe/eblocker:latest

⁠Hinweise (DE):

parent immer auf das Haupt-Interface deines Hosts setzen (z.B. eth0, ens18 …).

subnet, gateway und ipv4_address an dein eigenes Netz anpassen.

Im eBlocker-UI kannst du den Netzwerkmodus auf Automatisch/DHCP lassen – der Container selbst hat durch macvlan trotzdem eine feste IP und bleibt immer unter derselben Adresse erreichbar.

Tag summary

Content type

Image

Digest

sha256:499756c88…

Size

702.2 MB

Last updated

9 months ago

docker pull shedowe/eblocker