Public | Automated Build

Last pushed: 2 years ago
Short Description
AD-ZaiJian (廣告再見): Keep Ads away from any devices.
Full Description

AD-ZaiJian <img src="https://cloud.githubusercontent.com/assets/690703/9665138/d2c577e8-52a0-11e5-9608-1e7a24492d9c.png" width="200" align="right">

Currently, most of this repo is forked from :point_right: PI-hole.

Already tested on the following platforms

  • Raspberry PI 2 (kernel 4.2)
  • Synlolgy DS 713+
  • Ubuntu 14.04 64bit

Demo

Prerequisite

  • A server with Docker :whale:

Usage

1. Pull image from Docker Hub

# For x86_64 machine:
λ ~/ docker pull zack/ad-zaijian

# For RPI 2 or other armhf devices:
λ ~/ docker pull zack/ad-zaijian-armhf

2. Run container

λ ~/ export IP=192.168.1.100
λ ~/ docker run -d --name ad-zaijian -e IP=$IP -p 53:53/tcp -p 53:53/udp -v `pwd`:/data --cap-add=NET_ADMIN zack/ad-zaijian
  • Change envirment variable IP to server's IP address
  • The block lists and server log will save to your current work directory via pwd

    Of course, you could change it to any where you want.

It will take a while for fetching lots of block lists from internet at the first time :sweat_smile:.

3. Modify your devices' dns

Set DNS Server to your ad-zaijian's IP and That's all!

TODO

  • [ ] Rewrite or enhance block lists scripts
  • [ ] Expose dnsmasq statistics & data via API or ...

License

GPL v2

Docker Pull Command
Owner
zack
Source Repository