Fuwari 博客部署指南#

本指南介绍如何在服务器上通过 Docker 部署 Fuwari 博客，并使用 Nginx 提供公网访问。

1. 获取项目代码#

使用 git 将仓库克隆到本地（假设路径为 /root）：

1
git clone https://github.com/saicaca/fuwari.git

2. 安装 Node.js 与 pnpm#

推荐使用 Node.js v22.21.1 (LTS) 与 pnpm 配合 Docker 运行：

这里使用的是官网的

Get Node.js v22.21.1 (LTS) for Linux using Docker with pnpm

版本。

1
# Docker has specific installation instructions for each operating system.
2
# Please refer to the official documentation at https://docker.com/get-started/
3

4
# Pull the Node.js Docker image:
5
docker pull node:22-alpine
6

7
# Create a Node.js container and start a Shell session:
8
docker run -it --rm --entrypoint sh node:22-alpine
9

10
# Verify the Node.js version:
11
node -v # Should print "v22.21.1".
12

13
# Download and install pnpm:
14
corepack enable pnpm
15

16
# Verify pnpm version:
17
pnpm -v

注意：上面那些代码只需要运行 docker pull node:22-alpine
官方建议 Node.js <= 22，pnpm <= 9，如版本不符请调整。

3. 启动 Docker 容器#

在 Docker 中挂载本地项目目录：

1
docker run -d \
2
  --name fuwari \
3
  -p 4321:4321 \
4
  -v /root/fuwari:/root/fuwari \
5
  node:22-alpine \
6
  tail -f /dev/null

-v /root/fuwari:/root/fuwari 将本地项目挂载到容器，方便开发和构建。

4. 安装依赖并启动开发环境#

有两种方式执行命令：

进入容器执行：

1
docker exec -it fuwari sh
2
cd /root/fuwari
3
corepack enable pnpm
4
pnpm install
5
pnpm add sharp
6
pnpm dev

直接在宿主机执行带 docker exec -w 的命令：

1
docker exec -w /root/fuwari fuwari corepack enable pnpm
2
docker exec -w /root/fuwari fuwari pnpm install
3
docker exec -w /root/fuwari fuwari pnpm add sharp
4
docker exec -w /root/fuwari fuwari pnpm dev

默认开发环境仅在本机访问：http://localhost:4321。
如需公网访问，可加 --host 0.0.0.0：

1
pnpm dev --host 0.0.0.0

此时可以以使用<服务器公网ip>:4321进行访问。

NOTE
因为这里是docker环境，所以不加--host 0.0.0.0会导致无法访问，建议还是加上，或者不使用docker。
同时需要注意开放公网访问的隐患，建议使用pnpm build构建静态网页再进行访问。

中止或重启服务：

1
docker stop fuwari
2
docker restart fuwari

若在容器内执行 pnpm dev，可使用 Ctrl+C 停止。

5. 构建静态网页#

将网站构建为静态文件：

1
pnpm build

构建完成后，/root/fuwari/dist 目录下将生成静态网页，可用于 Nginx 部署。

6. Nginx 配置示例#

6.1 HTTP 访问#

1
server {
2
    listen 80;
3
    listen [::]:80;
4
    http2 on;
5

6
    server_name example.com;  # 已解析到服务器的域名
7

8
    root /root/fuwari/dist;  # 指向 dist 目录
9
    index index.html;
10

11
    location / {
12
        try_files $uri $uri/ /index.html;
13
    }
14
}

6.2 HTTPS 访问(需要证书)#

1
server {
2
    listen 443 ssl;
3
    listen [::]:443 ssl;
4
    http2 on;
5

6
    server_name example.com;
7

8
    ssl_certificate /etc/nginx/ssl/example.com.cert.pem;
9
    ssl_certificate_key /etc/nginx/ssl/example.com.key.pem;
10

11
    root /root/fuwari/dist;  # 指向 dist 目录
12
    index index.html;
13

14
    location / {
15
        try_files $uri $uri/ /index.html;
16
    }
17
}