Hexo个人博客 专属操作手册

一、核心固定信息速记

项目 对应内容
本地博客根目录 C:\Users\Lenovo\Desktop\cloudsync\blog
文章存放路径 blog/source/_posts
站点主配置文件 blog/_config.yml
Butterfly主题配置文件 blog/_config.butterfly.yml
服务器公网IP 82.156.110.111
服务器登录用户名 root
服务器博客存放目录 /var/www/hexo
待备案域名 kuafu111.fun

二、日常高频操作（重点保存，日常最常用）

场景1：写新文章 & 发布到线上

  1. 打开本地Git Bash，进入博客目录
    1
    2
    # cd = Change Directory（切换目录），后面跟你要进入的文件夹路径
    cd C:/Users/Lenovo/Desktop/cloudsync/blog
  2. 创建新文章（替换双引号内的文章标题）
    1
    2
    3
    # hexo new post = Hexo新建正式文章的固定命令
    # 双引号里的内容是你的文章标题，会自动生成对应的.md文件
    hexo new post "你的文章标题"
  3. 打开文章文件编辑
    路径：blog/source/_posts/你的文章标题.md
    用记事本/Markdown编辑器编写内容，完成后保存文件。
  4. 本地预览（可选，确认排版效果）
    1
    2
    3
    4
    5
    # && 是连接符，代表依次执行后面的命令
    # hexo clean = 清除旧的缓存文件，避免旧内容干扰
    # hexo g = hexo generate 的缩写，生成静态网页文件
    # hexo s = hexo server 的缩写，启动本地预览服务器
    hexo clean && hexo g && hexo s
    浏览器访问 http://localhost:4000 预览，按 Ctrl+C 停止预览服务。
  5. 一键部署到线上服务器
    1
    2
    # hexo d = hexo deploy 的缩写，把生成的文件推送到服务器
    hexo clean && hexo g && hexo d
    输入服务器密码（配置免密登录后无需输入），看到 INFO Deploy done: git 即发布成功。
  6. 线上查看
    • 备案完成前：访问 http://82.156.110.111
    • 备案完成后：访问 https://kuafu111.fun

场景2：主题美化/配置修改 & 生效上线

  1. 打开主题配置文件修改
    路径：blog/_config.butterfly.yml
    用记事本打开，修改导航栏、头像、样式等配置，完成后保存文件。
  2. 本地预览测试（必做，确认修改无错误）
    打开本地Git Bash，进入博客目录，执行：
    1
    2
    # 同样是清除缓存→生成文件→启动预览
    hexo clean && hexo g && hexo s
    浏览器访问 http://localhost:4000 确认效果，按 Ctrl+C 停止预览。
  3. 确认无误后，部署到线上
    1
    2
    # 一键推送到服务器
    hexo clean && hexo g && hexo d

场景3：登录腾讯云服务器

方式1：腾讯云WebShell（新手推荐，零门槛）

  1. 打开腾讯云控制台，登录账号，进入「云服务器」→「实例」
  2. 找到你的服务器，点击右侧「登录」，选择「标准登录 | WebShell」→「立即登录」
  3. 用户名填 root，输入服务器密码，即可登录操作。

方式2：本地Git Bash登录

  1. 打开本地Git Bash，执行命令：
    1
    2
    3
    # ssh = Secure Shell（安全外壳协议），用于远程登录服务器
    # 格式：ssh 用户名@服务器IP地址
    ssh root@82.156.110.111
  2. 输入服务器密码，回车即可登录。

场景4：服务器常用维护命令

命令 核心作用 详细含义
nginx -t 测试Nginx配置是否正确 -t = Test（测试），检查配置文件语法，避免重启失败
systemctl restart nginx 重启Nginx服务 systemctl = 系统服务控制命令，restart = 重启，让新配置生效
systemctl status nginx 查看Nginx运行状态 status = 状态，排查服务是否正常运行、是否报错
ls /var/www/hexo 查看博客文件是否成功部署 ls = List（列出），查看指定目录下的文件列表
cd ~ 快速回到服务器家目录 ~ = 波浪号，在Linux中代表当前用户的家目录（root用户就是/root）

三、域名备案通过后，必做收尾操作

  1. 确认域名解析配置（腾讯云域名管理→解析）
    添加2条解析记录：

    主机记录 记录类型 记录值 TTL
    @ A记录 82.156.110.111 5分钟
    www A记录 82.156.110.111 5分钟

  2. 一键配置HTTPS证书（地址栏安全小绿锁）
    登录服务器WebShell，执行命令：

    1
    2
    3
    4
    # certbot = Let's Encrypt官方证书工具
    # --nginx = 自动适配Nginx配置，无需手动修改
    # -d = Domain（域名），指定要申请证书的域名
    certbot --nginx -d kuafu111.fun -d www.kuafu111.fun

    按提示操作：

    • 输入你的常用邮箱
    • 同意服务条款（输入Y）
    • 拒绝邮箱分享（输入N）
    • 选择强制HTTPS跳转（输入2）
      完成后，即可通过 https://kuafu111.fun 安全访问博客。

四、完整项目流程回顾（理清整体逻辑）

  1. 本地环境搭建：安装Node.js、Git → 安装Hexo → 初始化博客项目 → 安装Butterfly主题 → 配置站点和主题基础信息
  2. 服务器环境搭建：登录腾讯云服务器 → 安装Nginx、Git → 配置Nginx网站托管 → 放开服务器安全组端口 → 创建Git裸仓库 → 配置自动部署钩子
  3. 部署链路打通：本地安装部署插件 → 配置站点部署信息 → 配置Git全局身份 → 测试本地一键部署
  4. 域名与合规：配置域名解析 → 提交ICP备案申请 → 备案通过后配置HTTPS证书
  5. 日常使用：文章创作 → 本地预览 → 一键部署 → 线上访问