Skip to content

IPv6 Setup — vBNG / BiSON BNG

This guide covers how to configure IPv6 with prefix delegation on vBNG / BiSON BNG for use with Zal Ultra ISP CRM.

⚠️ PREREQUISITES

  • vBNG or BiSON BNG installed and running (latest version)
  • PPPoE server already configured and working with IPv4
  • RADIUS client configured and connected to Zal Ultra
  • Valid IPv6 prefix allocated from your upstream provider
  • Backup your configuration before making changes

Architecture

Subscriber CPE (DHCPv6-PD Client)

vBNG / BiSON BNG (Virtual BNG + RADIUS Client)

Zal Ultra (RADIUS Server + Billing)

Step 1: Configure IPv6 Pool

yaml
# vBNG IPv6 pool configuration (YAML-based config)
ipv6:
  pools:
    - name: ipv6-pd-pool
      prefix: "2001:db8:1000::/40"
      delegation-length: 56
      type: prefix-delegation
    - name: ipv6-wan-pool
      prefix: "2001:db8:2000::/48"
      delegation-length: 64
      type: wan-address
ParameterDescription
nameA descriptive name for the pool
prefixYour allocated IPv6 prefix from upstream provider
delegation-lengthPrefix length delegated to each subscriber
typePool type (prefix-delegation for LAN, wan-address for WAN link)

Step 2: Configure Subscriber Profile

yaml
# Subscriber profile with IPv6 support
subscriber:
  profile: default-ipv6
  ipv4:
    enabled: true
    pool: ipv4-pool
  ipv6:
    enabled: true
    pd-pool: ipv6-pd-pool
    wan-pool: ipv6-wan-pool
    slaac: true
    dhcpv6: true
    nd:
      managed-flag: true
      other-config-flag: true
      ra-interval: 30

Step 3: Configure RADIUS Authentication

yaml
# RADIUS configuration for IPv6
radius:
  authentication:
    server: <ZAL_ULTRA_IP>
    port: 1812
    secret: "<YOUR_RADIUS_SECRET>"
  accounting:
    server: <ZAL_ULTRA_IP>
    port: 1813
    secret: "<YOUR_RADIUS_SECRET>"
  attributes:
    ipv6:
      framed-ipv6-prefix: true
      delegated-ipv6-prefix: true
      framed-ipv6-pool: true

Step 4: Configure PPPoE with IPv6

yaml
# PPPoE service configuration with dual-stack
pppoe:
  service-name: "ISP-INTERNET"
  interface: "eth0"
  authentication: "radius"
  ipv4:
    enabled: true
  ipv6:
    enabled: true
    pd-pool: "ipv6-pd-pool"
    wan-pool: "ipv6-wan-pool"

Step 5: Apply and Verify

bash
# Apply configuration
sudo vbng-cli apply-config

# Check subscriber sessions
sudo vbng-cli show subscribers --detail

# Check IPv6 pool utilization
sudo vbng-cli show pools --family ipv6

# Check RADIUS logs
sudo vbng-cli show radius statistics

Quick Reference

TaskCommand
Apply configsudo vbng-cli apply-config
Check subscriberssudo vbng-cli show subscribers --detail
Check IPv6 poolssudo vbng-cli show pools --family ipv6
Check RADIUS statssudo vbng-cli show radius statistics
View logssudo vbng-cli show logs

Need Help?

If you need assistance with vBNG / BiSON BNG IPv6 configuration, please contact Onezeroart Support.

www.onezeroart.com