私密博客 · 全套使用说明书
私密博客 · 全套使用说明书 除了hzj,其他人都是访客!!! 密码是:36_SDFZ_learners 一、系统整体介绍 本系统为 本地 Markdown 私密笔记系统,全程免费、无广告、密码加密访问。 运行流程: 本地写 Markdown → Hugo 生成网页 → StatiCrypt 全站加密 → GitHub 存储 → Cloudflare Pages 上线 系统特点 全站统一密码访问,外人无法查看内容 所有原始笔记仅保存在你的电脑本地 云端只有加密网页,无法还原原文 线上仅可浏览,不能在线编辑 手机/电脑自适应、暗黑模式、搜索、标签分类齐全 ⚠️ 三条绝对红线(务必记住) 不要把本地 content 文件夹上传 GitHub(原始笔记会泄露) 云端所有文件都是加密的,丢失本地文件无法恢复 前端加密适合学习/工作/生活记录,禁止存放身份证、银行卡、密钥等高敏感资料 二、文件目录规则 你只需要管理唯一文件夹: 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