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:
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user