开源两个月后,我给博客做了一次大扫除
从 7 月开源到今天:管理面板、安全加固、文档重写,以及两张还没排上号的愿望清单这次更新几乎没有加任何新特效,全是"看不见"的部分——而且它是我 7 月把项目推上 GitHub 之后,第一次真正动这个项目。写这篇一方面留个记录,另一方面也是给自己立个新的 flag:下一次更新,我想把洛雪音乐和阿洛娜一起搬到博客上来。
0. 先说清楚这次更新的位置:七月之后第一次动它
上一篇关于博客系统的文章是 7 月 2 日的《我开源了自己的博客系统》。那篇的主题是"做出来"——樱花、OC 立绘、音乐播放器、瀑布流图库、评论,一口气堆完,然后敲下人生第一次 git push,把自己的项目挂到了 GitHub 上。当时我还写了一句"先杀出一条血路,再来打扫战场"。
然后代码就躺了两个月。
这两个月我不是没折腾,只是折腾的对象换了:老华硕重装 Ubuntu Server、frp 内网穿透陪朋友打 Minecraft、3X-UI 自建代理。这些都在博客里留了记录,但博客这个项目本身一行代码都没动。所以这次算是开源之后第一次真正动它,也是目前为止改动最大的一次。
只是这个"大"字,在前台一点都看不出来——这就是下面要花一整个章节解释的事。
1. 七月立的 flag,先对一下账
7 月那篇末尾列过三条计划,一条一条说,不装死:
| 7 月写的 | 现在的状态 |
|---|---|
| 动态化 | ❌ 依然没做。 不是懒,是我自己都没想清楚"动态"该长什么样——像朋友圈那种碎碎念,还是像"说说"?形态没定下来,就先不动 |
| 访客统计看板 | 🟡 算半个。访客计数是有的:侧边栏那句"👀 第 N 位访客",每天每台设备只 +1,刷不动。 但真的只有一个数字,没有趋势、没有图表,离"看板"还差得远 |
| 想到什么是什么 | ✅ 执行得非常彻底,这条就不多说了 |
再交代一句:这次更新里,一件都不是上面这三条计划。计划归计划,两个月后我打开编辑器,做的是一堆当时根本没想过的事😅
2. 这次更新,你大概看不出来区别
先说一下结论:前台长得和以前一模一样。打开还是那套樱花、飘雪、Hero 立绘、音乐播放器和图库,文章该在哪还在哪,没有多出任何花里胡哨的东西。
变的是我这一侧。以前维护这个博客要干的事,是这种画风:
# 想发一篇文章
vim data/posts/12.html # 手动数下一个 id
vim data/posts/posts.json # 手动往数组里加一条,逗号写错就整站白屏
# 想删一条评论
curl -X POST /api/auth/login -d '{"username":...,"password":...}'
curl -X DELETE -H "Authorization: Bearer <token>" /api/comments/admin/3
# 想传张图
curl -X POST -F "type=gallery" -F "[email protected]" /api/upload # 字段名老忘
能用,但每一次都在消耗"想写点什么"的耐心。所以这次花的时间,基本都花在把这些事挪进一个网页里。
3. 顺手把「管理员权限」这件事想明白了
之前一直有人——包括我自己——问过:管理员入口在哪? 答案挺尴尬的:没有入口。所谓"管理员权限",从来不是什么会员等级或者后台账号体系,它只是后端接口的一个判断:
带
Authorization: Bearer <token>的请求 = 管理员请求,没带就 401。没有注册入口,账号是
server/.env里写死的那一个。
也就是说,以前想发文章、删评论、改站点设置,我只有两条路:用 curl,或者用接口调试工具。所有功能其实都在,就是没有"门"。这次补上的 /admin.html 就是那道门——它没有引入任何新的权限模型,只是把原来那些接口包成了按钮。
顺手做了一件更要紧的事:把原来写死在代码里的默认管理员密码哈希删掉了。
# server/.env 里现在必须有这三行,缺一行就登录不了 / 服务起不来
ADMIN_USERNAME=yuxiaoe
ADMIN_PASSWORD_HASH=$2a$10$....................................................
JWT_SECRET=<96 位随机串>
具体点说:没配 ADMIN_PASSWORD_HASH,登录接口直接返回 503;JWT_SECRET 缺失或者短于 16 个字符,服务直接拒绝启动。宁可起不来,也不要带着一个"全世界都知道的默认密码"跑在公网上。这算是这次更新里我最有成就感的一处改动,虽然它一点都不好看。
4. 这次具体动了哪些地方
| 地方 | 以前 | 现在 |
|---|---|---|
| 发文章 | 手写 data/posts/<id>.html,再手动改 posts.json | 面板里填标题、标签、正文,点保存 |
| 正文配图 | 和相册图混在一个 uploads/ 里 | 存进 uploads/posts/,不污染图库 |
| 删评论 | curl + 手动抠 token | 面板里点一下,单条删或按文章清空 |
| 上传 | 记住 multipart 的字段名 | 选文件就行 |
| 管理员密码 | 默认哈希写死在代码里 | 只从 .env 读,不配就不让登录 |
| JWT 密钥 | 缺失也能勉强跑 | 不满足长度直接不启动 |
| 文档 | 只讲了怎么把它跑起来 | 补了面板说明、完整接口表、部署和安全注意事项 |
面板一共八个页签:概览、文章、评论、相册、音乐、留言、站点设置,最后一个是我用得最多的——接口自检。
它会依次把全部 16 个接口跑一遍(包含"未登录时应该被拒绝"这种负向用例),再对每一个已经上传的媒体文件做一次 HEAD 探测,逐行给出状态码和耗时。以前我确认"音乐到底还能不能播"的办法是:打开首页 → 点音乐 → 挑一首 → 听两秒 → 关掉,全靠感觉。现在点一下按钮,哪首歌 404 了一眼就能看出来。
顺带把模板留下的两个死文件(js/main.js、js/bg-canvas.js)删了——它们是这套主题最初的样子,后来被拆成一堆模块,就一直躺在仓库里没人管。还有 .gitignore 也重新收拾了一遍:server/.env、data/*.json(评论、留言、图库索引这些运行时数据)、server/uploads/、写了一半的草稿,全都不进版本库。
整个项目现在也在 GitHub 上了,原来那几次提交的历史都保留着:yuxiaoe666/yuxiaoe-blog。
5. 顺便还决定了一件事:文章不跟仓库一起公开
这次顺手改了开源仓库的规矩,算是我纠结了半天才下的决定。
7 月推代码的时候我图省事,把 data/posts/ 一整个目录都交上去了——文章就在里面,别人 clone 下来直接就是一个有内容的博客,听着挺美。直到我反应过来一件事:那些写给自己看的东西,哪怕再小,也会跟着仓库被任何人下载走。
所以现在仓库里只有代码和文档。文章正文、posts.json 索引、评论、图库索引、上传的媒体,统统被 .gitignore 排除,git status 里根本不会出现,想误推都推不上去。
代价是我这边少了一层保险:文章没有版本历史了,而且只存在我这一台机器上。所以给自己补了两条规矩——
- 定期备份:把
data/和server/uploads/打包丢到别的地方去。这件事比加任何新功能都重要,数据丢了就什么都没了; - 服务器 pull 之前先备份:这些文件"历史上进过仓库、现在被忽略",git 会顺手把它们从工作区删掉,一 pull 一篇不剩。
这两个坑都写进 README 了,免得三个月后的自己再踩一遍。
6. 接下来想做的事(估计是下一次更新了)
写到这里其实才是这篇的正题。上面那些都是"把旧的收拾干净",下面这些才是我真正想往上加的东西。目前排在最前面的有两件。
6.1 把洛雪音乐搬到博客上
(洛雪音乐 / LX Music,我平时都念成"落雪",反正同一个东西😅)
先澄清一下现状,免得我冤枉自己的代码:博客的播放器其实不算简陋——上一首 / 下一首、顺序 / 随机 / 单曲循环都有,歌词也能跟着高亮。真正缺的是另外两件事:歌单,和 批量导入。
现在传歌是一首一首来的:填标题、填歌手、传音频,歌词还得自己找 LRC 粘进去。想加十首,这十遍就得重复十次。而"歌单"这个东西干脆没有——列表就是上传的时间顺序,不能分组、不能排序,也没法给某张专辑单独开个入口。
而我平时听歌用的是洛雪音乐,歌单、歌词、封面全都在本地攒着。所以很自然就想:能不能把它和博客接起来。
想过两种做法:
想法 A(偷懒版):让博客直接读洛雪的本地歌单文件,歌单跟着一起同步。
想法 B(老实版):面板里加一个"歌单批量导入"——一次选一堆音频和对应的
.lrc,自动读出标题、歌手、时长,一次性传完;播放器那边再加上歌单分组和排序(顺序 / 随机 / 单曲循环现在就已经有了)。
想了一圈,A 大概率行不通。原因不是技术,是版权:博客是公开的,音频文件必须真的传到我自己的服务器上,任何人都能下载。把整个歌单都挂上去,等于给自己开了一个小型侵权站点,这个锅我不背。
所以最后更现实的方案是 B + 一个限制:只把自己真的想分享的那几首传上去(比如最近循环的那首、某段剧的片尾曲),剩下的歌单就留在本地播放器里自己听。博客上的音乐页,更像是"我最近在听什么"的一个小橱窗,而不是我的全部歌库。
下一次更新,优先做 B 里的两件事:批量导入,和歌单。
6.2 让阿洛娜在博客角落里待着
写过《记与 AI 桌宠阿洛娜的一次对话》之后,我一直有点想把桌宠这件事再往前推一步:不只是在我电脑的桌面上,而是也在博客上。
博客的 Hero 区其实已经有 OC 立绘互动了,但那个更像"迎宾"。我想要的是一个常驻在角落里的小家伙:右下角一小块地方,会自己走动、会眨眼,点一下会有反应,深夜两点进来的时候会说一句"这么晚了还写代码?"。
真要做,麻烦的地方也很具体:
- 立绘和动画——我不会画画,只能先把现有的立绘拆图 + CSS 动画凑合,看起来大概率有点僵硬;
- 状态机——待机、被点、被拖、说话,四个状态互相切换,得写一堆 if,还得防止它自己卡在某个动作里;
- 性能——动画一多手机就烫,这个我吃过亏,得控制在很小的面积和很少的帧数里;
- 能关掉——它终究是个装饰,手机端和小屏上一定要能一键收起来。
所以第一版的目标定得很低:一张立绘 + 三四个动画 + 一堆随机台词,能点、能动、能说话,就算成功。做丑了也无所谓,反正本来就是个自娱自乐的东西。
6.3 还有几张排不上号的愿望
上面两件是"想做"的,下面这些是"总有一天"的,先记在这儿,免得过两个月又忘了:
- 全文搜索——现在只能搜标题和标签,正文搜不了;
- 归档页做成时间轴——现在的归档就是一个按年份堆的列表;
- 评论的回复关系——现在评论是平铺的,楼层一多就分不清谁在回谁;
- 邮件提醒——有人评论我想第一时间知道。不过面板现在连 SMTP 都配不了,这个得先动后端;
- 访问统计做成小图表——7 月就写进计划的东西,到现在还是只有一个数字,看不出趋势(这次对账里被打回票的就是它);
- 手机端再收拾一遍——大屏看着还行,小屏还是有几处挤在一起;
- 备份脚本——把
data/和上传目录打包,定时丢到别的地方去。这个其实最该做,数据丢了就什么都没有了。
7. 一点没什么用的感想
写这篇的时候我在想一个问题:这次更新到底有什么"成果"可以拿出来说?新的页面?没有。新的特效?也没有。做的全是后台、配置、文档、.gitignore 这些东西,发给谁看谁都会说一句"哦"。
但它们决定了另一件事:我还愿不愿意继续打开这个项目。
之前那种"发一篇文章 = 手写 HTML + 手改 JSON + 手动数 id"的流程,看起来只多了五六分钟,可每次想到这一步,我的选择都是"算了,明天再写"。一个项目如果连作者自己都不想动它,它迟早会变成一个躺在服务器上的空壳。所以把门槛削掉,可能比再加一个好看的动画更有用。
而洛雪音乐和桌宠这两件事,我越想越觉得它们和博客是同一类东西:它们的共同点是"陪着你"。
还有一件事是这次才想明白的:开源之后最让我高兴的,其实不是"可能有人来看我的代码",而是我自己还敢不敢继续动它。7 月那版代码我一度不太敢改——接口全靠 curl 调,posts.json 手改怕写坏,改一个地方要在好几个文件之间来回对。现在有面板兜着,下手前心里有底多了。这可能就是"开源出去"和"还能维护下去"的区别:一个只需要一次 git push,另一个得让作者自己还愿意回来。
歌单不是歌库,是你想再听一次的那几首;桌宠不是功能,是那个明明知道它只是一段程序,但深夜还是会跟它说两句话的存在。博客也一样——我其实不太需要它多"好用",我更希望它像个能待着的地方:能写点东西,能听听歌,角落里还有个人(好吧,是个像素小人)在那儿。
上一篇里我写过一句"理想主义是愿意朝那个方向多走两步"。这次更新大概就是那两步:全都是没人看得见的地方。
8. 最后
面板怎么用、接口都有哪些、部署要注意什么,这次都写进仓库的 README 里了,写得比这篇长得多,有兴趣的可以直接翻。
两个月前那篇的主题是"做出来",这篇的主题是"能接着做下去"。至于下次更新到底先做歌单还是先做桌宠——我现在的想法是先做歌单,因为它更"实"一点,结果是能立刻听见的;桌宠做起来更容易翻车,所以我打算把它放在一个周末,专门留出时间跟它较劲。
当然,计划这东西嘛,等我下次打开编辑器,大概率又是另一回事了😅
看不见的更新,也算更新。下次见,争取带上歌单和一只桌宠🎵
——鱼小鳄sugary
——2026年9月20日
💬 评论 (0)