ZBlog零基础使用全指南：从环境部署到发布首篇文章分步实操

一、前期准备与环境搭建

本文基于云服务器+宝塔面板实操，零基础可直接照搬所有步骤，所有工具免费可用。

1.1 准备基础资源

• 服务器：选择1核1G1M带宽的云服务器即可满足个人博客需求，系统选择CentOS 7.x
• 域名：在正规域名服务商注册即可，国内服务器需提前完成ICP备案

1.2 安装宝塔面板

远程连接你的云服务器，复制粘贴以下命令回车执行，等待3-5分钟即可完成安装：

``` yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh ```

安装完成后，控制台会输出面板登录地址、默认账号和密码，请务必把这些信息保存好，后续登录要用。

1.3 安装ZBlog所需运行环境

用浏览器打开刚才获取的面板登录地址，输入账号密码登录，按以下步骤操作：

1. 点击左侧菜单栏【软件商店】
2. 搜索安装 Nginx 1.20、PHP 7.4、MySQL 5.7，全部使用默认配置即可，不需要修改任何参数
3. 安装完成后，点击左侧【网站】-【添加站点】
4. 在域名框输入你注册备案好的域名，数据库选择MySQL，PHP版本选择7.4，点击提交
5. 提交完成后，会弹出数据库的名称、用户名和密码，一定要把这三个信息复制保存，安装ZBlog的时候必须用到

二、ZBlog程序下载与部署

2.1 下载官方最新程序

直接打开官方下载地址获取安装包：https://www.zblogcn.com/download/，下载最新稳定版ZBlog PHP压缩包到本地电脑即可。

2.2 上传程序到服务器

1. 回到宝塔面板，点击你刚创建的站点右侧的【根目录】，进入站点文件目录
2. 选中目录里默认的所有文件，点击删除，清空根目录
3. 点击页面上方的【上传】按钮，选择你刚下载到本地的ZBlog压缩包，等待上传完成
4. 上传完成后，点击压缩包右侧的【解压】，选择解压到当前目录，点击确认

注意：必须确保解压后，ZBlog的入口文件index.php直接在站点根目录，不能放在二级文件夹下，否则会出现访问404错误，这是新手最容易出错的地方

三、在线完成ZBlog安装

所有部署完成后，打开你的域名，会自动跳转到ZBlog的安装引导页面，按以下步骤操作即可：

1. 勾选同意用户协议，点击下一步
2. 进入数据库配置页面，数据库地址固定填localhost，然后把之前保存的数据库名称、数据库用户名、数据库密码分别填入对应输入框
3. 设置网站名称（也就是你的博客标题），设置管理员账号和密码，记好这个账号密码，后续登录后台要用
4. 点击开始安装，等待10秒左右会提示安装完成，点击进入后台即可登录ZBlog管理后台

四、基础配置与发布文章

4.1 必做基础配置

刚登录后台，只需要完成3项基础配置就能正常使用：

1. 永久链接配置

   点击左侧菜单栏【设置】-【永久链接】，文章链接格式选择自定义，填入以下内容后保存：

   /%category%/%post_id%.html

   这种链接结构清晰，更利于搜索引擎收录。

2. 主题安装

   点击左侧【主题】-【添加新主题】，可以直接在线搜索免费主题，找到喜欢的主题点击安装，安装完成后启用即可；也可以下载第三方主题压缩包后，点击上传压缩包安装。

3. 必备插件安装

   点击左侧【插件】-【添加新插件】，搜索安装2个免费必备插件：Akismet反垃圾评论（自动阻挡垃圾评论）、百度XML地图（生成网站地图方便搜索引擎收录），安装后直接启用即可，不需要额外配置。

4.2 发布第一篇文章

基础配置完成后，就可以发布内容了，步骤非常简单：

1. 点击左侧菜单栏【文章】-【写文章】
2. 在顶部标题输入框填写你的文章标题，中部编辑器中输入文章内容，编辑器是可视化操作，支持直接插入图片、修改文字格式，不需要懂代码
3. 右侧可以选择文章分类，也可以点击新建分类创建自己需要的分类
4. 所有内容编辑完成后，点击页面底部的发布按钮，文章就正式上线了

打开你的网站首页，就能看到刚发布的第一篇文章了。

五、零基础常见问题解决

• 访问域名显示404错误：90%以上是因为ZBlog文件被解压到了二级目录，检查根目录是否有index.php文件，移动所有文件到根目录即可；另外检查宝塔站点的域名绑定是否正确。
• 安装提示数据库连接失败：检查数据库账号密码是否复制错误，服务器环境下数据库地址默认就是localhost，不需要修改。
• 无法访问网站或后台：检查云服务器的安全组是否开放了80（HTTP）和443（HTTPS）端口，到服务器运营商后台安全组规则添加这两个端口即可。