#开发日志

5 条帖子 · 1 位参与者 · 近 24 小时 5 条新帖
建站日志
建站日志 @devlog · 11-19

为什么是 Go + SQLite + 一个二进制:技术选型其实是放弃清单

有人问「做个论坛该用什么技术栈」,底下的回答基本是 Postgres + Redis + 一个前端框架 + Docker Compose,四件套。这套东西没错,问题是它回答的不是被问的那个问题——它回答的是「怎么让这个项目看起来像个正经项目」。

我想回答的是另一个:一个不懂运维的人,能不能在半小时里把站跑起来。

这两件事的答案经常相反。所以下面按「放弃了什么」写,不按「有什么好处」写。好处到处都有人吹,代价没人肯讲。

Go:放弃了现成的生态。 论建站,PHP 和 Python 的现成货比 Go 多一个数量级——CMS、后台、支付、插件,全都有现成的在这等着你。用 Go 等于从零削木头。换来的是交叉编译出一个静态二进制,扔到任何一台 x86 的 Linux 上就能跑,不用装运行时、不用管版本、不用「先执行这个再执行那个」。

单二进制:放弃了横向扩展的幻想。 一个进程,一张库。没有 worker,没有队列服务,没有定时任务容器。听起来像 2009 年,实际上对一个小站来说,一个 16MB 的进程能扛的事,比一个编排系统能扛的更多——因为后者你会配错。

SQLite:放弃了并发写。 这条要说清楚,因为它是真的物理限制:SQLite 全库一个写锁。所以这套程序里所有写操作走一条串行队列,发帖、点赞、浏览数、通知全排在一条队里过。

问题是这个限制够不够用。500 人日活的论坛,写 QPS 是个位数,热的时候十几个。串行队列的处理能力是每毫秒级一条。差的不是一星半点。上 Postgres 是提前为明年的流量买单,而明年你可能没有流量,那时候你已经背上了一个要维护的数据库服务。

模板直出:放弃了前后端分离。 html/template 直接吐 HTML,没有 API 契约、没有状态同步、没有「后端加了字段前端没跟上」。代价很实在:交互重的页面做得难受,改一版要动服务端的模板,前端拿不到那种改一个组件就上线的爽感。论坛的交互重不到那份上,我们认了。

不用 Redis:放弃了分布式限流。 我们的限流是内存态,重启清零,多实例之间不共享。一个单机站要那么多干嘛。代价写进文档了,将来真横向扩,这块得重做。

媒体只外链:放弃了完整体验。 用户得自己有图床。这是故意的,另一篇专门写了为什么。

---

上面的账,得反过来算一遍才算诚实。

接手的人要重新学:没有熟悉的目录结构,没有现成组件库,翻文档的时候你会发现网上根本搜不到这个项目。想加功能的时候没有生态可借——全文搜索我们只有 SQL LIKE,做不了中文分词,做不了高亮。想扩的时候路很窄:要么垂直升配,要么整个重写成多实例,中间没有平滑过渡。

所以如果你的项目要活过三年,会长到几十万用户,上面每一条都是错的。你该用 Postgres,该用正经的前端框架,该有 CI 和监控。别学我。

如果你的项目是个小站,或者你压根不确定它会不会有人来——那这堆选择最大的好处是:你失败的成本是半小时。

最后说句可能得罪人的。很多「技术选型」讨论到最后,选的是简历不是系统。四件套往简历上一写很体面,单二进制写上去像没尽力。我不评判这个动机,只想把两笔账都摆出来,让人知道自己在选什么。

#开发日志 #技术选型 #Go #SQLite
建站日志
建站日志 @devlog · 11-19

给 AI 的规则文件我写了 586 行,几乎每行都在解释「为什么」

反例先摆出来。你要是跟 AI 说「请保持代码整洁」,它会把一个函数拆成八个,给每个加一段注释,再顺手补一个你永远用不上的抽象层。它不是变坏了,是「整洁」对它没有约束力——它不知道你在乎什么,只能按训练里见过的平均值猜。

能约束它的话长这样,都是这个仓库 AGENTS.md 里的原文:

---

所有 DML 必须走写队列:不需要返回结果的异步操作用 internal.EnqueueWrite;需要同步结果的用 EnqueueWriteWait;绝对禁止直接调用 db.Create/Update/Delete,否则会触发 SQLite 库级写锁竞争。

---

后半句是关键。没有「否则会触发库级写锁竞争」,前半句就是一条风格偏好,AI 会在某次「我这儿就一个 UPDATE,应该没事」的判断里悄悄绕过去,而它觉得自己是理性的。加上物理原因之后,绕过去等于无视一个事实,AI 一般不会这么干。

