如何在虚拟主机上成功搭建hexo博客?详细步骤与注意事项揭秘!
- 虚拟主机
- 2025-11-04
- 6

Hexo 是一个快速、简洁且高效的博客框架,使用 Node.js 编写,它可以将 Markdown 文件转换为静态网页,非常适合搭建个人博客,在虚拟主机上搭建 Hexo 博客,可以让你随时随地访问自己的博客,以下是详细的搭建步骤:


准备工作
| 步骤 | 说明 |
|---|---|
| 1 | 确保你的电脑上已安装 Node.js 和 npm(Node.js 的包管理器),你可以通过访问 Node.js 官网 进行安装。 |
| 2 | 安装 Git,因为 Hexo 需要使用 Git 进行版本控制,你可以通过访问 Git 官网 进行安装。 |
| 3 | 准备一个虚拟主机,例如阿里云、腾讯云等。 |
| 4 | 在虚拟主机上创建一个网站目录,/var/www/myblog。 |
| 5 | 在虚拟主机上配置域名解析,将域名指向你的虚拟主机 IP 地址。 |
搭建 Hexo 博客
| 步骤 | 说明 |
|---|---|
| 1 | 在本地电脑上,打开终端(Mac/Linux)或命令提示符(Windows)。 |
| 2 | 进入你创建的网站目录,cd /var/www/myblog。 |
| 3 | 初始化 Hexo 博客,执行以下命令:hexo init。 |
| 4 | 进入博客目录,执行以下命令安装依赖:npm install。 |
| 5 | 启动本地服务器,执行以下命令:hexo server,你可以通过访问 http://localhost:4000 查看博客效果。 |
| 6 | 将本地博客上传到虚拟主机,在本地博客目录下创建一个名为 .deploy 的隐藏文件夹。 |
| 7 | 在 .deploy 文件夹中创建一个名为 _config.yml 的文件,并添加以下内容:“` |
deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master
| 8 | 安装 Git 钩子,执行以下命令:`npm install hexodeployergit save`。 | | 9 | 在博客目录下,执行以下命令部署博客:`hexo generate`,然后执行 `hexo deploy`。 | ### 配置虚拟主机 | 步骤 | 说明 | | | | | 1 | 在虚拟主机上配置 Nginx 或 Apache,以下以 Nginx 为例。 | | 2 | 在 Nginx 的配置文件中添加以下内容:``` server { listen 80; server_name yourdomain.com; root /var/www/myblog/public; index index.html index.htm; location / { try_files $uri $uri/ /index.html; } } ``` | | 3 | 重新加载 Nginx 配置,执行以下命令:`sudo systemctl reload nginx`。 | ### 在虚拟主机上搭建 Hexo 博客,需要先在本地电脑上安装 Node.js、Git 和 Hexo,然后在虚拟主机上创建网站目录、配置域名解析、安装 Nginx,最后将本地博客上传到虚拟主机并配置 Nginx,以下是两个常见问题的解答: ### FAQs **问题 1:如何将本地博客内容迁移到虚拟主机?** **解答:** 在本地电脑上执行 `hexo generate` 和 `hexo deploy` 命令,将博客内容上传到 GitHub 仓库,在虚拟主机上创建一个名为 `public` 的文件夹,将本地博客目录下的 `public` 文件夹内容上传到虚拟主机上的 `public` 文件夹,在虚拟主机上配置 Nginx 或 Apache,将域名解析到虚拟主机 IP 地址即可。 **问题 2:如何自定义博客主题?** **解答:** Hexo 提供了丰富的主题,你可以在 [Hexo 主题市场](https://hexo.io/themes/) 选择喜欢的主题,下载主题后,将其解压到本地博客目录下的 `themes` 文件夹中,然后在 `_config.yml` 文件中设置 `theme` 选项为所选主题的名称,重新部署博客后,即可看到新的主题效果。