讲师中心 微信公众号
AI工具推荐 视频效率加速

XAMPP环境下多端口部署Hexo静态博客

夏晨姑娘_2198

夏晨姑娘_2198

发布时间:2026-05-06 17:00:25

|

313人浏览过

|

来源于php中文网

原创

不能直接用 hexo s 在 XAMPP 里跑 Hexo 博客,因为 hexo s 启动的是独立 Express 服务器(默认端口 4000),与 XAMPP 的 Apache 完全无关;需通过 hexo g 生成静态文件并正确配置 Apache 虚拟主机、DirectoryIndex 和 mod_rewrite 才能使其在 XAMPP 中正常运行。

xampp环境下多端口部署hexo静态博客

为什么不能直接用 hexo s 在 XAMPP 里跑 Hexo 博客

Hexo 自带的 hexo s 启动的是独立 Express 服务器(默认端口 4000),和 XAMPP 的 Apache 完全无关。你把它开着,XAMPP 的 httpd.exe 还在监听 80 或 8080,两者不互通、不代理、不共享配置——相当于两个各自点火的炉子,烧的不是同一锅水。

想让 Hexo 内容走 XAMPP,核心动作只有一个:把 hexo g 生成的 public/ 目录当作纯静态文件,扔进 Apache 能服务的路径下,并确保端口、权限、重写规则都对得上。

如何把 public/ 正确挂进 XAMPP 的多端口 Apache

XAMPP 默认只开 80 端口,要支持多端口(比如 8080、8081),必须手动改 httpd.conf 和虚拟主机配置:

  • 打开 XAMPP\apache\conf\httpd.conf,确认已启用 Include conf/extra/httpd-vhosts.conf(去掉行首 #)
  • 编辑 XAMPP\apache\conf\extra\httpd-vhosts.conf,追加类似以下配置(以端口 8080 为例):
    <VirtualHost *:8080>
        DocumentRoot "D:/myblog/public"
        ServerName localhost
        <Directory "D:/myblog/public">
            Options Indexes FollowSymLinks
            AllowOverride All
            Require all granted
        </Directory>
    </VirtualHost>
  • 确保 DocumentRoot 指向你执行过 hexo g 后的真实 public/ 路径,且路径中不含中文或空格
  • 重启 Apache(通过 XAMPP 控制面板),再访问 http://localhost:8080 就能看到博客首页

hexo g 后的链接路径错乱?检查 url 和 root 配置

Hexo 生成的 HTML 中所有资源(CSS、JS、图片)路径,都依赖 _config.yml 里的两个关键字段:

XAMPP 8.0.30
XAMPP 8.0.30

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

下载
  • url: 必须设为最终可访问的完整地址,比如 http://localhost:8080(不是 http://localhost:4000)
  • root: 如果博客部署在子路径(如 http://localhost:8080/myblog/),这里才填 /myblog/;如果直接挂在根目录(http://localhost:8080/),就填 /
  • 改完务必重新执行 hexo clean && hexo g,否则旧缓存会继续输出错误路径

常见现象:页面空白、样式丢失、文章 404——八成是 root 填成了 /,但实际 Apache 虚拟主机却配在了子目录;或者 url 还留着默认的 http://yoursite.com,导致浏览器去请求外网资源。

Apache 处理 Hexo 的 404 和伪静态问题

Hexo 生成的是真实 HTML 文件(如 post/hello-world/index.html),但你访问 /post/hello-world/ 时,Apache 默认不会自动找 index.html——除非开启 DirectoryIndex:

  • 在虚拟主机配置的 <Directory> 块内,加上一行:DirectoryIndex index.html
  • 如果你用了 Hexo 插件(如 hexo-permalink-pinyin)生成非标准路径,或启用了 pretty_urls,还需启用 mod_rewrite 并添加 .htaccess(放在 public/ 根目录):
    RewriteEngine On
    RewriteBase /
    RewriteRule ^index\.html$ - [L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . /index.html [L]
  • 注意:mod_rewrite 必须在 httpd.conf 中启用(去掉 #LoadModule rewrite_module modules/mod_rewrite.so 前的 #)

没配好 DirectoryIndex,你会看到「Forbidden: You don't have permission to access this resource」;没启用 mod_rewrite 或规则不对,点击文章链接就会直接 404——这不是 Hexo 的问题,是 Apache 没理解你要它“兜底”。

最易被忽略的一点:每次改完 _config.yml 或 Apache 配置,都要分别执行 hexo clean && hexo g 和重启 Apache。两个环节缺一不可,且顺序不能反——先有正确的静态文件,再有正确的服务器响应。

热门AI工具

更多
PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
XAMPP用法详解
XAMPP用法详解

本专题整合了XAMPP相关用法介绍,阅读专题下面的文章了解更多详细内容。

253

2026.04.08

XAMPP 安装与快速入门指南
XAMPP 安装与快速入门指南

面向零基础用户,详细介绍 XAMPP 在 Windows、macOS、Linux 三大平台上的下载、安装步骤、首次启动配置、控制面板使用以及 Apache/MySQL 服务的基本启停操作,帮助初学者在最短时间内搭建起可用的本地开发环境。

250

2026.04.08

XAMPP Apache 与 MySQL 核心配置实战
XAMPP Apache 与 MySQL 核心配置实战

深入讲解 XAMPP 中 Apache 和 MySQL 的核心配置技巧,包括 httpd.conf 端口修改、虚拟主机(VirtualHost)多站点配置、MySQL 用户权限管理与远程连接设置、php.ini 关键参数调优,以及 SSL 证书的本地配置方法,适合有一定基础的开发者进阶使用。

465

2026.04.08

XAMPP 本地项目部署与调试全流程
XAMPP 本地项目部署与调试全流程

以 WordPress、Laravel、ThinkPHP 等主流 PHP 框架和 CMS 为例,演示如何在 XAMPP 环境中完成项目部署、本地域名绑定(hosts配置)、数据库导入、伪静态规则配置以及 Xdebug 断点调试的完整流程,让本地开发与线上环境无缝衔接。

122

2026.04.08

XAMPP 常见问题排查与故障解决
XAMPP 常见问题排查与故障解决

汇总 XAMPP 使用过程中最常遇到的故障场景及其解决方案,涵盖 80/443 端口被占用、Apache 或 MySQL 无法启动、phpMyAdmin 访问报错、文件权限不足、日志分析方法等问题,提供逐步排查思路与一键修复技巧,减少开发者的排错时间。

410

2026.04.08

XAMPP 安全加固与生产环境迁移
XAMPP 安全加固与生产环境迁移

聚焦 XAMPP 的安全实践与环境迁移,包括修改 MySQL 默认 root 密码、关闭目录列表浏览、限制 phpMyAdmin 外部访问、配置防火墙规则等安全加固措施,同时讲解如何将 XAMPP 本地开发完成的项目平滑迁移部署到 Linux 生产服务器。

284

2026.04.08

XAMPP 与 phpMyAdmin 数据库管理实操
XAMPP 与 phpMyAdmin 数据库管理实操

专注于 XAMPP 内置的 phpMyAdmin 数据库管理工具,系统讲解数据库和数据表的创建与设计、SQL 语句执行、CSV/SQL 格式数据的导入导出、定时备份与一键还原、多数据库批量管理等日常操作,帮助开发者高效管理本地 MySQL 数据。

355

2026.04.08

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

40

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn