A lightweight and efficient transparent router solution for debian-based systems.

Install required system packages:

sudo apt update
sudo apt install netplan.io iptables fish net-tools

and install the docker by the script which locatied at scripts/install_docker.fish.

Configure network interfaces using Netplan:

sudo cp netplan/*.yaml /etc/netplan/
sudo netplan apply

Available configurations:

• 90-static.yaml - Static IP configuration for router interface
• 99-dhcp.yaml - DHCP fallback configuration

Apply optimized kernel parameters for routing performance:

sudo cp sysctl.d/*.conf /etc/sysctl.d/
sudo sysctl --system

Configure transparent proxy and security rules:

sudo ./scripts/firewall.fish

you can auto start the script by enable the rc.local service:

sudo systemctl enable rc-local

and link the script to /etc/rc.local:

sudo ln -s /path/to/faure.sh/scripts/firewall.fish /etc/rc.local

Enable Docker service and start containers:

sudo systemctl enable docker
sudo systemctl start docker

Deploy Mihomo for transparent proxy functionality:

cd compose/mihomo
docker compose up -d

Deploy AdGuard Home for DNS filtering:

cd compose/adguard
docker compose up -d

Deploy iperf3 for network performance testing:

cd compose/iperf3
docker compose up -d

This project is licensed under the MIT License - see the LICENSE file for details.