#从零开始

12 条帖子 · 1 位参与者 · 近 24 小时 12 条新帖
建站日志
建站日志 @devlog · 11-17 · 已编辑

建站日志 · 目录

这是这个站从零到上线的施工记录,一共 11 篇,外加每篇下面的细节回帖。

按下面的顺序读(不是按发布时间,信息流里是倒序的):
  1. 序:一个人为什么自己写论坛
  2. 第一天:先让它能跑
  3. 第二天:照抄 X,抄错了三遍
  4. 第三到五天:第一次安全审计
  5. 第六天:2 核 2G 的自觉
  6. 第十三天:把 11221 行拆成 23 个文件
  7. 第十四天:上线
  8. 踩坑:备份不能用 cp
  9. 踩坑:一个 404 追了一晚上
  10. 踩坑:每个新用户都成了管理员
  11. 踩坑:我把自己封了 24 小时
前 7 篇是正传:为什么做、第一天怎么起步、抄界面抄错哪三遍、安全审计改了什么、2 核 2G 的取舍、一次大规模拆文件、最后怎么上线。

后 4 篇是踩坑,每篇一个具体的、能复现的错误:备份拷走是坏的、一个 404 追了一晚上、每个新用户都被标成管理员、我把自己封在门外 24 小时。

为什么写这些

不是教程。是一个不懂编程的人 + AI,把想法做成能上线的产品,中间真实发生了什么。

教程会告诉你「应该怎么做」,施工记录告诉你「实际会怎么错」。后者更难找,也更有用。

想自己跑一套?

部署流程单独写了一篇,从买机器到 HTTPS,20 分钟:20 分钟把论坛跑起来

#建站日志 #从零开始
建站日志
建站日志 @devlog · 11-17

踩坑:我把自己封了 24 小时

这条纯粹是自找的。

事情经过

服务器装 fail2ban 防 SSH 爆破,规则是「10 分钟内失败 4 次,封 24 小时」。

配完之后我一直在调 SSH 密钥,中间反复失败、重连、换参数——十几次失败认证,全是我自己。

然后我就连不上了。

怎么救回来的

用云控制台的 VNC 登录进去,fail2ban-client unban --all,把参数放宽到「8 次 / 1 小时」。

教训

  1. 调 SSH 之前先把 fail2ban 的阈值放大,调完再收紧。顺序反了就是自锁。
  2. 一定要留一条不带密钥的救援通道(云控制台 VNC)。只有 SSH 一条路,SSH 一挂就是整台机器失联。
  3. 防火墙同理:改规则前先确认自己当前这条连接不会被新规则踢掉。
这类坑的共同点:你在给自己上锁,而钥匙还在门里。
#踩坑 #从零开始
建站日志
建站日志 @devlog · 11-17

踩坑:每个新用户都成了管理员

这个bug 比上面那个严重得多,而且是我做示例账号时才发现的。

现象

新建的示例账号,用户组是「会员」,但数据库里 is_admin = 1。

原因

建号那行代码写的是:
IsAdmin = 该组的权限数值 != 0
「会员」组的权限值是 24576——那是前台发帖、回帖的权限位,当然不为 0。

所以:每一个新注册的普通用户,都会被标成管理员。

为什么没炸

因为大多数界面判定走的是另一个函数(只看后台位),把它兜住了。真正的后台动作也有权限点兜底。

但它就是错的。哪天有个地方直接读这个字段,洞就开了。

修法

把判据收成一处:AdminMirror(组ID),只认后台位。注册和第三方登录建号都走它,不许各写一遍。

配一条测试:会员组必须为假、管理员组必须为真、不存在的组必须为假。

教训

「权限非空」不是「有后台权限」。权限位是位运算,不是布尔值。分开定义、分开判,别图省事。

#踩坑 #从零开始 #AI编程
建站日志
建站日志 @devlog · 11-17

踩坑:一个 404 追了一晚上

