挥一拍 | Blog

第一篇日志 —— 你好,世界

Fri, 01 Jan 2027 00:00:00 GMT

第一篇日志 —— 你好,世界

搭建这个小站的初衷很简单:有一个属于自己的地方,用来记录、分享和沉淀。

为什么要写博客

强迫自己思考:写作是把模糊想法变为清晰认知的过程
记录成长:回头看过去的文章,能看到自己走过的路
帮助他人:分享的知识,也许正好能帮到某个陌生人

未来会写些什么

技术笔记:后端、前端、架构、工具使用
项目复盘:做过的项目,踩过的坑
生活随笔:偶尔的胡思乱想,与代码无关的片刻

你好,世界。希望这里能坚持写下去。

在 Astro 中搭建个人主页与 Blog

Fri, 01 Jan 2027 00:00:00 GMT

在 Astro 中搭建个人主页与 Blog

本文记录我如何用 Astro + Starlight 搭建本站点。它纯静态、构建快、Markdown 友好,非常适合个人主页与博客。

为什么选择 Astro

纯静态输出: astro build 会生成静态 HTML/CSS/JS,可直接部署到任意静态托管
岛屿架构: 默认零 JS,组件可按需加载,页面加载飞快
Markdown 友好: 用 .md / .mdx 写内容,内置代码高亮
生态丰富: Starlight 文档主题 + starlight-blog 插件,开箱即用的博客能力

初始化项目

# 用 Starlight 模板初始化站点
npm create astro@latest -- --template starlight

# 安装博客插件与 sitemap
npm install starlight-blog
npm install @astrojs/sitemap

目录结构

astro-site/
├── astro.config.mjs        # 站点配置(Starlight + starlight-blog)
├── src/
│   ├── content.config.ts   # 内容集合 schema
│   ├── content/docs/       # 文档与博客内容
│   │   ├── about.md        # 关于页
│   │   ├── projects.md     # 项目展示
│   │   └── blog/           # 博客文章
│   │       ├── tech/       # 技术笔记
│   │       └── life/       # 生活随笔
│   ├── pages/index.astro   # 自定义首页
│   └── styles/             # 主题样式
└── public/                 # 静态资源

配置站点

核心在 astro.config.mjs,通过 Starlight 集成配置标题、导航、侧边栏、社交链接与页脚,并挂载 starlightBlog() 插件开启博客功能。

import starlight from '@astrojs/starlight'
import starlightBlog from 'starlight-blog'

export default defineConfig({
  site: 'https://huiyipai.cloud',
  integrations: [
    starlight({
      title: '挥一拍',
      nav: [
        { label: '首页', link: '/' },
        { label: '博客', link: '/blog/' },
        { label: '项目', link: '/projects/' },
        { label: '关于', link: '/about/' },
      ],
      plugins: [starlightBlog()],
    }),
  ],
})

内容集合与博客文章

src/content.config.ts 里把 starlight-blog 的 schema 合并进 Starlight 的 docs 集合,即可支持博客文章的 date、tags、excerpt 等字段。文章放在 src/content/docs/blog/ 下,自动按日期倒序生成博客列表与标签页。

生成 sitemap

Starlight 生态内置 @astrojs/sitemap,在 astro.config.mjs 的 integrations 里引入即可在构建时自动生成 sitemap.xml,无需手写脚本(详见站长平台收录与推流指南)。

部署

把 dist/ 上传到任意静态托管即可,例如 Nginx、GitHub Pages、Cloudflare Pages、Vercel。

站长平台收录与推流指南

Wed, 14 Oct 2026 00:00:00 GMT

站长平台收录与推流指南

本站在 https://huiyipai.cloud。为了让搜索引擎尽快收录本站,除了配备 sitemap.xml 和 robots.txt 之外,还需要在各大站长管理平台提交站点。本文以本站为例,整理主流平台的提交与“推流”方法。

前置准备:确保基础 SEO 已就绪

在提交到任何站长平台之前,先确认站点已具备:

sitemap.xml → https://huiyipai.cloud/sitemap.xml
robots.txt → https://huiyipai.cloud/robots.txt(已通过 <Sitemap> 标签指向 sitemap)
HTTPS → 站点通过 https://huiyipai.cloud 可访问
每个页面都有合理的 <title> 与 <meta description>

检查方式:在浏览器直接打开上面两个地址,能看到 XML / 文本内容即为正常。

