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

容器化实战：1Panel 部署 Z-BlogPHP 的数据库连接与目录陷阱

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

# 技术运维：利用 IP 直连在 1Panel 上光速部署 Z-BlogPHP

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

---

在“为了折腾而折腾”的圈子里，Halo 确实很火，界面炫酷，技术栈新颖。
但如果是为了**“过日子、做运营、搞流量”**，**Z-BlogPHP** 才是那个最稳重、最让站长省心的“老管家”。

* **成熟：** 十几年的积淀，代码极其精简，对服务器资源占用极低。
* **生态：** 插件库（尤其是 SEO 类）极其丰富，这正是流量操盘手最看重的。
* **架构：** PHP 是互联网的“通用语”，出了问题随便搜都有答案，不像 Java 报错一堆堆栈看不懂。

以下是 1Panel 部署 Z-BlogPHP 的全流程实战。

---

## 第一步：准备粮仓 (创建数据库)

Z-Blog 需要一个地方存文章。在 Docker 环境下，这一步有讲究。

1.  打开 1Panel -> **数据库** -> **MySQL**。
2.  点击 **“创建数据库”**。
    * **名称：** 建议填 `zblog_muqing`（清晰易读）。
    * **用户名：** 建议填 `zblog_user`（**安全铁律：** 永远不要在业务代码里用 root 账号）。
    * **密码：** 复制生成的复杂密码，存到备忘录。
    * **权限：** 默认 `%` 或 `127.0.0.1` 均可（在 1Panel 内部容器网络里是互通的）。
3.  点击确认。

---

## 第二步：打好地基 (创建网站)

这一步有个**关键技巧**，能让你在域名无法解析时也能访问网站。

1.  打开 1Panel -> **网站**。
2.  点击 **“创建网站”** -> 选择 **“运行环境”**。
3.  **核心配置：**
    * **主域名：** 填 `muqing.net`。（先占坑，方便后续管理，虽然现在打不开）。
    * **其他域名（关键）：** **填你的公网 IP 地址**（例如 `123.45.67.89`）。
        * *原理：填了 IP，Nginx 就会监听这个 IP 的请求。你可以直接通过 IP 进入安装程序。*
    * **运行环境：** 选择之前创建的 `PHP 8.2`。
4.  点击确认。

---

## 第三步：进货上架 (上传程序)

1.  去 [Z-Blog 官网](https://www.zblogcn.com/) 下载最新的正式版（.zip 或 .xml）。
2.  回到 1Panel 网站列表，点击 `muqing.net` 右侧的 **“文件”**。
3.  **清理现场：** 全选并删除默认生成的 `index.php` 和 `404.html`。
4.  **上传解压：** 上传 Z-Blog压缩包并解压。
5.  **避坑指南（目录层级）：**
    * 解压后，请务必检查 `index.php` 是否在**当前根目录**。
    * 如果解压出了一个文件夹（如 `Z-BlogPHP_1_7_3`），请点进去 -> 全选 -> 剪切 -> 回到上一级 -> 粘贴。**不要让程序多套一层壳！**

---

## 第四步：开始装修 (安装向导)

在浏览器地址栏输入：`http://你的公网IP`。
你应该能看到 Z-Blog 熟悉的安装界面了。

### 1. 环境检查
如果之前的 PHP 扩展（GD, MySQLi, Curl）选对了，这里应该是一路**绿灯**。

### 2. 数据库设置 (由 Docker 导致的“最大深坑”)
这是 99% 新手卡住的地方。
* **数据库主机：**
    * ❌ **错误：** `localhost` （在 Docker 里，localhost 指向的是 PHP 容器自己，而不是数据库）。
    * ✅ **正确：** **`mysql`** （这是 1Panel 数据库容器的服务名）或 **`127.0.0.1`**。
* **账号密码：** 填第一步创建的 `zblog_user` 和对应密码。
* **数据库名：** `zblog_muqing`。

### 3. 网站设置
* **标题：** 填“沐青硬核操盘”或你的 IP 名称。
* **管理员：** 设置好密码。

点击下一步，**安装成功！🎉**

---

## 第五步：挂绿锁 (预绑定 SSL)

虽然现在主要用 IP 访问（提示不安全），但我们可以先把证书绑好，为未来做准备。

1.  回到 1Panel -> 网站 -> 点击配置。
2.  点击 **“HTTPS”** 标签。
3.  **启用 HTTPS：** 勾选。
4.  **SSL 证书：** 下拉选择你申请好的 `*.muqing.net` 泛域名证书。
5.  **强制 HTTPS：** **暂时不要勾选！**
    * *原因：IP 地址是没有 SSL 证书的。如果现在开启强制 HTTPS，通过 IP 访问时会报错或无法连接。等备案下来，只用域名访问时再开这个开关。*
6.  点击保存。

---

## 沐青总结

至此，你的 **Z-BlogPHP** 已经成功跑在了 **1Panel** 上。
现在的状态是：
* **可以通过 IP 访问后台**，发文章、装主题、调 CSS，随便折腾。

**Next Step：**
博客搭好了，下一步就是**SEO 优化**。Z-Blog 默认的伪静态规则（URL 结构）对搜索引擎并不友好。下一期，我将教你如何配置 **Nginx 伪静态**，把 URL 变成百度最喜欢的 `.html` 结尾。