feat: central system database bootstrap for local developers #2

lunanting · 2026-09-12T16:07:38+08:00

lunanting commented

2026-09-12 16:07:38 +08:00

目的与范围

本地首次启动弹窗通过 HTTPS + 一次性部署 Key 注册设备，自动建立受限 SSH 数据库隧道。默认请求地址为 https://ck.yydd.ai:8443/v1/enroll。
中央系统库保存系统配置和第三方数据库连接配置；每台设备独立数据库账号，创建一次性显示的应用管理员。
增加 ck.yydd.ai 服务端 broker、服务器安装脚本、DNS-01 证书配置和远程部署文档。
纳入多人及 AI 开发提交合并规范。

安全边界

Key 只保存哈希并限制次数/有效期；MySQL 继续只监听 127.0.0.1:3307。
SSH 账号只能本地端口转发到系统库，设备可单独撤销；仓库不包含任何运行时密码、私钥或业务数据。
应用管理员密码只在注册响应中返回一次。

验证

npm --prefix backend run check：通过（306 tests）
npm --prefix frontend run check：通过（lint、21 tests、build）
npm run test:remote：通过（3 tests）
服务端端到端验证：临时设备注册、SSH 隧道、管理员 bcrypt 密码校验、第三方配置读取、跨库读取拒绝、撤销清理均通过。

服务器前置条件

ck.yydd.ai 使用 Cloudflare DNS-01；管理员需在服务器放置 root-only /etc/cangku-tls/cloudflare.ini，再运行证书和安装脚本。Certbot 自动续期。

## 目的与范围 - 本地首次启动弹窗通过 HTTPS + 一次性部署 Key 注册设备，自动建立受限 SSH 数据库隧道。默认请求地址为 `https://ck.yydd.ai:8443/v1/enroll`。 - 中央系统库保存系统配置和第三方数据库连接配置；每台设备独立数据库账号，创建一次性显示的应用管理员。 - 增加 ck.yydd.ai 服务端 broker、服务器安装脚本、DNS-01 证书配置和远程部署文档。 - 纳入多人及 AI 开发提交合并规范。 ## 安全边界 - Key 只保存哈希并限制次数/有效期；MySQL 继续只监听 127.0.0.1:3307。 - SSH 账号只能本地端口转发到系统库，设备可单独撤销；仓库不包含任何运行时密码、私钥或业务数据。 - 应用管理员密码只在注册响应中返回一次。 ## 验证 - `npm --prefix backend run check`：通过（306 tests） - `npm --prefix frontend run check`：通过（lint、21 tests、build） - `npm run test:remote`：通过（3 tests） - 服务端端到端验证：临时设备注册、SSH 隧道、管理员 bcrypt 密码校验、第三方配置读取、跨库读取拒绝、撤销清理均通过。 ## 服务器前置条件 - `ck.yydd.ai` 使用 Cloudflare DNS-01；管理员需在服务器放置 root-only `/etc/cangku-tls/cloudflare.ini`，再运行证书和安装脚本。Certbot 自动续期。

lunanting added 2 commits 2026-09-12 16:07:38 +08:00

feat: bootstrap local instances from central system database 3239d6a558

docs: define safe multi-user and AI contribution workflow 584e0b4612

lunanting added 1 commit 2026-09-12 16:09:01 +08:00

fix: use DNS validation for managed TLS certificate 5689671312

lunanting added 1 commit 2026-09-12 16:11:10 +08:00

fix: route bootstrap HTTPS through port 8443 088a24c3a9

lunanting added 1 commit 2026-09-12 16:53:31 +08:00

ops: add isolated production deployment a85acabde5

lunanting added 1 commit 2026-09-12 16:56:01 +08:00

fix: use backend liveness health check 3229c2a1c3

lunanting added 1 commit 2026-09-12 16:58:07 +08:00