TYPO3 Multi-Domain-Setup: Eine Basis-Installation für mehrere Webseiten meistern

Einleitung 

Sie stehen vor einer Herausforderung, die viele Unternehmen kennen: Mehrere digitale Präsenzen – von der Haupt-Website über Produktseiten bis hin zu Event-Microsites – sollen zentral verwaltet werden. Die gute Nachricht: Mit TYPO3 ist genau das nicht nur möglich, sondern auch extrem effizient.

Ein Multi-Domain-Setup mit TYPO3 bedeutet: Eine Installation, unbegrenzte Möglichkeiten. Sie sparen Hosting-Kosten, reduzieren Wartungsaufwand und behalten die volle Kontrolle über Ihre digitale Infrastruktur.

In diesem Guide begleiten wir eine HTTP-Anfrage auf ihrer Journey durch das System – von der Browser-Eingabe bis zur finalen Content-Auslieferung. Sie verstehen nicht nur wie die Konfiguration funktioniert, sondern vor allem warum.

Inhaltsverzeichnis 

• Einleitung
• Teil 1: Die Anatomie einer URL – Was Ihr Browser wirklich sendet
• Teil 2: DNS – Das globale Adressbuch des Internets
• Teil 3: Apache Virtual Host – Der intelligente Traffic-Director
• Teil 4: TYPO3 Site Management – Die Content-Engine
• Teil 5: Die komplette Request Journey – End-to-End
• Fazit: Ihre digitale Infrastruktur – skalierbar und zukunftssicher

Teil 1: Die Anatomie einer URL – Was Ihr Browser wirklich sendet 

Bevor wir Server konfigurieren, müssen wir die Sprache des Webs verstehen. Jede Web-Anfrage beginnt mit einer URL – schauen wir uns an, was wirklich in der Adresszeile passiert.

URL-Komponenten im Detail 

Nehmen wir eine komplexe URL auseinander:

https://user:pass@myserver.at/folder1/folder2/datei.html#absatz3

Die Request Journey im Überblick 

Bevor wir in die Details gehen, hier der Gesamtprozess auf einen Blick:

Schauen wir uns jede Phase im Detail an.

Teil 2: DNS – Das globale Adressbuch des Internets 

DNS (Domain Name System) ist das Fundament jeder Web-Kommunikation. Browser verstehen nur IP-Adressen – DNS übersetzt menschenlesbare Domainnamen in maschinenlesbare IPs.

A-Record vs. CNAME-Record: Die entscheidende Wahl 

Für Multi-Domain-Setups gibt es zwei DNS-Record-Typen. Die Wahl hat massive Auswirkungen auf Performance und Funktionalität:

DNS-Konfiguration: Die praktische Umsetzung 

Für unser Multi-Domain-Setup mit firma-a.de und projekt-b.com benötigen Sie folgende DNS-Einträge:

; Hauptdomains
firma-a.de.           IN  A    123.45.67.89
www.firma-a.de.       IN  A    123.45.67.89
projekt-b.com.        IN  A    123.45.67.89
www.projekt-b.com.    IN  A    123.45.67.89

; E-Mail-Records funktionieren parallel
firma-a.de.           IN  MX   10 mail.firma-a.de.
projekt-b.com.        IN  MX   10 mail.projekt-b.com.

DNS-Propagierung verstehen 

DNS-Änderungen sind nicht sofort weltweit sichtbar. Hier ist, was passiert:

Propagierung testen

Nutzen Sie Tools wie DNS Checker, Google Admin Toolbox Dig oder das CLI-Tool dig, um die globale DNS-Propagierung zu überprüfen:

Web-basierte Tools:

Das Google Admin Toolbox Dig Tool ermöglicht DNS-Lookups direkt im Browser – ideal für schnelle Checks ohne Terminal-Zugriff.

---

CLI-Tool:

Bash

dig firma-a.de +short
# Output: 123.45.67.89

Teil 3: Apache Virtual Host – Der intelligente Traffic-Director 

DNS hat die IP-Adresse geliefert – jetzt empfängt Apache die HTTP-Anfrage. Seine Aufgabe: Anfragen für hunderte möglicher Domains an die richtigen Verzeichnisse routen.

Virtual Hosts: Ein Server, viele Websites 

Stellen Sie sich Apache als Empfangshalle eines Bürogebäudes vor. Die IP-Adresse ist die Hausadresse. Der Host-Header in jedem HTTP-Request ist wie der Firmenname auf einem Briefumschlag. Apache schaut in seiner Konfiguration nach und leitet den Request an das richtige "Büro" (DocumentRoot).