第二条:

---

页面模板里不许再写 `<svg>` 画界面图标——需要新图标就往片段 if 链里加一条,path 必须取自 Heroicons 官方,不许自己描点;名字没命中时片段渲染空串,这是故意的,宁可少一枚也不画一个不是 Heroicons 的图形。

---

这条背后有一堆实测数字:全量符号塞进 sprite 会让首页 gzip 从 38,293 涨到 38,983,只留高频六个才降到 35,669。数字写进去,AI 才知道「少一枚图标是可以接受的代价」,而不是「用户体验缺失需要修复」。

第三条最像人话:

---

回帖框是 `textarea`,Enter 换行、Ctrl / ⌘ + Enter 发送,空内容时发送按钮置灰:它曾经是单行 input(连换行都不支持),改成 textarea 是「回帖 = 主题帖」在控件形态上的对齐,别为了「按回车就能发」改回 input。

---

为什么必须写「别为了」这三个字:改控件的时候 AI 最喜欢做体验优化,而「回车直接发送」在它的判断里是明确的进步——更快、更顺、更像成熟产品。它不知道这条是有人专门否决过的。你要是不写,它隔三差五就会帮你「进步」一次。

---

能直接粘的那段

改这个仓库之前,先完整读一遍 AGENTS.md。里面每一条形如「必须 X / 不许 Y」的规则,后面那句「否则会 Z」都是真踩过的坑,不是风格偏好。不要用你更喜欢的方案去覆盖它。如果你确实认为某条该改,先告诉我它当初是为了解决什么问题,以及放弃那个收益的代价是什么,我们再决定。

---

三条实操,都不复杂:

规则带版本号。写成 (v1.12.12) 那种。半年后你和一个新来的模型(或者一个新来的人)都需要知道这条规则是不是过期了——没版本号的规则,谁都不敢删,最后全部留着,文件变成考古现场。

只写踩过的坑。假设性的「要注意安全」写进去,AI 会当成铁律照办,结果比没写更糟:它会为了一个从没发生过的风险,把你正常的功能改得别扭。

允许它变长。这份文件现在 586 行,我猜它还会涨。通读一遍的成本是十分钟,从头再踩一遍的成本是一周。这两件事不能等值比较。

#开发日志 #AI协作 #提示词
建站日志
建站日志 @devlog · 11-19

我的密码没错,是我的脚本读错了

昨天挂了个批量发帖的脚本,往站里灌两篇技术帖。第一次跑,报「用户名或密码错误」。

我想都没想就认定密码过期了——这账号是上个月批量建机器人时生的,密码随手记在一个本地文本文件里,那文件开头还写着「生成时间: 2026-11-18 08:53」。行,重置。登服务器,停服务,备份库,本地生成 bcrypt,写回 users 表,起服务,curl 返回 200。一套动作很熟,因为一个月前建号的时候就是这么干的。

再跑。还是那五个字。

这时候才回头看脚本自己。它读账号文件的方式是:按 " / " 切开,第一段当用户名,含 @ 的那段当邮箱,剩下那段当密码。文件里那行长这样:
devlog / devlog@admxn.com / devlog2026    # 昵称: 建站日志(发连载用)
剩下那段是 devlog2026 # 昵称: 建站日志(发连载用)。连注释一起提交上去了。

那个注释是我自己写的。写的时候想的是「这文件以后万一别人看呢」,完全没想过它唯一的读者是个不认注释的解析器。

改起来一行:先把 # 后面的剪掉再切。

第二道坎接着来。修完注释,脚本能登录了,但登录页冒出一道算术题。因为我在几分钟前刚连着失败了四五次,同一个来源 IP 十分钟内失败够数,风险验证自己开了。

脚本不读页面,它只往登录接口 POST 用户名和密码。所以它被挡在了门外——而那道题的设计目的,原文就写在我们的开发指引里:让不解析页面内容的通用爆破工具过不去。

它确实过不去。包括我自己的脚本。

补了二十行:正则抓出题目,算答案,把 token 和答案一起交回去。跑通了,两篇帖子发出去了。

所以那道题到底挡住了谁?挡住了四十分钟前的我。

要记的教训只有一条:给机器读的文件里别写给人看的注释。如果以后还有第二次,那就让解析器认得出注释——但那样等于承认这文件是给人看的,又绕回来了。这种小坑不值得写进开发指引,写进去反而让那份文件变长一寸。就先这么着。

#开发日志 #取舍
建站日志
建站日志 @devlog · 11-19

登录页那道算术题,是路障不是验证码

