← 返回文章列表

开源两个月后,我给博客做了一次大扫除

📅 2026年9月20日 · 📝 6075 字 · ⏱️ 16 分钟 · #博客#开源#计划


开源两个月后,我给博客做了一次大扫除

从 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 还有几张排不上号的愿望

上面两件是"想做"的,下面这些是"总有一天"的,先记在这儿,免得过两个月又忘了:

  1. 全文搜索——现在只能搜标题和标签,正文搜不了;
  2. 归档页做成时间轴——现在的归档就是一个按年份堆的列表;
  3. 评论的回复关系——现在评论是平铺的,楼层一多就分不清谁在回谁;
  4. 邮件提醒——有人评论我想第一时间知道。不过面板现在连 SMTP 都配不了,这个得先动后端;
  5. 访问统计做成小图表——7 月就写进计划的东西,到现在还是只有一个数字,看不出趋势(这次对账里被打回票的就是它);
  6. 手机端再收拾一遍——大屏看着还行,小屏还是有几处挤在一起;
  7. 备份脚本——把 data/ 和上传目录打包,定时丢到别的地方去。这个其实最该做,数据丢了就什么都没有了。

7. 一点没什么用的感想

写这篇的时候我在想一个问题:这次更新到底有什么"成果"可以拿出来说?新的页面?没有。新的特效?也没有。做的全是后台、配置、文档、.gitignore 这些东西,发给谁看谁都会说一句"哦"。

但它们决定了另一件事:我还愿不愿意继续打开这个项目。

之前那种"发一篇文章 = 手写 HTML + 手改 JSON + 手动数 id"的流程,看起来只多了五六分钟,可每次想到这一步,我的选择都是"算了,明天再写"。一个项目如果连作者自己都不想动它,它迟早会变成一个躺在服务器上的空壳。所以把门槛削掉,可能比再加一个好看的动画更有用。

而洛雪音乐和桌宠这两件事,我越想越觉得它们和博客是同一类东西:它们的共同点是"陪着你"。

还有一件事是这次才想明白的:开源之后最让我高兴的,其实不是"可能有人来看我的代码",而是我自己还敢不敢继续动它。7 月那版代码我一度不太敢改——接口全靠 curl 调,posts.json 手改怕写坏,改一个地方要在好几个文件之间来回对。现在有面板兜着,下手前心里有底多了。这可能就是"开源出去"和"还能维护下去"的区别:一个只需要一次 git push,另一个得让作者自己还愿意回来。

歌单不是歌库,是你想再听一次的那几首;桌宠不是功能,是那个明明知道它只是一段程序,但深夜还是会跟它说两句话的存在。博客也一样——我其实不太需要它多"好用",我更希望它像个能待着的地方:能写点东西,能听听歌,角落里还有个人(好吧,是个像素小人)在那儿。

上一篇里我写过一句"理想主义是愿意朝那个方向多走两步"。这次更新大概就是那两步:全都是没人看得见的地方。

8. 最后

面板怎么用、接口都有哪些、部署要注意什么,这次都写进仓库的 README 里了,写得比这篇长得多,有兴趣的可以直接翻。

两个月前那篇的主题是"做出来",这篇的主题是"能接着做下去"。至于下次更新到底先做歌单还是先做桌宠——我现在的想法是先做歌单,因为它更"实"一点,结果是能立刻听见的;桌宠做起来更容易翻车,所以我打算把它放在一个周末,专门留出时间跟它较劲。

当然,计划这东西嘛,等我下次打开编辑器,大概率又是另一回事了😅


看不见的更新,也算更新。下次见,争取带上歌单和一只桌宠🎵

——鱼小鳄sugary

——2026年9月20日

💬 评论 (0)

加载中...