neatplan 0.0.2

nginx-style network configuration

neatplan

nginx-style network configuration

Dependencies

• Python >= 3.6
• crossplane
• iproute2

Features

So far:

• Boot-time configuration only
• IPv4/IPv6 autodetection (ip or ip -6 prefix)
• Set loopback interface up by default (ip link set lo up)
• Set link up for a given interface (ip link set <iface> up)
• Set IP address for a given interface (ip addr add <ip/mask> dev <iface>)
• Set IP route for a given interface (ip ro add <ip> dev <iface>)
• Set default IP route for a given interface (ip ro add default via <ip> dev <iface>)
• Set via IP route for a given interface (ip ro add <ip> via <ip> dev <iface>)
• Set nameservers (/etc/resolv.conf)
• Firewall configuration (iptables-restore, ip6tables-restore)
• Custom commands to run before and after
• Configured interfaces are being stored in /run/neatplan

Installation

Alpine Linux

cd /opt
git clone https://github.com/c0m4r/neatplan.git
cd neatplan
cp etc/init.d/neatplan /etc/init.d/
cp -r etc/neatplan /etc/
rc-update del networking boot
rc-update add neatplan boot

Configuration

Sample config: /etc/neatplan/default.conf

network {
    backend iproute2;
    before {
        command "touch /tmp/neatplan";
    }
    firewall {
        iptables /etc/iptables/iptables.rules;
        ip6tables /etc/iptables/ip6tables.rules;
    }
    ethernet {
        eth0 {
            addresses {
                address fe80:ffff:eeee:dddd::1/64;
                address fe80:ffff:eeee:dddd::2/64;
                address 192.168.0.10;
                address 192.168.100.50/24;
            }
            routes {
                route fe80::1 default;
                route 192.168.0.1;
                route 1.1.1.1 via 192.168.0.1;
            }
        }
    }
    dns {
        nameserver 2606:4700:4700::1111;
        nameserver 2606:4700:4700::1001;
    }
    after {
        command "echo I\'m so custom, wow";
        command "ip link add link eth0 name eth0.1337 type vlan id 1337";
    }
}

Funding

If you found this script helpful, please consider making a donation to a charity on my behalf. Thank you.