Domain auf datametric360.de umgestellt (war .app)

Alle Referenzen in Doku und Code aktualisiert (REVERSE_PROXY.md,
INTERNET_ZUGRIFF_EINRICHTEN.md, COMPANION_APP_ARCHITECTURE.md, AGENTS.md,
UMSETZUNGSPLAN.md, companion-app/src/api/umgebung.ts-Kommentar). Dabei den
.app-spezifischen HSTS-Preload-Hinweis in COMPANION_APP_ARCHITECTURE.md §5.4
korrigiert - gilt für .de nicht, Force-SSL in Nginx Proxy Manager deckt das
weiterhin ab. UMSETZUNGSPLAN.md Phase 12 zusätzlich mit einem
Aktualisierungshinweis versehen (zwei-Hostnamen-Plan und pyscript-Namen dort
waren ohnehin schon überholt, jetzt klar auf REVERSE_PROXY.md/
INTERNET_ZUGRIFF_EINRICHTEN.md als maßgeblich verwiesen).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-28 15:06:07 +02:00
parent 3ad1809af6
commit 137d32d28d
6 changed files with 65 additions and 53 deletions
+7 -7
View File
@@ -13,7 +13,7 @@ es hier keine Automatisierung, nur die genauen Schritte. Alles, was als Datei/Ko
werden konnte, ist bereits fertig (`REVERSE_PROXY.md`s Regeln).
**Voraussetzungen, die bereits erfüllt sind** (nichts davon ist hier noch zu tun):
- `datametric360.app` ist bei all-inkl registriert (siehe `../COMPANION_APP_ARCHITECTURE.md` §5 Punkt 4)
- `datametric360.de` ist bei all-inkl registriert (siehe `../COMPANION_APP_ARCHITECTURE.md` §5 Punkt 4)
- eigens dafür, ohne Webseite/Postfach darauf.
- Die companion-app spricht bereits ausschließlich REST/WebSocket gegen eine konfigurierbare
"Server-Adresse" (kein `hass`-Objekt, kein fest verdrahteter Hostname) - dieser Schritt ändert nur,
@@ -24,7 +24,7 @@ werden konnte, ist bereits fertig (`REVERSE_PROXY.md`s Regeln).
## 1. Cloudflare-Konto anlegen, Domain hinzufügen
1. Auf [cloudflare.com](https://cloudflare.com) ein (kostenloses) Konto anlegen.
2. Im Dashboard *Add a Site*`datametric360.app` eingeben.
2. Im Dashboard *Add a Site*`datametric360.de` eingeben.
3. Plan **Free** wählen - reicht vollständig aus (Tunnel und DNS sind im Free-Plan enthalten, nur das
"partial/CNAME setup" ohne Nameserver-Wechsel wäre Business-only, siehe Schritt 2).
4. Cloudflare scannt bestehende DNS-Einträge der Domain und schlägt zwei Nameserver vor (z. B.
@@ -35,7 +35,7 @@ werden konnte, ist bereits fertig (`REVERSE_PROXY.md`s Regeln).
**Das ist der eigentliche Knackpunkt** - erst danach kann der Tunnel überhaupt einen Hostnamen
veröffentlichen.
1. Bei all-inkl (KAS-Verwaltung) einloggen → *Domains*`datametric360.app` → Nameserver-Einstellungen.
1. Bei all-inkl (KAS-Verwaltung) einloggen → *Domains*`datametric360.de` → Nameserver-Einstellungen.
2. Von all-inkls eigenen Nameservern auf die beiden von Cloudflare vorgeschlagenen (Schritt 1.4)
umstellen - das ist ein **"Full setup"**: die komplette DNS-Verwaltung der Domain wandert zu
Cloudflare, nicht nur ein einzelner Eintrag. Das ist hier folgenlos, weil auf dieser Domain nichts
@@ -69,7 +69,7 @@ veröffentlichen.
2. Die Weboberfläche des Add-ons öffnen (Standard-Login beim ersten Start: `admin@example.com` /
`changeme` - **sofort ändern**, siehe Add-on-Dokumentation).
3. *Hosts → Proxy Hosts → Add Proxy Host*:
- **Domain Names:** `datametric360.app`
- **Domain Names:** `datametric360.de`
- **Forward Hostname/IP:** `homeassistant` (interner Name im Supervisor-Docker-Netz;
alternativ `localhost`/`homeassistant.local.hass.io`, je nach Add-on-Version - im Zweifel im
Add-on-Log nachsehen, mit welchem Namen sich `homeassistant:8123` von dort aus auflösen lässt)
@@ -89,9 +89,9 @@ veröffentlichen.
1. Zurück im Cloudflare-Dashboard: *Zero Trust → Networks → Tunnels* → den Tunnel aus Schritt 3 öffnen →
*Public Hostname**Add a public hostname*.
2. **Subdomain:** leer lassen (Apex-Domain `datametric360.app` selbst - kein Subdomain-Präfix, siehe
2. **Subdomain:** leer lassen (Apex-Domain `datametric360.de` selbst - kein Subdomain-Präfix, siehe
"Ein einziger Hostname genügt" in `REVERSE_PROXY.md`).
3. **Domain:** `datametric360.app`
3. **Domain:** `datametric360.de`
4. **Service Type:** `HTTPS` (nicht `HTTP` - Nginx Proxy Manager terminiert selbst wieder TLS).
5. **URL:** die interne Adresse des Nginx-Proxy-Manager-Add-ons, üblicherweise der Add-on-Hostname im
Supervisor-Netz plus dessen konfigurierten Port (im Add-on selbst unter *Info* nachsehen, welcher
@@ -111,7 +111,7 @@ das muss ins Leere laufen).
## 7. Server-Adresse in der App eintragen
Auf jedem Gerät, auf dem die companion-app sideload-installiert ist: beim (erneuten) Einrichten
`https://datametric360.app` als Server-Adresse eintragen, den bestehenden Zugriffstoken wiederverwenden
`https://datametric360.de` als Server-Adresse eintragen, den bestehenden Zugriffstoken wiederverwenden
oder einen neuen erzeugen. Ab hier funktionieren sowohl die normalen Datenabrufe als auch
Fern-OTA-Updates (`AGENTS.md`, Abschnitt zu `@capgo/capacitor-updater`) über denselben Weg - lokal im
Heimnetz weiterhin genauso wie zuvor, da HA selbst unverändert nur lokal erreichbar bleibt und die App
+5 -5
View File
@@ -137,7 +137,7 @@ location / {
```
**Ein einziger Hostname genügt.** Die frühere Überlegung, App und Schnittstelle auf zwei getrennte
Hostnamen zu legen (`datametric360.app` für die App, `api.datametric360.app` für die Schnittstelle),
Hostnamen zu legen (`datametric360.de` für die App, `api.datametric360.de` für die Schnittstelle),
stammte aus der Annahme, die App würde selbst als Web-Build unter einer eigenen Adresse ausgeliefert
(siehe Korrektur-Hinweis oben) - das entfällt mit der nativen Distribution ersatzlos. Es gibt nur noch
*eine* Adresse, die überhaupt gebraucht wird: die, die die App beim Einrichten als "Server-Adresse"
@@ -150,7 +150,7 @@ Von einem Netz ohne VPN, etwa über Mobilfunk (Hostnamen unten sind Platzhalter
Einrichtung tatsächlich gewählt wurde):
```bash
API=https://datametric360.app
API=https://datametric360.de
T=<Zugriffstoken>
# muss gehen
@@ -177,7 +177,7 @@ Zusätzlich: Port 8123 darf von außen **gar nicht** antworten.
Siehe [`INTERNET_ZUGRIFF_EINRICHTEN.md`](INTERNET_ZUGRIFF_EINRICHTEN.md) für den vollständigen,
geordneten Ablauf - kurz zusammengefasst bleibt vor der ersten echten Nutzung dieser Liste offen:
- Cloudflare-Konto anlegen, `datametric360.app`-Zone hinzufügen
- Nameserver von `datametric360.app` bei all-inkl auf Cloudflare umstellen („Full setup")
- Cloudflare-Konto anlegen, `datametric360.de`-Zone hinzufügen
- Nameserver von `datametric360.de` bei all-inkl auf Cloudflare umstellen („Full setup")
- Cloudflared- und Nginx-Proxy-Manager-Add-ons installieren, Tunnel + öffentlichen Hostnamen einrichten
- `https://datametric360.app` als Server-Adresse in der App eintragen (jedes Gerät, beim Einrichten)
- `https://datametric360.de` als Server-Adresse in der App eintragen (jedes Gerät, beim Einrichten)