Správa routera: panel VyManager alebo API

VyManager – grafický panel

Najjednoduchší spôsob správy routera je grafický panel VyManager . Otvorte ho tlačidlom Open VyManager na stránke routera – prihlásite sa automaticky, žiadne samostatné heslo nie je potrebné.

Všetko sa nastavuje myšou:

• Firewall – pravidlá, skupiny a zásady filtrovania prevádzky.
• VPN (WireGuard) – spustenie tunela a pripojenie vašich zariadení.
• NAT a presmerovanie portov – sprístupnenie služieb navonok.
• DHCP – rozsahy adries prideľované vo vašich sieťach.
• Smerovanie – statické trasy a tiež BGP a OSPF pre zložité topológie.
• Sieťové rozhrania routera.

Panel pokrýva každodenné úlohy bez príkazového riadka. Na všetko ostatné a na automatizáciu je tu API – poskytuje prístup k ľubovoľnému nastaveniu VyOS bez obmedzení.

Správa cez API

Router sa konfiguruje cez HTTPS API – praktické na automatizáciu aj jednorazové úlohy. Nižšie sú hotové príklady (curl) pre bežné scenáre.

Čo budete potrebovať

• Adresu routera – jeho verejnú IP (stránka routera, pole Public IP).
• Váš API kľúč – stránka routera, blok Router Information, pole API Key (tlačidlo Copy).

V príkladoch nižšie: <ROUTER-IP> je vaša verejná IP, <API-KEY> je váš kľúč.

Ako funguje požiadavka

Každá zmena má dva kroky:

1. Apply – POST na /configure so sadou príkazov (aplikujú sa atomicky).
2. Save – POST na /config-file, inak sa zmeny pri reštarte routera stratia (pozri „Uloženie zmien“ nižšie).

Konfiguráciu môžete kedykoľvek prečítať – POST na /retrieve. Prepínač -k v curl akceptuje certifikát routera podpísaný samým sebou.

1. Čítanie konfigurácie

curl -k -X POST "https://<ROUTER-IP>/retrieve" \
  --form 'data={"op":"showConfig","path":[]}' \
  --form 'key=<API-KEY>'

Ak chcete zobraziť len časť, zadajte cestu, napríklad NAT: "path":["nat"], rozhrania: "path":["interfaces"].

2. Presmerovanie portu na interný server (DNAT)

Presmerujte port verejnej IP routera na server vo vašej privátnej sieti. Príklad: externý port 8080 → server 10.0.0.50:80, len z vašej IP 203.0.113.5.

curl -k -X POST "https://<ROUTER-IP>/configure" --form 'key=<API-KEY>' --form 'data=[
  {"op":"set","path":["nat","destination","rule","1000","description"],"value":"web-to-10.0.0.50"},
  {"op":"set","path":["nat","destination","rule","1000","inbound-interface","name"],"value":"eth0"},
  {"op":"set","path":["nat","destination","rule","1000","protocol"],"value":"tcp"},
  {"op":"set","path":["nat","destination","rule","1000","destination","port"],"value":"8080"},
  {"op":"set","path":["nat","destination","rule","1000","source","address"],"value":"203.0.113.5"},
  {"op":"set","path":["nat","destination","rule","1000","translation","address"],"value":"10.0.0.50"},
  {"op":"set","path":["nat","destination","rule","1000","translation","port"],"value":"80"}
]'

Potom uložte (pozri „Uloženie zmien“ nižšie). Používajte čísla pravidiel od 1000 vyššie , aby nekolidovali s automatickými. Pole source.address obmedzuje prístup na vašu IP; odstráňte ho, ak má byť port otvorený pre všetkých.

3. Pravidlo firewallu

Príklad: zablokovať TCP port 23 k vašim serverom a zvyšok prevádzky ponechať otvorený.

curl -k -X POST "https://<ROUTER-IP>/configure" --form 'key=<API-KEY>' --form 'data=[
  {"op":"set","path":["firewall","ipv4","forward","filter","default-action"],"value":"accept"},
  {"op":"set","path":["firewall","ipv4","forward","filter","rule","100","action"],"value":"drop"},
  {"op":"set","path":["firewall","ipv4","forward","filter","rule","100","protocol"],"value":"tcp"},
  {"op":"set","path":["firewall","ipv4","forward","filter","rule","100","destination","port"],"value":"23"}
]'

Riadok default-action: accept je dôležitý – zabezpečuje, že všetka ostatná prevádzka funguje a blokuje sa len nastavené pravidlo. Firewall možno nastaviť aj myšou v paneli VyManager.

4. WireGuard VPN

Najjednoduchší je panel VyManager – má vstavané nastavenie WireGuard a kľúče vygeneruje za vás. Cez API je nastavenie viackrokové: vygenerujte kľúče na routeri, potom definujte rozhranie a protistranu (peer). Štruktúra príkazov:

set interfaces wireguard wg0 address '10.10.0.1/24'
set interfaces wireguard wg0 port '51820'
set interfaces wireguard wg0 peer my-laptop public-key '<your device's public key>'
set interfaces wireguard wg0 peer my-laptop allowed-ips '10.10.0.2/32'

Generovanie kľúčov routera a kompletný návod nájdete v dokumentácii VyOS (sekcia WireGuard).

5. Rozsah DHCP v sieti

Názov vašej siete je viditeľný v konfigurácii (pozri „Čítanie konfigurácie“ vyššie) v tvare LAN-eth1, LAN-eth2. Príklad – prideľovať adresy z rozsahu 10.0.0.100-10.0.0.200:

curl -k -X POST "https://<ROUTER-IP>/configure" --form 'key=<API-KEY>' --form 'data=[
  {"op":"set","path":["service","dhcp-server","shared-network-name","LAN-eth1","subnet","10.0.0.0/24","range","0","start"],"value":"10.0.0.100"},
  {"op":"set","path":["service","dhcp-server","shared-network-name","LAN-eth1","subnet","10.0.0.0/24","range","0","stop"],"value":"10.0.0.200"}
]'

6. Uloženie zmien

Po každom /configure:

curl -k -X POST "https://<ROUTER-IP>/config-file" \
  --form 'data={"op":"save"}' \
  --form 'key=<API-KEY>'

7. Zrušenie pravidla

Vymažte ho celé (napríklad presmerovanie portu zo sekcie 2) a znova uložte:

curl -k -X POST "https://<ROUTER-IP>/configure" \
  --form 'data={"op":"delete","path":["nat","destination","rule","1000"]}' \
  --form 'key=<API-KEY>'

Kompletná referencia

Všetky príkazy VyOS s príkladmi pre každú funkciu nájdete v oficiálnej dokumentácii: docs.vyos.io.