Apache多端口监听需同步修改httpd.conf中的Listen和ServerName,再在httpd-vhosts.conf中为每个端口配置独立VirtualHost、DocumentRoot及Directory权限,并确保Z-Blog数据库名、表前缀、zb_users目录和cache完全隔离。

Apache多端口监听必须改httpd.conf里的Listen和ServerName
XAMPP默认只监听80端口,想用http://localhost:8080和http://localhost:8081同时跑两个Z-Blog站点,光加一行Listen 8080不够——ServerName也得同步更新,否则Apache启动时会报错或拒绝响应。
打开XAMPP\apache\conf\httpd.conf,找到这两处修改:
-
Listen 80改成Listen 80(保留原端口)、再新增Listen 8080和Listen 8081 -
ServerName localhost:80改为ServerName localhost:80,再新增两行:ServerName localhost:8080和ServerName localhost:8081
不改ServerName会导致虚拟主机识别失败,浏览器访问:8080时可能直接跳转到XAMPP首页或返回404。
每个端口要对应独立的DocumentRoot和Directory权限配置
Z-Blog不是单入口程序,它依赖zb_users/cache等子目录写入权限。如果两个站点共用htdocs,缓存、插件、主题会互相污染;更糟的是,Directory权限没配对,会出现403或500错误。
在XAMPP\apache\conf\extra\httpd-vhosts.conf里添加两个<VirtualHost>块:
<VirtualHost *:8080>
DocumentRoot "X:/XAMPP/htdocs/zblog-en"
<Directory "X:/XAMPP/htdocs/zblog-en">
Require all granted
AllowOverride All
</Directory>
</VirtualHost>
<VirtualHost *:8081>
DocumentRoot "X:/XAMPP/htdocs/zblog-cn"
<Directory "X:/XAMPP/htdocs/zblog-cn">
Require all granted
AllowOverride All
</Directory>
</VirtualHost>
注意三点:
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包,专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括:Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统,可让开发者在个人电脑上轻松模拟服务器环境,无需复杂配置即可运行 WordPress、Thin
- 路径中的盘符(如
X:)必须和你实际安装路径一致,不能用C:写死后复制粘贴到D盘环境 -
Require all granted是Apache 2.4+必需项,漏掉就403;旧版Allow from all在XAMPP新版本中已失效 - 两个Z-Blog必须分别解压到
zblog-en和zblog-cn这样的独立子目录,不能混放
数据库名、表前缀、zb_system/config.php三者必须一一对应
同一MySQL实例下跑多个Z-Blog,靠的不是端口隔离,而是数据库层面的区分。装第二个站点时,如果还用zblog库名+默认zbp_前缀,安装过程会提示“表已存在”,或者后台登录后文章全乱。
操作顺序不能错:
- 先用phpMyAdmin新建库
zblog_en和zblog_cn,字符集选utf8mb4_unicode_ci - 安装第一个站点时,在数据库配置页填库名
zblog_en、表前缀留空或填en_ - 安装第二个站点时,库名填
zblog_cn、表前缀填cn_(避免和第一个冲突) - 装完立刻检查各自
zb_system/config.php里的$zbp->option['ZC_DATABASE_NAME']和'ZC_TABLE_PREFIX'值是否匹配
常见错误:改了库名但忘了改config.php,导致后台打不开或前台显示空白页,错误日志里会出现Table 'zblog_cn.zbp_post' doesn't exist这类提示。
zb_users目录权限和cache清空时机容易被忽略
多端口部署后最隐蔽的问题,往往出在缓存和权限上。比如你在:8080站点后台更新了主题,:8081站点却还在用旧CSS——因为两个站点若共用zb_users/cache,缓存文件会互相覆盖。
正确做法是:
- 每个Z-Blog子目录下的
zb_users必须是独立副本,不能硬链接或共享 - Windows下右键
zb_users→ 属性 → 安全 → 编辑 → 给IIS_IUSRS或Everyone勾选“修改”权限(仅限开发环境) - Linux/macOS执行:
chmod -R 755 zb_users,但zb_users/theme和zb_users/plugin若需上传,应补775 - 每次切换站点调试前,手动删掉对应
zb_users/cache/*下的所有文件,避免旧缓存干扰
这个步骤没有图形化提示,也不报错,但会导致样式错乱、插件不生效、后台设置不保存——问题表象和原因完全脱节,排查起来最耗时间。

















