wanderadock/jool

jool-docker

Jool 是一个功能强大的内核空间命名空间感知的有状态NAT64和SIIT实现。本仓库包含该工具的简单Docker包装配置器。尽管Jool支持iptables和netfilter后端，但此镜像仅使用iptables。

核心功能和特性

• 在当前网络命名空间中设置Jool 4.x有状态NAT64模式：
  • 主机网络
  • Docker网络
  • Kubernetes pod

前提条件

运行镜像前，主机必须已安装Jool并加载为模块。请按照Jool文档进行安装。

Ubuntu 18.04示例：

bash
apt-get update
wget https://github.com/NICMx/Jool/releases/download/v4.0.8/jool-dkms_4.0.8-1_all.deb -O /tmp/jool-dkms_4.0.8-1_all.deb
apt install -y /tmp/jool-dkms_4.0.8-1_all.deb
modprobe jool
modprobe ip6table_mangle

使用方法和配置说明

容器必须具备扩展的网络能力。

在本地网络使用默认知名前缀64:ff9b::/96设置Jool：

bash
docker run --cap-add=NET_ADMIN --network host wanderadock/jool

在Docker网络test中使用自定义前缀2001:db8:1234::/96设置Jool：

bash
docker run --cap-add=NET_ADMIN --network test wanderadock/jool --pool6=2001:db8:1234::/96

在Docker网络test中使用自定义IPv6 MTU 1420设置Jool：

bash
docker run --cap-add=NET_ADMIN --network test wanderadock/jool --lowest-ipv6-mtu=1420

清理操作

如果在主机网络上运行Jool，可能需要清理：

bash
docker run --cap-add=NET_ADMIN --network host --entrypoint /cleanup.sh wanderadock/jool

其他情况下，所有Jool实例会在网络命名空间销毁时（通常是容器/Docker网络/Kubernetes pod销毁时）自动清理。

Kubernetes使用示例

Jool可用于在Kubernetes pod内设置NAT64，仍需主机安装Jool内核模块。

yaml
apiVersion: apps/v1
kind: Pod
metadata:
  name: jool-example
spec:
  initContainers:
    - name: jool
      image: wanderadock/jool:latest
      args:
        - "--pool6=2001:db8:1234::/96" # 使用自定义前缀
        - "--lowest-ipv6-mtu=1420" # 使用自定义IPv6 MTU
      securityContext:
        capabilities:
          add: ["NET_ADMIN"]
  ...

Docker仓库

该工具以Docker镜像形式发布，详见https://hub.docker.com/r/wanderadock/jool/%E3%80%82