站上线之后,左上角的 logo 是坏的。
/static/logo.svg => 404
但同一个目录下的 favicon.svg、og-default.jpg、app.css 全是 200。

排查

先怀疑文件丢了——本地 static/ 里它明明在,955 字节,和 favicon 一模一样大。

再看处理器逻辑,是「磁盘优先、内置兜底」:
  1. 磁盘上有 static/logo.svg → 直接返回
  2. 没有 → 从编译进二进制的副本里取
  3. 再没有 → 404
关键差别:我本地跑的时候,static/ 目录在磁盘上,走的是第 1 步;服务器上只放了二进制,工作目录里没有 static 目录,只能走第 2 步。

真正的原因

//go:embed 的列表是手写的七个文件名,漏了 `logo.svg`。

之前把全站 LOGO 从内联 SVG 换成 static/logo.svg 这张图时,只改了模板,忘了往 embed 列表里加一行。

怎么防下次

我加了一个测试:遍历 `static/` 目录,逐个断言能从内置副本里读到。

以后谁往 static/ 里加文件但忘了同步 embed,go test 会直接红。
单二进制部署有个隐藏代价:你磁盘上有的东西,二进制里不一定有。本地能跑 ≠ 线上能跑。
#踩坑 #从零开始
建站日志
建站日志 @devlog · 11-17

踩坑:数据库备份不能用 cp

这条坑让我丢了两个小时的测试数据。

现象

数据库开了 WAL 模式(Write-Ahead Logging)。我用最直觉的办法备份:
cp data.db backup.db
恢复之后,数据少了一截。刚发的那几条帖子全没了。

原因

WAL 模式下,新写进去的东西先在 `data.db-wal` 里,data.db 本体还没落盘。你 cp 走的是一份旧快照,而真正的新数据在那个 -wal 文件里躺着。

正确做法

sqlite3 data.db ".backup 'backup.db'"
它会在一个事务里给你一份一致的快照——包括 WAL 里还没落盘的部分。

两个附带的坑

  1. 恢复时要连 `-wal` / `-shm` 一起删。你只把 backup.db 拷回 data.db,旁边还留着旧的 data.db-wal,程序启动时会拿旧的 WAL 去「重放」,数据就乱了。
  2. 用 `tar` 直接打包正在写的库,一样不安全。要么先停服务,要么走 .backup。
#踩坑 #从零开始
建站日志
建站日志 @devlog · 11-17

第十四天:上线

2026 年 11 月 17 日,这个站跑在了公网上。

服务器

阿里云 ECS 最便宜的那档:2 核 2G,40G 硬盘,3M 固定带宽,Ubuntu 22.04。

当天做的事

  • 建一个普通用户跑程序,不用 root
  • SSH 关掉密码登录,只允许密钥
  • 防火墙只开 22 / 80 / 443
  • Nginx 反代到本机 8090,开 HTTP/2、HSTS、gzip
  • Let's Encrypt 证书,定时自动续
  • 每天 03:30 自动备份数据库,留 14 天
  • 每 5 分钟自检一次,页面不是 200 就自动重启并记日志

三个我特意没做的事

  1. 没装面板。1Panel / 宝塔 都是好东西,但这台机器上我只想要「一条命令能说清楚」的部署。多一层面板 = 多一个要打补丁的东西。
  2. 没在服务器上编译。2G 内存跑 go build 会很难受。本地交叉编译好,传二进制上去就行。
  3. 没上 CDN。首屏 16 KB,先看真实流量再说。

上线第一天的真实数据

进程 25 MB、内存用 200 MB、磁盘用 5.1G(剩 33G)。

这个站现在能接客了,但还没有客人。下一篇写我怎么把第一批内容铺上去。

#建站日志 #上线 #从零开始
建站日志
建站日志 @devlog · 11-17

第十三天:把一个 11221 行的 main.go 拆成 23 个文件

到这天,main.go 有 11221 行。

这不是我一开始想要的。一开始它确实只有一个文件,几十行。然后每天加一点、再加一点,三个月后就成了这样。

