ZBlog站点基础搭建全程实操指南 从环境部署到上线全流程零门槛操作

一、前置准备（操作前需提前备好所有物料）

以下物料需提前准备完成，避免搭建过程中断：

• 服务器/虚拟主机：国内服务器需提前完成域名备案，推荐使用CentOS7.9及以上版本云服务器，虚拟主机需满足PHP5.6~8.1、MySQL5.6及以上、支持伪静态、存储空间≥1G
• 已解析的域名：将域名A记录解析到服务器/虚拟主机的IP地址，解析生效时间一般为1~10分钟
• FTP工具：FileZilla，官方下载地址：https://filezilla-project.org/download.php?type=client，仅用于虚拟主机文件上传，云服务器可直接用面板在线操作

二、运行环境部署

2.1 虚拟主机环境（新手首选）

直接在主机商后台确认以下配置已开启即可，无需手动部署：

• PHP版本切换为7.4（兼容性最优）
• MySQL数据库已创建，记录好数据库名、用户名、密码、连接地址
• 根目录权限设置为可读可写

2.2 云服务器环境（宝塔面板一键部署）

云服务器先开放端口：80、443、8888（宝塔面板端口），操作路径为云服务商后台的安全组配置。然后远程登录服务器执行以下命令安装宝塔面板：

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

安装完成后控制台会输出面板地址、管理员账号、密码，保存好后登录面板，在弹出的推荐套件页选择以下组件一键安装：

• Nginx 1.20
• MySQL 5.7
• PHP 7.4

套件安装完成后，点击左侧【网站】-【添加站点】，输入你的域名，数据库选择MySQL，系统会自动生成数据库名、账号、密码，记录下来后续要用，点击提交即可。

三、ZBlog程序上传与安装

3.1 程序下载与上传

ZBlog官方最新正式版下载地址：https://www.zblogcn.com/download/zblogphp/，下载后得到zip压缩包。

虚拟主机操作：打开FileZilla，输入主机商提供的FTP地址、账号、密码，端口默认21，连接成功后将压缩包内所有文件上传到根目录（一般为public_html或wwwroot文件夹）。

云服务器操作：进入宝塔面板【网站】- 对应站点的根目录，点击上传按钮，将下载的zip压缩包上传后右键选择在线解压，解压后确认所有文件直接放在根目录，不要嵌套zblogphp文件夹。

3.2 安装向导配置

直接在浏览器访问你的域名，系统会自动跳转至ZBlog安装向导：

• 第一步：环境检测，所有检测项显示对号后点击下一步，如有红叉需对应修复环境配置
• 第二步：数据库配置，填写之前记录的数据库地址（本地部署填localhost，云服务器默认也是localhost）、数据库名、数据库用户名、数据库密码
• 第三步：管理员账号设置，禁止使用admin作为管理员用户名，密码需至少8位，包含数字、字母、特殊字符，填写完成后点击下一步

安装完成后系统会提示成功，后台登录地址为：你的域名/zb_system/login.php，保存好该地址。

四、站点基础初始化配置

4.1 伪静态配置

登录后台，点击左侧【设置】-【伪静态】，勾选【启用伪静态】，选择你的服务器环境（Nginx/Apache），复制系统生成的伪静态规则：

云服务器用户：进入宝塔面板【网站】- 对应站点的【设置】-【伪静态】，粘贴规则后保存。

Apache环境用户：系统会自动生成.htaccess文件到根目录，无需手动操作，确认根目录有该文件即可。

4.2 基础信息配置

点击左侧【设置】-【站点设置】，按需填写以下内容：

• 站点名称、站点描述、首页关键词（对应SEO基础配置）
• 首页文章显示数量（推荐设置为10~20篇）
• 评论审核开关（推荐开启新评论需审核，避免垃圾内容）
• 上传附件大小限制（按需调整，最大不超过PHP配置的上传上限）

4.3 必装插件与主题配置

点击左侧【插件管理】-【获取插件】，搜索安装以下免费插件：

• 静态缓存插件：大幅提升站点访问速度，启用后默认配置即可
• 登录/评论验证码插件：防止暴力破解后台、垃圾评论
• XML地图插件：自动生成sitemap，方便搜索引擎收录

点击左侧【主题管理】-【获取主题】，筛选响应式免费主题，安装启用后可在主题设置内调整配色、布局等参数。

五、常见问题排查

• 访问域名跳转到404页面：检查根目录是否存在index.php文件，若解压后文件嵌套在zblogphp文件夹内，需将文件夹内所有文件移动到根目录
• 伪静态配置后文章页404：检查服务器伪静态规则是否粘贴正确，是否和当前使用的Web服务器（Nginx/Apache）匹配
• 后台密码遗忘：登录数据库管理面板（phpMyAdmin），找到zb_member表，将对应管理员账号的password字段值修改为e10adc3949ba59abbe56e057f20f883e（对应密码123456），登录后立即修改为自定义强密码
• 后台上传附件失败：检查根目录zb_users/UPLOAD文件夹权限是否设置为755，PHP配置的上传大小上限是否大于上传文件大小