lutinglt/ipv6lanrouter repository overview

⁠Github: https://github.com/lutinglt/ipv6lanrouter⁠

⁠IPv6 LAN Router

Assign IPv6 addresses to networks that can't get IPv6 addresses, redistribute IPv6 addresses on the LAN, and be transparent to higher-level routing.

⁠Features

• Easy to deploy and out-of-the-box
• Supports automatic multi-LAN assignment
• Supports automatic recognition of WAN interfaces
• Supports recognizing dynamic prefix of WAN port and modifying LAN prefix automatically.
• Stateless only
• No PD server required, inter-subnet routing
• LAN interface IPv6 prefix matches IPv4 and MAC address assignment rules for Docker
• Global IPv6 addresses can be assigned to containers under a Docker bridged network

⁠Getting Started

Via docker-compose.yml

services:
  ipv6lanrouter:
    image: lutinglt/ipv6lanrouter:latest
    container_name: ipv6lanrouter
    hostname: ipv6lanrouter
    restart: on-failure
    networks:
#  macvlan is WAN(Interfaces capable of obtaining IPv6 global addresses)
      macvlan:
#  bridge is LAN(Interfaces that cannot obtain IPv6 global addresses)
      bridge1:
      bridge2:
      bridge3:
   environment:
      - TZ=Asia/Shanghai
#      - CHECK=3
#      - LAN_MODE=docker
#      - PREFIXLEN=60
#      - MTU=0
#      - RDNSS=*:*:*:*;*:*:*:*;
#      - EXCLUDE_SUB=00;01;02;03;...;
#      - EXCLUDE_NUM1=0;1;2;3;...;
#      - EXCLUDE_NUM2=0;1;2;3;...;
    cap_add:
      - NET_ADMIN
    sysctls:
      - "net.ipv6.conf.all.forwarding=1"
      - "net.ipv6.conf.all.proxy_ndp=1"
      - "net.ipv6.conf.all.accept_ra=2"
      - "net.ipv6.conf.default.forwarding=1"
      - "net.ipv6.conf.default.proxy_ndp=1"
      - "net.ipv6.conf.default.accept_ra=2"

networks:
  macvlan:
    external: true
    name: macvlan
  bridge1:
    external: true
    name: bridge1
  bridge2:
    external: true
    name: bridge2
  bridge3:
    external: true
    name: bridge3

⁠Configuration

⁠PREFIXLEN && LAN_MODE

• Only prefix lengths 56 58 60 62 64 are supported.

• If the PREFIXLEN is not 64, the WAN port address will be excluded from the subnet address pool and then the LAN port address will be assigned.

• If the PREFIXLEN is 64, the default LAN ports are all Docker bridge networks, and the IPv6 subnet address and prefix length are calculated based on the MAC address assigned to the IPv4 prefix length of the bridge network in Docker. (Linux stateless IPv6 addresses are calculated by default using EUI64).

• If the PREFIXLEN is 64, and LAN_MODE is set to net or any other value, only one LAN is supported and there is no communication between LAN port LAN and WAN port LAN.

⁠EXCLUDE_SUB

Addresses to exclude when assigning subnets (Supports two digits or one digit in hexadecimal only) (Split each address with ";")

⁠EXCLUDE_NUM1 && EXCLUDE_NUM2

Facilitates exclusion of unassigned prefixes (Supports one digit in hexadecimal only) (Split each address with ";")