← Semua tutorial

TUTORIAL 8 / 12

Toko-tokomu. Domainmu. Satu instalasi.

Gunakan domain checkout berbeda untuk toko-tokomu sambil mempertahankan satu instalasi Wholly Crypto.

Yang akan kamu miliki

Domain aktif yang divalidasi, tautan khusus toko, dan rencana aman untuk mengganti nama host lama.

1. Rencanakan alamat

Setiap domain dasar memiliki tiga peran: Konsol untuk timmu, Checkout untuk pelanggan, dan API Publik untuk integrasi. Nama bawaan adalah merchant, pay, dan api; kamu dapat memilih yang lain dan menambahkan alias.

PeranDomain pertamaDomain kedua
Konsolmerchant.example.companel.example.org
Checkoutpay.example.compayment.example.org
API Publikapi.example.comapi.example.org

Kedua domain mengarah ke instalasi yang sama. Keduanya tidak membuat dompet, data, atau izin akses terpisah. Domain pilihan toko mengendalikan tautan yang dibuat; bukan isolasi tenant.

2. Tambahkan domain atau kelola alias

Buka Pengaturan → Sistem → Domain. Gunakan Tambahkan domain di atas Domain aktif untuk domain dasar baru seperti example.org. Gunakan Kelola pada entri yang ada untuk menambahkan alias atau mengubah alamat utama.

Misalnya, pertahankan merchant dan panel sebagai nama konsol. Nama pertama, ditandai bintang, adalah nama utama untuk peran itu. Pilih domain dasar utama untuk tautan bawaan seluruh sistem.

Nama domain dasar aktif tidak diganti langsung; tambahkan domain pengganti. Draf menunjukkan Menunggu aktivasi dan belum aktif. Pilih Lanjutkan ke DNS untuk menyimpan dan meninjau.

3. Arahkan DNS ke VPS-mu

Tambahkan record A untuk setiap nama host baru, yang menunjuk ke IPv4 VPS yang ditampilkan panel. Tambahkan AAAA hanya ketika alamat IPv6 itu benar-benar menjangkau server. Hapus record usang; Wholly Crypto tidak menyunting DNS untukmu.

Biarkan koneksi masuk TCP 80 dan 443 terbuka di firewall server dan penyedia. Pertahankan akses SSH-mu. Klik Periksa DNS. Ini memeriksa pasangan host/peran baru atau yang diubah terhadap DNS otoritatif; alamat aktif yang tidak berubah digunakan kembali.

Menggunakan Cloudflare?

Untuk instalasi pertama, biarkan proxy nonaktif sampai penyiapan selesai. Setelahnya kamu dapat memakai DNS langsung atau melalui proxy tanpa beralih mode di Wholly Crypto. Let’s Encrypt tetap di VPS.

Gunakan Full (strict) ↗. Pastikan challenge sertifikat HTTP dapat dijangkau dan lewati cache serta challenge browser/bot untuk permintaan konsol, checkout, dan API. Wholly Crypto juga harus dapat memverifikasi origin.

Pemeriksaan otoritatif melewati cache alamat VPS/ISP biasa. Pengunjung mungkin masih memiliki DNS lama dalam cache, dan perubahan nameserver dapat memerlukan waktu lebih lama.

4. Tinjau, lalu terbitkan

Domain → DNS & peninjauan → Aktivasi

Menyimpan draf atau lulus pemeriksaan DNS tidak mengubah rute aktif.

Tinjau penambahan, penghapusan, dan perubahan alamat utama, lalu pilih Lanjutkan ke aktivasi → Validasi SSL & terbitkan. Penyuntingan atau pemeriksaan DNS yang berusia lebih dari sepuluh menit memerlukan pemeriksaan lagi.

Alamat baru diperiksa untuk challenge sertifikat, HTTPS, dan layanan yang benar. Pasangan host/peran aktif yang tidak berubah tidak mengulang pemeriksaan jaringan tersebut, tetapi konfigurasi Nginx lengkap tetap divalidasi.

Tunggu keberhasilan dan kembali ke Domain aktif. Buka setiap nama host baru dan periksa perannya. Jika gagal, baca laporan deployment dan status rollback sebelum mencoba lagi; jangan hapus domain yang berfungsi untuk memaksa aktivasi.

5. Pilih domain untuk setiap toko

Buka Proyek → Toko → pilih toko → Dasar → Domain toko. Pilih host merchant, checkout, dan API aktif untuk toko tersebut. Alamat tertunda tidak dapat dipilih.

Tautan yang dibuat memakai pilihan toko → toko default proyek → pengaturan bawaan sistem. Misalnya, links.checkout API invoice dapat memakai payment.example.org untuk satu toko sementara toko lain tetap memakai pay.example.com.

Konfigurasikan origin API SDK dan plugin toko secara terpisah; mengubah preferensi toko tidak menulis ulang pengaturan integrasimu. Percobaan ulang IPN/webhook bertanda tangan yang masih tersimpan mempertahankan tautan aslinya. Bookmark dan tautan pelanggan yang ada tidak ditulis ulang.

Alias konsol tetap memerlukan Basic Auth dan login aplikasi. Di Pengaturan → Sistem → Pembatasan IP sumber, aturan berlaku untuk setiap nama host secara terpisah. Biarkan checkout pelanggan terbuka kecuali kamu sengaja menjalankan checkout privat.

6. Ganti alamat lama dalam dua tahap

  1. Tambahkan dan terbitkan pengganti selagi nama host lama masih berfungsi.
  2. Buka alamat konsol baru dan masuk. Uji akses checkout dan API melalui penggantinya.
  3. Perbarui preferensi toko, integrasi, bookmark, dan tautan yang diterbitkan. Pertahankan alias pay/API lama selama pelanggan atau klien masih menggunakannya.
  4. Dari alamat konsol baru, kelola domain atau alias lama dan siapkan penghapusannya. Tinjau dan terbitkan perubahan sebelum menghapus record DNS-nya.

Panel mencegah penghapusan nama host konsol yang sedang kamu gunakan. Host yang dihentikan ditolak, bukan dialihkan secara otomatis. Perubahan yang hanya menyangkut alamat utama atau penghapusan tetap memerlukan peninjauan dan penerbitan, meskipun tidak perlu pencarian DNS baru.

Referensi domain · Pemecahan masalah HTTPS