ตั้งค่า Custom Domains

ภาพรวมคัดลอกลิงก์หัวข้อ

โดยค่าเริ่มต้น แอป Stardeck ที่เผยแพร่แล้วทุกแอปเข้าถึงได้ที่ app-slug.stardeck.site โดย app-slug คือตัวระบุเฉพาะของแอปคุณ

โดเมนของคุณเอง (custom domain) ให้คุณโฮสต์แอป Stardeck บนชื่อโดเมนของคุณเอง (เช่น www.your-site.com) แทน subdomain เริ่มต้น app-slug.stardeck.site คู่มือนี้พาคุณทำตามทุกขั้นตอนของการตั้งค่า custom domain

Custom domain ของแอปผูกกับโฮสต์หลักของแอป (root Surface) ปัจจุบันยังไม่มีตัวเลือก custom domain แยกรายต่อ Surface — Surface อื่นๆ ใช้ URL ของ Surface ที่ Stardeck สร้างให้หลัง deploy ไป production

ก่อนเริ่มคัดลอกลิงก์หัวข้อ

ก่อนตั้งค่า custom domain คุณต้องมี:

1. แอปที่เผยแพร่แล้ว - แอปของคุณต้อง deploy และทำงานอยู่บน Stardeck
2. สิทธิ์เข้าถึงการตั้งค่า DNS ของโดเมน - คุณต้องแก้ไข DNS record
3. สิทธิ์ admin ขององค์กร - Custom domain จัดการที่ระดับองค์กร
4. แพ็กเกจที่รองรับ custom domain - ทุกแพ็กเกจในปัจจุบันรองรับ ส่วนแพ็กเกจรุ่นเก่าที่ไม่รองรับ Add New Domain จะแสดงประกาศ Upgrade Required แทนฟอร์ม

ขั้นที่ 1: เพิ่มโดเมนในองค์กรของคุณคัดลอกลิงก์หัวข้อ

ขั้นแรก เพิ่มโดเมนของคุณเข้าในรายการโดเมนที่ใช้ได้ขององค์กร:

1. ไปที่การตั้งค่าองค์กร

   • ไปที่ Dashboard ของคุณ
   • เปิด Settings ในแถบด้านข้าง
   • เลือกแท็บ Domains

2. เพิ่มโดเมนของคุณ

   • ในส่วน Add New Domain กรอกชื่อโดเมน
   • กรอกเฉพาะโดเมน (เช่น example.com) - Stardeck จะเติมคำนำหน้า www. ให้อัตโนมัติ
   • คลิก Add Domain

ซื้อโดเมนแทน (ไม่บังคับ)คัดลอกลิงก์หัวข้อ

หากยังไม่มีโดเมน แท็บ Domains มีส่วน Buy a Domain โดเมนที่ซื้อที่นี่จะมีป้าย Managed และ Stardeck จะตั้ง DNS record ให้คุณ ข้ามขั้นที่ 2 และขั้นที่ 3 ได้เลย เปิด Auto-Renew จากปุ่ม Settings ของโดเมนเพื่อให้ต่ออายุก่อนหมดอายุ

ขั้นที่ 2: ตั้งค่า DNS recordคัดลอกลิงก์หัวข้อ

หลังเพิ่มโดเมน คุณจะเห็นคำแนะนำการตั้งค่า DNS ให้เพิ่ม record เหล่านี้ที่ผู้ให้บริการ DNS ของคุณ เพื่อยืนยันความเป็นเจ้าของและเปิดใช้ SSL ปุ่ม Copy all ในแถวของโดเมนจะคัดลอกทุก record ในครั้งเดียว (โดเมนที่ซื้อผ่าน Stardeck จะมีปุ่ม DNS แทน ซึ่งคุณเพิ่ม แก้ไข และลบ record ได้)

การยืนยันโดเมนและ SSL (TXT record)คัดลอกลิงก์หัวข้อ

คุณต้องเพิ่ม TXT record สองรายการ เพื่อยืนยัน:

การยืนยันความเป็นเจ้าของโดเมน:

• Record Type: TXT
• Name/Host: (Stardeck ให้มา ขึ้นต้นด้วย _cf-custom-hostname เช่น _cf-custom-hostname.www)
• Value: (token ยืนยันเฉพาะที่ Stardeck ให้มา)

การยืนยันใบรับรอง SSL:

• Record Type: TXT
• Name/Host: (Stardeck ให้มาสำหรับการยืนยัน SSL)
• Value: (token ยืนยัน SSL เฉพาะที่ Stardeck ให้มา)

การส่งต่อทราฟฟิก (CNAME record)คัดลอกลิงก์หัวข้อ

CNAME record หลัก:

• Record Type: CNAME
• Name/Host: www.example.com (โดเมนเต็มของคุณ)
• Points To: cname.stardeck.dev

Apex domain redirect (จำเป็นสำหรับโดเมน www)คัดลอกลิงก์หัวข้อ

สำหรับโดเมน www. ให้ redirect ผู้เข้าชมจาก apex domain (example.com) ไปที่ www.example.com โดเมนจะอยู่ในสถานะรอดำเนินการจนกว่า redirect นี้จะผ่านการตรวจสอบ subdomain อื่น เช่น app.example.com ไม่ต้องทำขั้นตอนนี้