Name-Based Virtual Hosts: Die Konfiguration 

Name-based Virtual Hosts ermöglichen mehrere Websites auf einer IP-Adresse – unterschieden nur durch den Domainnamen im HTTP-Header.

<VirtualHost *:80>
  # DocumentRoot: Der zentrale Einstiegspunkt für alle Domains
  # Alle Anfragen landen hier, unabhängig von der aufgerufenen Domain
  DocumentRoot /var/www/typo3

  # ServerName: Die primäre Domain dieses Virtual Hosts
  # Apache nutzt diese, wenn keine andere Domain passt
  ServerName www.firma-a.de

  # ServerAlias: Alle weiteren Domains, die ebenfalls hier landen
  # Durch Leerzeichen getrennte Liste aller zusätzlichen Domains
  ServerAlias firma-a.de www.projekt-b.com projekt-b.com

  # Logging für Debugging und Monitoring
  ErrorLog ${APACHE_LOG_DIR}/typo3_error.log

Multi-Domain mit separaten DocumentRoots 

Manchmal möchten Sie unterschiedliche TYPO3-Installationen pro Domain. Hier die erweiterte Konfiguration:

# Virtual Host 1: Firma A
<VirtualHost *:443>
  DocumentRoot /var/www/firma-a
  ServerName www.firma-a.de
  ServerAlias firma-a.de
  
  <Directory /var/www/firma-a>
      Options FollowSymLinks
      AllowOverride All
      Require all granted
  </Directory>
</VirtualHost>

# Virtual Host 2: Projekt B
<VirtualHost *:443>

Teil 4: TYPO3 Site Management – Die Content-Engine 

Apache hat den Request weitergeleitet – jetzt übernimmt TYPO3. Das CMS muss entscheiden: Welche Webseite soll für diese spezifische Domain ausgeliefert werden?

Das Fundament: Der TYPO3-Seitenbaum 

TYPO3 verwaltet alle Inhalte in einem hierarchischen Seitenbaum (Page Tree). Für jede unabhängige Website benötigen Sie eine Root Page (Wurzel-Seite).

Site Management Modul: Die moderne Konfiguration 

Seit TYPO3 v9 ersetzt das Site Management Modul komplexe TypoScript-Konfigurationen. Es definiert Entry Points – die Verknüpfung zwischen Domain und Root Page.

Die config.yaml im Detail 

Jede Site-Konfiguration wird als YAML-Datei gespeichert. Hier die Struktur für unsere Firma A:

# typo3conf/sites/firma_a/config.yaml
rootPageId: 1
base: 'https://www.firma-a.de/'

# Sprach-Konfiguration
languages:
-
  title: Deutsch
  enabled: true
  languageId: 0
  base: /
  typo3Language: de
  locale: de_DE.UTF-8
  iso-639-1: de
  navigationTitle: Deutsch

TYPO3 Request-Matching: Der Algorithmus 

So entscheidet TYPO3, welche Site für eine Anfrage zuständig ist:

Wichtig: TYPO3 prüft base UND baseVariants. Die erste passende Konfiguration gewinnt. Bei mehreren Matches hat die alphabetisch erste config.yaml Vorrang.

Teil 5: Die komplette Request Journey – End-to-End 

Verfolgen wir nun eine vollständige Anfrage für www.projekt-b.com durch alle Schichten:

Request-Details: Die HTTP-Header 

Was sendet der Browser wirklich? Schauen wir uns die tatsächlichen HTTP-Header an:

GET / HTTP/1.1
Host: www.projekt-b.com
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: de-DE,de;q=0.9,en;q=0.8
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Upgrade-Insecure-Requests: 1

Troubleshooting: Häufige Fehler 

Fazit: Ihre digitale Infrastruktur – skalierbar und zukunftssicher 

Sie haben die vollständige Architektur eines TYPO3 Multi-Domain-Setups gemeistert. Von der DNS-Ebene über den Apache Virtual Host bis zur TYPO3 Site-Konfiguration – Sie verstehen jetzt, wie die einzelnen Komponenten nahtlos ineinandergreifen.

Was Sie erreicht haben 

Die drei Ebenen im Überblick 

Ihre nächsten Schritte 

Best Practices für den Produktivbetrieb 

Support & Weiterführende Ressourcen 

Offizielle Dokumentation:

• TYPO3 Site Handling Documentation
• Apache Virtual Host Documentation
• Let's Encrypt Certbot Guide

Tools:

• DNS Checker – Globale DNS-Propagierung prüfen
• SSL Labs – SSL-Konfiguration testen
• GTmetrix – Performance-Analyse