Writing
2026年实测:用 Astro 从零搭建静态博客并上线全流程(含Nginx配置)
记录2026年用Astro搭建静态博客的全过程,包括项目初始化、主题配置、Nginx部署和HTTPS证书申请,附实测可用的命令行操作和避坑指南。
上周想把老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格式不能错。