Z-Blog是一款国产开源博客系统，最初基于ASP开发，后推出PHP版本，以MIT协议开源。Z-Blog诞生于2005年，是国内历史最悠久的独立博客程序之一，以简洁、稳定、易用著称。Z-Blog拥有丰富的模板和插件生态，支持多用户、多语言，适合个人博客、企业官网、小型资讯站点。
核心优势：安装简单、后台操作直观、模板体系成熟、插件丰富、支持静态化生成、SEO友好、多数据库支持（MySQL/SQLite/PostgreSQL）、多语言支持、国内社区活跃。Z-Blog PHP版本性能优秀，资源占用低，是国内博客用户的热门选择。
环境要求
- Web服务器：Nginx / Apache / IIS
- PHP版本：PHP 7.0 ~ 8.3（推荐PHP 8.0+）
- 数据库：MySQL 5.5+ / MariaDB / SQLite 3 / PostgreSQL
- 内存：最低128MB，推荐256MB以上
- 磁盘：至少100MB可用空间
- PHP扩展：pdo、pdo_mysql（或pdo_sqlite）、mbstring、json、curl、gd、xml
安装教程
步骤1：下载Z-Blog PHP安装包
cd /www/wwwroot/yourdomain.com
wget https://www.zblogcn.com/download/zblogphp/latest.zip -O zblog.zip
unzip zblog.zip
rm -f zblog.zip解压后将Z-BlogPHP目录内的所有文件移至网站根目录。
步骤2：创建数据库（MySQL方式）
mysql -u root -p
CREATE DATABASE zblog DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'zblog_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON zblog.* TO 'zblog_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;也可选择SQLite，无需创建数据库，安装时自动生成。
步骤3：配置文件权限
chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
chmod -R 777 /www/wwwroot/yourdomain.com/zb_users
chmod 666 /www/wwwroot/yourdomain.com/zb_users/c_option.php 2>/dev/null || true步骤4：Nginx配置
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /www/wwwroot/yourdomain.com;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
fastcgi_pass unix:/tmp/php-cgi-82.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
location ~ /\.ht {
deny all;
}
}
步骤5：运行安装向导
浏览器访问 http://yourdomain.com，自动进入安装页面：
- 选择安装语言（简体中文）
- 环境检测页面，确认所有检测项通过
- 填写数据库配置：
- 数据库类型：MySQL（PDO）
- 数据库服务器：localhost
- 数据库用户名：zblog_user
- 数据库密码：你的密码
- 数据库名称：zblog
- 表前缀：zbp_（默认即可）
- 填写网站信息：
- 网站名称：你的博客名称
- 管理员用户名：admin
- 管理员密码：设置强密码
- 管理员邮箱：你的邮箱
- 点击”下一步”，等待安装完成
步骤6：登录后台
安装完成后，访问 http://yourdomain.com/zb_system/login.php 登录后台。Z-Blog后台功能包括：文章管理、页面管理、评论管理、分类管理、标签管理、模板管理、插件管理、用户管理、数据备份、系统设置等。
Windows环境安装（phpStudy集成环境）
对于Windows用户，推荐使用phpStudy或XAMPP集成环境快速搭建：
- 下载安装phpStudy（https://www.xp.cn）或XAMPP（https://www.apachefriends.org）
- 启动集成环境，开启Apache/Nginx和MySQL服务
- 将程序源码解压到网站根目录（phpStudy默认是WWW目录，XAMPP默认是htdocs目录）
- 打开phpMyAdmin创建数据库（访问http://localhost/phpmyadmin）
- 浏览器访问http://localhost，按照安装向导完成安装
注意：Windows环境仅推荐用于本地开发和测试，生产环境建议使用Linux服务器。
宝塔面板安装（推荐）
宝塔面板是国内最流行的服务器管理面板，支持一键部署PHP环境和网站：
- 安装宝塔面板：CentOS执行
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh，Ubuntu/Debian执行wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh - 安装完成后，登录宝塔面板（地址和账号密码在安装完成后显示）
- 首次登录提示安装LNMP/LAMP环境，选择Nginx + MySQL + PHP，点击一键安装
- 点击”网站” → “添加站点”，填写域名、选择PHP版本、创建数据库
- 将程序源码上传到网站根目录（/www/wwwroot/你的域名）
- 设置目录权限：在文件管理器中选中网站目录，权限设置为755，所有者为www
- 浏览器访问域名，按照安装向导完成安装
宝塔面板优势：可视化操作、一键环境配置、方便管理数据库和文件、内置SSL证书部署、适合新手和非技术用户。
服务器配置建议
- PHP内存限制：
memory_limit = 128M - 上传文件大小：
upload_max_filesize = 32M，post_max_size = 32M - 最大执行时间：
max_execution_time = 120 - 启用OPcache加速
- 后台设置 → 静态管理中心 → 开启伪静态（需Nginx配置支持）
- 可配置纯静态化，进一步提升性能和SEO效果
- 安装缓存插件（如Z-Blog缓存插件）
- 定期备份数据库和zb_users目录
常见问题
Q：安装时提示”zb_users目录不可写”？
A：执行chmod -R 777 zb_users，确保目录所有者为www用户。
Q：开启伪静态后文章404？
A：确认Nginx配置中包含try_files $uri $uri/ /index.php?$args;，并在后台静态管理中心重新保存设置。
Q：后台登录提示验证码错误？
A：检查PHP是否安装了gd扩展，验证码依赖gd库。执行apt install php8.2-gd。
Q：忘记管理员密码怎么办？
A：数据库执行：UPDATE zbp_member SET Password=MD5('新密码') WHERE ID=1;（zbp_替换为你的表前缀）