📋 斐讯N1 博客搭建工作记录
日期：2026年5月24日
操作用户：jiaxf
核心目标：在 N1 上搭建 Hugo 静态博客，部署到腾讯云 EdgeOne Pages，配置评论系统和远程写作环境
一、Hugo 博客本地搭建
| 项目 | 操作摘要 | 备注 |
|---|---|---|
| 安装 Hugo | APT 安装旧版后，手动下载 hugo_0.161.1_linux-arm64.deb 升级 | 因 GitHub 下载慢，通过代理解决 |
| 创建博客 | hugo new site blog | 目录：/home/jiaxf/blog |
| 配置主题 | 使用 PaperMod 主题，git submodule add | 兼容 Hugo ≥ 0.146.0 |
| 修复警告 | languageCode → locale，zh-CN → zh-cn（全小写） | Hugo v0.158+ 的变更 |
| 第一篇文章 | content/posts/hello-world.md | 需将 draft: true 改为 false 才能发布 |
关键技术点：
- Hugo 是“一次性”生成工具，不是常驻后台进程，运行时几乎不消耗 N1 资源
- 新文章默认为草稿，部署时需去掉
draft: true
二、GitHub 仓库与推送
| 项目 | 详情 |
|---|---|
| 仓库地址 | git@github.com:jiaxv/myblog.git |
| 推送方式 | SSH（使用 N1 上的 id_ed25519 密钥） |
| 用户配置 | git config --global user.name/email |
| 初始提交 | git commit -m "初始化博客" 并推送成功 |
问题与解决：
git commit身份未知 → 配置user.name和user.emailPermission denied (publickey)→ 将 N1 公钥添加到 GitHubRepository not found→ 确认仓库名大小写正确
三、腾讯云 EdgeOne Pages 部署
| 配置项 | 填写值 |
|---|---|
| 框架预设 | Hugo |
| 构建命令 | hugo --minify |
| 输出目录 | public |
| 根目录 | ./ |
| 安装命令 | 留空 |
| 加速区域 | 全球可用区（含中国大陆） |
| 绑定域名 | blog.jiaxv.top |
| CNAME 记录 | 在阿里云 DNS 添加，指向 EdgeOne 提供的地址 |
| 归属验证 | 添加 TXT 记录验证域名所有权 |
问题与解决：
ERR_CONNECTION_REFUSED→ 配置未完全生效，重新部署后正常HTTP ERROR 418→ 同上，等待并重新触发部署- 备案提示 →
jiaxv.top已备案，直接可用
四、评论系统
| 系统 | 状态 | 说明 |
|---|---|---|
| Giscus | ✅ 已配置 | 基于 GitHub Discussions，评论数据存在仓库 |
| Waline | ❌ 尝试后放弃 | 需额外 Vercel + 数据库，复杂度较高 |
Giscus 配置要点：
- 仓库需启用 Discussions（Settings → Features）
- 安装 Giscus App 并授权仓库
- 页面映射选择“Discussion 的标题包含页面的 pathname”
- 代码粘贴到
layouts/partials/comments.html
局限性：用户必须登录 GitHub 才能评论，不支持匿名。
五、远程写作环境搭建
| 工具 | 作用 |
|---|---|
| VS Code | Windows 本地编辑器 |
| Remote-SSH 插件 | 通过 SSH 连接 N1，直接编辑远程文件 |
| SSH 密钥 | Windows 生成 id_ed25519，公钥上传至 N1 的 authorized_keys |
VS Code 推荐扩展（均安装在远程 N1 上）：
| 扩展名 | 用途 |
|---|---|
| Markdown All in One | 快捷键、自动补全、表格格式化 |
| Markdown Preview Enhanced | 增强实时预览 |
| Paste Image | 截图后 Ctrl+Alt+V 粘贴图片 |
| Front Matter | Hugo 文章头部管理 |
| Hugo Language Support | Hugo 模板语法高亮 |
N1 资源优化配置：
{
"search.followSymlinks": false,
"files.watcherExclude": {
"**/.git/objects/**": true,
"**/public/**": true
},
"editor.quickSuggestions": false
}
六、SSH 密钥体系梳理
| 密钥位置 | 用途 | 公钥去向 |
|---|---|---|
N1 (~/.ssh/id_ed25519) | N1 → GitHub 免密推送 | GitHub SSH Keys |
Windows (C:\Users\Administrator\.ssh\id_ed25519) | Windows → N1 免密登录 | N1 的 authorized_keys |
七、技术概念总结
| 概念 | 解释 |
|---|---|
| 静态博客原理 | Hugo 在本地将 Markdown 编译成 HTML，部署到 CDN，无需后端服务器 |
| 公钥/私钥 | 公钥上锁（放服务器），私钥开锁（放自己电脑），全程私钥不离开本地 |
| Ed25519 | 目前最推荐的 SSH 加密算法，安全、高效、密钥短 |
| CNAME 工作原理 | 域名 CNAME 指向 CDN 地址，用户访问域名时实际访问的是 CDN 节点 |
| VS Code Remote-SSH | 界面在本地渲染，文件操作和扩展逻辑在远程 N1 执行 |
八、日常写作流程
- 打开 VS Code，Remote-SSH 连接 N1
- 创建文章：
hugo new content posts/文章名.md - 用 VS Code 编辑 Markdown
- 截图粘贴：
Ctrl+Alt+V - 发布：将
draft: true改为false - 推送：
git add . && git commit -m "新文章" && git push - EdgeOne Pages 自动部署，
blog.jiaxv.top更新
当前状态：博客正常运行，写作环境就绪，评论系统可用。
后续可探索：Waline 匿名评论、博客主题美化、自定义域名邮箱等。