Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,10 +137,13 @@ dass die eigene Veröffentlichung daran scheitern soll); interne Verweise prüft
und das schlägt sehr wohl fehl. lychee braucht `--root-dir`, sonst meldet es jeden wurzelrelativen
Pfad als Fehler.

Die Seite läuft unter `https://conspiratio.github.io/`. **Die Umstellung von `conspiratio.net` auf
Pages hat noch nicht stattgefunden** — Reihenfolge, DNS-Werte und Fallstricke stehen in
[`docs/umstellung-dns.md`](docs/umstellung-dns.md). Bis dahin melden CI-Läufe zwei Gruppen toter
Verweise, beide erwartet: `forum.conspiratio.net` (die Subdomain entsteht erst) und
`conspiratio.net/…` (kanonische Adressen, geprüft gegen die noch laufende alte Seite).
Die Seite läuft seit dem **12.09.2026 unter `https://conspiratio.net`**; `conspiratio.github.io`
zeigt dasselbe. Das Forum liegt seither unter `forum.conspiratio.net` (weiterhin bei Hostgator,
wie die Mail), und das Zertifikat von GitHub deckt Apex und `www` ab.

Der Ablauf der Umstellung samt der Stellen, an denen es anders kam als geplant, steht als
Protokoll in [`docs/umstellung-dns.md`](docs/umstellung-dns.md) — dort auch, worauf beim Messen
zu achten ist (Mod_Security weist Abrufe ohne browserartige Kopfzeilen ab, und das ausgelieferte
Zertifikat hängt an der SNI).

Entwurf und Plan des Neubaus liegen unter [`docs/superpowers/`](docs/superpowers/).
216 changes: 176 additions & 40 deletions docs/umstellung-dns.md
Original file line number Diff line number Diff line change
@@ -1,69 +1,205 @@
# Umstellung von conspiratio.net auf GitHub Pages

Diese Schritte kann nur ausführen, wer Zugriff auf die Domainverwaltung und auf die
Repo-Einstellungen hat. **Die Reihenfolge ist zwingend** — andernfalls ist das Forum
zwischen zwei Schritten nicht erreichbar.
> **Durchgeführt am 12.09.2026.** Die Seite wird seitdem von GitHub Pages ausgeliefert, das
> Forum läuft unter `forum.conspiratio.net`, die Mail unverändert bei Hostgator. Dieses
> Dokument bleibt als Protokoll stehen — es beschreibt den tatsächlichen Ablauf samt der
> Stellen, an denen es anders kam als geplant.

## Wo die Zone liegt

Die Domain ist bei **United-Domains** registriert, aber dort sind Hostgators Nameserver
eingetragen (`ns8353.hostgator.com`, `ns8354.hostgator.com`). Autoritativ ist damit Hostgator:
**Alle DNS-Einträge werden in cPanel unter „Domains → Zone Editor" geändert**, nicht bei
United-Domains. Dort steht nur die Registrierung und der Verweis auf diese Nameserver.

Das ist auch die risikoärmste Variante, weil MX, SPF und DKIM unangetastet an Ort und Stelle
bleiben und nur die A-Einträge angefasst werden.

### Bestand vor der Umstellung

| Typ | Name | Wert |
|---|---|---|
| A | `@` | `108.167.142.87` |
| CNAME | `www` | `conspiratio.net` |
| A | `mail` | `108.167.142.87` |
| MX | `@` | `0 mail.conspiratio.net` |
| TXT | `@` | `v=spf1 a mx include:websitewelcome.com ~all` |
| TXT | `default._domainkey` | DKIM-Schlüssel |

AAAA-Einträge gab es **keine** — IPv6 ist nicht in Gebrauch, und GitHub Pages ist über IPv4
vollständig erreichbar. Ein `_dmarc`-Eintrag fehlt ebenfalls; das ist unabhängig von dieser
Umstellung.

## 1. Forum auf eine eigene Subdomain

Beim DNS-Anbieter einen A-Record `forum.conspiratio.net` auf die bisherige Hostgator-IP
setzen und im Forum selbst die Basis-URL auf `https://forum.conspiratio.net/` umstellen.
**Reihenfolge beachten — hier ging es beim ersten Versuch schief:** Wer den A-Eintrag für
`forum` von Hand im Zone Editor anlegt, kann die Subdomain danach nicht mehr erstellen. cPanel
bricht ab mit

