Skip to content

部署到 Netlify ​

Netlify 支持手动拖入 public/,也支持连接 GitHub 自动更新。先完成通用发布前检查,然后选一种方式。Netlify 官方入门说明包含这两种流程。

方式一:手动拖入网页文件夹 ​

1. 生成网页 ​

在博客根目录运行:

bash
hexo clean
hexo generate

确认 public/index.html 存在。Netlify 默认会给站点生成一个名字和 *.netlify.app 地址;第一次部署后再用实际地址修正博客配置。

2. 上传并记下地址 ​

  1. 登录 Netlify,在团队页面选择 Add new project → Deploy manually,或打开 Netlify Drop。
  2. 把整个 public/ 文件夹拖到上传区域;不要拖博客根目录或主题目录。手动拖入时应选文件夹,Netlify 的官方说明也建议先解压 ZIP 再拖文件夹。
  3. 部署成功后,复制控制台显示的 *.netlify.app 地址。在 _config.yml 修改原有的 url,root 设为 /:
yaml
url: https://实际站点名.netlify.app
root: /
  1. 重新运行 hexo clean、hexo generate,到该站点的 Deploys 页面,再把新的 public/ 拖入部署区域。这样站内链接会使用正确地址。

3. 以后更新 ​

每次写完文章,都重新生成并在 Deploys 页面拖入新的 public/。只改本地文件不会更新线上。站点名可以在控制台自定义;改名后默认地址也会变化,需要再次修改博客的 url。Netlify 项目名称说明

方式二:连接 GitHub 自动部署 ​

1. 准备仓库 ​

按通用 GitHub 步骤推送自己的博客。确认仓库中有 package.json、package-lock.json、source/ 和两份配置文件;package.json 中有 "build": "hexo generate"。

2. 导入并填写构建配置 ​

  1. 在 Netlify 团队的 Projects 页面选 Add new project → Import an existing project。
  2. 选择 GitHub,授权后选中博客仓库。
  3. 核对下表。Netlify 自动识别的值若不同,以这里为准。
字段值
Branch to deploymain
Base directory留空,使用仓库根目录
Build commandnpm run build
Publish directorypublic
环境变量NODE_VERSION = 24
  1. 点击部署,等待构建日志显示成功,复制实际的 *.netlify.app 地址。Netlify 的Hexo 构建说明列出的输出目录也是 public;Node.js 版本说明支持用 NODE_VERSION 指定版本。

3. 修正网址并更新 ​

在博客 _config.yml 把 url 改为控制台显示的地址,root: /,然后按通用 Git 更新步骤推送一次。以后写文章也按同样方式推送;Netlify 会自动重新构建。

常见问题 ​

  • 首页 404:检查 Publish directory 是否为 public,并确认日志显示成功生成 public/index.html。
  • 本地改了文章但线上未变化:手动站点要再次拖入文件夹;Git 站点要提交并推送。
  • 图片或搜索异常:核对 url 与 root,重新生成、重新部署。

回到平台选择

基于 MIT 许可发布