Notes

用 Astro 和 R2 搭建个人作品档案

2026-06-26 Website Astro R2 Web

使用 Astro Content Collections 管理作品和笔记,用 R2 承载图片资源,让网站保持轻量、可迁移和易维护。

这个站点采用 Astro 生成静态页面,内容通过 src/content 下的 Markdown / MDX 文件管理。新增作品时,不需要手写新页面,只要新建一个内容文件并填写 frontmatter。

图片不直接放进代码仓库,而是通过 Cloudflare R2 或其他对象存储提供外链。内容文件里只写相对路径,例如:

cover: architecture/project-name/cover.webp

组件会通过 r2() 工具函数自动拼接成完整图片地址。这样可以让仓库保持轻量,也方便未来替换图片域名。

理想更新流程是:上传图片到 R2,新建 MDX,写正文,提交代码,让构建服务自动发布。