```
Error: (XID …) A DNS entry for "forum.conspiratio.net" already exists.
```

Richtig ist deshalb: **erst die Subdomain in cPanel anlegen, den DNS-Eintrag macht cPanel
selbst.** Steht dort schon einer, vorher im Zone Editor löschen.

In cPanel unter **Domains → Create A New Domain** (ältere Fassungen: **Subdomains**) `forum`
anlegen. Beim Dokumentenstamm aufpassen: Er muss auf den **vorhandenen** Forenordner zeigen —
hier `public_html/forum` —, nicht auf das von cPanel vorgeschlagene
`public_html/forum.conspiratio.net`.

**Eine Änderung am Dokumentenstamm wirkt nicht sofort.** Nach dem Speichern vergehen einige
Minuten, bis der vHost neu gebaut ist; bis dahin liefert die Subdomain weiterhin eine
Fehlerseite. Das ist kein Grund, an der Einstellung zu zweifeln — erst nach ein paar Minuten
erneut nachsehen.

Im Forum selbst (phpBB) umstellen:

- **ACP → Allgemein → Server-Einstellungen:** Domain-Name `forum.conspiratio.net`, Skript-Pfad
`/` (vorher `/forum`), Protokoll `https://`, Port 443, „Server-URL erzwingen" ein.
- **ACP → Allgemein → Cookie-Einstellungen:** Cookie-Domain auf `forum.conspiratio.net`. Ohne
das funktioniert die Anmeldung nicht. Alle Nutzer werden dabei einmal abgemeldet.
- Falls der Zugang zum ACP danach klemmt: Dieselben Werte stehen in der Tabelle `phpbb_config`
unter `server_name`, `script_path`, `server_protocol` und `cookie_domain` und lassen sich in
phpMyAdmin geradeziehen.

**Sobald „Server-URL erzwingen" gesetzt ist, ist das Forum unter der alten Adresse nicht mehr
bedienbar** — es leitet dann auf die Subdomain, und wenn die noch nicht steht, ist es
vorübergehend nirgends erreichbar. Diesen Schritt also erst machen, wenn die Subdomain
antwortet.

### Zertifikat für die Subdomain

