1436 字

7 分钟

Astro 博客 CI/CD 自动部署教程：使用 GitHub Actions 实现服务器自动发布

2025-10-15

从零开始的博客网站

astro

/

CI/CD

/

Linux

0. 准备工作#

你需要准备

一台有公网IP的Linux服务器
一个可以运行的Astro项目

1. Linux上的部署#

在Linux服务器上依次执行如下步骤：

1. 创建角色#

创建Github部署时登录的角色

TIP
推荐创建一个用户专门用于Github的CI/CD，不建议使用root角色进行CI/CD；
如果使用root需要配置Root的远程登录

1
sudo adduser github-ci

2. 创建文件夹#

创建放置部署文件的文件夹并给CI角色赋权

1
mkdir /var/www/releases
2
chown -R github-ci:github-ci /var/www/releases

3. 安装openssh-server服务#

先检查服务器上是否安装了ssh server

1
which ssh
2
which sshd

如果显示：

1
root@:~/.ssh# which ssh
2
/usr/bin/ssh
3
root@:~/.ssh# which sshd
4
/usr/sbin/sshd

表示已经安装了SSH服务，请跳转到；
如果未显示一个路径地址，则表示没有安装，需要安装，步骤如下：

Ubuntu / Debian

1
# 安装服务
2
sudo apt update
3
sudo apt install -y openssh-server
4
# 设置自启
5
sudo systemctl enable ssh
6
# 启动服务
7
sudo systemctl start ssh

CentOS / RHEL

1
# 安装服务
2
sudo yum install -y openssh-server
3
# 设置自启
4
sudo systemctl enable sshd
5
# 启动服务
6
sudo systemctl start sshd

4. 权限配置#

1
# 先切换到CI角色
2
su - github-ci
3
# 生成SSH的公钥和私钥
4
chmod 700 ~/.ssh
5
ssh-keygen -t ed25519
6
# 查看~/.ssh文件夹下有没有authorized_keys文件，如果没有，则创建authorized_keys并赋权
7
touch ~/.ssh/authorized_keys
8
chmod 600 ~/.ssh/authorized_keys
9
# 将公钥（~/.ssh/id_ed25519.pub）的内容添加到 ~/.ssh/authorized_keys
10
grep "$(cat ~/.ssh/id_ed25519.pub)" ~/.ssh/authorized_keys || cat ~/.ssh/id_ed25519.pub >> ~/.ssh/authorized_keys

5. 安装Nginx服务#

先查看服务器有没有安装Nginx

1
nginx -v

如果提示：command not found，则表示未安装Nginx，安装步骤如下：

Ubuntu / Debian

1
# 安装服务
2
sudo apt update
3
sudo apt install -y nginx
4
# 设置自启
5
sudo systemctl enable nginx
6
# 启动服务
7
sudo systemctl start nginx

CentOS / RHEL

1
# 安装服务
2
sudo yum install -y nginx
3
# 设置自启
4
sudo systemctl enable nginx
5
# 启动服务
6
sudo systemctl start nginx

验证安装情况：

1
systemctl status nginx

如果显示下列内容，则表示已经安装并启动了Nginx：

1
github-ci@:~/.ssh$ systemctl status nginx
2
● nginx.service - A high performance web server and a reverse proxy server
3
     Loaded: loaded (/lib/systemd/system/nginx.service; disabled; vendor preset: enabled)
4
     Active: active (running) since Mon 2026-03-23 15:58:11 CST; 1 week 2 days ago
5
       Docs: man:nginx(8)
6
    Process: 2379804 ExecReload=/usr/sbin/nginx -g daemon on; master_process on; -s reload (code=exited, status=0/SUCCESS)
7
   Main PID: 2330136 (nginx)
8
      Tasks: 3 (limit: 1834)
9
     Memory: 10.2M
10
        CPU: 18.277s
11
     CGroup: /system.slice/nginx.service
12
             ├─2330136 "nginx: master process /usr/sbin/nginx -g daemon on; master_process on;"
13
             ├─2379805 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""
14
             └─2379806 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""

6. 配置Nginx#

修改Nginx的配置文件

1
user www-data;
2
worker_processes auto;
3

4
events {
5
    worker_connections 1024;
6
}
7

8
http {
9
    server {
10
        listen 80;
11
        server_name _;
12

13
        root /var/www/current/dist;
14
        index index.html;
15

16
        location / {
17
            try_files $uri $uri/ /index.html;
18
        }
19
    }
20
}

修改完成后，运行检查：

