使用 blog-tool 一键部署博客系统（10 分钟上线）

一、环境前提

请先按 《建站前置条件清单》 准备好：

• 一台 Debian 13 (Trixie) 或 Ubuntu 24.04 及以上 服务器（x86_64）
• root 或 sudo 权限
• 想公网访问：域名 + 备案（国内）+ HTTPS 证书
• 想做付费：商户资质

ssh 链接参考 如何使用 tabby SSH 连接 Linux

二、下载 blog-tool

国内推荐 OSS：

curl -fsSL -o blog-tool.sh https://demo.jiaopengzi.com/sh/blog-tool.sh

GitHub 用户：

curl -fsSL -o blog-tool.sh https://raw.githubusercontent.com/jiaopengzi/blog-tool/main/dist/blog-tool.sh

三、零交互安装

第一次部署，建议直接使用零交互安装。它会按顺序帮您做完如下操作：

• 新建运行所需的系统用户
• 生成自签 SSL 证书
• 全新安装 Docker（⚠️ 如果机器上已有别的 Docker 业务，请勿选此项，请使用菜单逐项执行）
• 拉取所有需要的镜像（含 blog-server + blog-client）
• 初始化并安装数据库（PostgreSQL、Redis、ES）
• 安装 server + client 服务
• 注册管理员账户

复制命令后，将如下参数修改为您自己的内容即可。

1、有域名和公网 IP

sudo bash blog-tool.sh --auto \
 --domain=example.com \
 --project_name=blog-server \
 --public_ip=1.2.3.4 \
 --cert=/your/path/cert.pem \
 --cert_key=/your/path/cert.key \
 --admin_username=adminuser \
 --admin_email=adminuser@example.com \
 --admin_password='Password123'

2、本地内网无公网 IP

在本地 wsl 执行命令前，需要将 Windows 宿主机的防火墙入站规则放行 80,443,5426 端口；避免造成 blog-server 启动超时 的错误。

sudo bash blog-tool.sh --auto \
 --admin_username=adminuser \
 --admin_email=adminuser@example.com \
 --admin_password='Password123'

参数说明：

图片示例中，我们用 test.jiaopengzi.com 来举例。

在安装 docker 的时候，需要耐心等待。

最后看到如下信息，即表示安装成功。可以访问，查看结果。

再次查看当前目录时，会多一个 volume 的目录，这是所有数据目录，非常重要。

整个一键部署的时间，会依赖网速快慢，一般时间在 5~10 分钟内都能完成。

四、命令面板日常维护

sudo bash blog-tool.sh

执行后，您会看到一个交互式菜单：

1. 看日志（排查问题）

08  监控 server 日志  

2. 升级 / 回滚

11  查看 server 版本 
12  查看 client 版本
13  升级或回滚 server
14  升级或回滚 client   

按版本号挑升级 / 回滚，不需要重新部署。

3. 重启服务

09  重启 server 服务
10  重启 client 服务

五、注意事项

1. 需将域名解析到部署机器公网IP；
2. 服务器：必须在控制台开放端口（80 / 443）。

配套教程导航

本文是『自建博客系统教程』系列第 5 篇，配套教程共 13 篇。