跳到主要内容
基础设施

zeki.casa 自托管门户

一台自己维护的机器,一套 Traefik + Authelia,把个人主页、社团公告板和几个模块收进同一个入口。整套东西从域名、证书、反代到埋点全是自己搭的。

自托管DockerTraefikAutheliaNode.jsCloudflare
角色
设计 + 实现 + 运维
形态
多容器 + 反向代理
域名
zeki.casa / club / app
状态
线上运行

01为什么要自己搭

最初只是想有个能放东西的地方。后来发现「自己的站点」和「租个博客」是两件完全不同的事:前者要处理域名解析、证书、鉴权、反代、缓存、监控,以及半夜服务挂了怎么办。这些正是我想练的部分,所以没有选托管平台。

现在这套东西真实承载着:一个公开主页、一个社团公告板(老师和社团干部在上面发通知)、一个需要登录的控制台,以及若干按 /mod/<前缀>/ 挂载的模块。

02一个域名一件事

这是目前真实在跑的域名表。同一个 Node 进程按 Host 头分流,Traefik 在它前面决定每个名字要不要人登录。公开的那几个是完全公开的(谁都能打开),受保护的那些统一走门户登录门。

zeki.casa公开
主站。就是你现在看的这个页面:关于我、社团、项目、设计、影像、公告、精选。纯静态渲染,没有登录也能读完。源站不暴露公网 IP——入口是 Cloudflare Tunnel 打进来,证书和边缘缓存都在 Cloudflare。
www.zeki.casa公开 · 跳转
只做一件事:去掉 www。www.zeki.casa/xxx 会 302 到 zeki.casa/xxx,路径原样带上。这个规则必须显式存在——不写的话它会落到下面的通配规则上、被要求登录,实测踩过。
club.zeki.casa公开只读
社团公告板。老师和社团干部发通知的地方,学生和校外的人都能直接看,不登录。写作不在这个域名上——发布走 app 站登录后的控制台,所以公开站只放行几个只读 API(公告列表、公告流、社团信息),其余接口对它一律 404。
app.zeki.casa需登录
控制台。默认落到登录页;进来之后是站点配置、模块管理、公告发布、访问分析、个人设置。/mod/<前缀>/ 下的模块也全在这个域名下,同样受保护。域名本身就是「管理面」的意思:同一个进程,换个 Host 就是另一套可见范围。
openclaw.zeki.casa不挂登录门
OpenClaw 网关。这是我平时跑的助手运行时,在这里它同时是一个被反代的服务。它是全套里唯一故意不挂 forwardAuth 的受控入口:它服务的是 node / CLI 机器客户端和 WebSocket,那些客户端根本没有浏览器登录态,挂上去就会被 302 到登录页。所以安全边界改成网关自己的 token;身份头照样清空,入口不替任何客户端背书。
dsh.zeki.casa需登录
DeepSeek Harness,我用来跑工程任务的执行层。它必须占一个一级子域而不是 app.zeki.casa/mod/dsh/:它的前端把大量路径写成了绝对路径,改不掉 base。顺带这也是为什么不能给它二级域名——免费证书只签一级。
forms.zeki.casa公开填表 + 受保护工作台
自托管表单站(HeyForm 社区版,独立 compose)。这个域名被切成两半:/form、/static、/graphql 这些是公开的——别人点链接就能匿名填表,不用注册;创建、编辑、导出、看结果则在登录门后面。/graphql 必须公开,因为公开表单页靠它拉表单定义和提交,这部分鉴权由应用层自己做。
git.zeki.casa需登录
自托管 Git(Gitea)。私有仓库放在自己机器上,不依赖别人家的服务条款。选了「全员走浏览器」的路线——网页版自带上传和在线编辑器,所以直接用统一登录,不另开一套 Basic Auth。在 app 站登录过就直接进。
drive.zeki.casa需登录
自托管网盘(Nextcloud,带独立数据库容器)。放需要跨设备取的文件:课件、素材、备份。这是「不想开自己电脑也能拿文件」的答案——和 tmp 的区别是这里有权限、有版本、有配额,tmp 只是公开的临时展示位。
tmp.zeki.casa公开
临时展示位。把做好的课件、PDF、预览页挂成一个固定链接发出去。存在的理由很具体:临时隧道(trycloudflare)过夜就失效,局域网 IP 会变,而「发给别人一个明天就打不开的链接」很蠢。公开路由,所以只放可公开的东西,私密文件一律不进。
<任意名字>.zeki.casa通配 · 需登录
兜底规则:任何没被上面显式接管的子域,都会被当成「待上线的新模块」,默认挂上登录门、反代到门户。这样加一个新模块时,域名先能通、权限先是对的,再去接后端。它的优先级必须最低,否则会把 app / club / www 这些抢走——这是实际踩过的顺序 bug。

旁边那四个容器(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(走子域形态)。

模块不是「有链接就算在」。每个模块有 7 态状态机:在线 / 唤醒中 / 闲置下线 / 探活失败 / 崩溃循环 / 维护 / 管理员下线。打开一个处于下线态的模块时不是 404,而是返回可读的状态页并触发按需唤醒。

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现在

线上稳定运行,处于冻结期(只做静态层改动)。下一步是把模块编排真正接进容器生命周期——现在模块状态机是完整的,但「从镜像起一个容器」这一步还留着口子。

主站