登录页平时没有验证码。只有在同一个来源 IP 近十分钟内已经失败两次之后,第三次开始才会冒出一道算术题。这篇说明它为什么长这样、以及在什么地方它根本不算防线。

一、常驻验证码是拿所有人换一个概率

把图形码挂在每一次登录上,等于让 99.99% 的正常用户为 0.01% 的攻击付成本。国内还多一层麻烦:reCAPTCHA、hCaptcha 的脚本经常加载不出来,自研图形码又基本一天被 OCR 破掉。既然挡不住,就没必要天天弹。

二、它要挡的不是人

这道题真正的作用,是让「不解析页面内容」的通用爆破脚本过不去。那种脚本只做一件事:往登录接口 POST 用户名和密码。它不 GET 登录页、不拿 cookie、不读题、也不带 token。加一道题,这类工具直接哑掉。而真人被卡一次,无非心算一下。

说得更直白点:它不是防线,大模型两秒就能解。所以我们的文档里不许把它写成「安全验证」——那是骗自己。

三、真防线在别处

挡爆破真正起作用的是三件事:同一账号失败逐档加延迟(顶到 3 秒)、同一账号同时只允许一个尝试在跑、全站登录并发上限 16 且每分钟 120 次。它们治的是「IP 池 + 慢速撞库」这种真打法。算术题只是把最廉价的那层工具筛掉。

四、答错不算失败

输错密码和看错题不是一回事。答错不记失败、不累加延迟,只作废这道题。token 一次性,对错都作废;答案只存内存、绑定来源 IP,所以答案空间没法枚举。否则一个眼神不好的用户会被自己的手抖锁在门外。

五、注册那边是另一套

注册用的是邮箱验证码,跟这道算术题没关系。配套限流是每 IP 十分钟 5 次、每个收件邮箱十分钟 2 封。目的很朴素:不让一个人半小时往站里塞进一百个死邮箱账号。

一句话总结:算术题是给机器看的门坎,不是给人的考试。

#开发日志 #取舍 #安全
建站日志
建站日志 @devlog · 11-19

我们为什么暂时不做图片上传:一次关于「薄」的取舍

站点设置里没有「上传」,发帖框里也没有附件图标。有人问过为什么,答案不是「还没做」,是「暂时不想做」。这篇把理由摊开,将来要改的时候也知道当初在想什么。

一、开了上传,它就不再是「一个文件 + 一个数据库」

这套程序现在最硬的一条卖点是:一个可执行文件,加一个 data.db,拷走就是全部。开上传之后,文件系统里会长出一个无限增长的目录,你得开始管配额、管清理、管孤儿文件、管备份体积。备份从几百 KB 变成几个 G,恢复从「拷个文件」变成「等半小时」。

二、安全面会成倍膨胀

文件落盘这件事,坑比想象的多:类型嗅探要防伪装后缀,图片要重编码去掉 EXIF(有人专门传带 GPS 的照片),SVG 里能塞脚本,压缩包能炸,文件名能穿越目录,托管在同域名下的用户 HTML 就是现成的同源 XSS。还有盗链和流量盗用。认真做是一整个子系统,敷衍做等于给站开个后门。

三、责任跟着文件走

用户传上来的每一张图,都变成「你存的」。有人传了违规内容,被追责的是你,不是他。自托管的小站没有审核人力,接不住这一层。

四、第三方存储是最优解,但它把「零配置」毁了

对象存储(OSS / COS / R2)确实是正路:不占你的带宽,不占你的磁盘。代价是要密钥、要配 CORS、要开 CDN、要花钱、要处理签名 URL 过期。一个新站主为了发第一张图,得先去注册云账号、配 IAM 权限——这件事本身就把人劝退了。

所以现在选的是外链

正文里贴一个图片 URL,程序自动识别成图;贴 YouTube / Bilibili / Vimeo 链接,自动转成 iframe 播放器;贴任意网页链接,自动去抓 OG 标题、摘要和封面,拼成卡片(带 SSRF 防护,缓存十分钟,失败负缓存 90 秒)。你的服务器里存的始终只有一行文本。

代价也明摆着:图床挂了图就裂,防盗链做不了,私密图别传(第三方看得见)。换来的是整套程序不需要磁盘规划。

将来想加怎么办

位置是留着的:一个上传接口、一张 media 表、一个定时清理任务,再把渲染处的外链逻辑复用一遍就行。这套程序本来就是写给人丢给 AI 改的——你把这段需求原样粘过去,半小时的事。

现在不做,是不想为了一个按钮,把「薄」这个前提扔掉。

#开发日志 #取舍 #设计