• Record Type: A Record + URL Redirect (แตกต่างกันตามผู้ให้บริการ DNS)
• Name/Host: @ (หรือเว้นว่าง)
• Redirect To: www.example.com

ขั้นที่ 3: ตรวจสอบการตั้งค่า DNSคัดลอกลิงก์หัวข้อ

หลังเพิ่ม DNS record ครบแล้ว:

1. รอการแพร่กระจาย - การเปลี่ยนแปลง DNS อาจใช้เวลาถึง 24 ชั่วโมงจึงแพร่กระจายทั่วถึง
2. ตรวจสถานะการยืนยัน - ในแท็บ Domains ขององค์กร คุณจะเห็นสถานะการยืนยันแต่ละขั้น:
   • Ownership (การยืนยัน TXT record)
   • SSL TXT (การยืนยันใบรับรอง SSL)
   • CNAME (การยืนยันการส่งต่อทราฟฟิก)
   • Redirect (การยืนยัน apex domain redirect เฉพาะโดเมน www.)
3. ใช้ปุ่มตรวจสอบ - คลิกปุ่ม "Check" ข้างแต่ละขั้นเพื่อสั่งตรวจสอบด้วยตนเอง

ขั้นที่ 4: กำหนดโดเมนให้แอปคัดลอกลิงก์หัวข้อ

เมื่อโดเมนของคุณผ่านการตรวจสอบครบแล้ว:

1. ไปที่แอปของคุณ
2. เปิดการตั้งค่าแอป - คลิกไอคอนการตั้งค่าในแอปของคุณ
3. ไปที่แท็บ Domain ใต้ Deployments
4. เลือกโดเมนของคุณ - เลือกจากโดเมนขององค์กรที่ผ่านการตรวจสอบแล้ว
5. กำหนดโดเมน - คลิกเพื่อกำหนดโดเมนให้แอปของคุณ

coding agent ของคุณทำขั้นตอนนี้และตรวจ DNS ให้ได้: list_domains และ get_domain แสดง record และสถานะของโดเมน ส่วน assign_app_domain กำหนดโดเมนให้แอปหลังจากคุณยืนยัน การเพิ่มหรือซื้อโดเมนทำได้เฉพาะใน dashboard

ตัวอย่างผู้ให้บริการ DNS ที่พบบ่อยคัดลอกลิงก์หัวข้อ

Cloudflareคัดลอกลิงก์หัวข้อ

• TXT record: เพิ่มในหน้าจัดการ DNS โดยใช้ name/host และ value ตามที่ให้มาทุกตัวอักษร
• CNAME: ชี้ www.example.com ไปที่ cname.stardeck.dev
• Apex redirect: ใช้ "Page Rules" หรือ "Redirect Rules" เพื่อ redirect example.com ไปที่ www.example.com

Name-cheapคัดลอกลิงก์หัวข้อ

• TXT record: เพิ่มในส่วน "Advanced DNS"
• CNAME: เพิ่ม CNAME record โดยตั้ง host เป็น www ชี้ไปที่ cname.stardeck.dev
• Apex redirect: ใช้ฟีเจอร์ "Redirect Domain" ในการตั้งค่าโดเมน

GoDaddyคัดลอกลิงก์หัวข้อ

• TXT record: เพิ่มในหน้าจัดการ DNS
• CNAME: เพิ่มโดยตั้ง name เป็น www และชี้ไปที่ cname.stardeck.dev
• Apex redirect: ใช้ "Forwarding" ในการตั้งค่าโดเมน

การแก้ไขปัญหาคัดลอกลิงก์หัวข้อ

DNS ยังไม่แพร่กระจายคัดลอกลิงก์หัวข้อ

• การเปลี่ยนแปลง DNS อาจใช้เวลาถึง 24 ชั่วโมง
• ใช้เครื่องมืออย่าง dig หรือเว็บตรวจ DNS เพื่อตรวจว่าแพร่กระจายแล้ว
• ล้างแคชของเบราว์เซอร์แล้วลองในโหมดไม่ระบุตัวตน

การยืนยันไม่ผ่านคัดลอกลิงก์หัวข้อ

• ตรวจสอบอีกครั้งว่าชื่อและค่าของ TXT record ตรงกันทุกตัวอักษร
• ตรวจให้แน่ใจว่าไม่มีช่องว่างเกินในค่าของ DNS record
• ผู้ให้บริการ DNS บางรายต้องใส่จุดต่อท้ายสำหรับชื่อโดเมนเต็ม

CNAME ขัดแย้งกันคัดลอกลิงก์หัวข้อ

• ลบ A record เดิมของ subdomain เดียวกันออก
• CNAME record อยู่ร่วมกับ record ชนิดอื่นที่ใช้ชื่อเดียวกันไม่ได้
• ตรวจว่าคุณใช้ www.your-domain.com สำหรับ CNAME ไม่ใช่ apex domain

ยังมีปัญหาอยู่?คัดลอกลิงก์หัวข้อ

หากยังพบปัญหา:

1. ตรวจสถานะการยืนยันในแท็บ Domains ขององค์กร
2. ใช้ปุ่ม "Check" เพื่อสั่งตรวจสอบด้วยตนเอง
3. ติดต่อทีมซัพพอร์ตของ Stardeck ผ่าน dashboard พร้อมแจ้งชื่อโดเมนและรายละเอียดข้อผิดพลาด

ถัดไปคัดลอกลิงก์หัวข้อ