For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /dns/dns-update.md.
  • Svenska
  • Ändra poster via DNS UPDATE

    Du kan skapa, ändra och ta bort poster i din zon programmatiskt med standardprotokollet DNS UPDATE (RFC 2136). Ändringarna signeras med en TSIG-nyckel som bara gäller din zon. Det fungerar med nsupdate, Terraform/OpenTofu, ACME-klienter och de flesta automationsverktyg.

    I exemplen nedan heter zonen example.se och nyckeln example-dnsupdate. Byt till dina egna värden.

    Steg 1: Beställ en nyckel

    Skicka ett ärende i portalen och skriv vilken zon nyckeln ska gälla. Vi skapar nyckeln och lägger till den på din domän. Det görs manuellt av oss just nu. Vi arbetar på att du ska kunna hantera nycklarna själv i portalen.

    Du får tre uppgifter:

    UppgiftExempel
    Nyckelns namnexample-dnsupdate
    Algoritmhmac-sha512
    Hemligheten base64-sträng
    Hemligheten är ett lösenord

    Den som har hemligheten kan ändra alla poster i din zon. Lägg den inte i ett git-repo i klartext, och skicka den inte vidare i mejl. Tror du att den har läckt, kontakta oss så byter vi den direkt.

    Steg 2: Spara nyckeln

    De flesta verktyg läser nyckeln i BIND-format. Spara den i en fil, till exempel example.se.key:

    key "example-dnsupdate" {
      algorithm hmac-sha512;
      secret "<hemligheten>";
    };

    Se till att bara du kan läsa filen:

    chmod 600 example.se.key

    Anslutningsuppgifter

    InställningVärde
    Serverns1.getgeek.se (IPv4 och IPv6)
    Port53, UDP och TCP
    Zondin domän, t.ex. example.se
    Nyckelnamnet du fått, t.ex. example-dnsupdate
    Algoritmhmac-sha512

    Skicka alltid ändringarna till ns1.getgeek.se. De andra namnservrarna tar inte emot DNS UPDATE.

    nsupdate

    nsupdate ingår i BIND-verktygen: paketet bind9-dnsutils på Debian och Ubuntu, bind-utils på Rocky, Alma och Fedora, och bind i Homebrew.

    Lägg till en post:

    nsupdate -k example.se.key <<EOF
    server ns1.getgeek.se
    zone example.se
    update add www.example.se. 3600 A 192.0.2.10
    send
    EOF

    Ändra en post. Ta bort den gamla och lägg till den nya i samma anrop, så genomförs antingen båda eller ingen av dem:

    nsupdate -k example.se.key <<EOF
    server ns1.getgeek.se
    zone example.se
    update delete www.example.se. A
    update add www.example.se. 3600 A 192.0.2.20
    send
    EOF

    Ta bort en post:

    nsupdate -k example.se.key <<EOF
    server ns1.getgeek.se
    zone example.se
    update delete www.example.se. AAAA
    send
    EOF

    update delete <namn> <typ> tar bort alla poster av den typen på namnet. Vill du bara ta bort en av flera, ange värdet också: update delete www.example.se. A 192.0.2.10.

    Inget svar betyder att ändringen gick igenom. Kontrollera den med dig:

    dig +short www.example.se A @ns1.getgeek.se

    Det kan ta upp till några minuter innan dig visar ändringen, även mot ns1.getgeek.se. Själva ändringen är redan sparad, men namnservrarna kan fortfarande svara ur sin cache.

    Terraform och OpenTofu

    Använd providern hashicorp/dns. Nyckelns namn och zonen skrivs med punkt på slutet:

    terraform {
      required_providers {
        dns = {
          source = "hashicorp/dns"
        }
      }
    }
    
    variable "tsig_secret" {
      type      = string
      sensitive = true
    }
    
    provider "dns" {
      update {
        server        = "ns1.getgeek.se"
        key_name      = "example-dnsupdate."
        key_algorithm = "hmac-sha512"
        key_secret    = var.tsig_secret
      }
    }
    
    resource "dns_a_record_set" "www" {
      zone      = "example.se."
      name      = "www"
      addresses = ["192.0.2.10"]
      ttl       = 3600
    }

    Ge hemligheten via miljövariabeln TF_VAR_tsig_secret i stället för att skriva den i en fil i repot.

    dns_a_record_set äger alla A-poster på namnet. Finns det redan A-poster på www som inte står i addresses tar Terraform bort dem, och terraform destroy tar bort alla A-poster på namnet.

    Certifikat med DNS-01

    ACME-klienter med stöd för RFC 2136 kan skapa _acme-challenge-posten själva. Med lego (version 5) kan du använda nyckelfilen från steg 2 direkt:

    DNSUPDATE_NAMESERVER=ns1.getgeek.se \
    DNSUPDATE_TSIG_FILE=example.se.key \
    lego run -m du@example.se --dns dnsupdate -d example.se -d '*.example.se'

    I lego 4 heter providern rfc2136 och variablerna börjar med RFC2136_.

    acme.sh (dns_nsupdate), certbot (certbot-dns-rfc2136) och cert-manager (rfc2136) fungerar på samma sätt, med uppgifterna under Anslutningsuppgifter.

    Verktyg som behöver läsa hela zonen

    Vissa verktyg, till exempel external-dns i Kubernetes, hämtar hela zonen (zonöverföring, AXFR) för att se vilka poster som finns. Det är inte påslaget från början. Skriv i ärendet att du vill ha det, så ger vi din nyckel läsrätt till zonen.

    Hur snabbt syns ändringen?

    Ändringen syns oftast på alla våra namnservrar inom en minut, ibland efter några minuter. Resolvrar som redan har cachat det gamla svaret visar det tills postens TTL har gått ut. Sänk TTL:en i förväg om du planerar en flytt.

    Felsökning

    SvarTrolig orsak
    update failed: REFUSEDAnropet var inte signerat, nyckeln gäller inte den här zonen, eller ändringen skickades till en annan server än ns1.getgeek.se.
    TSIG error with server: expected a TSIG or SIG(0) följt av REFUSEDServern godkände inte signaturen: fel hemlighet, fel algoritm eller fel nyckelnamn. Det kan också bero på att klockan på din dator går fel, eftersom TSIG kräver att den går rätt på några minuter när.
    update failed: NXDOMAIN eller YXDOMAINEtt villkor (prereq) i anropet var inte uppfyllt. Ingenting ändrades.
    Communication with … failed: timed outUtgående trafik på port 53 blockeras, oftast av en brandvägg i ditt nät.

    Hjälper inget av det, skicka ett ärende med kommandot du körde (utan hemligheten) och hela svaret.