用 Astro 搭一个足够小的静态博客
从 Markdown 到静态页面,一套适合个人长期维护、也适合宝塔部署的轻量方案。
个人博客的技术选型常常被想得过于复杂。对一个以文字为主的网站来说,真正重要的指标通常只有三个:写起来顺手、打开足够快、几年后还能轻松维护。
为什么选择静态站点
静态站点没有运行时数据库。访问者请求页面时,Nginx 直接返回已经生成好的 HTML、CSS 和少量 JavaScript。
它带来几个很现实的好处:
- 部署简单,上传文件即可;
- 攻击面小,不需要维护后台账号;
- 页面天然容易缓存,访问速度稳定;
- 文章本身是普通 Markdown 文件,迁移成本很低。
一篇文章的结构
每篇文章由 Frontmatter 和正文组成:
---
title: 文章标题
description: 一句话摘要
pubDate: 2026-08-18
category: 技术
tags: [Astro, 建站]
---
这里开始写正文。
文件保存后,Astro 会读取这些字段,自动生成文章页、标签页、分类页和 RSS。
部署并不神秘
本地运行 npm run build,把生成的 dist 目录内容上传到宝塔站点根目录即可。服务器只负责提供静态文件,不需要安装 Node.js。
如果以后希望自动发布,也可以把项目放进 Git 仓库,再由服务器拉取并构建。但在文章数量不多的阶段,手动上传反而更清楚可靠。
技术应当退到背景里,让写作留在前景。