为什么必须拆

不是「代码规范」,是三个具体的疼:
  1. AI 改不动了。让它改一个功能,它得先读一万多行,读一半就开始瞎猜,改完经常把别的功能弄坏。
  2. 我自己看不懂了。我想查「通知是怎么发的」,得在整个文件里翻。
  3. 改一处,全文件重编译。虽然 Go 编译快,但心理上很劝退。

怎么拆的

按「域」拆,不按「层」拆:首页、帖子、用户、设置、后台、认证、邮件、通知、接口、静态资源、SEO……每个文件是一个业务面。

拆的是源码组织,产物仍然是一个零依赖单二进制。 //go:embed 没动、module 没动、构建命令没动。

拆完:23 个文件、11046 行,最大的 settings.go 800 多行。main.go 只剩 400 行左右——入口、全局状态、路由注册。

一句实话

拆包花的时间不多,难的是拆完之后把文档改对。AGENTS.md、README、更新记录里所有写「改 main.go 的 xxx」的地方都得改,否则下次(包括 AI)会找错文件。

#建站日志 #从零开始 #AI编程
建站日志
建站日志 @devlog · 11-17

第六天:2 核 2G 的自觉

我用的是最便宜的云服务器:2 核、2G 内存、3M 带宽。这个配置决定了程序能怎么写、不能怎么写。

首页每请求的 SQL 预算

首页要渲染:我的信息流、右栏热门话题、右栏推荐关注、每条帖子的作者、点赞状态、收藏状态、转发状态、回复数……

如果每条帖子查一次作者、每个计数查一次,一屏 20 条帖子就是几十次查询。小机器上这不叫慢,这叫卡死。

做法:
  • 作者、话题、关注关系一次批量取回,在内存里拼
  • 「我有没有赞过 / 藏过 / 转过」合并成一次查询
  • 热门话题与活跃用户进 5 分钟缓存,写操作时主动失效
  • 三条复合索引:信息流、热度、作者

结果

首屏 HTML 66 KB,gzip 之后 16 KB。外部访问 200,约 86 毫秒。

一个进程常驻 25 MB 内存,整机用 200 MB 左右。

但真正的瓶颈不是 CPU

是那 3M 带宽。首屏 16 KB,理论并发 20 个,实际 8 到 10 个人同时开页就开始排队。

这就是小站的物理上限。想扛更多人,先想清楚是加带宽、上 CDN,还是干脆把首页再瘦一圈。

#建站日志 #从零开始
建站日志
建站日志 @devlog · 11-17

第三到五天:第一次安全审计,被自己吓到

程序能跑了,我开始让它自己审自己。下面四条是那几天真改掉的东西。

1. 发信没有限流

注册要发验证码、找回密码要发信。我一开始只判「这个邮箱格式对不对」。也就是说:任何人都能拿我的服务器当免费短信/邮件炮台,换个收件人就能一直发。

现在每一处发信入口都先过一道 AllowMail(ip, email):每个 IP 10 分钟 5 次、每个收件邮箱 10 分钟 2 封。后来又加了 60 秒最小间隔——因为配额本身允许连点两下发两封,而用户不爽的正是「我点一下怎么来了两封」。

2. 搜索的 LIKE 没转义

搜索框我把用户输入直接拼进 LIKE '%...%'。有人输入 %,就能把全表捞出来。

SQLite 默认不认反斜杠,光替换字符没用,必须带 `ESCAPE ''` 子句才算真转义。这条我踩了两次才记住。

3. 来源 IP 取错了

限流都按 IP 算,但我取的是 X-Forwarded-For 的第一个。反代是追加式转发,最左边是客户端自己报的——那是个可以随便填的值。按它限流等于没限。

改成优先 X-Real-IP,然后取 X-Forwarded-For 的最后一跳。反代侧也配成用 $remote_addr 覆盖,不是追加。

4. 备份文件权限

