把 Astro 站点部署到 VPS：从构建到 HTTPS

Astro 静态站部署可以极简：`bun run build` 产出 dist，用 Nginx 托管静态文件并配置 HTTPS；先保证可访问与可回滚，再谈自动化发布。

什么时候适合 VPS

• 需要多个站点共用一台机器
• 想完全控制 Nginx / 证书 / 日志
• 已有自动化或后端服务要同机部署

若只是单个静态站，托管平台也完全够用。本指南面向「想掌握基础运维」的个人开发者。

最小路径

1. 本地 bun run build，确认 dist/ 正常
2. 服务器安装 Nginx
3. 把 dist/ 同步到如 /var/www/blktech
4. 配置 server block 指向该目录
5. 用 Certbot 或等价方式上 HTTPS
6. 保留上一个版本目录，方便回滚

Nginx 示意

server {
  listen 80;
  server_name blktech.cn www.blktech.cn;
  root /var/www/blktech/current;
  index index.html;

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

静态站点注意：

• Astro 默认带尾部斜杠策略时，路径要与构建配置一致
• 对 HTML 可用短缓存，对带 hash 的资源可长缓存

上线检查清单

• HTTP 自动跳转 HTTPS
• www 与裸域策略明确（跳转或并行）
• 404 页可访问
• robots.txt / sitemap.xml 可抓取
• 备份：至少保留上一版 dist

安全底线

• 关闭密码登录，改用 SSH Key
• 防火墙只开放 22/80/443（或你的管理端口）
• 定期 apt/yum 安全更新
• 不在仓库提交 .env 与私钥

下一步

部署稳定后，再加 GitHub Actions / 脚本实现「推送即发布」。自动化是结果，不是第一步。