一次甚是有趣的决定
我其实不喜欢写文章,这点在关于页面就能看得出来,我也不擅长写文章,所以本站可能生来就没什么文章
但是为了目标——ICP备案,也就只能让我租一年的腾讯云了,租都租了那我不得用上不用不就亏了吗,于是乎便有了本站
而关于博客这个东西我想要的东西其实很少。写 markdown 扔进一个文件夹就算发布、能按标签和年份翻、多少有点搜索功能、页面简洁干净现代化,Thats all。
而安全和性能则更是我关注的重中之重了,本站的前端基本上是纯静态的,后端则是运行在非特权的容器内,下面让我的智能体来帮我介绍一下得了:
内容就是一堆 md,别无其他
站里的文章全是 content/posts 下的 markdown。数据库只是它们的索引,删了能随时从文件重建。真相在文件,不在库。
后端是个 Go 小程序,标准库 net/http 就够,ServeMux 直接写方法加路径:
mux.HandleFunc("GET /api/posts/{slug}", h.GetPost)
mux.HandleFunc("GET /api/search", h.Search)
SQLite 用纯 Go 的 modernc.org/sqlite,不碰 CGO,产物是一个十几兆的静态二进制。加文章就是往文件夹扔个 md,给进程发个 HUP 让它重扫,按哈希分新增、更新、跳过。
颜色都归文章,站点自己不上色
界面只有近白和近黑两种底色,其余颜色全来自文章:每篇带一个 accent,是写它那天的光。首页铺成一墙色样,归档排成一条年份光谱。暗色模式就是把灯关掉,只剩色样还亮着。这一层是 React 加 Vite 出的纯静态文件,没有服务端渲染的运行时,放进 CDN 直接缓存。
安全是重点,我不敢松
后端不占任何 TCP 端口,只在一个 Unix socket 上听,除了同机的 Caddy 谁也连不进来。Caddy 在最前面终止 TLS、托管静态站、反代接口,顺手把 CSP 和一组安全头统一加上,脚本放行细到哈希,连首屏那段内联脚本都要对得上指纹。容器以非特权用户运行,内容目录只读挂载。唯一一处「按用户给的路径读磁盘」的媒体接口收得很紧:扩展名白名单、逐段挡 ..、再解一次符号链接比对,三道都过才给。
不跑 JS 的也能读
单页应用对爬虫和 Lynx 这类文本浏览器是一张白页。所以后端另用 goldmark 渲了一套没有 JavaScript 的纯 HTML,按 User-Agent 分流:人看会动的那版,机器读干净的素版,内容一致。顺带把每页的标题、摘要、结构化数据都给足,分享和收录都不吃亏。
爬虫欢迎,但别太勤
搜索引擎和问答抓取随便来。那些高频来扫的 AI 爬虫按「来源加路径」限了频,一个地址一小时最多两次,超了回 429。不是拒之门外,是别把这台小机器压趴。
怎么上线
代码推到 main,CI 在代码仓库把前端和镜像都构建好,打成一个包 rsync 到这台机器上解开。后端没动就不重传那十几兆镜像,所以多半发一篇文章分分钟就生效。
讲完了。要的「简洁、干净、够安全」,大致就是这么拼出来的。
现在
感谢智能体的精彩发言,虽然他给我删了一次我写好的这个文件然后让我被迫重写这一段,但是我还是要感谢一下,总之就是这样。
写完基本上也就2点多快3点了,希望能尽快完事吧。
想搭一个一样的?你自己想办法写个一样的得了,我不打算开源这个站,因为有点太简易了,你实在想要就发个邮件跟我要就OK。