Operations 4 min read

Fixing Vercel DNS Pollution for Chinese Users: A Step‑by‑Step Guide

This guide explains why Vercel‑deployed static sites become inaccessible in mainland China due to DNS pollution, shows how to test the issue, and provides a simple CNAME reconfiguration using cname‑china.vercel‑dns.com to restore access.

Programmer DD
Programmer DD
Programmer DD
Fixing Vercel DNS Pollution for Chinese Users: A Step‑by‑Step Guide

Our Chrome extension’s website, hosted as a static site on Vercel, was reported as unreachable for users in mainland China. The site itself was still online, but DNS pollution caused the domain to be blocked.

Users can temporarily resolve the issue by manually setting their DNS server to 8.8.8.8, which bypasses the polluted records.

Original Configuration

After deploying the static site on Vercel, an automatic domain is assigned. In the DNS settings we added a www record with a CNAME pointing to that auto‑assigned domain. This configuration works globally but fails for Chinese mainland users.

DNS pollution check
DNS pollution check

Optimized Configuration

According to Vercel’s documentation, the fix is to change the CNAME target from the auto‑assigned domain to cname-china.vercel-dns.com. This directs DNS queries to a server that is not polluted in China.

Updated DNS configuration
Updated DNS configuration

After updating the CNAME, wait for propagation and re‑run the DNS pollution check.

DNS check after fix
DNS check after fix

The check now shows no pollution, confirming that the site is accessible from mainland China.

Original Source

Signed-in readers can open the original source through BestHub's protected redirect.

Sign in to view source
Republication Notice

This article has been distilled and summarized from source material, then republished for learning and reference. If you believe it infringes your rights, please contactadmin@besthub.devand we will review it promptly.

DeploymentChinaDNSVercelstatic siteCNAME
Programmer DD
Written by

Programmer DD

A tinkering programmer and author of "Spring Cloud Microservices in Action"

0 followers
Reader feedback

How this landed with the community

Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.