N1搭建Hexo个人博客,部署博客到Github 📅 2026/8/14 14:06:11 N1刷的是 Armbian 系统设备访问 npm 官方源速度较慢先切换国内源查看当前 npm 镜像源npmconfig get registry切换到淘宝源npmconfigsetregistry https://registry.npmmirror.com一安装 Nodejs1安装Nodejsnodejs官网下载并安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh|bash代替重启 shell\.$HOME/.nvm/nvm.sh下载并安装 Node.js这里安装的22版本nvminstall22验证 Node.js 版本node-v验证 npm 版本npm-v2安装 Gitaptinstallgit验证 git 版本git-v二安装 Hexonpminstallhexo-cli-gHexo 查看版本hexov提示如下图说明安装成功出现 warn 执行第4步如果要卸载Hexo重装执行下面命令npmuninstall hexo-cli-g验证是否卸载成功hexo-v如果提示hexo不是内部或外部命令...”或 “command not found”说明全局工具已卸载成功为了确保彻底干净特别是如果你打算重新安装 Hexo建议清理 npm 缓存清理 npm 缓存npmcache clean--force1新建一个文件夹作为博客根目录mkdirmylogcdmylog2初始化博客生成 Hexo 博客文件hexo init3安装依赖cdmylognpminstall如果安装依赖提示如下图这些 warn 只是警告不是错误不影响使用4可执行下面命令不再拦截# 1. 查看当前被拦截的脚本列表确认是 hexo-utilnpminstall-scriptsls# 2. 全局允许 hexo-util 运行安装脚本 不再拦截npmconfigsetallow-scriptshexo-util--locationuser# 3. 重新安装依赖npminstall5启动 hexo本地预览cdmyloghexo s重新连接后需要进博客文件夹启动 hexocdmylog提示上面的说明启动成功打开地址即可访问博客了IP:4000http://localhost:4000/每次新建文章或者修改配置都执行三步本地预览hexo cleanhexo ghexo s部署到远程 github 仓库hexo cleanhexo ghexo d三修改主题美化主题Butterfly主题官方演示1进入博客文件夹cdmylog下载主题gitclone-bmaster https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly2修改 /root/mylog 目录下的 _config.yml把主題theme后面的 landscape 改为 butterfly注意theme: 冒号后面有空格theme: butterfly或者用命令直接替换 _config.yml 中的主题配置sed-is/theme: .*/theme: butterfly/_config.yml3创建主题配置文件更新主题配置不会丢失cpthemes/butterfly/_config.yml _config.butterfly.yml4安装插件npminstallhexo-renderer-pug hexo-renderer-stylus--save重新启动hexo cleanhexo ghexo d配置参考官方文档Hexo官方文档也可以直接上传主题文件到 /root/mylog/themes 目录下然后解压修改 /root/mylog 目录下的 _config.yml加 # 号注释原来的 #theme: *****新增一句 theme: xxxx 注意冒号后面有空格xxxx为 themes/ 文件夹下主题文件夹名称修改 /root/mylog 目录下的 _config.yml对应主题文件名修改后重新启动 hexohexo cleanhexo ghexo d主题下载主题1下载地址主题2下载地址主题3下载地址Fluid主题 fluid安装官方文档配置指南Hexo Fluid 用户手册hexo主题网站主题网站①Fluid 安装进入博客目录执行命令npminstall--savehexo-theme-fluid②拉取 Fluid 主题成功后 theme 目录下没有 fluid 文件夹创建软链接执行下边命令ln-snode_modules/hexo-theme-fluid themes/fluid③创建主题配置文件更新主题配置不会丢失cpthemes/fluid/_config.yml _config.fluid.yml④编辑 _config.fluid.yml 来个性化你的博客比如修改导航栏、首页信息、颜色主题等参考这里修改根目录的 _config.ymltheme: fluid或者用命令直接替换 _config.yml 中的主题配置sed-is/theme: .*/theme: fluid/_config.yml四部署到远程仓库GitHub1注册github账号github官网2新建仓库仓库名最好和用户名一样这里只做演示和用户名一样github 博客地址就是 https://用户名.github.io/ 短网址而不是 https://用户名.github.io/仓库名.github.io/ 长网址用户名格式需要注意必须是 用户名.github.io3添加远程仓库地址新建的仓库初始化一下再添加远程地址gitinitgitremoteaddorigin gitgithub.com:你的用户名/你的仓库名.git验证远程仓库是否关联成功gitremote-v4安装 Hexo 部署插件用于将静态文件部署到 GitHubnpminstallhexo-deployer-git--save5修改 /root/mylog 目录下_config.yml 底部 deploy 位置deploy: type:gitrepo: gitgithub.com:你的用户名/你的仓库名.git branch: main6配置SSH钥匙用 hexo d 部署需要设置一下#输入自己的邮箱地址创建一对密钥ssh-keygen-ted25519-C你的邮箱example.com查看公钥cat~/.ssh/id_ed25519.pub秘钥位置在 /root/.ssh 文件下后缀是pub这个是公钥把公钥的内容复制下来到 github点你的头像有个 setting进去后点 SSH and GPG keys 点击 New SSH key配置好公钥了检查一下输入 yesssh-Tgitgithub.comSSH 认证已经成功7设置用户信息gitconfig--globaluser.namegithub名字#用户名gitconfig--globaluser.emailgithub注册的邮箱#填写自己的邮箱检查一下输入 yesssh-Tgitgithub.com然后执行部署命令hexo cleanhexo ghexo d部署成功后 github 仓库会多出来文件8打开仓库在 Pages 设置页面打开 main 分支然后点击 Save最好看一下 _config.yml 里面是哪个分支重要提示GitHub Pages 设置的发布分支必须与_config.yml中deploy配置的branch保持一致。如果您的_config.yml中配置的是branch: main那么 GitHub Pages 也必须选择main分支作为发布源如果配置的是branch: master则需选择master分支稍等几分钟就可以打开博客地址了https://用户名.github.io/9创建自动化一键部署博客在 hexo 根目录手动创建 deploy.sh 文件添加下面的进去#!/bin/bash# 脚本一键部署 Hexo 博客到 GitHub# 用法在博客根目录下执行 ./deploy.shset-e# 任何命令执行失败则立即退出脚本echo 执行 hexo clean ...hexo cleanecho 执行 hexo generate ...hexo generateecho 执行 hexo deploy ...hexo deployecho✅ 部署完成每次写文章或是修改了配置推送到 github执行下面命令即可cdmylog./deploy.sh至此 N1 搭建 hexo 部署到 github 已完成五日常写文章并发布进入hexo 目录cdmylog hexo n你的文章标题名这会在 source/_posts/ 下生成一个 Markdown 文件用任意编辑器VS Code、Typora 等打开生成的 .md 文件复制下面的进去替换--- title: file_name tag: 标签名 categories: 分类# 分类在sakura显示才能查看comment: 是否允许评论(true orfalse)description: 描述 language: zh-CN timezone:Asia/Shanghai---然后写正文即可编辑好文章后重新执行部署到 github 仓库hexo cleanhexo ghexo d设置每次新建文章时自动添加文章标题进入博客目录并编辑 scaffolds/post.md里面内容全部删掉把下面的复制进去--- title:{{title}}date:{{date}}updated:{{date}}tag:[]categories:[]comment:truedescription:language: zh-CN timezone:Asia/Shanghai---{{ title }} 会自动取你 hexo new 后面的文章名{{ date }} 会自动取当前时间常用命令就以下几个hexo n写文章hexo s本地预览hexo g生成页面hexo d部署上线hexo clean清缓存六备份源码上传到 github 仓库备份在 Hexo 根目录新建 .gitignore 文件添加排除 列表node_modules/ public/ db.json .deploy_git/ .cache/ *.log#添加所有源码文件进入博客目录执行gitpull origin main# 先拉取避免冲突gitadd.gitcommit-m更新文章$(date%Y-%m-%d)gitpush origin main七hexo 瘦身可以放心删除的目录/文件推荐的安全清理命令# 1. 清理生成缓存和部署缓存最常用最安全hexo clean# 2. 手动删除效果等同 hexo clean更彻底rm-rfpublic .deploy_git db.json# 3. 如果 node_modules 太大且想重装rm-rfnode_modules package-lock.jsonnpminstall# 4. 重新生成hexo g八常见问题这里查看看到这里斐讯N1 hexo 博客就部署完成了感谢耐心阅读