Zipoly

docs-site 多域名 SEO 配置 ​

📋 配置说明 ​

本站点配置了主域名 + 备用域名的多域名 SEO 策略。

域名配置 ​

  • 主域名（Primary）: https://zipoly.raychart.cn/ - SEO 主要域名，所有 canonical 链接指向此域名
  • 备用域名（Alternate）: https://zipoly.netlify.app/ - CDN 加速域名，提供备用访问

工作原理 ​

每个页面都会自动注入：

html
<!-- 主域名作为 canonical（告诉搜索引擎这是首选 URL） -->
<link rel="canonical" href="https://zipoly.raychart.cn/guide/install.html">

<!-- 备用域名作为 alternate（告诉搜索引擎这是备用 URL） -->
<link rel="alternate" href="https://zipoly.netlify.app/guide/install.html">

SEO 效果 ​

  • 🔍 搜索引擎将主域名作为首选 URL（SEO 权重集中）
  • 🌐 两个域名都可以正常访问，不会被判定为重复内容
  • 📊 搜索结果主要显示 zipoly.raychart.cn

✅ 配置完成确认 ​

VitePress 配置文件 ​

文件: .vitepress/config.ts

  • [x] PRIMARY_SITE_URL = 'https://zipoly.raychart.cn'
  • [x] ALTERNATE_SITE_URL = 'https://zipoly.netlify.app'
  • [x] sitemap.hostname = PRIMARY_SITE_URL
  • [x] Open Graph URL 使用主域名
  • [x] Twitter Card 图片使用主域名
  • [x] Schema.org 中添加 sameAs: [ALTERNATE_SITE_URL]
  • [x] transformPageData 注入 canonical + alternate 链接

robots.txt ​

文件: public/robots.txt

  • [x] 包含主域名 Sitemap
  • [x] 包含备用域名 Sitemap

内容文件 ​

文件: faq.md

  • [x] 链接已更新为主域名

🧪 部署后验证步骤 ​

步骤 1: 检查 HTML 源代码 ​

访问 https://zipoly.raychart.cn/ 并查看源代码，确认包含：

html
<!-- Canonical (主域名) -->
<link rel="canonical" href="https://zipoly.raychart.cn/">

<!-- Alternate (备用域名) -->
<link rel="alternate" href="https://zipoly.netlify.app/">

<!-- Open Graph -->
<meta property="og:url" content="https://zipoly.raychart.cn">
<meta property="og:image" content="https://zipoly.raychart.cn/og-image.png">

<!-- Schema.org -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "url": "https://zipoly.raychart.cn",
  "sameAs": ["https://zipoly-web.netlify.app", "https://zipoly.netlify.app"]
}
</script>

步骤 2: 检查 Sitemap ​

访问两个 sitemap，确认都可以正常访问：

  • ✅ https://zipoly.raychart.cn/sitemap.xml
  • ✅ https://zipoly.netlify.app/sitemap.xml

确认 sitemap 中的 URL 都是主域名：

xml
<url>
  <loc>https://zipoly.raychart.cn/</loc>
  <lastmod>2026-06-29</lastmod>
</url>
<url>
  <loc>https://zipoly.raychart.cn/guide/install.html</loc>
  <lastmod>2026-06-29</lastmod>
</url>

步骤 3: 检查 robots.txt ​

访问 https://zipoly.raychart.cn/robots.txt，确认包含：

User-agent: *
Allow: /

# 主域名 Sitemap
Sitemap: https://zipoly.raychart.cn/sitemap.xml

# 备用域名 Sitemap
Sitemap: https://zipoly.netlify.app/sitemap.xml

步骤 4: 测试两个域名访问 ​

  • ✅ https://zipoly.raychart.cn/ - 主域名可访问
  • ✅ https://zipoly.netlify.app/ - 备用域名可访问
  • ✅ 内容完全一致
  • ✅ HTTPS 证书有效

步骤 5: SEO 工具验证 ​

Google Rich Results Test ​

访问: https://search.google.com/test/rich-results

输入: https://zipoly.raychart.cn/

确认:

  • ✅ Schema.org 结构化数据无错误
  • ✅ SoftwareApplication 类型识别正确

Facebook Sharing Debugger ​

访问: https://developers.facebook.com/tools/debug/

输入: https://zipoly.raychart.cn/

确认:

  • ✅ og:url 显示主域名
  • ✅ og:image 正确显示
  • ✅ 标题和描述正确

Twitter Card Validator ​

访问: https://cards-dev.twitter.com/validator

输入: https://zipoly.raychart.cn/

确认:

  • ✅ Card 类型: summary_large_image
  • ✅ 图片正确显示

📊 提交到搜索引擎 ​

Google Search Console ​

  1. 添加主域名资源:

  2. 提交 Sitemap:

    • Sitemap URL: https://zipoly.raychart.cn/sitemap.xml
    • 等待索引（1-2 周）

  3. 可选: 添加备用域名资源:

    • 添加资源: https://zipoly.netlify.app
    • 监控是否有重复内容警告

百度站长平台 ​

  1. 添加站点:

  2. 提交 Sitemap:

    • 链接提交 → Sitemap
    • URL: https://zipoly.raychart.cn/sitemap.xml

  3. 请求抓取:

    • 抓取诊断 → 抓取测试
    • 输入首页 URL

Bing Webmaster Tools ​

  1. 添加网站:

  2. 提交 Sitemap:

    • Sitemaps → 提交 Sitemap
    • URL: https://zipoly.raychart.cn/sitemap.xml

🔍 监控检查点 ​

第 1 周 ​

  • [ ] Google Search Console 显示已提交的页面
  • [ ] 检查抓取错误
  • [ ] 验证 canonical 标签被正确识别

第 2-4 周 ​

  • [ ] 检查索引页面数量
  • [ ] 监控主域名 vs 备用域名的索引比例
  • [ ] 确认无重复内容警告

第 1-3 个月 ​

  • [ ] 监控关键词排名
  • [ ] 检查搜索结果显示的域名（应该主要是主域名）
  • [ ] 分析自然搜索流量来源

⚠️ 常见问题 ​

Q: 搜索结果显示备用域名怎么办？ ​

A: 这是正常的过渡期现象：

  1. 等待 1-2 周让搜索引擎重新索引
  2. 确认 canonical 标签正确配置
  3. 在 Search Console 提交主域名的 sitemap
  4. 通常 2-4 周后会自动切换到主域名

Q: 两个域名都被索引了？ ​

A: 这可能导致 SEO 权重分散：

  1. 检查 canonical 标签是否正确
  2. 检查 alternate 标签是否存在
  3. 在 Search Console 请求删除备用域名的索引
  4. 或者添加 301 重定向（备用域名 → 主域名）

Q: 需要设置 301 重定向吗？ ​

A: 不一定：

  • 不需要：如果你想保留两个域名都可以访问（当前配置）
  • 需要：如果你想强制所有访问都跳转到主域名

如果要设置 301 重定向，在 Netlify 配置：

toml
# netlify.toml
[[redirects]]
  from = "https://zipoly.netlify.app/*"
  to = "https://zipoly.raychart.cn/:splat"
  status = 301
  force = true

📈 预期效果时间线 ​

时间预期效果
立即canonical 标签生效，备用域名不会被惩罚
1-2 周搜索引擎开始识别主域名优先级
2-4 周搜索结果逐渐切换到主域名
1-3 个月SEO 权重完全集中到主域名

📚 参考 ​

创建时间: 2026-06-29
最后验证: 待部署后验证
负责人: v-plugin

专为 Web3D 开发者设计

Copyright © 2024–2026 RayChart. All rights reserved.