ip6tables_nat kernel module for QNAP NAS

This repository contains a collection of scripts for building the ip6tables_nat kernel module for a QNAP NAS.

Motivation

The main problem why I need those kernel modules is IPV6.

Basically I want to publish some web services that run in Docker containers (on my QNAP NAS) to the internet. The problem is that my internet provider only gives me an IPV6 address. So Docker on my NAS must also use IPV6.

Thes led me to docker-ipv6nat. At this repository the problem of Docker with IPV6 is described much more in detail.

To use this workaraound/software the ip6table_nat kernel module is required. Sadly it's not built into the QTS kernel...

So I built it myself :)

Download the precompiled images

There's a GitHub workflow that builds kernel images of this repository. You can download them directly from the releases page.

Currently the modules are only compiled for the x86_64 architecture!

The modules are based on the GPL QTS version

Building

On my own QNAP NAS the toolchain for building the kernel is

>$ cat /proc/version

Linux version 5.10.60-qnap [...] (toolchain config: [gcc-4.9.2 binutils-2.25 glibc-2.21]) [...]

Because these are quite old versions the simpliest solution to get this build context was to use Docker with an old Ubuntu 15.04 image.

I reccomend to use Docker to build these modules rather than to setup the build context on your PC manually.

1) Build the Docker image

To build the Docker image run:

docker build -t ip6tables_nat-qnap --build-arg PUID=`id -u` --build-arg PGID=`id -g` .

For customizations you can specify the following build arguments:

• BUILD_USER [builder]: The name for the user that runs the build process.
• PUID [1000]: The user ID of that user. The above command uses the current user ID.
• PGID [1000]: The group ID that belongs to that user. The above command uses the current group ID.

2) Run the Docker image to build the Kernel modules

To start the automated build process run:

docker run --rm -v `pwd`/out:/out ip6tables_nat-qnap

By default if no arguments were specified, the resulting kernel modules should be available in your current working directory. Otherwise check the -v argument. On container side the path should be equal to the VOLUME_DIR path that is defined in the Dockerfile.

Using the kernel modules

1. Copy them to your QNAP NAS.
2. Load them via insmod:

# some required modules are already built into QTS, so you can load them with 'modprobe'
/sbin/modprobe ip6_tables
/sbin/modprobe nf_nat
/sbin/modprobe xt_MASQUERADE

# then load the new modules
/sbin/insmod /<path_to_module>/ip6t_NPT.ko
/sbin/insmod /<path_to_module>/nf_reject_ipv6.ko
/sbin/insmod /<path_to_module>/ip6t_REJECT.ko
/sbin/insmod /<path_to_module>/ip6table_nat.ko

The other modules that were also built can be ommited.

You can add the above commands to the autorun.sh file to load those modules at boot time. The process for creating the autorun.sh file is described in the official QNAP Wiki: https://wiki.qnap.com/wiki/Running_Your_Own_Application_at_Startup