Custom domeinen instellen

Setup en configuratie

Lees vóór elke stap Voordat u begint en Basisbeginselen van de terminal. Deze instructies gaan ervan uit dat je de volledige supastack monorepo in VS Code hebt geopend; zijn root package.json markeert de root van de repository. In pnpm-opdrachten is een werkruimtepakket een app of map met gedeelde code; in het product is een werkruimte de gegevenscontainer en de beveiligingsgrens van een team. corepack pnpm --filter ... selecteert één pakket uit de monorepo terwijl opdrachten vanuit de root worden uitgevoerd. Als u alleen een gesynchroniseerde mobiele map of desktopmap hebt geopend, bevat deze niet de webbackend, Docker-installatie of rootscripts: voer de backend uit vanaf deze monorepo of een bereikbare gehoste server en gebruik de eigen scripts van de platformmap. Een omgevingsvariabele is een benoemde instelling die is opgeslagen in een lokaal .env-bestand of op uw hostingdashboard; start de relevante app opnieuw nadat u deze hebt gewijzigd en houd servergeheimen buiten de NEXT_PUBLIC_- en EXPO_PUBLIC_-waarden.

1. Open apps/web/.env.local en gebruik CUSTOM_DOMAINS_PROVIDER=local om een voorbeeld van het scherm Domeinen te bekijken zonder DNS-wijzigingen.

2. Voor een echte klanthostnaam configureert u Cloudflare voor SaaS met uw eigen zone, een API-token beperkt tot die zone, en het CNAME-doel; voer de waarden voor alleen de server in op de webhost, niet in de browser.

3. Voer Web uit met corepack pnpm --filter @supastack/web dev en open Instellingen → Domeinen als eigenaar/beheerder van de werkruimte. Verwacht: de lokale adapter activeert onmiddellijk een testdomein; de Cloudflare-adapter wacht op de weergegeven DNS-records.

Stel CUSTOM_DOMAINS_PROVIDER=cloudflare in met CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID en CUSTOM_DOMAIN_CNAME_TARGET. Het API-token heeft SSL en Certificaten:Bewerkingsrechten nodig voor de zone (de aangepaste hostnamen API bevinden zich onder /zones/{zone_id}/custom_hostnames). Het CNAME-doel is een hostnaam in uw Cloudflare-zone (bijvoorbeeld customers.example.com) die wordt omgezet naar uw geïmplementeerde app.

Voeg een DNS-record toe in de zone die het CNAME-doel naar uw oorsprong verwijst (de fallback-oorsprong in Cloudflare voor SaaS-termen). Cloudflare geeft voor elke aangepaste hostnaam een ​​DCV TXT-record plus een optioneel eigendoms-TXT-record; het instellingenscherm laat klanten precies zien welke records ze moeten aanmaken.

Gebruik voor lokale ontwikkeling CUSTOM_DOMAINS_PROVIDER=local, waarmee elke hostnaam onmiddellijk actief wordt gemarkeerd bij doelklanten.localhost. CUSTOM_DOMAINS_PROVIDER=off (de standaardinstelling) verbergt de bedieningselementen van de sectie.

CUSTOM_DOMAINS_PROVIDER=cloudflare
CLOUDFLARE_API_TOKEN=cf_token_with_ssl_edit
CLOUDFLARE_ZONE_ID=zone_id
CUSTOM_DOMAIN_CNAME_TARGET=customers.example.com

Commando's om te kopiëren

Volg de opmerkingen om te zien in welke map een opdracht wordt uitgevoerd. Als twee terminals zijn gelabeld, opent u twee terminalvensters en laat u de eerste opdracht draaien terwijl u de tweede gebruikt.

corepack pnpm --filter @supastack/web dev

Implementatieworkflow

Eigenaren en beheerders van werkruimten beheren domeinen onder Instellingen → Domeinen (vijf per werkruimte). Klanten wijzen een CNAME-record voor hun hostnaam naar het CNAME-doel, voegen de TXT-records toe die worden weergegeven voor eigendoms- en certificaatvalidatie en drukken vervolgens op Status vernieuwen. Zodra Cloudflare de hostnaam actief rapporteert, wordt het een vertrouwde bron voor authentificatie op die implementatie en wordt de werkruimtenaam/het logo van de app chroom op die hostnaam.

Apex-(hoofd)domeinen kunnen bij de meeste DNS-providers geen CNAME's zijn. Klanten moeten een subdomein gebruiken, zoals portal.example.com, of een provider met CNAME-afvlakking. Cookies blijven beperkt tot elke host, dus een klantdomein is een afzonderlijke aanmelding; Single sign-on op aangepaste domeinen valt buiten het bereik.

Verificatie en probleemoplossing

Als Cloudflare in behandeling blijft, vergelijk dan de CNAME- en TXT-records van de klant met de exacte waarden die op de domeinkaart worden weergegeven en geef DNS de tijd om te updaten. Gebruik een subdomein wanneer de DNS-provider een hoofddomein CNAME niet kan afvlakken. Als het menu ontbreekt, controleer dan of de functie is ingeschakeld en of de aangemelde gebruiker eigenaar of beheerder van de werkruimte is.

Als dit lange tijd in behandeling is, betekent dit meestal dat de CNAME van de klant ontbreekt of nog steeds wordt verspreid. Controleer opnieuw de DNS-records die op de domeinkaart worden weergegeven. Een verplaatste of mislukte status betekent dat Cloudflare de hostnaam niet langer kan omzetten in de zone; verwijder het en voeg het opnieuw toe. Validatiegegevens worden opgeslagen als provider JSON, dus toekomstige Cloudflare-validatievormen hoeven geen schemawijziging te ondergaan.