Conceitos

Clientes e serviços

O roteador conhece dois tipos de assinante.

Serviços são o modelo atual. Um serviço é um cliente, uma ONT, uma velocidade, um endereço fixo e um id permanente (svc_xxxxxxxx). O seu sistema de cobrança o cria com uma chamada. O roteador registra a ONT na OLT e configura tudo do seu próprio lado. Nenhum endereço MAC é necessário em momento algum: se o cliente trocar o roteador da casa, o serviço continua funcionando com o mesmo endereço.

Clientes são o modelo mais antigo, baseado em MAC. Um cliente é um endereço MAC com um IP fixo em uma VLAN que você criou. O listener MK-api, compatível com MikroTik, trabalha com clientes. Os clientes continuam totalmente suportados para as redes que precisam deles.

	Serviço	Cliente
Identificado por	ONT (porta e id da ONT, via Option 82)	endereço MAC
Criado com	`dtvsol service add`, `POST /services`	`dtvsol clients add`, MK-api
VLAN	uma por porta PON, criada para você	uma que você cria
Velocidade aplicada por	a OLT (CAR)	o roteador (tc HTB)
Suspensão	a ONT é desativada na OLT e o endereço é bloqueado	o endereço é bloqueado no roteador

Uma VLAN por porta PON

Cada roteador tem a sua própria S-VLAN em cada OLT. Dentro dela, cada porta PON tem a sua própria C-VLAN:

C-VLAN = 100 + card × 16 + pon

A porta 0/1/0 (placa 1, PON 0) é a VLAN 116. A porta 0/0/3 é a VLAN 103.

Cada porta PON recebe o seu próprio /24 do pool IPv4 dos serviços (svc_ipv4_pool em /opt/dtvsol/etc/config.php), e o seu próprio /64 quando o IPv6 está configurado:

port network = pool + (C-VLAN − 100) × 256      VLAN 100 → 100.64.0.0/24
gateway      = .1                               VLAN 116 → 100.64.16.0/24
ONT address  = .2 + ONT id                      ONT 7    → 100.64.16.9

No roteador, a interface da porta se chama v<svlan>.<cvlan>, por exemplo v1000.116. Você nunca aloca VLANs ou endereços à mão: eles decorrem da OLT, da placa, da porta e do id da ONT.

Os roteadores de várias operadoras podem compartilhar uma OLT. Cada roteador tem a sua própria S-VLAN nela.

Option 82

Quando uma ONT pede um endereço, a OLT acrescenta a DHCP Option 82 à requisição: de qual porta e de qual ONT ela veio. O roteador entrega o endereço fixo da ONT somente a uma requisição cuja Option 82 identifique essa ONT. É por isso que um serviço não precisa de endereço MAC.

Veja o que o roteador recebe:

dtvsol option82

Blocos de portas do CGNAT

Os assinantes geralmente têm endereços privados (por exemplo de 100.64.0.0/10). O CGNAT os envia para fora através de um pequeno pool de endereços públicos.

O CGNAT do roteador é determinístico. Cada endereço público é dividido em blocos de portas fixos (2048 portas cada, por padrão, das portas 1024–65535). Cada assinante recebe um bloco em um endereço público e o mantém. Cada atribuição e liberação é gravada em /opt/dtvsol/log/cgnat-mappings.log.

Assim, não há log por conexão a guardar. Para responder “quem usou o XXX.XXX.XXX.70 porta 40000 naquele momento”, consulte o bloco:

dtvsol cgnat lookup XXX.XXX.XXX.70 40000

Veja CGNAT.

Configuração salva e versões

Toda a configuração fica em um único arquivo SQLite, /opt/dtvsol/data/dtvsol.db. Clientes, serviços, VLANs, OLTs, planos, a rede e o resto são documentos dentro dele. Cada alteração é uma transação.

Como na flash de um switch, você pode manter versões:

dtvsol config save "before the new OLT"
dtvsol config versions
dtvsol config diff 12 running
dtvsol config restore 12 --yes

O backup diário salva uma versão sozinho quando a configuração mudou. Os documentos nunca são editados à mão: use dtvsol config edit <name>, que verifica o JSON e guarda uma versão antes. Veja Backup e restauração.

O rollback de 120 segundos

Uma alteração na rede do próprio roteador (portas, bonds, endereços neles, a rota padrão) pode deixar você sem acesso. Por isso ela é aplicada com uma rede de segurança:

É feito backup dos arquivos do netplan e uma versão da configuração é salva.
O novo arquivo é verificado com netplan generate e depois aplicado.
Você tem 120 segundos para confirmar. Sem confirmação, a rede antiga é restaurada.

Uma alteração que tiraria o endereço usado pela sua sessão SSH, pela API ou pelo monitor é recusada antes de qualquer coisa ser executada.

dtvsol netcfg apply
dtvsol netcfg confirm      # keep it
dtvsol netcfg rollback     # or put the old one back now

A página Settings → Interfaces do monitor funciona da mesma forma. Veja Alterações de rede.

Este site foi escrito com a ajuda de IA e revisado pela nossa equipe.