▲ PromNET

SÚGÓ › Domain

Saját domain bekötése Cloud-projektre — wizard-ben és utólag

A varázslón belül vagy utólag a projekt-oldalon: saját domain (root vagy aldomain) bekötése egy Cloud-projektre 1 kattintással.

Egy Cloud-projekt alapértelmezetten a <slug>.promnet.cloud aldomain-en érhető el. Ha saját domain-ed van (pl. peldul.hu vagy blog.peldul.hu), két ponton kötheted rá:

Mindkét eset ugyanazt az /api/cloud/[slug]/set-domain end-pointot hívja, és pillanatok alatt aktívvá teszi a saját domain-en a projektedet.

1. Előfeltétel — a domain legyen aktív

Ahhoz, hogy egy domain bekötési-választ tudjunk ajánlani, a domain-nek aktív státuszban kell lennie a /app/domains oldalon.

Hogyan kerül oda?

  • PromNET-en regisztrált domain (.com / .net / .dev / .io / .app): azonnal active, semmi extra teendő
  • mhosting.hu-ról áthozott .hu: amikor a két DNS-szervert átírtad, 24 órán belül active-ra vált (CF DNS-ellenőrzés)
  • Külső registrátortól áthozott: nameserver-átállás után active

Részletek: HU domain bekötése és DNS-rekordok.

2. Wizard-en belül — 4. lépés

A varázsló utolsó lépésén egy dropdown-ban válogathatsz az aktív domain-jeid közül:

  • csak default aldomain — <slug>.promnet.cloud (ingyenes)
  • peldul.hu (root) — a teljes domain a projektre megy
  • peldul.hu + aldomain — pl. blog.peldul.hu egy szöveg-mezőben adod meg az aldomain-részt

A “Létrehozás” gomb után a saját domain-bekötés automatikusan megtörténik. Részletek a Cloud projekt-varázsló súgóban.

3. Utólag — “URL csere” gomb a projekt-oldalon

Ha már létezik a projekt és most akarsz saját domain-t kötni rá:

  1. Menj a projekt-oldalára: /app/cloud/<slug>
  2. A felső sávon megnézed a jelenlegi URL-t (pl. anna-portfolio.promnet.cloud)
  3. A jelenlegi URL melletti “URL csere” gomb (kis ceruza-ikon)
  4. Modal: ugyanaz a 3-opciós választó, mint a varázslóban
  5. Kiválasztod, “Mentés” gomb

Mi történik:

POST /api/cloud/<slug>/set-domain
Content-Type: application/json

{ "mode": "custom-root", "domain_id": 42 }
// vagy "custom-sub" + "subdomain": "blog"
// vagy "default" (visszavált aldomain-re)

A response { ok: true, url: "https://blog.peldul.hu" } 1-2 másodperc alatt megjön. A projektet azonnal a saját domain-en is eléred.

4. Mi történik a háttérben?

  1. DNS-rekord — a saját domain-edhez (vagy aldomain-hez) egy CNAME íródik a CF-en, amely a <slug>.pages.dev projekt-szerverre mutat
  2. Pages-projekt domain-rögzítés — a CF Pages API-n a <slug>.pages.dev projekthez hozzáadjuk a custom-domain-t
  3. Universal SSL — a CF automatikusan generál egy Let’s Encrypt-tanúsítványt; 1-3 perc alatt aktívvá válik
  4. Default aldomain marad — a <slug>.promnet.cloud továbbra is működik, nem kapcsoljuk le. Mindkettőt használhatod párhuzamosan, vagy 301-redirect-elhetsz egyikre

Tipp: Ha csak a saját domain-t akarod használni (és az aldomain-re redirect-eljen), a projekt index.html-ébe rakhatsz egy <meta http-equiv="refresh">-et, vagy a _headers fájlban használhatsz CF-redirect-szabályt.

5. Aldomain (subdomain) választás

Ha aldomain-t (blog.peldul.hu) kötsz, a subdomain mező csak az első részt kéri: blog. Ne add meg a teljes nevet! A varázsló / modal automatikusan felfűzi a root-domain-t.

Tipikus aldomain-ek:

  • blog — blog-projekt
  • docs — dokumentációs projekt
  • app — webalkalmazás (külön a marketing-oldaltól)
  • shop — webshop
  • dev — fejlesztői/staging-verzió

Egy domain-en több aldomain is mehet különböző projektekre — csak más-más Cloud-projektre kötöd őket.

6. Több projekt egy domain-re?

A root-domain (peldul.hu) egy Cloud-projekthez tartozhat egyszerre. Ha másik projektre akarod cserélni:

  1. Menj a régi projekt URL csere-modaljába → “Vissza default aldomainre”
  2. Mentés (a saját domain felszabadul)
  3. Az új projekt-oldalon kötöd be ugyanazt

A folyamat 30 másodperc — átállás közben pár pillanatra 404 jelenhet meg.

7. Hibák és figyelmeztetések

“A domain nem aktív”: a kiválasztott domain pending vagy error státuszban. Várd meg a DNS-propagálást vagy ellenőrizd a nameserver-eket.

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

“SSL még generálódik”: a kötés ment, de a HTTPS 1-3 percig 526-os SSL-hibát adhat — ez normális. Vár néhány percet, és újra próbálkozz.

“Domain nem hozzád tartozik”: a beazonosító ellenőrzés szerint nem te birtoklod ezt a domain-t. Kontextus: a CF-zóna account-ja egyezik-e a PromNET-account-oddal?

8. SSL-hibák

A 99%-ban automatikusan rendeződik az 1-3. perc-en belül. Ha mégsem, a részletes ellenőrzést és cleanup-folyamatot ld. SSL hibaelhárítás.

9. Domain-eltávolítás

A “URL csere” modal “Vissza default aldomainre” opcióval a saját domain levalik a projektről, de a domain-rekord a /app/domains-on megmarad — más projektre is rákötheted.

A teljes domain-törléshez (regisztrátor-szinten is) a Domains-oldalra kell menned.

← Domain Frissítve: 2026. 05. 08.