← ClaudeAtlas

chinese-web-deploymentlisted

Deploy Next.js web apps accessible in mainland China. Covers .cn domain registration on Alibaba Cloud, real-name verification, DNS configuration for Vercel custom domains, clientHold troubleshooting, and alternative deployment paths when Vercel is blocked. Also covers embedding static knowledge bases (Vitepress/MkDocs/Docsify) within an existing Next.js project's public/ directory.
wlkerwong-boop/china-web-deployment · ★ 0 · Web & Frontend · score 73
Install: claude install-skill wlkerwong-boop/china-web-deployment
# Chinese Web Deployment Deploy Vercel-hosted apps accessible from mainland China. ## Architecture ``` User (China) → Alibaba DNS → Vercel CDN (global) → Next.js app ↕ Alibaba Cloud Console (domain reg + DNS records) ``` ## Key Facts - `.vercel.app` domains are **blocked in mainland China** (GFW). - Fix: use a **Chinese .cn / .com.cn domain** registered via Alibaba Cloud, plus Vercel custom domain. - Vercel's custom domain IP (for A records): **`198.51.100.10`** (not `198.51.100.11`). - CNAME for www subdomain: **`cname.vercel-dns.com`**. - Alibaba DNS servers: `dns9.hichina.com` / `dns10.hichina.com` or `dns27`/`dns28`. ## Deployment Steps ### 1. Register Domain on Alibaba Cloud Search at https://wanwang.aliyun.com/domain/ → purchase .cn domain (~30元/year). Domain enters **clientHold** immediately. ### 2. Real-Name Verification Go to https://dc.console.aliyun.com/next/index → find domain → click 实名认证 → upload ID. Each .cn domain needs individual verification even if account is verified. Wait for hold to lift (minutes to 24h). ### 3. Check Domain Status `whois yourdomain.cn | grep -i "hold"` — `ok` = ready, `clientHold` = not ready. ### 4. Activate DNS & Add Records At https://dnsnext.console.aliyun.com/authoritative/domains/yourdomain.cn: - If "未开通" → click 前往开通 - Add A record: `@` → `198.51.100.10` - Add CNAME: `www` → `cname.vercel-dns.com` - Verify: `dig @dns9.hichina.com yourdomain.cn A +short` ### 5. Vercel Custom Domain