关于搭建博客的经过

​ 由于准备迁移个人笔记,将冗杂的信息彻底消除,将使用了近半年的Logseq中值得保留的部分,一点点摘取出来,适当修改错误的地方,尽量保持原样,发布到博客上。也许最后的最后,信息的湮灭,代表着念头的消失,可这不代表着如琴弦或波浪般的振动,并不会在这个无边的场域中和另一个念头同频共振,这次共振会有下次吗,不知道,这次共振后就此消失了吗,不,那是业力刚刚的开始。(过于抽象,但为了显摆,还是放在这儿)

​ 功不唐捐,每一次用心的记录,都是雕琢心的艺术。

  • 搭起来了,搭了人生第一个博客。好开心。(摘取自2025年5月4日日记

    https://xiaoshami.org

    紧急写一下搭起来的经过,

  • 准备工作:

  1. 需要下载的工具包:Node.js, Git,VSCode

    CMD跑三条命令确认安装成功

1
2
3
git --version
node -v
npm -v
  1. 需要准备的平台账户:Github(用国外邮箱注册)、Vercel(用Github注册)

    • Github建仓库

      • Github - New repository
      • 强制格式:<用户名>.github.io
      • 其它默认即可
    • Vercel注册并关联Github仓库

      • Vercel - Sign Up
      • Plan选择“personal projects”,Name填写<用户名>
      • Continue with Github
      • Import Git Reporsitory
      • Import
      • Deploy
  • 实际操作:

    在本地建立一个目录,用于存放博客的本体源代码

    在当前目录下,鼠标右键任意空白处,点击“Open Git bash here”选项

  • 跑命令:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    git config --global user.name "你的用户名" #注意是在Github上创建账户的用户名,如我的fffc8893
    git config --global user.email "你的邮箱" #注意是在Github上创建账户的邮箱,如我的fffc8893@proton.me
    hexo init #在当前目录下存放Hexo文件
    npm i #安装相关依赖
    hexo g #生成静态文件
    hexo s #启动项目,成功后可以访问http://localhost:4000/测试效果
    ssh-keygen -t rsa -C "你的邮箱" #会在Git根目录下创建密钥!,例如D:\Program Files\Git\c\Users\Administrator\.ssh
    #这一步需要再Github上操作,打开刚才创建的密钥文件id_rsa.pub,复制内容,Github - 右上角头像Setting - SSH and GPG keys - New SSH key - Title填写"用户名_key1" - Key位置粘贴刚才的密钥
    ssh - T git@github.com #如遇报错,请继续下面的命令
    mkdir -p /home/Administrator/.ssh #在 Git Bash 里,先创建 SSH 家目录
    cp /c/Users/Administrator/.ssh/id_rsa* /home/Administrator/.ssh/ #把你误生成在安装目录下的密钥拷过去
    chmod 700 /home/Administrator/.ssh #修正权限
    chmod 600 /home/Administrator/.ssh/id_rsa #修正权限
    chmod 644 /home/Administrator/.ssh/id_rsa.pub #修正权限
    ssh-keyscan github.com >> /home/Administrator/.ssh/known_hosts #预装 GitHub 主机公钥
    ssh -T git@github.com #再次尝试
    #出现如下结果即正常。Hi fffc8893! You've successfully authenticated, but GitHub does not provide shell access.
    npm install hexo-deployer-git --save ##安装hexo部署工具

    继续跑命令修改更多细节(右击博客源代码目录,以VsCode模式打开)

    1
    2
    3
    4
    5
    deploy:
    type: git
    repo: git@github.com:fffc8893/fffc8893.github.io.git ##强制格式
    branch: main
    message: Site updated:{{ now('YYYY-MM-DD HH:mm:ss') }}

    继续回到git终端跑命令

    1
    hexo cl && hexo g && hexo d  ##三件套命令,clean缩写cl清缓存,generate缩写g生成静态文件,deploy缩写d部署网站

    网站已成功发布到Github、Vercel域名下的网页(Pages)!

  • 优化改进:改主题

    • 下载最新主题包
    • 解压到 themes 目录,并将解压出的文件夹重命名为
  • 如下修改 Hexo 博客目录中的 _config.yml

    1
    2
    - theme: fluid  # 指定主题
    - language: zh-CN # 指定语言,会影响主题显示的语言,按需修改
  • 其它命令:

    1
    2
    npm update --save hexo-theme-fluid #更新主题
    hexo g --debug #查看配置是否生效
  • 配置域名:

    首先,需要一个域名服务提供商(优选国外,无需提供身份证之类的证明,避开审查)

    域名服务提供商的DNS设置中,设置成如下:

    Type A

    Host xiaoshami.org # 这里填你购买的域名

    Answer/Vaule 76.76.21.21

    TTL 600

    然后在Vercel中添加域名,等待自动配置。期间可以使用dnschecker工具检测是否可以连通(一般需要5-10分钟)

    https://dnschecker.org/

  • 参考博文

    https://baiyi.ink/posts/d89a0dc3.html

    https://blog.3ms.run/archives/Hexo-Github-Vercel-DeploymentTutorial.html

    https://github.com/fluid-dev/hexo-theme-fluid

  • 补充:

    后续日常发布博客的流程:Typora编辑器写好后存入草稿文件夹 - 校对一遍后存入项目\source\posts文件 - 右击空白处git打开 - 按顺序跑如下命令 - 验证OK即可

    1
    2
    3
    4
    hexo g --debug		#更新主题,无论有无更新
    hexo s #启动项目
    ssh -T git@github.com #连到github
    hexo cl && hexo g && hexo d #清缓存、生成静态文件、部署

关于搭建博客的经过
http://example.com/2025/10/21/2025-10-21_howtoblog/
作者
fffc8893
发布于
2025年10月21日
许可协议