▲ PromNET

SÚGÓ › Felhő tárhely

URL csere — Cloud-projekt domain-jének váltása utólag

A projekt-oldalon az "URL csere" gomb: default aldomain és saját-domain közti váltás 1 kattintással, SSL automatikus.

Egy meglévő Cloud-projekted URL-jét bármikor át tudod cserélni — vagy a default <slug>.promnet.cloud aldomain és egy saját domain (peldul.hu, blog.peldul.hu) között váltogathatsz. A folyamat 1 gomb a projekt-oldalán, és 1-2 másodperc.

1. Hol van a gomb?

A /app/cloud/<slug> oldalon, felül a “jelenlegi URL” mellett egy ceruza-ikonos “URL csere” gomb. Példa:

🌐 https://anna-portfolio.promnet.cloud  [✏ URL csere]

Kattintásra egy modal nyílik 3 opcióval:

  • csak a default aldomain — <slug>.promnet.cloud
  • saját domain (root) — pl. peldul.hu
  • saját domain + aldomain — pl. blog.peldul.hu

2. A 3 opció részletesen

a) Default aldomain (<slug>.promnet.cloud)

Az ingyenes, minden Cloud-projekttel jár. Ezt nem lehet megszüntetni — ha rajta vagy egy saját domainen, az aldomain ugyanúgy működik mellette.

Akkor jó, ha:

  • még nincs saját domain-ed
  • staging-environmentnek használod (production = saját domain)
  • a projekt-domain később dől el (most a kódra fókuszálsz)

b) Saját domain (root)

A teljes domain-ed (pl. peldul.hu) erre a projektre köti. Az aktív domain-jeid közül választasz egy dropdown-ban. Ha még nincs aktív domain-ed, először a /app/domains oldalon vásárolj / köss be egyet.

Akkor jó, ha:

  • ez az fő-projekted a domain-en
  • a meglévő peldul.hu weboldalt cseréled lecserélni
  • élesben akarod megmutatni a végfelhasználóknak

c) Saját domain + aldomain

Egy aldomain-en (pl. blog.peldul.hu) helyezi a projektet. A root-domain szabadon marad (másik projektre köthető vagy más céllal használható).

Akkor jó, ha:

  • a peldul.hu egy WordPress vagy más oldal, és csak a blog.peldul.hu-t szeretnéd a Cloud-projektre kötni
  • különálló oldalak (docs., app., shop.) közül egy a Cloud-on
  • tesztelési-aldomain (dev., staging.) a fejlesztéshez

3. Mi történik a “Mentés” gomb után?

sequenceDiagram
  participant U as User
  participant API as PromNET API
  participant CF as Cloudflare
  participant Pages as CF Pages

  U->>API: POST /api/cloud/<slug>/set-domain
  API->>CF: Új CNAME a saját domain-re
  CF-->>API: ok
  API->>Pages: Custom-domain hozzáadása a Pages-projekthez
  Pages-->>API: ok (SSL generálódik 1-3 perc)
  API-->>U: { ok: true, url: "https://blog.peldul.hu" }

A teljes folyamat 1-2 másodperc a Mentés-gomb után. A SSL-tanúsítvány viszont 1-3 perc alatt aktivál — addig a HTTPS 526-os hibát adhat.

4. URL-csere alatt nem áll le a régi

A régi URL ugyanúgy él a csere alatt. Pl. ha most az anna-portfolio.promnet.cloud-on volt a projekted, és átkapcsolod anna.hu-ra:

  • anna-portfolio.promnet.cloud → továbbra is működik (default aldomain marad)
  • anna.hu → új-jelölt URL, 1-2 mp után már él

Ha megszüntetnéd a default aldomainet, az nem lehetséges — de redirect-elhetsz egy _redirects vagy _headers fájllal:

# _redirects
https://anna-portfolio.promnet.cloud/* https://anna.hu/:splat 301

5. Domain-elhagyás (vissza default-ra)

Ha mégsem akarod a saját domain-en a projekt-et, válaszd a “csak default aldomain”-t. A saját domain-rekord (CNAME) eltávolítódik a CF-ről, a Pages-projekt-domain-listából is törlődik.

A saját domain NEM törlődik a /app/domains oldalon — csak az adott Cloud-projektről veszi le. Más projektre rákötheted, vagy hagyhatod feleslegesen lógni.

6. URL csere több projekt között

A root-domain (peldul.hu) egy időben egy projekthez tartozhat. Ha átkötnéd egy másikra:

  1. Régi projekten: URL csere → “csak default aldomain” → mentés (a domain felszabadul)
  2. Új projekten: URL csere → “saját domain (root)” → válaszd a peldul.hu-t
  3. Mentés (1-2 mp után az új projekten van a domain)

A két lépés között átállás-window ~30 másodperc — közben a domain 404-et adhat.

7. Endpoint-leírás

A modal a POST /api/cloud/[slug]/set-domain endpointot hívja. A payload:

{
  "mode": "default" | "custom-root" | "custom-sub",
  "domain_id": 42,        // mode != "default" esetén kötelező
  "subdomain": "blog"     // mode == "custom-sub" esetén kötelező
}

Válasz:

{
  "ok": true,
  "url": "https://blog.peldul.hu",
  "ssl_status": "pending"  // 1-3 perc múlva "active"
}

8. Mire NEM jó az URL csere?

  • A slug átnevezése — a <slug>.promnet.cloud slug-rész nem cserélhető ki ezzel; ahhoz support-ticket kell
  • DNS-config kézzel-állítás — a CF-tál minden automatikus, te csak a domain-t választod
  • HTTP-only-mode — minden URL automatikusan HTTPS-en megy, HTTP-only nincs

9. Hibák

“Domain nem aktív”: a választott domain pending státuszban a DNS-propagálás miatt. Várd meg az active-ra váltást, és próbáld újra.

“Aldomain már foglalt”: ugyanezen domain-en egy másik projekted a megadott aldomain-t használja. Válassz másikat, vagy szabadítsd fel.

“SSL még generálódik”: a kötés ment, de a HTTPS 526-os hibát adhat 1-3 percig. Várj és újra-tölts.

“Endpoint nem találja a projektet”: vagy a slug helytelen, vagy a projekt nem a tied. A /app/cloud-on ellenőrizd a projekt-listát.

10. Roadmap

  • Multi-aldomain egy projekten — pl. dev. + staging. + prod. ugyanarra a projektre
  • Wildcard-támogatás — *.peldul.hu az összes aldomain ugyanaz
  • A/B-domain-test — 50%-50% forgalom-megosztás két projekt között

Szavazz a /roadmap oldalon!

← Felhő tárhely Frissítve: 2026. 05. 08.