本博客的诞生记录：Astro + Firefly 建站全流程

归档39

C++ 教程12 Java 教程12 Python 教程11 网络安全2 技术分享1 社团动态1

662 字

3 分钟

本博客的诞生记录：Astro + Firefly 建站全流程

2026-10-28

为什么选择静态博客#

社团官网的核心需求很简单：展示文章、稳定、省资源、好维护。对比了几个方案：

方案	优点	缺点
WordPress	生态大、后台完善	PHP + MySQL，资源占用高，需要持续打补丁
Halo	国产、界面现代	需要 Java 运行时，内存占用高
Astro 静态站	零数据库、纯静态文件、速度快	更新内容需要重新构建

我们的服务器配置不高，静态方案几乎不占运行时资源，nginx 托管静态文件的内存开销可以忽略，安全性也远好于动态 CMS——最终选择 Astro + Firefly 主题。

技术栈一览#

1
博客框架     Astro v7（静态站点生成）
2
主题         Firefly（基于 Fuwari 二次开发）
3
包管理器     pnpm
4
源码托管     GitHub - 1376524890/cyberpioneer_blog
5
Web 服务     nginx（托管静态文件）
6
部署方式     源码推 GitHub → 服务器拉取构建 → 同步上线

本地开发流程#

1
# 安装依赖（需要 Node.js >= 22.23）
2
corepack enable
3
pnpm install
4

5
# 本地预览 http://localhost:4321
6
pnpm dev
7

8
# 构建静态站点到 dist/
9
pnpm build

写一篇新文章#

文章以 Markdown 格式存放在 src/content/posts/ 目录，只需复制一份模板修改 frontmatter：

1
---
2
title: 文章标题
3
published: 2026-10-28
4
description: 一句话摘要，会显示在列表页
5
tags: [标签1, 标签2]
6
category: 分类名
7
slug: url-friendly-slug
8
---
9

10
正文支持 Markdown……

保存后推送到 GitHub，服务器端拉取重新构建即可上线。

部署要点#

静态博客的部署非常简单：任意一台 Linux 服务器 + nginx 托管 dist/ 目录即可。下面是一份通用的 nginx 站点配置示例（端口与路径按自己环境调整）：

1
server {
2
    listen 80 default_server;
3
    listen [::]:80 default_server;
4
    server_name _;
5

6
    root /var/www/blog;   # 指向构建产物目录
7
    index index.html;
8

9
    # Astro 默认带尾斜杠
10
    location / {
11
        try_files $uri $uri/ $uri/index.html =404;
12
    }
13

14
    # 静态资源长缓存
15
    location /_astro/ {
16
        expires 30d;
17
        add_header Cache-Control "public, immutable";
18
    }
19

20
    gzip on;
21
    gzip_types text/css application/javascript image/svg+xml application/json;
22
}