AutoSSL war auf diesem Konto nicht verfügbar („because my server is not configured to support
it"). **Das war kein Hindernis:** Auf dem Konto lag bereits ein Wildcard-Zertifikat

Erst weitermachen, wenn das Forum über die neue Adresse erreichbar ist. Die neue Seite
verweist bereits ausschließlich dorthin.
```
CN = *.conspiratio.net Let's Encrypt
SAN: *.conspiratio.net, conspiratio.net
```

Solange die Subdomain fehlt, meldet der lychee-Schritt in CI sie zu Recht als nicht
erreichbar. Das ist erwartet und blockiert nichts (`fail: false`); nach diesem Schritt
verschwindet die Meldung von selbst.
Ein Wildcard deckt genau eine Ebene ab, also auch `forum.conspiratio.net`. Hostgators eigene
Automatik hat es dem neuen vHost von selbst zugewiesen, kurz nachdem er stand. Falls das einmal
nicht geschieht, lässt es sich unter **SSL/TLS → „Zertifikate installieren und verwalten"** von
Hand zuweisen („Autofill by Domain").

## 2. Neue Seite unter github.io abnehmen
> **Im Blick behalten:** Das Wildcard läuft alle 90 Tage ab. Dass es bisher erneuert wurde,
> spricht dafür, dass es weiterhin geschieht — ein Blick vor dem jeweiligen Ablaufdatum schadet
> nicht.

In `Settings → Pages → Build and deployment → Source` auf **„GitHub Actions"** stellen.
Nach dem nächsten Push auf `main` läuft der Workflow und veröffentlicht unter
## 2. E-Mail-Routing festnageln

In cPanel unter **E-Mail → E-Mail-Routing** ausdrücklich auf **„Local Mail Exchanger"** stellen.

Steht dort „Automatisch", entscheidet cPanel anhand des DNS, ob es Mail selbst zustellt. Sobald
der A-Eintrag des Apex auf GitHub zeigt, kann es auf „Remote Mail Exchanger" umspringen und die
lokale Zustellung einstellen — die Mail geht dann ins Nichts, obwohl der MX stimmt.

## 3. Neue Seite unter github.io abnehmen

In `Settings → Pages → Build and deployment → Source` auf **„GitHub Actions"** stellen. Nach dem
nächsten Push auf `main` läuft der Workflow und veröffentlicht unter
`https://conspiratio.github.io/`.

Dort abnehmen: alle zehn Seiten, in hell und dunkel, mit Zier- und Lesbarkeitsschrift,
in Telefonbreite und mit abgeschaltetem JavaScript.
Dort abnehmen: alle Seiten, in hell und dunkel, mit Zier- und Lesbarkeitsschrift, in
Telefonbreite und mit abgeschaltetem JavaScript.

## 4. TTL senken

## 3. Apex auf GitHub umstellen
Ein bis zwei Tage vor der Umstellung die TTL des A-Eintrags für `@` auf **300 Sekunden** setzen.
Dann ist eine Rücknahme in Minuten statt in Stunden wirksam. Nach der geglückten Umstellung
wieder auf den üblichen Wert erhöhen.

Beim DNS-Anbieter eintragen:
## 5. Apex auf GitHub umstellen

Im Zone Editor den A-Eintrag für `@` durch diese vier ersetzen:

| Typ | Name | Wert |
|---|---|---|
| A | `@` | `185.199.108.153` |
| A | `@` | `185.199.109.153` |
| A | `@` | `185.199.110.153` |
| A | `@` | `185.199.111.153` |
| AAAA | `@` | `2606:50c0:8000::153` |
| AAAA | `@` | `2606:50c0:8001::153` |
| AAAA | `@` | `2606:50c0:8002::153` |
| AAAA | `@` | `2606:50c0:8003::153` |
| CNAME | `www` | `conspiratio.github.io` |

Dann im Repo eine Datei `CNAME` mit dem einzigen Inhalt `conspiratio.net` anlegen und
pushen (oder in `Settings → Pages → Custom domain` eintragen, was dieselbe Datei erzeugt).
**Alle vier A-Einträge**, nicht einer — sie sind Ausfallsicherheit, kein Auswahlmenü. Der alte
Eintrag `108.167.142.87` wird dabei ersetzt, nicht ergänzt.

## 4. HTTPS erzwingen — erst danach
**`www` muss auf `conspiratio.github.io` zeigen, nicht auf den Apex.** Zeigt es auf
`conspiratio.net`, nimmt GitHub den Namen nicht mit ins Zertifikat, und `https://www…` wirft
eine Zertifikatswarnung — auch wenn die Seite selbst erreichbar ist.

GitHub stellt das Zertifikat selbst aus (Let's Encrypt). Das dauert bis zu 24 Stunden.
AAAA ist nicht nötig (siehe oben). Wer sie doch will: `2606:50c0:8000::153` bis
`2606:50c0:8003::153`.

**„Enforce HTTPS" erst anhaken, wenn GitHub das Zertifikat ausgestellt hat.** Vorher
gesetzt, ist die Seite in der Zwischenzeit nicht erreichbar.
**Nicht anfassen:** `MX`, den A-Eintrag für `mail` (der darf **nicht** mit umziehen), und das
DKIM-TXT. Sie stören sich nicht mit den A-Einträgen des Apex — das ist der Grund, warum der
Umzug der Webseite die Mail nicht berührt.

## 5. Nachkontrolle
## 6. Custom Domain und HTTPS

- `https://conspiratio.net` und `https://www.conspiratio.net` erreichbar, gültiges Zertifikat.
- `https://conspiratio.net/geschichte.html` landet auf `/spiel/` — ebenso die fünf anderen
alten Adressen (`download.html`, `bilder.html`, `ueber.html`, `links.html`, `kontakt.html`).
- `https://forum.conspiratio.net/` erreichbar.
- `https://conspiratio.net/feed.xml` liefert den Newsfeed.
In **Settings → Pages → Custom domain** `conspiratio.net` eintragen und speichern. Das genügt;
eine `CNAME`-Datei im Repo ist derselbe Schalter über einen zweiten Weg und nicht zusätzlich
nötig.

GitHub stellt das Zertifikat selbst aus (Let's Encrypt), in der Regel in unter 15 Minuten.
**„Enforce HTTPS" erst anhaken, wenn es steht.**

**Ändert sich danach etwas am DNS, zieht GitHub von selbst nach.** Im Pages-Reiter erscheint
dann „Detected a change to DNS settings. Requesting a new certificate." — in diesem Fall genügt
Warten; die Domain muss nicht gelöscht und neu eingetragen werden. So kam auch `www` ins
Zertifikat, nachdem der CNAME korrigiert war.

## Was danach entfällt
## 7. SPF nachziehen

Der Hostgator-Webspeicher wird nur noch vom Forum gebraucht. Bevor er ganz abgeschaltet
wird: **Die Installationsprogramme von 1.4.1 und 1.4.2 liegen ausschließlich dort**
(`/downloads/Conspiratio.1.4.1.0.msi` und `.1.4.2.0.msi`). Es gibt für beide kein
GitHub-Release. Wer sie erhalten will, lädt sie vorher herunter und legt sie als Release
im Repo `Conspiratio.WinForms` ab; danach können die Einträge in `_data/downloads.yml`
ihre `msi:`-Zeile bekommen und der Hinweis auf der Downloadseite entfallen.
Der Eintrag lautete:

```
v=spf1 a mx include:websitewelcome.com ~all
```

Das `a` bedeutet „der Server hinter dem A-Eintrag von conspiratio.net darf senden". Nach der
Umstellung zeigt dieser A-Eintrag auf GitHub — das `a` autorisiert also Webserver, die niemals
Mail versenden, und nicht mehr den Mailserver.

**Die Zustellung bricht dadurch nicht**, weil `mx` den tatsächlichen Absender weiterhin abdeckt
(`mail.conspiratio.net` zeigt auf dieselbe IP). Richtig ist danach trotzdem:

```
v=spf1 mx include:websitewelcome.com ~all
```

Nur das `a` streichen, sonst nichts.

## 8. Nachkontrolle

- `https://conspiratio.net` und `https://www.conspiratio.net` erreichbar, gültiges Zertifikat —
im Zertifikat müssen **beide** Namen stehen (`subjectAltName`).
- `https://conspiratio.net/geschichte.html` landet auf `/spiel/` — ebenso die fünf anderen alten
Adressen (`download.html`, `bilder.html`, `ueber.html`, `links.html`, `kontakt.html`).
- `https://conspiratio.net/forum/` leitet auf die Subdomain; ein Tiefenlink wie
`/forum/viewtopic.php?p=204` ebenfalls (über die 404-Seite).
- `https://forum.conspiratio.net/` zeigt **direkt** die Forenübersicht, nicht erst unter
`/forum/`. Anmeldung prüfen.
- `https://conspiratio.net/feed.xml` liefert den Newsfeed.
- **Eine Testmail an `mail@conspiratio.net` senden und eine von dort verschicken.**

## Beim Nachmessen zu beachten

- **Zwischenspeicher hinken hinterher.** Direkt nach der Umstellung liefern öffentliche
Auflöser und der eigene Rechner noch die alte Adresse — teils stundenlang. Autoritativ
nachsehen statt sich beirren zu lassen:
`nslookup -type=A conspiratio.net ns8353.hostgator.com`
- **Mod_Security weist nackte Abrufe ab.** `curl` ohne browserartige Kopfzeilen bekommt vom
Hostgator ein `406 Not Acceptable` oder eine Weiterleitung auf eine Fehlerseite. Zum Prüfen
`User-Agent`, `Accept` und `Accept-Language` mitschicken, sonst misst man den Schutzmechanismus
statt der Seite.
- **Das ausgelieferte Zertifikat hängt an der SNI.** Wer mit dem Browser oder `openssl` prüft,
muss den richtigen Namen mitschicken (`-servername www.conspiratio.net`), sonst sieht man ein
anderes Zertifikat als das, um das es geht.

## Was danach noch offen ist

Der Hostgator-Webspeicher wird nur noch vom Forum und von der Mail gebraucht. cPanel betrachtet
den A-Eintrag der Hauptdomain als „seinen" — nach größeren Kontoaktionen prüfen, ob er noch auf
GitHub zeigt.
Loading