1121 字
6 分钟
Astro Shiroe 配置、迁移及优化

众所周知,以前本网站以加载速度极慢和连接重置而出名(bushi,经过一番考虑之后决定由 WordPress 迁移至 Astro,并顺带做“一”点优化。

开始之前#

Astro 是一个学习难度较高的框架,没有任何后台,通过向文件内添加内容并触发构建来工作,实际网站内容是构建后的静态文件。即使配置(此处指硬件)较差,也能提供良好的体验。唯独难以给那些“被图形界面快惯坏了”的开发者以良好体验。

心理准备#

如果你不幸是那图形化大军中的一员,那么要做好心理准备,但也不要轻易放弃,最终效果会让你大开眼界。

准备环境#

  1. 挑选一个你喜欢的主题(theme),通读一遍其对应 wiki。
  2. 在你的生产环境域名下添加一个子域,用于充当测试环境。
  3. 准备好测试平台,最好是所需部署平台所支持的 Git 平台。

不同主题,不同版本的 Astro 可能有所不同,本文以 Astro 7,Shirone V2.0 为例。

正式开始#

发布第一个部署#

按所选主题的 wiki 正确配置必要 config

通常配置说明在 /wiki/、/src/config/README.md 下。

Shirone 要求必需至少配置 src/config/siteConfig.ts。

用任意方式发布部署,此处建议是 Vercel,对中国优化较好且稳定。

进一步配置#

第一个部署发布后,你可能会发现:里面的文章不是你写的,作者介绍不是你,头像不是你… 这好像是别人的网站一样!别急,慢慢来。

重点配置内容:

  • siteConfig.ts:名称、副名称、首页打中机的动画内容,大文本内容
  • CommentsConfig.ts:评论配置文件,推荐使用 Giscus或 Twikoo,简单快捷(只是Giscus国内加载较慢),
  • FooterConfig:页脚内容,备案信息通常填写于此,亦可写入版权信息、运营主体等。
  • ProfileConfig.ts:作者相关信息,如名称、头像、联系方式等

每个主题所需配置方式不同,请按照对应主题配置。多查阅对应主题 wiki 及开发文档。

此处不再一一列举,建议在每次修改后查看一下效果,不仅可以验证是否写对了文件,同时也能起到查错作用(若有配置错误则会构建失败)。

tips:别把 true 写成 ture(一开始我都蒙了,到底哪有问题啊???)

迁移文章#

来到 /src/content/posts/ 下,里面有一堆 md 或 mdx 文件(也有可能没有)。这是一些初始文章,将其全部删除。(你想留作纪念也行…吧)

文件名代表路由,也就是说 a-now-post.md 实际部署后的网址路径就是 example.com/posts/a-new-post,所以别乱取名。支持添加子级目录,把同类的文章写一起。

将你的文章转为 md 或 mdx,在其开头加入一段元信息,格式是强制统一的,不规范填写会构建报错。下面是一段示例:

---
title: "Astro Shiroe 配置、迁移及优化"
published: 2026-11.21
description: ""
tags: ["Astro,改造,服务器"]
category: "改造"
draft: false
---

收尾工作#

  • 将临时子域删除,并连接至生产环境域名。

!!! 注意修改 siteConfig.ts 中的地址字段 !!!

  • 检查文章是否完成,是否有未完成的构建与构建错误
  • 通阅全站,是否有遗留初始页面、作者信息、许可证、评论系统、底部署名信息、友链链接 未完成配置和迁移。
  • 及时提交新的 sitemap 至搜索引擎。
  • 若友链路由变更,及时告知友链自动化管理的网站,防止失联。

结束优化#

如果你是用的 Vercel,一定要记得更改服务器位置。进入到已经部署的项目中,点击settings ➡️Functions➡️Functions Region 这里还有一个坑 你需要先切换到North America取消勾选USA 否则会选中两个地区导致在hobby计划下无法使用

另外,Vercel 还有专门的中国优化的路由优选,仅需通过 CNAME 配置为 cname-china.vercel-dns.com即可。

Vercel 不建议再挂 CDN,但图片最好还是走外链(如图床,转发 CDN 等)

希望各位能在本文中获得一些启发,这是我迁移至 Astro 后的第一篇文章,也欢迎测试评论系统(旧评论没有迁移)及提出宝贵建议!

Astro Shiroe 配置、迁移及优化
https://sssr7844.qzz.io/posts/config-astro-shirone/
作者
sssr7844
发布于
2026-11-21
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...