当前位置：首页 > 技术运维

从源码到上线：Z-BlogPHP 在 1Panel 面板的全流程部署实操

李牧之6个月前 (12-05)技术运维86

**作者：沐青 | 栏目：技术运维 | 预计阅读时间：8 分钟**

---

Z-BlogPHP 以其轻量、高效著称，非常适合作为个人 IP 的流量承载页。而 1Panel 则是目前最火的现代化运维面板。

很多新手习惯了“应用商店一键安装”，但在 1Panel 上，Z-Blog 官方应用可能缺席，或者第三方库更新滞后。
更重要的是，**作为技术流站长，你必须拒绝“黑盒交付”。**

只有通过**“源码 + 手动环境构建”**的方式部署，你才能完全掌控网站的 PHP 版本、扩展配置以及目录权限。一旦后续出现性能瓶颈，你才知道去哪里优化。

本文将拆解在 1Panel 上部署 Z-Blog 的标准流程。

## 一、 环境准备：容器化的底层逻辑

1Panel 的核心是 Docker。在开始之前，请确保你的“应用商店”里已经安装了以下两个基础设施：
1.  **OpenResty** (Web 服务器，Nginx 的增强版)
2.  **MySQL** (数据库，推荐 5.7 或 8.0)

---

## 二、 构建 PHP 运行环境 (Runtime)

Z-BlogPHP 是 PHP 程序，我们需要先给它造一个“容器壳子”。

1.  进入 **“网站” -> “运行环境”**。
2.  点击 **“创建运行环境”**。
    * **名称：** 建议命名为 `php8.1-zblog`，方便识别。
    * **PHP 版本：** 强烈推荐 **PHP 8.0** 或 **PHP 8.1**。这是性能与兼容性的最佳平衡点（配合 JIT 性能起飞）。
    * **镜像源：** 保持默认。
    * **扩展选择：** Z-Blog 很轻量，但为了避免报错，请务必检查并勾选以下扩展：
        * `mysqli` (数据库连接必选)
        * `gd` (图片处理)
        * `curl` (远程请求)
        * `mbstring` (多字节字符串处理)
        * `xml` / `json` (基础数据处理)
3.  点击确认，等待系统自动拉取镜像并构建。

---

## 三、 创建网站与数据库挂载

环境造好了，现在开始建站。

1.  进入 **“网站” -> “网站”** 列表，点击 **“创建网站”**。
2.  **类型选择：** 必须选 **“运行环境”**。
3.  **核心配置：**
    * **主域名：** 填入你的域名（如 `blog.muqing.net`）。
    * **运行环境：** 选择上一步创建的 `php8.1-zblog`。
    * **数据库：** 选择 **MySQL**。
        * 设置一个复杂的密码。
        * **注意：** 系统会自动创建一个同名的数据库和用户，**请拿小本本记下来**，这一步至关重要。
4.  点击确认。

---

## 四、 源码部署：拒绝多余目录

这一步很多新手容易犯错，导致访问域名出现 403 或 404。

1.  前往 [Z-Blog 官网](https://www.zblogcn.com/) 下载最新的正式版安装包（.xml 或 .zip）。
2.  回到 1Panel，点击网站右侧的 **“文件”**。
3.  **清理现场：** 删除目录下默认生成的 `index.php` 或 `404.html` 文件，保持目录干净。
4.  **上传解压：**
    * 上传 Z-Blog 安装包。
    * 解压到当前目录。
    * **关键检查：** 确保 `index.php` 直接位于网站根目录（`www/sites/你的域名/index`），而不是躲在下一级文件夹里。如果多了一层文件夹，全选 -> 移动 -> 粘贴到根目录。

---

## 五、 安装向导与数据库连接陷阱

在浏览器访问你的域名，你将看到 Z-Blog 的安装界面。
前几步直接“同意”，重点在于 **数据库配置**。

**这是 1Panel 用户最容易卡壳的地方：**

* **数据库主机：** * **错误写法：** `localhost` (因为 PHP 在独立的容器里，localhost 指向的是 PHP 容器自己，而不是 MySQL)。
    * **正确写法：** `mysql` (1Panel 默认将 MySQL 容器的服务名设为 mysql) 或者 `127.0.0.1` (取决于容器网络模式)。
    * **沐青实战技巧：** 如果填 `mysql` 连不上，去 1Panel **“数据库”** 页面，查看 MySQL 的 **“连接地址”** 或容器别名。通常 Docker 内部互联用服务名最稳。

* **用户名/密码/数据库名：** 填入第三步记在本子上的信息。

点击安装，几秒钟后即可看到“安装成功”。

---

## 六、 伪静态配置 (流量核心)

安装完不是结束，如果不配置伪静态，你的文章链接会包含 `index.php`，既难看又影响 SEO 收录。

1.  回到 1Panel **“网站”** 列表，点击网站名称进入设置。
2.  点击 **“伪静态”** 标签。
3.  在下拉菜单中选择 **“Z-Blog”** 模板。
4.  点击 **“保存”**。

此时，去 Z-Blog 后台开启“静态化管理中心”，你的 URL 就会变成清爽的 `yourdomain.com/post/1.html` 格式。

---

## 沐青总结

在 1Panel 上部署 Z-Blog，本质是一次 **Docker 容器编排** 的微缩实践。

1.  **环境独立**：PHP 8.1 独立容器，互不干扰。
2.  **网络互通**：理解 `host` 和 `container` 的通信逻辑。
3.  **规则前置**：伪静态是 SEO 的生命线。

不要迷信“一键安装”，只有手动部署过的系统，你才真正拥有它的“Root 权限”。