Skip to content
5 Min. Lesezeit Aktualisiert

WireGuard-VPN auf MikroTik automatisiert: Role-based Peers via Terraform

WireGuard-VPN auf MikroTik per Terraform: feste Peer-IPs pro Gerät und rollenbasierter Zugriff, damit das Handy nicht dasselbe erreicht wie der Admin-Laptop.


Update (Mai 2026): Dieses WireGuard-Setup habe ich am 20.05.2026 abgeschaltet. Remote-Zugriff läuft seitdem über Headscale mit OIDC über Authelia (englischer Artikel). Die Terraform-Muster unten funktionieren auf RouterOS 7 weiterhin, laufen bei mir aber nicht mehr.

WireGuard ist inzwischen der Standard für Remote-Access-VPNs: schnell, einfach und mit moderner Kryptografie. Dieses Setup läuft auf einem MikroTik RB5009, auf dem RouterOS 7 WireGuard nativ beherrscht, ganz ohne zusätzlichen Container. Die einfache Einrichtung verleitet allerdings zu schlampiger Sicherheit, etwa jedem verbundenen Gerät vollen Zugriff aufs gesamte interne Netz zu geben.

In einer sicheren Umgebung, ob Unternehmensnetz oder Homelab, sollte ein Handy, das ein Dashboard abruft, nicht dieselben Netzwerkrechte haben wie ein Admin-Laptop, der Infrastruktur deployt.

Dieser Artikel automatisiert ein WireGuard-„Roadwarrior”-Setup auf MikroTik RouterOS mit Terraform und setzt rollenbasierten Zugriff über Firewall-Filter durch.

View the complete MikroTik IaC source code on GitHub

1. Die VPN-Topologie festlegen

🇬🇧 English: Die englische Fassung dieses Artikels: Automating MikroTik WireGuard VPN with Role-Based Access via Terraform →.

Am Anfang stehen das VPN-Subnetz, der Listen-Port und die festen IPs für jeden Peer (jedes Gerät). In Terraform-locals liegt das alles an einer Stelle, und IP-Konflikte fallen später gar nicht erst an.

locals {
  vpn_config = {
    subnet = "10.6.0.0/24"
    port   = 51820
    name   = "wg-roadwarrior"
  }

  vpn_handy_ip  = "10.6.0.2/32"
  vpn_laptop_ip = "10.6.0.3/32"
}

2. Das WireGuard-Interface anlegen

Mit dem terraform-routeros-Provider brauchen WireGuard-Interface und Gateway-IP des Routers im VPN-Subnetz genau zwei Ressourcen.

# Create the WireGuard Interface
resource "routeros_wireguard" "wg_vpn" {
  name        = local.vpn_config.name
  listen_port = local.vpn_config.port
  comment     = "Remote Access VPN"
}

# Assign the Gateway IP to the Router
resource "routeros_ip_address" "wg_ip" {
  interface = routeros_wireguard.wg_vpn.name
  # Uses cidrhost to automatically calculate the first IP (.1)
  address   = "${cidrhost(local.vpn_config.subnet, 1)}/24"
}

cidrhost() berechnet die .1-Adresse aus dem Subnetz in den locals, es gibt also keine Adresse, bei der man sich vertippen kann. Wer den Bereich 10.6.0.0/24 von Hand wählt, prüft ihn vorher im IPv4-Subnetzrechner auf Überschneidungen. Ein VPN-Bereich, der sich mit einem LAN-Bereich überlappt, fällt oft erst Wochen später als kaputte Route auf.

3. Die Peers (Geräte) anlegen

Als Nächstes kommen die Public Keys der Geräte auf den Router. WireGuard arbeitet mit Cryptokey Routing: Über das Feld allowed_address entscheidet der Router, zu welchem Peer eine IP gehört, und verwirft Pakete eines Peers, deren Quell-IP nicht in dessen Liste steht.

Weil jede /32-Adresse fest an einen Key gebunden ist, hat jedes Gerät eine feste Identität, auf die sich die Firewall-Regeln später verlassen können.

resource "routeros_wireguard_peer" "handy_dw" {
  interface            = routeros_wireguard.wg_vpn.name
  comment              = "Smartphone DW - Limited Access"
  public_key           = "X9iI0RGNf7kTxdBOs4CsDcOQtKRFMYALY/ugHv67uAo="
  allowed_address      = [local.vpn_handy_ip]
  persistent_keepalive = "25s"
}

