Z-BlogPHP 手动安装完整教程：从下载到伪静态

虚拟主机或云服务器装 Z-BlogPHP，全程十分钟以内。这篇按顺序把每一步写清楚，包括最容易卡住的伪静态。

一、准备工作

• 下载 Z-BlogPHP 最新版安装包（注意别下成主题包）
• 准备好数据库信息：主机地址、库名、用户名、密码
• 确认环境：PHP ≥ 7.4（推荐 8.0 以上）、MySQL ≥ 5.6

二、上传源码

把安装包上传到网站根目录并解压。解压后根目录应该能看到 index.php、zb_system、zb_users 这几项。

如果解压后多了一层文件夹（比如 Z-BlogPHP_1.7.5/），要把里面的内容移到根目录，否则访问会白屏或出现目录列表。

三、目录权限

Linux 环境下把站点目录属主设为 web 用户（宝塔面板默认是 www），权限 755 即可，不要图省事直接 777。

四、运行安装向导

浏览器访问站点域名，会自动跳转到安装向导。按提示填写数据库信息并创建管理员账号。

两个提醒：

• 数据库前缀别用默认的 zbp_，改成自己的，能挡掉一部分自动化扫描
• 管理员密码设强一点，安装完成后确认 zb_install 目录已删除

五、配置伪静态（最容易卡的一步）

不配伪静态，文章地址会是 ?id=123 这种形式，对 SEO 不友好。步骤：

1. 后台 → 网站设置 → 开启静态化管理，选好 URL 规则
2. 服务器端加对应重写规则：
   • nginx：在站点配置里加 rewrite 规则，或用面板的"伪静态"功能直接选 Z-Blog 规则
   • Apache：确认 mod_rewrite 已开启，且站点允许 .htaccess 生效
3. 保存后访问一篇文章，看地址是否变成 post/x.html 这类形式

六、安装后必做的几件事

• 改掉默认的网站名称和副标题
• 删除示例文章和测试分类
• 设置好每页的 TDK
• 生成并提交 sitemap

常见问题

访问报 404：先确认站点运行目录设置正确，再检查伪静态规则。

安装向导不出现：多半是根目录多了层级，或目录权限不对。

后台白屏：查看 PHP 错误日志，常见原因是 PHP 版本过低或缺少扩展。

本文链接：https://www.zkui.cn/post/10.html