1
sudo nginx -t

如果显示下列内容，则显示配置文件没有问题：

1
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
2
nginx: configuration file /etc/nginx/nginx.conf test is successful

另外，需要为CI用户添加配置允许无密码执行 nginx reload：
执行：sudo visudo 在文件尾部添加如下内容

1
github-ci ALL=(ALL) NOPASSWD:/bin/systemctl reload nginx

添加完成后键入：ctrl+o
显示 File Name to Write: /etc/sudoers，然后按Enter保存

2. Github上的配置：#

根据如下路径配置Github远程登录服务器相关内容： GitHub Actions Secrets 配置界面

配置项及描述如下

配置项	描述
HOST	服务器的公网IP
USER	1-1中创建的角色名，示例为github-ci
SSH_KEY	1-4中生成的SSH私钥

3. 编写deploy.yml#

在项目的根目录下，在.github/workflows/下创建deploy.yml，如果没有则创建。
deploy.yml文件内容如下：

1
name: Astro deploy
2
on:
3
  push:
4
    branches:
5
      - main # 这里是分支名称
6
jobs:
7
  build:
8
    runs-on: ubuntu-latest # 编译运行的平台
9
    steps: # 编译运行的步骤
10
      - name: 拉代码
11
        uses: actions/checkout@v4
12
      - name: Node环境
13
        uses: actions/setup-node@v4
14
        with:
15
          node-version: 20
16
      - name: 安装 pnpm
17
        uses: pnpm/action-setup@v3
18
        with:
19
          version: 9
20
          run_install: false
21
      - name: 安装依赖
22
        run: pnpm install --no-frozen-lockfile
23
      - name: 构建
24
        run: pnpm build
25
      - name: 上传文件
26
        uses: appleboy/[email protected]
27
        with:
28
          host: ${{ secrets.HOST }}
29
          username: ${{ secrets.USER }}
30
          key: ${{ secrets.SSH_KEY }}
31
          source: "dist/"
32
          target: "/var/www/releases/${{ github.run_id }}"
33
      - name: 部署
34
        uses: appleboy/[email protected]
35
        with:
36
          host: ${{ secrets.HOST }}
37
          username: ${{ secrets.USER }}
38
          key: ${{ secrets.SSH_KEY }}
39
          script: |
40
            mkdir -p /var/www/releases/${{ github.run_id }}
41
            ln -sfn /var/www/releases/${{ github.run_id }} /var/www/current
42
            systemctl reload nginx

4. 编写博文#

在src/content/post文件夹下，创建一个新的Markdown文件，或者在控制台运行下列命令生成新的文件

1
pnpm new-post <filename>

在其中编写你的博文内容后，将markdown文件commit并push到Github后，在Github中查看编译运行情况：如何在Action页面查看每次CI/CD

左侧的Astro Deploy是deploy.yml中的name键的值
点击右侧的Commit Message可以查看这次Push对应的Action详情

如何在Action页面查看某次CI/CD 这里可以看到每一步操作的日志信息，如果出现错误则进行对应的处理后重新部署

TIP
如果你修改了服务器配置或者Github相关配置，没有修改代码但是又需要重新触发CI/CD，你有如下两种方案

在Action左侧选择Astro Deploy，在右侧单击最后一次Push，然后在右侧点选Re-run all jobs

你可以通过Commit并Push一次空的提交来触发CI/CD
命令为：git commit --allow-empty -m <commit message>

5. 回滚版本#

你可以通过如下的命令将发布的版本回退到指定的版本：

1
ln -sfn /var/www/releases/旧版本ID /var/www/current

这个旧版本ID为github执行CI/CD的run-id
github.run_id 是 GitHub Actions 为每次 workflow run 自动生成的唯一整数 ID，用于区分不同部署版本。
这一项是在deploy.yml中写到的：mkdir -p /var/www/releases/${{ github.run_id }}
在Action中，找到你需要回退到的那一次Push，在详情页面的URL可以找到这次CI/CD对应的run-id
服务器上的run-id github中的run-id

Astro 博客 CI/CD 自动部署教程：使用 GitHub Actions 实现服务器自动发布

https://yuumiblog.com/posts/blogbuild/blogbuildnote03/

作者

悠米的开发笔记

发布于

2025-10-15

许可协议

CC BY-NC-SA 4.0

Astro 博客添加 Waline 评论系统，Waline 的 docker 部署

Astro 博客搭建教程：框架选择与项目初始化完整指南

3. 安装openssh-server服务