resource "routeros_wireguard_peer" "laptop_dw" {
  interface            = routeros_wireguard.wg_vpn.name
  comment              = "Laptop DW - Full Admin Access"
  public_key           = "zD+/yfLfjQ7N1H5NBIwa2zKNd/bLZ6VRdEbKBxCmOVA="
  allowed_address      = [local.vpn_laptop_ip]
  persistent_keepalive = "25s"
}

4. Rollenbasierten Zugriff durchsetzen (die Firewall)

Das VPN steht, aber ohne Firewall-Regeln kommt der Verkehr nirgendwo an, vorausgesetzt, es gibt eine strikte Default-Deny-Firewall wie in meinem Artikel zur Zero-Trust-Firewall auf MikroTik.

Die Forward-Chain legt fest, was jedes Gerät erreichen darf.

Der Admin-Laptop (voller Zugriff)

Der Laptop ist ein vertrauenswürdiges Admin-Gerät. Er bekommt den gesamten Block 10.0.0.0/16: Server, Management-Interfaces und die DMZ.

resource "routeros_ip_firewall_filter" "fwd_06_vpn_laptop" {
  action       = "accept"
  chain        = "forward"
  src_address  = local.vpn_laptop_ip
  dst_address  = "10.0.0.0/16"
  place_before = routeros_ip_firewall_filter.fwd_99_drop_all.id
  comment      = "06: VPN - Laptop Full Access"
  
  lifecycle {
    ignore_changes = [src_address]
  }
}

Das Handy (Split-Tunnel, eingeschränkter Zugriff)

Handys sind das größere Risiko. Sie hängen in öffentlichen WLANs und gehen verloren. Das Handy darf deshalb nur in bestimmte Service-Subnetze: das Server-Netz vlan20 und den DMZ-Proxy. Auf das Proxmox-Management-VLAN und interne Infrastruktur-Backends hat es keinen Zugriff.

resource "routeros_ip_firewall_filter" "fwd_07_vpn_handy_srv" {
  action       = "accept"
  chain        = "forward"
  src_address  = local.vpn_handy_ip
  dst_address  = "10.0.20.0/24"
  place_before = routeros_ip_firewall_filter.fwd_99_drop_all.id
  comment      = "07: VPN - Mobile limited to internal services"
}

resource "routeros_ip_firewall_filter" "fwd_08_vpn_handy_dmz" {
  action       = "accept"
  chain        = "forward"
  src_address  = local.vpn_handy_ip
  dst_address  = "10.0.30.0/24"
  place_before = routeros_ip_firewall_filter.fwd_99_drop_all.id
  comment      = "08: VPN - Mobile access to DMZ (External Proxy)"
}

place_before setzt diese Regeln oberhalb der abschließenden „Drop All”-Regel ein, die die Chain verankert.

5. Die Input-Chain nicht vergessen

Damit das VPN überhaupt eine Verbindung aufbauen kann, muss der Listen-Port auf dem WAN-Interface des Routers offen sein. Diese Regel gehört in die input-Chain, weil der Handshake am Router selbst endet.

resource "routeros_ip_firewall_filter" "in_02_wg" {
  action       = "accept"
  chain        = "input"
  protocol     = "udp"
  dst_port     = local.vpn_config.port
  in_interface = "ether1"
  place_before = routeros_ip_firewall_filter.drop_all_input.id
  comment      = "IN-02: WireGuard handshake"
}

Identität als Adresse

Das statische Cryptokey Routing von WireGuard bindet jeden Geräte-Key an eine feste IP-Adresse. Liegt diese Zuordnung in Terraform, stehen Identität und Firewall-Policy im selben geprüften Code, und die Zero-Trust-Regeln bleiben strikt, lesbar und in Git dokumentiert.

Kryptografische Identität an Netzwerkzugriff zu koppeln ist dasselbe Prinzip wie bei Azure Private Link und Managed Identity, nur eine Schicht höher.

War das hilfreich?
Teilen
DW

David Woitzik

Hybrid Cloud Engineer

Ich arbeite vor allem mit Azure, Terraform und Zero-Trust-Netzwerkdesign und veröffentliche die Terraform-Vorlagen und Artikel, die ich selbst gern gehabt hätte, als ich vor denselben Problemen stand.

Weiterlesen

Mehr davon in deinem Postfach

Neue Terraform-Module und Artikel per E-Mail. Kein Spam.