/var/backups 里的数据库备份,默认权限谁都能读。里面是所有人的账号、私信、草稿。

改成只允许服务账号和 root 读。

#建站日志 #从零开始 #踩坑
建站日志
建站日志 @devlog · 11-17

第二天:我照抄 X,抄错了三遍

抄界面这件事,看着简单,其实每一步都在暴露「我没想清楚」。

第一错:回帖的连接线

X 的详情页里,回复是挂在主帖下面、带一条竖线的。我照着画了。

画完发现不对:主帖只有一条,回复有十几条,那条线从上拉到下,像一根电线杆。而且主帖本身不该有「上线」——它不是回复,它是话题的起点。

改了三版:先加线,再只给回复加线,最后全部删掉,改成「@作者 · 原文标题」的来源行。

第二错:正文缩进

X 的信息流里,正文是缩进在头像右边的。详情页里,正文是通栏的。

我一开始两处都缩进,结果详情页的长文左侧空出一条白,像被挤在头像下面。后来才改成:列表缩进、详情通栏。同一条帖子,在两个地方长得不一样——这不是不一致,这是 X 有意为之。

第三错:按钮挤成一排

操作行我用的是 grid 五等分,每个按钮左对齐。结果详情页通栏时,五个按钮全堆在左边,右边空一大条。

改成 flex justify-between:两端有锚点,中间均分。

教训

抄界面不是抄像素,是抄它为什么这么排。你不知道原因,就一定会抄错一处,然后在真机上看见它。

#建站日志 #从零开始
建站日志
建站日志 @devlog · 11-17

第一天:先让它能跑

2026 年 11 月 4 日,第一次提交。

那天我没想架构、没想拆包、没想命名,只想要一个东西:打开浏览器能看见一条帖子。

当时定的三条底线

  • 一个二进制跑起来:Go 编译出来一个文件,拷到服务器就能跑,不用装 PHP、不用装数据库服务
  • 数据存本地 SQLite:一个 data.db 文件就是全站,备份就是拷走它
  • 界面照抄 X 的三栏:左导航、中信息流、右推荐。不自己发明布局
第三条是偷懒,也是省事。萌新不需要新奇的界面,需要的是「一看就知道怎么用」。

第一版长什么样

注册、发帖、回帖、点赞、收藏、关注、话题页、个人主页。就这些。

没有后台、没有权限、没有通知、没有邮件。管理员靠改数据库。
第一版最难的不是写代码,是决定不写什么。每多一个功能,就多一处以后要维护的地方。
#建站日志 #从零开始
建站日志
建站日志 @devlog · 11-17 · 已编辑

序:一个不懂编程的人,为什么自己写论坛

我 36 岁,在石油行业做数字化运营,不是程序员。

十几年前我混 Discuz! 圈子,做过插件和模板,还仿过一套推特风格的模板免费发给站长们用。那时候我就知道站长们缺什么:一个能自己掌控、又不用天天修的小站。

Discuz 太重了。PHP 环境、插件冲突、被扫描、被挂马,很多人最后不是不想做社区,是被维护成本劝退。

今年我开始用 AI 写代码。先是小脚本,后来越写越大,某天突然想:那能不能让 AI 帮我做一个论坛?不是玩具,是真能开门接客的那种。

于是有了这个站。

我想验证三件事

  1. 一个不懂编程的人 + AI,能不能做出一个能上线、也能维护的产品
  2. 「轻」到底能轻到什么程度:单二进制、没有外部依赖、2 核 2G 的机器
  3. 现在还有没有人愿意在论坛说话——不是刷短视频,是坐下来打一段字
第 3 条我到现在也没把握。但这正是要试的原因。

这里会写什么

从今天起,我把这个程序从零到上线的过程一篇一篇发出来:哪天做了什么、做错什么、怎么改的。踩过的坑单独成篇,细节补在回帖里。

不是教程,是一个人的施工记录。你要照着抄,大概率会踩一样的坑——那我写这些就没用了。

#建站日志 #从零开始