Skip to content

Latest commit

 

History

History
35 lines (25 loc) · 1.63 KB

README.md

File metadata and controls

35 lines (25 loc) · 1.63 KB

TC IPIP Mapper (WIP)

Description

A project aimed to add support for multiple remotes on an IPIP tunnel. This project consist of two TC programs (one for ingress and the other for egress).

The main goal of the TC ingress program is to map the client IP (inner IP header's source IP address) to the remote IP (the outer IP header's source address).

When outgoing IPIP packets are sent back out, it will replace the outer IP header's destination IP address with the mapped remote IP if it exist. If it doesn't, the packet will go out unchanged.

An example where this is useful is if you're utilizing IPIP tunnels with an Anycast network and want the traffic to go back the same POP server it came in with.

Command Line Usage

The only command line option is -i --dev which determines which interface to attach to. An example of using the ipipmapper loader may be found below.

./ipipmapper --dev ens18

Installing

You may use git and make to install this project onto your server. I'd suggest the following commands for downloading and installing.

git clone --recursive https://github.com/gamemann/TC-IPIP-Mapper.git # Recursive will download LibBPF.
cd TC-IPIP-Mapper/
make && make install

If you want to enable this via systemd, I'd suggest modifying the /etc/systemd/system/IPIPMapper.service file after install and ensure it is set to use the correct interface via the -i flag. Afterwards, you may execute the following commands.

systemctl enable IPIPMapper # Enables the program on startup.
systemctl start IPIPMapper  # Starts the program via systemd.

Credits