小而美的生产级单体后端：键盘小鹿 Bun + Hono + 环回 Docker 隔离、Redis ACL 自审与零停机原子发布

一、 为什么中小型教育产品更需要“小而美的生产级单体”？——第一性原理

在系统架构演进中，很多团队错误地将“架构先进性”等同于“服务拆分的数量”，结果在生产运维中惨遭反噬：

• MicroserviceTrap -> KeyDeerMonolithArch
• 1. 穿透表象：业务物理事实对性能的真实要求： 打字训练系统的服务端核心职责非常清晰内聚： - 提供轻量用户档案同步与课时进度落盘； - 校验竞速挑战赛防作弊回放签名； - 分发客户端自更新版本元数据与静态课程 JSON。 这些业务逻辑全部是高频、轻量且具备高度关联性的。一个高度内聚、内存共享的单体后端，其内部函数调用的延迟在微秒级，相比跨网络的 RPC 远程调用快了数千倍。
• 2. 传统粗放单体后端的安全死穴： 很多单体后端容易走另一个极端——将 MySQL、Redis 端口直接裸奔监听在 0.0.0.0，所有项目共用一个 root 权限数据库，发布新版本时直接在服务器交互终端手工敲 git pull 覆盖文件。一旦代码报错，整个线上服务当场停摆，引发严重的线上事故。

二、 环回网络隔离与单一公网咽喉拓扑

键盘小鹿在线服务构建了坚不可摧的“三层物理安全边界”：公网流量只进 Nginx，所有底层容器全部封锁在回环网卡（127.0.0.1）：

生产级安全不变量（Invariants）： 1. 公网零暴露：MySQL 与 Redis 容器的端口映射严格限定为 127.0.0.1:3306:3306 与 127.0.0.1:6379:6379，绝不绑定 0.0.0.0，外部扫描器即便探测服务器所有端口，也探测不到任何数据库服务； 2. 多租户数据彻底物理隔离：键盘小鹿拥有完全独立的 Docker 容器、独立的数据卷（Volume）与专属数据库账号，严禁与其他外部项目共用任何数据库或 Redis 实例，杜绝连带被拖库风险。

• PublicInternet["公网用户流量 (HTTPS / 443)"] -> NginxProxy["Nginx 反向代理 (唯一公网入口 / SSL 终结 / 限流防刷)"]
• NginxProxy -> |Unix Domain Socket / 127.0.0.1:3000| BunApp["Bun + Hono 单体应用服务 (Systemd 守护)"]
• BunApp -> DockerMySQL
• BunApp -> DockerRedis

三、 核心工程实现细节

// server/online/src/app.ts 生产级单体入口核心实现
import { Hono } from 'hono'
import { logger } from 'hono/logger'
import { cors } from 'hono/cors'
import { syncRouter } from './modules/sync'
import { updateRouter } from './modules/update'
import { competitionRouter } from './modules/competition'

const app = new Hono()

// 1. 注册核心中间件 (全链路微秒级计时与安全头)
app.use('*', logger())
app.use('*', cors({
  origin: ['https://www.keydeer.cn', 'https://keydeer.cn'],
  allowMethods: ['GET', 'POST', 'OPTIONS'],
  allowHeaders: ['Content-Type', 'Authorization', 'X-Idempotency-Key']
}))

// 2. 深度健康检查端点 (供发布部署流水线原子探针探测)
app.get('/health', async (c) => {
  const isDbHealthy = await checkDatabaseConnection()
  const isRedisHealthy = await checkRedisConnection()
  
  if (!isDbHealthy || !isRedisHealthy) {
    return c.json({ status: 'unhealthy', db: isDbHealthy, redis: isRedisHealthy }, 503)
  }
  return c.json({ status: 'healthy', uptime: process.uptime(), time: new Date().toISOString() })
})

// 3. 挂载高内聚核心业务路由模块
app.route('/api/sync', syncRouter)
app.route('/api/update', updateRouter)
app.route('/api/competition', competitionRouter)

// 4. 监听本地环回端口
export default {
  port: Number(process.env.PORT || 3000),
  hostname: '127.0.0.1',
  fetch: app.fetch
}

• 1. Bun + Hono 极致精悍的服务端核心（server/online/src/app.ts）： 得益于 Bun 对 TypeScript 的原生支持与 Hono 基于智能正则表达式 Trie 树路由的极致优化，整个核心单体应用代码简洁明了，冷启动耗时低至 18 毫秒：
• 2. Redis 7.0 ACL 细粒度权限自审： 键盘小鹿拒绝使用传统的全局无权限 Redis，而是通过 ACL 限制当前服务仅能读写专属命名空间（如 keydeer:*），杜绝因开发误操作执行 FLUSHALL 祸及其他业务：

四、 零停机原子发布流水线（Atomic Zero-Downtime Deployment）

键盘小鹿坚决废止在生产环境直接覆盖文件或拉取代码的做法，而是设计了基于软链接（Symlink）与预检回滚的工业级部署流水线：

核心部署脚本实现节选：

• Build -> Upload -> Preflight
• Preflight -- 预检失败 -> Abort["立即终止！服务器 current 软链接保持不动，线上运行不受丝毫影响"]
• Preflight -- 预检通过 -> SwitchSymlink["4. 执行 ln -sfn 原子切换当前符号链接 (current -> 新版本目录)"]
• SwitchSymlink -> Reload["5. systemctl reload dazitong-online (无损优雅平滑重载进程)"]
• Reload -> HealthCheck["6. 向 127.0.0.1:3000/health 发送探针请求"]
• HealthCheck -- 探针异常 -> AutoRollback["触发自动回滚！瞬间将 current 切回旧版本目录并重启"]
• HealthCheck -- 返回 200 OK -> Success["发布圆满成功！无感零停机上线"]

五、 后端方案综合指标对比看板