Neu: PostScale -- E-Mail-API für transaktionale, eingehende und maskierte Adressen. PostScale

    CNAME-Einträge erklärt

    Verstehen Sie, wie CNAME-Einträge funktionieren, welche Einschränkungen sie haben und wann man sie einsetzt. Mit Beispielen für das DNScale-Dashboard und die API.

    Ein CNAME-Eintrag (Canonical Name) erstellt einen Alias von einem Domainnamen zu einem anderen. Anstatt auf eine IP-Adresse zu verweisen, zeigt ein CNAME auf einen anderen Domainnamen, der dann aufgelöst wird, um die endgültige IP-Adresse zu erhalten.

    Wie CNAME-Einträge funktionieren

    Wenn ein DNS-Resolver auf einen CNAME-Eintrag trifft, folgt er dem Alias, um die tatsächliche IP-Adresse zu finden:

    blog.example.com.    3600    CNAME    example.com.
    example.com.         3600    A        192.0.2.1

    Abfrageablauf:

    1. Der Client fragt nach blog.example.com
    2. DNS gibt einen CNAME zurück, der auf example.com verweist
    3. DNS löst dann example.com zu 192.0.2.1 auf
    4. Der Client verbindet sich mit 192.0.2.1

    Häufige Anwendungsfälle

    Subdomain-Aliase

    Mehrere Subdomains auf dasselbe Ziel verweisen:

    www.example.com.     3600    CNAME    example.com.
    blog.example.com.    3600    CNAME    example.com.
    shop.example.com.    3600    CNAME    example.com.

    CDN-Integration

    Ihre Domain auf einen CDN-Anbieter verweisen:

    www.example.com.    3600    CNAME    d1234.cloudfront.net.
    static.example.com. 3600    CNAME    example.b-cdn.net.

    Cloud-Service-Integration

    Subdomains auf Cloud-Plattformen verweisen:

    app.example.com.    3600    CNAME    myapp.herokuapp.com.
    docs.example.com.   3600    CNAME    example.gitbook.io.

    E-Mail-Service-Verifizierung

    Viele E-Mail-Dienste erfordern CNAME-Einträge:

    em1234.example.com. 3600    CNAME    u1234.wl.sendgrid.net.

    Eintragsformat

    FeldBeschreibungBeispiel
    NameZu aliasende Subdomainwww, blog, api
    TypEintragstypCNAME
    InhaltZiel-Domainnameexample.com.
    TTLTime to Live (Sekunden)3600

    Wichtige Einschränkungen

    1. Nicht an der Apex-/Root-Domain verwendbar

    CNAME-Einträge können nicht an der Root-Domain (Apex) verwendet werden:

    # Nicht erlaubt
    example.com.    CNAME    other.com.
     
    # Erlaubt
    www.example.com.    CNAME    other.com.

    Für Apex-Domains verwenden Sie stattdessen ALIAS-Einträge.

    2. Muss der einzige Eintrag an diesem Namen sein

    Ein CNAME kann nicht mit anderen Eintragstypen am selben Namen koexistieren:

    # Nicht erlaubt - Konflikt mit CNAME
    www.example.com.    CNAME    example.com.
    www.example.com.    TXT      "verification=abc123"
     
    # Erlaubt - CNAME ist der einzige Eintrag
    www.example.com.    CNAME    example.com.

    3. Fügt Lookup-Latenz hinzu

    Jeder CNAME führt eine zusätzliche DNS-Abfrage ein, was die Latenz erhöhen kann. Für leistungskritische Anwendungen sollten Sie A/AAAA-Einträge direkt verwenden.

    Einen CNAME-Eintrag hinzufügen

    Über das Dashboard

    1. Navigieren Sie zu Ihrer Zone im DNScale-Dashboard
    2. Klicken Sie auf Add Record
    3. Konfigurieren Sie den Eintrag:
      • Name: Geben Sie die Subdomain ein (z. B. www, blog)
      • Type: Wählen Sie CNAME
      • Value: Geben Sie den Ziel-Domainnamen ein
      • TTL: Setzen Sie die Cache-Dauer (Standard: 3600)
    4. Klicken Sie auf Create Record

    Über die API

    Einen CNAME-Eintrag erstellen:

    curl -X POST "https://api.dnscale.eu/v1/zones/{zone_id}/records" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "www",
        "type": "CNAME",
        "content": "example.com",
        "ttl": 3600
      }'

    Subdomain auf CDN verweisen:

    curl -X POST "https://api.dnscale.eu/v1/zones/{zone_id}/records" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "cdn",
        "type": "CNAME",
        "content": "d1234567.cloudfront.net",
        "ttl": 3600
      }'

    API-Antwort:

    {
      "status": "success",
      "data": {
        "message": "Record created successfully",
        "record": {
          "id": "encoded-record-id",
          "name": "www.example.com.",
          "type": "CNAME",
          "content": "example.com.",
          "ttl": 3600,
          "disabled": false
        }
      }
    }

    Best Practices

    1. Abschließende Punkte verwenden - Der Ziel-Domainname sollte technisch mit einem Punkt enden (z. B. example.com.), DNScale handhabt dies jedoch automatisch

    2. Auf Konflikte prüfen - Stellen Sie sicher, dass keine anderen Einträge am CNAME-Namen existieren

    3. TTL sorgfältig wählen - Verwenden Sie kürzere TTLs, wenn sich das Ziel ändern könnte (z. B. bei CDN-Migrationen)

    4. Nicht zu viele CNAMEs verketten - Obwohl DNS CNAME-Ketten erlaubt, erhöhen sie Latenz und Komplexität

    5. ALIAS für Apex verwenden - Wenn Sie CNAME-ähnliches Verhalten an der Root-Domain benötigen, verwenden Sie ALIAS-Einträge

    CNAME vs. ALIAS vs. A-Eintrag

    EigenschaftCNAMEALIASA
    Verweist aufDomainnameDomainnameIP-Adresse
    Funktioniert an ApexNeinJaJa
    Kann mit anderen Einträgen koexistierenNeinJaJa
    Zusätzliche DNS-AbfrageJaNein (wird am autoritativen Server aufgelöst)Nein

    CNAME-Einträge testen

    Überprüfen Sie Ihren CNAME-Eintrag mit dig:

    dig CNAME www.example.com
     
    # Der Kette folgen, um die endgültige IP zu erhalten
    dig +trace www.example.com

    Verwandte Eintragstypen

    • A - Direkte IPv4-Zuordnung
    • AAAA - Direkte IPv6-Zuordnung
    • ALIAS - CNAME-ähnliches Verhalten für Apex-Domains

    Fazit

    CNAME-Einträge sind unverzichtbar für die Vereinfachung der DNS-Verwaltung, besonders bei der Integration mit Drittanbieter-Diensten. Das Verständnis ihrer Einschränkungen — insbesondere bezüglich Apex-Domains und Eintrags-Koexistenz — hilft Ihnen, die richtige Wahl zwischen CNAME, ALIAS und direkten A/AAAA-Einträgen zu treffen.