Writing

2026年实测:用 Astro 从零搭建静态博客并上线全流程(含Nginx配置)

记录2026年用Astro搭建静态博客的全过程,包括项目初始化、主题配置、Nginx部署和HTTPS证书申请,附实测可用的命令行操作和避坑指南。

· 12 分钟阅读
目录
  1. 一张表看懂搭建流程
  2. 1. 环境准备
  3. 2. 初始化Astro项目
  4. 3. 配置Nebula主题
  5. 4. 构建与部署
  6. 5. Nginx配置关键
  7. 6. 申请HTTPS证书
  8. 总结

上周想把老WordPress博客迁移到静态站点,试了Hexo和Hugo都觉得配置复杂,直到发现Astro——这玩意儿居然能在.md文件里直接写React组件!折腾三天终于搞定,记录下2026年最新版的完整流程。

📌 本文摘要:从零搭建Astro静态博客到上线的全流程,包含项目初始化(Node.js 20+环境)、主题配置(2026年推荐的新主题Nebula)、构建优化(压缩静态资源技巧),以及最终用Nginx部署并申请免费Let’s Encrypt证书的关键命令。重点解决astro build生成的页面在Nginx下路由404问题,实测适用于Ubuntu 22.04/24.04 LTS。

下面直接上干货,所有命令都在腾讯云轻量服务器(Ubuntu 24.04)实测通过。

一张表看懂搭建流程

阶段 耗时 关键工具
环境准备 5分钟 Node.js 20.x, npm 10.x
项目初始化 3分钟 npm create astro@latest
主题配置 15分钟 Nebula Theme (2026新版)
本地调试 10分钟 npm run dev
构建发布 2分钟 astro build
服务器部署 20分钟 Nginx, certbot

1. 环境准备

先更新系统并安装Node.js(2026年Astro要求Node 18+,推荐20.x LTS版本):

# 更新apt索引(需要sudo权限)
sudo apt update && sudo apt upgrade -y

# 安装Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 验证版本
node -v  # 应该输出 v20.x.x
npm -v   # 应该输出 10.x.x

提示:如果之前装过旧版Node,建议先执行sudo apt remove --purge nodejs npm彻底清理。

2. 初始化Astro项目

用官方脚手架创建项目(2026年新版交互式命令行会多一个SSR选项,我们选No做纯静态站点):

# 进入工作目录
cd ~
mkdir my-astro-blog && cd my-astro-blog

# 初始化项目(按提示选择)
npm create astro@latest

# 安装依赖
npm install

# 试运行
npm run dev

这时访问http://localhost:4321应该能看到默认欢迎页。关键目录结构:

  • src/pages/:放.md或.astro文件自动生成路由
  • public/:静态资源如图片
  • astro.config.mjs:核心配置文件

3. 配置Nebula主题

2026年最火的Astro主题是Nebula,比官方主题多了暗黑模式和多语言支持:

# 安装主题
npm install @astro-community/nebula-theme

# 修改astro.config.mjs
import nebula from '@astro-community/nebula-theme';

export default defineConfig({
  integrations: [nebula({
    primaryColor: '#3B82F6', // 可自定义主色调
    enableDarkMode: true
  })]
});

然后在src/content/目录下新建posts/first-post.md:

---
title: 我的第一篇文章
date: 2026-11-16
tags:
  - 博客搭建
---
## 你好世界!
这是用**Astro + Nebula**写的第一篇博客!

4. 构建与部署

本地测试没问题后,生成静态文件:

# 构建(生成的文件在dist目录)
npm run build

# 压缩dist目录备用
tar -czvf blog.tar.gz dist/

用scp传到服务器(假设IP是123.123.123.123):

# 从本地电脑执行(注意替换路径和IP)
scp blog.tar.gz root@123.123.123.123:/var/www/

# 在服务器解压
ssh root@123.123.123.123
cd /var/www/
tar -xzvf blog.tar.gz

5. Nginx配置关键

最容易踩坑的是路由问题——直接部署会导致页面刷新404。正确的Nginx配置(假设域名是blog.example.com):

# 安装Nginx
sudo apt install nginx -y

# 创建配置文件
sudo nano /etc/nginx/sites-available/blog.conf

写入以下内容(重点看try_files这行):

server {
    listen 80;
    server_name blog.example.com;
    root /var/www/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

启用配置并测试:

# 创建符号链接
sudo ln -s /etc/nginx/sites-available/blog.conf /etc/nginx/sites-enabled/

# 测试配置
sudo nginx -t

# 重启Nginx
sudo systemctl restart nginx

6. 申请HTTPS证书

2026年Let’s Encrypt依然免费,但certbot命令更简洁了:

# 安装certbot
sudo apt install certbot python3-certbot-nginx -y

# 一键获取证书(自动修改Nginx配置)
sudo certbot --nginx -d blog.example.com

按提示操作后,访问https://blog.example.com应该能看到带锁标志的博客。

总结

Astro在2026年仍然是静态博客的首选方案,相比WordPress省了90%的服务器资源。实测雨云最基础的1GB内存套餐(2026年价格¥12/月)就能流畅运行,用优惠码aabh还能打9折。关键点就两个:1) Nginx的try_files配置必须正确;2) 用.md写文章时Front Matter格式不能错。

相关文章