zeki.casa 自托管门户
一台自己维护的机器,一套 Traefik + Authelia,把个人主页、社团公告板和几个模块收进同一个入口。整套东西从域名、证书、反代到埋点全是自己搭的。
- 角色
- 设计 + 实现 + 运维
- 形态
- 多容器 + 反向代理
- 域名
- zeki.casa / club / app
- 状态
- 线上运行
01为什么要自己搭
最初只是想有个能放东西的地方。后来发现「自己的站点」和「租个博客」是两件完全不同的事:前者要处理域名解析、证书、鉴权、反代、缓存、监控,以及半夜服务挂了怎么办。这些正是我想练的部分,所以没有选托管平台。
现在这套东西真实承载着:一个公开主页、一个社团公告板(老师和社团干部在上面发通知)、一个需要登录的控制台,以及若干按 /mod/<前缀>/ 挂载的模块。
02一个域名一件事
这是目前真实在跑的域名表。同一个 Node 进程按 Host 头分流,Traefik 在它前面决定每个名字要不要人登录。公开的那几个是完全公开的(谁都能打开),受保护的那些统一走门户登录门。
www.zeki.casa/xxx 会 302 到 zeki.casa/xxx,路径原样带上。这个规则必须显式存在——不写的话它会落到下面的通配规则上、被要求登录,实测踩过。/mod/<前缀>/ 下的模块也全在这个域名下,同样受保护。域名本身就是「管理面」的意思:同一个进程,换个 Host 就是另一套可见范围。app.zeki.casa/mod/dsh/:它的前端把大量路径写成了绝对路径,改不掉 base。顺带这也是为什么不能给它二级域名——免费证书只签一级。/form、/static、/graphql 这些是公开的——别人点链接就能匿名填表,不用注册;创建、编辑、导出、看结果则在登录门后面。/graphql 必须公开,因为公开表单页靠它拉表单定义和提交,这部分鉴权由应用层自己做。tmp 的区别是这里有权限、有版本、有配额,tmp 只是公开的临时展示位。旁边那四个容器(forms / gitea / drive 各带自己的库)都不在宿主上发布端口,只挂在同一个内部网络上,对外唯一的口就是 Traefik。
03登录门是怎么做的
整套鉴权最容易被想成「装个 Authelia 打开它的登录页」。实际做法反过来了:Authelia 只做后台认证服务,它的登录 UI 一个都不对外暴露。
- 登录页是门户自己的
login.html。用户提交后,门户的/api/login代调 Authelia 的/api/firstfactor,再把会话 Cookie 转交浏览器。好处是登录页和站点完全同一套外观,也能在同一页里挂 Touch ID / Passkey。 - Traefik 的 forwardAuth 不指向 Authelia,指向门户自己的
/api/authz。它同时认两种身份:Authelia 的密码会话,和门户自己的 Passkey 会话;密码那条内部再回退去调 Authelia/api/verify。未登录时rd回我们自己的登录页。 - 登录页本身在受保护域名下,所以必须有一张白名单放行登录页、注册页、静态资源、登录/登出/注册接口、WebAuthn 接口和埋点采集——不绕开就是「未登录 → 跳登录页 → 又被拦」的死循环。
- 反向的一个坑:白名单路由不挂 forwardAuth,而 Traefik 默认会把客户端自带的
Remote-User原样透传。门户如果信这个头,就等于允许匿名者自称管理员。所以入口上加了一条strip-identity,在公开路由上把四个身份头全部清空。 - Cloudflare 终止 TLS、回源是明文 http,所以还要固定
X-Forwarded-Proto: https——否则 Authelia 判定目标不安全,拒绝下发会话,表现就是一串 401 循环。 - Authelia 的 session cookie 域设成
zeki.casa,所以在 app 站登录一次,git / drive / forms 全都直接进,不重复登录。
04模块挂在两个地方
模块有两种挂载形态,选哪一种由模块自己决定,不由我拍脑袋:
- 子路径
app.zeki.casa/mod/<前缀>/:默认形态,适合能在子路径下正常工作的服务。 - 一级子域
<前缀>.zeki.casa:给前端写死绝对路径、改不了 base 的服务。用一级而不是二级x.app.zeki.casa,是因为 Cloudflare 免费版 Universal SSL 的证书只覆盖根域和一级子域,二级名字根本不在 SAN 里,TLS 握手就失败。
现在的模块表:disk(我的文件)、stream(应急串流,现处下线态)、socialgraph(微信社交图谱,需 HTML 重写,因为它的前端同样写死了 /api/ 前缀)、dsh(走子域形态)。
05几个真正花时间的点
- 模块状态机:模块不是「有链接就算在」。设计了一套 7 态状态机(在线 / 唤醒中 / 闲置下线 / 探活失败 / 崩溃循环 / 维护 / 管理员下线),带健康探活、闲置自动下线、按需唤醒和崩溃循环保护,避免一个坏模块把整台机器拖死。
- 宿主机指标:容器里读到的 CPU 是 Linux VM 的,不是这台 PC 的。所以另写了一个跑在宿主机上的采集器(
127.0.0.1:3090),用 PDH 计数器取与任务管理器同口径的 CPU 和网络速率;GPU 单次采样要 7 秒且上千实例,改成后台 15 秒低频缓存,请求路径永不等待它。 - 数据口径要能自证:Cloudflare 免费版只有抽样表,没有精确请求数。页面上写的是「页面浏览(visits)」并注明抽样与约 5 分钟边缘聚合延迟,而不是把抽样数当 PV 报。
- 零停机改动:站点公开之后定了条纪律——不重启容器。静态页改动即时生效;后端改动先做在隔离副本里,等窗口再切。
- 零依赖的观感:页面的玻璃质感不是图片,是运行时按元素的圆角与实际尺寸现算位移贴图(圆角矩形 SDF + 斯涅尔定律),再叠一层 WebGL2 的逐像素光照;不支持的环境自动退回 CSS 毛玻璃与实心基线。
06顺手长出来的东西
门户跑起来之后,很多需求是自然出现的:社团要发通知,于是有了公告板与发布权限;想知道有没有人看,于是接了自建埋点与访问分析;不想开电脑也能翻文件,于是有文件模块;GitHub 上看到有意思的仓库,于是写了个每日精选的推送脚本。这些不是规划出来的,是「这里少一块」然后补上的。
07现在
线上稳定运行,处于冻结期(只做静态层改动)。下一步是把模块编排真正接进容器生命周期——现在模块状态机是完整的,但「从镜像起一个容器」这一步还留着口子。