静态项目部署 + SEO 全流程实战

前言:为啥写这篇

最近把技术博客从 pages.dev 切到独立域名,中间踩了一堆坑:

  • NS 切换 45 分钟等待焦虑
  • 百度报「主域可添加站点数量超过限制」(共享子域抢额度)
  • sitemap 提交额度永远是 0
  • 主动推送 API 报 401
  • Cloudflare Pages 把 *.html 308 重定向把百度文件验证搞挂

这篇教程按第一人称实战视角,分享我踩过的 5 个最关键的坑。你按这个流程走,能少走 2-3 天弯路。


第一部分:部署前要准备什么

Cloudflare 账号dash.cloudflare.com/sign-up 免费注册。建议切中文(右上角头像 → My profile → Language → 简体中文 → Save)。

域名(一年 60-80 块就够)

  • 推荐 .com ⭐⭐⭐⭐⭐、.org/.net ⭐⭐⭐⭐、.top ⭐⭐⭐(极便宜)、.cn/.com.cn ⭐(不推荐)
  • 我选 Porkbun:支付宝付款 30 秒,$9.73/年,0 套路
  • 其它备选:阿里云万网 ¥55、DNSPod ¥55、Namesilo $8.99、Cloudflare Registrar $10

不选 .cn 是因为备案 7-20 天 + DNS 污染;不选 freenom 是因为稳定性差 + 百度 SEO 歧视。

工具:Node.js 18+、wrangler CLI(npm install -g wrangler)、VS Code、Python 3(本地测试用)。


第二部分:一步步怎么部署

第一步:本地测试(5 分钟)

部署前先启动测试服务器:

python3 -m http.server 8768

浏览器打开 localhost:8768 即可访问。

第二步:部署到 Cloudflare Pages(10 分钟)

装 wrangler:用系统 npm 全局装。如果报「Cannot find module」说明装到了坏的 shim,改用 /usr/local/bin/npm 重装。

登录 + 创建 + 部署

wrangler login
wrangler pages project create <name> --production-branch main
wrangler pages deploy .

看到 Deployment complete! 就成功了。每次改完代码重新跑 deploy 命令,Cloudflare 只传有变化的部分。

第三步:绑定自定义域(30 分钟 + 1-6 小时等待)

3.1 Cloudflare 添加站点:登录 dash.cloudflare.com → 点「+ 添加站点」→ 选「连接域名」(不是「转移域名」)→ 输入域名。

3.2 配置 AI 爬虫策略:搜索/代理都选「允许」,训练选「在有广告的页面上阻止」。关闭「在 robots.txt 中阻止训练」——避免覆盖手写的 robots.txt。

3.3 选择 Free 计划:Workers 10万请求/天、Pages 无限静态站点、Universal SSL、全球 CDN——对独立项目完全够。

3.4 加 CNAME 记录:Cloudflare DNS 加记录,类型 CNAME,名称填子域名前缀(如 tools),目标填 <name>.pages.dev,代理状态选「已代理」(橙云)。

3.5 阿里云改 NS:阿里云 DNS 控制台 → 域名管理 → DNS 修改(不是「DNS 解析」)→ 填 Cloudflare 给的两个 NS → 保存。

真实时间线(我自己的):14:30 改 NS → 14:35 阿里云确认 → 14:36 Cloudflare 还在等 → 15:21 才激活。中间 45 分钟盯按钮,纯纯的等待焦虑

3.6 等 NS 传播 + Pages 绑域:通常 1-6 小时。期间别重复改 NS——会重置计时器。

第四步:配置 SEO(让搜索引擎收录你)

4.1 准备 5 类 SEO 资产(发布前就写好):

  • meta 标签(每个 HTML ):title / description / canonical / og:image(1200×630 PNG/JPG,< 500KB)
  • 6 个 JSON-LD 结构化数据(首页):WebSite / Organization / BreadcrumbList / ItemList / FAQPage / HowTo
  • 1200×630 OG 分享封面图:放 assets/og-cover.png
  • sitemap.xml:告诉搜索引擎有哪些页面
  • llms.txt + robots.txt:robots.txt 里主动放行 GPTBot / ClaudeBot / PerplexityBot——这些是 AI 训练/引用爬虫,不阻挡 =让 AI 学会引用你

4.2 百度站长平台ziyuan.baidu.com → 站点管理 → 添加站点 → 填完整 URL → 选「网站」。

领域分类选「工具服务及在线查询」或「IT 科技」。注意:百度说「30 天内只能修改一次」——一次选对

验证方式选「HTML 标签验证」:把百度给的 <meta name="baidu-site-verification"> 加到 index.html → 重新部署 → 点「完成验证」。

4.3 提交资源:验证通过后到「资源提交」→「普通收录」→ 选「手动提交」→ 贴 5 个 URL → 提交(API/sitemap 容易踩坑)。


第三部分:我踩过的 5 个最关键的坑

坑 1:NS 改了 1 小时还显示「等待传播」 —— 别慌。点「立即检查名称服务器」加速一次;期间别重复改 NS——会重置计时器。

坑 2:百度验证失败「301 网页存在跳转」 —— Cloudflare Pages 自动把 *.html 308 重定向到无后缀 URL,百度「文件验证」不跟 308。改用 HTML 标签验证即可。

坑 3:sitemap 显示「今日提交上限 0 条」 —— 百度对子域名 sitemap 配额限制。次日可能恢复;持续 0 条改用手动提交;或用 Google Search Console(无限制)。

坑 4:主动推送 API 报 401 token is not valid —— token 错或被撤。点「修改准入密钥」查看完整 token;仍报错放弃主动推送,用手动提交(5 个 URL/天完全够)。

坑 5:刚上线 2 小时搜不到关键词 —— 正常。SEO 是 1-12 个月的马拉松:抓取 1-3 天 → 建立索引 7-15 天 → 放出搜索结果 15-30 天 → 排到首页 3-12 个月。最快检查:百度搜索 site:你的域名.com


写在最后

这篇写了 3 小时,做这个项目总共花了 4 小时。踩了 14 个坑(本文讲最关键的 5 个),全部整理在这篇里——希望看完能少走 2-3 天弯路。

如果你也在部署自己的静态博客 /工具集 /文档站,欢迎留言交流踩坑经验。

📅 实践时间:2026-07
🛠️ 涉及工具:Cloudflare Pages + 阿里云 DNS + 百度站长平台 + wrangler CLI
💰 总成本:域名 ¥70/年 + Cloudflare 免费套餐 + Pages 免费额度


站内相关推荐

  • 📚 如何做好 SEO:个人博客/文档站 SEO 实战指南
  • 🛠️ NAS 飞书 AI 选题生成器部署教程
  • 📦 FileCodeBox 文件分享系统部署教程
  • 🎬 三星 Z Fold8 首发体验
  • 🤖 欢迎来到 idindoo.com

更多文章见 idindoo.com

消息盒子

# 暂无消息 #

只显示最新10条未读和已读信息