Özel alan adlarını kurun

Kurulum ve yapılandırma

Herhangi bir adımdan önce, Başlamadan önce ve Terminal temelleri bölümlerini okuyun. Bu talimatlar, supastack monorepo'nun tamamını VS Kodunda açtığınızı varsayar; kök package.json dosyası depo kökünü işaretler. pnpm komutlarında çalışma alanı paketi bir uygulama veya paylaşılan kod klasörüdür; Üründe çalışma alanı, ekibin veri taşıyıcısı ve güvenlik sınırıdır. corepack pnpm --filter ... komutlar kökünden çalıştırılırken monorepodan bir paket seçer. Yalnızca senkronize edilmiş bir mobil veya masaüstü klasörü açtıysanız, Web arka ucunu, Docker kurulumunu veya kök komut dosyalarını içermez: arka ucu bu monorepodan veya erişilebilir bir barındırılan sunucudan çalıştırın ve platform klasörünün kendi komut dosyalarını kullanın. Ortam değişkeni, yerel bir .env dosyasında veya barındırma kontrol panelinizde depolanan adlandırılmış bir ayardır; İlgili uygulamayı değiştirdikten sonra yeniden başlatın ve sunucu sırlarını NEXT_PUBLIC_ ve EXPO_PUBLIC_ değerlerinin dışında tutun.

1. apps/web/.env.local'yi açın ve DNS değişiklikleri olmadan Etki Alanları ekranını önizlemek için CUSTOM_DOMAINS_PROVIDER=local'yi kullanın.

2. Gerçek bir müşteri ana bilgisayar adı için, SaaS için Cloudflare'i kendi bölgenizle, o bölgeyle sınırlı bir API belirteciyle ve CNAME hedefiyle yapılandırın; yalnızca sunucuya ait değerleri tarayıcıya değil, Web ana bilgisayarına girin.

3. Web'i corepack pnpm --filter @supastack/web dev ile çalıştırın ve çalışma alanı sahibi/yönetici olarak Ayarlar → Etki Alanları'nı açın. Beklenen: Yerel bağdaştırıcının bir test etki alanını hemen etkinleştirmesi; Cloudflare adaptörü görüntülenen DNS kayıtlarını bekler.

CUSTOM_DOMAINS_PROVIDER=cloudflare'yi CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID ve CUSTOM_DOMAIN_CNAME_TARGET ile ayarlayın. API belirtecinin bölgede SSL ve Sertifikalar: Düzenleme iznine ihtiyacı vardır (Özel Ana Bilgisayar Adları API, /zones/{zone_id}/custom_hostnames altında bulunur). CNAME hedefi, Cloudflare bölgenizdeki, dağıtılan uygulamanıza çözümlenen bir ana bilgisayar adıdır (örneğin, customer.example.com).

Bölgeye CNAME hedefini kaynağınıza (SaaS terimleri için Cloudflare'deki geri dönüş kaynağı) işaret eden bir DNS kaydı ekleyin. Cloudflare, her özel ana bilgisayar adına bir DCV TXT kaydı artı isteğe bağlı bir sahiplik TXT kaydı verir; ayarlar ekranı müşterilere tam olarak hangi kayıtların oluşturulacağını gösterir.

Yerel geliştirme için, her ana bilgisayar adının hedef müşterilerle anında etkin olduğunu işaretleyen CUSTOM_DOMAINS_PROVIDER=local'yi kullanın.localhost. CUSTOM_DOMAINS_PROVIDER=off (varsayılan) bölümün kontrollerini gizler.

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

Kopyalanacak komutlar

Bir komutun hangi klasörde çalıştığını görmek için yorumları takip edin. İki terminal etiketlenmişse, iki terminal penceresi açın ve ikincisini kullanırken ilk komutu çalışır durumda tutun.

corepack pnpm --filter @supastack/web dev

Uygulama iş akışı

Çalışma alanı sahipleri ve yöneticileri, alanları Ayarlar → Etki Alanları (çalışma alanı başına beş) altında yönetir. Müşteriler, ana bilgisayar adları için CNAME hedefine bir CNAME kaydını işaret eder, sahiplik ve sertifika doğrulaması için gösterilen TXT kayıtlarını ekler ve ardından Durumu yenile'ye basar. Cloudflare, ana bilgisayar adının etkin olduğunu bildirdikten sonra, söz konusu dağıtımda kimlik doğrulama için güvenilir bir kaynak haline gelir ve çalışma alanı adı/logosu, söz konusu ana bilgisayar adı üzerindeki uygulama kromunu markalar.

Apex (kök) alanları çoğu DNS sağlayıcısında CNAME olamaz; müşteriler portal.example.com gibi bir alt alan adı veya CNAME düzleştirmeye sahip bir sağlayıcı kullanmalıdır. Çerezler her ana makine için kapsam dahilinde kalır; dolayısıyla müşteri alanı ayrı bir oturum açma işlemidir; Özel etki alanlarında tek oturum açma kapsam dışındadır.

Doğrulama ve sorun giderme

Cloudflare beklemede kalırsa müşterinin CNAME ve TXT kayıtlarını etki alanı kartında gösterilen tam değerlerle karşılaştırın ve DNS'nin güncellenmesi için zaman tanıyın. DNS sağlayıcısı CNAME kök etki alanını düzleştiremediğinde bir alt etki alanı kullanın. Menü yoksa özelliğin etkin olduğundan ve oturum açan kullanıcının çalışma alanı sahibi veya yöneticisi olduğundan emin olun.

Uzun süre beklemede kalması genellikle müşterinin CNAME'sinin eksik olduğu veya hala yayıldığı anlamına gelir; alan adı kartında gösterilen DNS kayıtlarını yeniden kontrol edin. Taşındı veya başarısız oldu durumu, Cloudflare'in artık ana bilgisayar adını bölgeye çözümleyemeyeceği anlamına gelir; kaldırıp tekrar ekleyin. Doğrulama verileri sağlayıcı JSON olarak depolandığından gelecekteki Cloudflare doğrulama şekillerinin şema değişikliğine ihtiyacı yoktur.