在搬瓦工 VPS 上搭建 Z-Blog 博客完整教程

Z-Blog 是一款国产开源 PHP 博客/CMS 程序，以轻量、易用著称，官方应用中心提供丰富的主题和插件，非常适合国内用户搭建个人博客、企业官网或小型资讯站。本文以 Debian/Ubuntu + Nginx + MySQL + PHP 8.1 环境为例，完整演示 Z-Blog PHP 版的安装与配置。

本文要点

PHP 扩展安装与权限配置
下载 Z-Blog 源码并部署到 Nginx
完成安装向导
配置 Nginx 伪静态，启用 SEO 链接
主题与插件安装推荐

环境要求

组件	最低版本	推荐版本
PHP	7.2	8.1 / 8.2
MySQL	5.6	8.0
PHP 扩展	pdo_mysql, gd, curl, mbstring, zip	全部安装
内存	128MB	512MB+

安装 PHP 扩展：

apt install -y php8.1-fpm php8.1-mysql php8.1-gd php8.1-curl php8.1-mbstring php8.1-zip php8.1-xml
systemctl restart php8.1-fpm

创建数据库

mysql -u root -p

CREATE DATABASE zblog DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'zbuser'@'localhost' IDENTIFIED BY '此处填强密码';
GRANT ALL PRIVILEGES ON zblog.* TO 'zbuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

下载并部署 Z-Blog

从 Z-Blog 官网下载最新 PHP 版安装包，上传并解压：

mkdir -p /var/www/zblog
# 上传后解压（以本地下载后 scp 为例）
# scp z_blog_php.zip root@服务器IP:/tmp/
unzip /tmp/z_blog_php.zip -d /tmp/zblog_tmp
cp -r /tmp/zblog_tmp/z_blog_php/* /var/www/zblog/
chown -R www-data:www-data /var/www/zblog
find /var/www/zblog -type d -exec chmod 755 {} \;
find /var/www/zblog -type f -exec chmod 644 {} \;
# Z-Blog 需要 zb_users 目录可写
chmod -R 775 /var/www/zblog/zb_users

配置 Nginx 虚拟主机

nano /etc/nginx/sites-available/zblog

填入以下配置（包含 Z-Blog 伪静态规则）：

server {
    listen 80;
    server_name your-domain.com www.your-domain.com;
    root /var/www/zblog;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }

    # Z-Blog 伪静态核心规则
    rewrite ^(.*)/post/([0-9]+)\.html$ $1/index.php?zblogphp=1&id=$2 last;
    rewrite ^(.*)/tag/(.+)\.html$ $1/index.php?zblogphp=1&tag=$2 last;
    rewrite ^(.*)/category/([a-zA-Z0-9-]+)\.html$ $1/index.php?zblogphp=1&cate=$2 last;

    location ~ /zb_system/(function|core|image/captcha)\.php$ { allow all; }
    location ~ /zb_system/ { deny all; }
    location ~ /zb_users/theme/ { allow all; }
    location ~ /zb_users/ { deny all; }
}

ln -s /etc/nginx/sites-available/zblog /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

运行安装向导

在浏览器访问 http://你的IP/zb_install/，进入安装向导：

检查环境，确认所有项均通过
填写数据库配置（主机 localhost，库名 zblog，用户 zbuser，密码）
设置博客名称和管理员账号信息
点击"开始安装"，等待完成

安装完成后，立即删除安装目录：

rm -rf /var/www/zblog/zb_install

删除 zb_install 目录

Z-Blog 的 zb_install 目录若不删除，任何人均可重新运行安装向导覆盖数据。安装完成后立即删除。

配置伪静态链接

登录 Z-Blog 后台（地址为 /zb_system/login.php）→ 系统设置 → URL 设置，开启伪静态并选择自定义链接格式（如 /post/{id}.html）。上面 Nginx 配置中的重写规则已经涵盖常用格式，保存后在前台验证文章链接是否变为静态 HTML 格式。

主题与插件推荐

Z-Blog 官方应用中心（app.zblogcn.com）提供大量免费主题和插件，在后台 应用中心 可直接搜索安装：

类型	推荐应用	功能
主题	Clearision	简洁现代风格，响应式设计
主题	ZBP Tiny	极简轻量主题，适合文字博客
插件	SEO 优化插件	自动生成 meta description、sitemap
插件	评论通知	新评论邮件通知管理员
插件	防垃圾评论	过滤垃圾留言和广告评论

应用中心安装方式

在 Z-Blog 后台进入 应用中心，搜索应用名称，点击安装，系统会自动下载并安装，无需手动上传文件。安装完成后在 插件管理 或 主题管理 中启用即可。

小结

Z-Blog 轻量易用，适合个人博客和小型内容站
Nginx 伪静态规则包含了 Z-Blog 所有常用 URL 格式
zb_install 目录必须在安装后立即删除
官方应用中心提供一键安装主题插件，极大降低扩展门槛

常见问题

Z-Blog 的后台登录地址是什么？

默认后台地址为 /zb_system/login.php，也可通过首页底部的"管理"链接进入。

Z-Blog 和 WordPress 哪个更适合新手？

Z-Blog 配置更简单，国内用户使用更顺畅，应用中心资源丰富；WordPress 国际化程度更高，插件生态更大。两者对新手都友好，Z-Blog 的学习曲线略低。

如何备份 Z-Blog 网站数据？

Z-Blog 后台提供数据备份功能（系统设置 → 数据备份），可导出数据库；文件层面使用 tar 命令打包 /var/www/zblog/zb_users 目录（包含所有用户上传和配置数据）。