一、百度搜索资源平台(百度站长平台)

地址: https://ziyuan.baidu.com

注册/登录百度账号,进入「搜索资源平台」。
添加站点:选择站点类型(普通站点),输入 https://huiyipai.cloud,进行域名所有权验证。
三种验证方式(任选其一):
- CNAME 验证:在域名 DNS 处添加一条解析。
- HTML 标签验证:把百度提供的 <meta name="baidu-site-verification" content="..."> 放到站点首页 <head> 中。
- 文件验证:把百度给的验证文件放到站点根目录,使其可通过 URL 访问。
验证通过后选择站点类型并提交。

推流(主动推送,加速收录):

普通收录 → 链接提交:可使用以下方式提交 URL:
- 手动提交:逐个或批量粘贴页面链接。
- sitemap 提交:填写 https://huiyipai.cloud/sitemap.xml,百度会定时抓取。
- API 推送:用 POST 接口把新页面链接主动推给百度(适合博客发布新文章时自动触发)。

百度对普通站点 sitemap 是相对友好的抓取方式;发布新文章后建议通过 API/手动推送,能明显加快收录。

二、Google Search Console(谷歌站长平台)

地址: https://search.google.com/search-console

登录 Google 账号,进入 Search Console。
添加资源 → 选择 「网域」 类型(推荐,覆盖所有子域和协议),输入 huiyipai.cloud。
验证归属:
- DNS TXT 验证(推荐):在域名 DNS 添加 Google 提供的 TXT 记录,通常解析生效后几分钟内即可验证完成。
验证通过后进入控制台。

提交 sitemap:

左侧菜单 「站点地图」(Sitemap) → 输入 sitemap.xml → 提交。
状态显示“成功”即完成。

抓取检查(推流):

顶部输入框输入页面 URL,点「测试网址」→「请求编入索引」,可主动让 Google 抓取该页面(有配额限制,新站点建议精打细算使用)。

三、必应 Webmaster Tools(必应站长平台)

必应在中国可用,提交入口:Bing Webmaster Tools

地址: https://www.bing.com/webmasters

登录 Microsoft 账号。
添加站点:输入 https://huiyipai.cloud。
验证方式:
- DNS TXT 记录(推荐)
- HTML meta 标签验证
- 文件上传验证
- 也可选择 「从 Google Search Console 导入」(若已配置 GSC,可一键导入,非常省事)。
验证后进入控制台。

提交 sitemap:

Sitemaps(站点地图) → 输入 sitemap.xml → 提交。

URL 提交(推流):

使用 「URL 提交」(Submit URLs) 功能,可一次性提交最多 10 个 URL(每天有一定限额),适合发布新文章后手动推送。

四、360 搜索资源平台(360 站长平台)

地址: https://zhanzhang.so.com

登录 360 账号,进入「站长平台」。
添加站点:输入 https://huiyipai.cloud,选择协议与站点类型。
验证:360 支持 HTML meta 标签 / 文件验证 / CNAME 验证,选择其一即可。
验证通过后提交。

推流:

提供 sitemap 提交 与 XML 格式的主动推送(实时收录)接口。新文章可调用 API 推送。

五、搜狗站长平台(可选)

地址: https://zhanzhang.sogou.com

搜狗主要覆盖微信搜索与搜索生态。若你的内容与搜狗搜索相关,可在此提交站点与 sitemap。
验证方式与上述平台类似(DNS / 文件 / HTML 标签)。

六、通用建议与“推流”策略

sitemap 是基础:所有平台都接受 sitemap.xml,务必先提交它。
新文章要及时推:发布新文章后,优先对百度 API 推送 + Bing URL 提交 + Google 请求编入索引,能显著缩短收录时间。
主动外链:在其他平台(如 GitHub、技术社区、社交平台)分享站点链接,有助于搜索引擎发现与权重积累。
保持内容更新:持续更新且有价值的原创内容,是长期收录与排名的根本。
定期检查:各站长平台的抓取/编制索引报告中,关注 404、抓取异常等情况并及时修复。

本文对应的本站资源

站点地图: https://huiyipai.cloud/sitemap.xml
robots: https://huiyipai.cloud/robots.txt

提示:各平台界面会随版本更新略有差异,但核心流程(添加站点 → 验证 → 提交 sitemap → 主动推流)基本一致。