私密博客 · 全套使用说明书

除了hzj，其他人都是访客！！！

密码是：36_SDFZ_learners

一、系统整体介绍

本系统为 本地 Markdown 私密笔记系统，全程免费、无广告、密码加密访问。

运行流程： 本地写 Markdown → Hugo 生成网页 → StatiCrypt 全站加密 → GitHub 存储 → Cloudflare Pages 上线

系统特点

  • 全站统一密码访问，外人无法查看内容
  • 所有原始笔记仅保存在你的电脑本地
  • 云端只有加密网页，无法还原原文
  • 线上仅可浏览，不能在线编辑
  • 手机/电脑自适应、暗黑模式、搜索、标签分类齐全

⚠️ 三条绝对红线（务必记住）

  1. 不要把本地 content 文件夹上传 GitHub（原始笔记会泄露）
  2. 云端所有文件都是加密的，丢失本地文件无法恢复
  3. 前端加密适合学习/工作/生活记录，禁止存放身份证、银行卡、密钥等高敏感资料

二、文件目录规则

你只需要管理唯一文件夹：

private-blog/content/posts/

所有笔记全部放在这里，文件后缀必须为 .md

三、文章头部格式（Frontmatter）【禁止改错】

每篇文章顶部必须保留 --- 配置区，控制文章是否展示

---
title: "文章标题"
date: 2026-07-24T20:30:00+08:00
draft: false
tags: ["标签"]
categories: ["分类"]
---
正文内容写在这里
参数说明：
draft: true = 草稿，网站不显示
draft: false = 正式文章，加密网站可见
title：网页展示标题
tags：标签，用于检索筛选
categories：文章分类
四、Markdown 写作语法参考
标题
markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
文字样式
markdown
**加粗文字**
*斜体文字*
~~删除线~~
无序列表
markdown
- 项目一
- 项目二
- 项目三
有序列表
markdown
1. 第一条
2. 第二条
3. 第三条
引用文本
markdown
> 引用内容
单行代码
markdown
`代码内容`
多行代码块
powershell
.\hugo.exe server
表格
markdown
| 名称 | 说明 |
| ---- | ---- |
| 项目1 | 内容 |
| 项目2 | 内容 |
分割线
markdown
---
链接与图片
markdown
[链接文字](https://xxx.pages.dev)
![图片描述](图片路径)
五、新建文章完整步骤
进入 private-blog 文件夹，打开 PowerShell 终端
执行新建命令
powershell
.\hugo.exe new posts/新文章名称.md
打开生成的 md 文件，将 draft: true 修改为 draft: false
填写标题、标签、正文内容，保存文件
六、本地预览（每次更新推荐执行）
powershell
.\hugo.exe server
浏览器访问地址：
plaintext
http://localhost:1313
确认排版无误后，按下 Ctrl + C 关闭预览服务
七、发布上线【标准全套流程】
编译静态网页
powershell
.\hugo.exe --gc --minify
进入网页输出目录
powershell
cd public
全站网页加密（修改引号内为你的访问密码）
powershell
staticrypt -r *.html -p "你的密码" --remember 30 --config false
参数说明：--remember 30 代表密码 30 天内免重复输入
推送加密文件到 GitHub
⚠️ 注意：-f 强制推送，请谨慎使用，避免覆盖远端历史
powershell
git add .
git commit -m "更新笔记"
git push -f origin main
推送完成后，Cloudflare Pages 自动部署，30 秒～2 分钟线上网站同步更新
八、日常各类操作指南
修改文章
本地编辑对应 md 文件 → 本地预览校验 → 编译→加密→推送上线
删除文章
本地直接删除对应的 .md 文件 → 执行完整发布流程推送更新
修改网站访问密码
修改 staticrypt 命令内密码 → 重新加密 → 推送至 GitHub
临时隐藏文章
将文章头部设置 draft: true，推送后网站不再展示该篇笔记
九、访客访问方式
浏览器打开你的 Cloudflare Pages 网址
输入统一访问密码
浏览全部私密笔记
首次输入密码后，30 天内无需重复验证；清除浏览器缓存后需要重新输入密码
十、常见问题排查
线上网站内容不更新
浏览器按下 Ctrl + F5 强制清除缓存刷新，或等待平台缓存自动更新
新建文章在网页无法看见
检查文章配置：确认 draft: false
打开网站没有密码输入框
本次更新忘记执行加密命令，重新运行 staticrypt 加密并推送
本地笔记文件丢失
⚠️ GitHub 上仅存在加密网页，无法逆向恢复原始 md 笔记，请定期备份整个 private-blog 文件夹
十一、极简操作流程总结
编辑 / 新增笔记 → 本地预览
编译网页
全站加密
Git 推送上线
十二、安全提示
原始笔记全部保存在本地电脑；
云端文件经过前端加密，无密码无法阅读正文；
适合日常笔记、学习资料存储，请勿存放极高敏感隐私资料；
整套服务免费部署，无流量费用、无广告。

---

# 日后更新
# 1. 根目录构建静态网页
.\hugo.exe --gc --minify

# 2. 进入public加密所有html
cd public
Get-ChildItem -Recurse -Filter *.html | ForEach-Object {
    Write-Host "正在加密：$($_.FullName)"
    staticrypt $_.FullName -p "36_SDFZ_learners" --remember 30 --config false --output .
}

# 3. 返回根目录提交推送
cd ..
git add .
git commit -m "更新笔记"
git push -f origin master