OtunLink 云资源配置(cloud-config)
本文件记录 OtunLink 已创建/回传的 Cloudflare 与对象存储资源(不含密钥)。
密钥一律放在 gitignored 文件中(见下文「密钥」),绝不提交仓库 。
项目
值
账户 Account ID
<CF_ACCOUNT_ID>
域名
otun.musi.land(CNAME → otun.pages.dev)
Pages 项目
项目名 otunlink (项目域 otun.pages.dev);自定义域 otun.musi.land status=active;部署方式:wrangler pages deploy apps/web/dist --project-name otunlink(GitHub Actions deploy.yml 自动执行;未用 CF Git 集成,monorepo 无法解析工作区包)
API Token
存于 <repo>\.cf\api-token.txt(gitignored;权限:Worker/Pages/KV/Hyperdrive 编辑)
API Worker
otunlink-api 已部署(2026-08-31);自定义域 api.otun.musi.land(自动创建 CNAME+证书)与 workers.dev 子域 otunlink-api.<account>.workers.dev 均已启用
绑定(已写入 apps/api/wrangler.toml)
绑定
资源
用途
HYPERDRIVE
id <HYPERDRIVE_ID>(wrangler.toml 以 <your-hyperdrive-id> 占位符提交,CI 部署时经 Secrets 自动替换,本地需手动回填)
私有 PostgreSQL 连接池(生产 DB 访问)
JWKS_CACHE
KV 命名空间 otunlink(id <KV_NAMESPACE_ID>,替换方式同上)
Entra JWKS 24h 缓存
2. 数据库(私有 PostgreSQL,经 Hyperdrive)
项目
值
主机 / 端口
sc.aloen.to:6432 (2026-11-05 起;旧地址 164.30.21.203:9500 已停用。6432 = PgBouncer 1.26 事务级池,PG 本体只听 127.0.0.1:5432);强制 TLS → 连接串用 ?sslmode=verify-full(证书 LE CN=sc.aloen.to)
数据库
otunlink(专用库 ;同机另有 musiland / fusionfx / status_dashboard 等其它项目的库,别混用。历史原因:账号对 postgres 默认库无 public 建表权限,PG15+ public schema 归 pg_database_owner,故单独建库并 OWNER 给业务账号)
用户
root(非超级用户,拥有 otunlink 库)
连接串(本地)
见 apps/api/.dev.vars 与根 .dev.vars(gitignored,含密码)
迁移
pnpm --filter @otunlink/db db:migrate(本地已验证:21 个枚举 / 29 表 / 293 列;2026-11-05 在新库重跑 → applied 0 / skipped 3,schema 一致)
Hyperdrive
名称 otunlink ,id d3f06050a92846ca950561f5d37f1232;2026-11-05 origin 改指 sc.aloen.to:6432 并升到 sslmode=verify-full (CA letsencrypt-isrg-root-x1 = f591f184-92b9-4846-8cd3-4dffe85f121f),远端实测 Worker 读到 PG 18.6;口径见 docs/db-setup.md §7
查询缓存
必须把 TTL 压到最小 :npx wrangler hyperdrive update "<HYPERDRIVE_ID>" --max-age=1 --swr=0(默认 max_age=60s + stale_while_revalidate=15s 且写入不会失效,会造成「改了看不到」,详见 docs/db-setup.md §6)
wrangler.toml 的 [[hyperdrive]] 绑定只接受 binding + id;缓存参数属于 Hyperdrive 资源本身,只能用 CLI / 控制台修改。
华为云 OBS,资源见用户回传;Worker 无原生绑定,运行时经 aws4fetch(SigV4 签名)访问。
配置项
值
Endpoint
<OBS_ENDPOINT>
Region
eu-de
Bucket
<S3_BUCKET>
Access Key
用户/AK 见 apps/api/.dev.vars(gitignored)
说明:用户回传的 <S3_BUCKET>.<OBS_ENDPOINT> 是「bucket 前缀」访问地址,
标准配置拆分为 endpoint + bucket + region 三项(已按上表录入 wrangler.toml [vars])。
4. 认证(Microsoft Entra ID,免费版单租户)
项目
值
目录(租户)ID
<TENANT_ID>
应用程序(客户端)ID
<CLIENT_ID>
API 暴露范围(scope)
https://<TENANT_DOMAIN>.onmicrosoft.com/OtunLink/API(发布者域形式;token aud 即此 URI)
注册
见 docs/auth-setup.md;Redirect URI 需含 https://otun.musi.land/auth/callback
本地配置
apps/api/.dev.vars:ENTRA_TENANT_ID/CLIENT_ID/AUDIENCE(AUDIENCE 已设为真实 scope);apps/web/.env.local:VITE_ENTRA_* + VITE_API_SCOPE(已设为真实 scope)
复制 .dev.vars.example → apps/api/.dev.vars(已完成,含 S3 凭据;gitignored)
wrangler dev 自动读取 apps/api/.dev.vars
前端:apps/web/.env.local(gitignored)保存 VITE_*(如 API 基址、MSAL 配置)
# 设置 CF API token(wrangler 读取 CLOUDFLARE_API_TOKEN)
$env: CLOUDFLARE_API_TOKEN = (Get-Content ' <repo>\.cf\api-token.txt' - Raw).Trim()
# 部署 secrets(仅首次)
cd < repo> \apps\api
npx wrangler secret put S3_ACCESS_KEY_ID -- name otunlink- api
npx wrangler secret put S3_SECRET_ACCESS_KEY -- name otunlink- api
# 以及 DB 相关(Hyperdrive 连接串在控制台配置,无需 secret)
# Hyperdrive 查询缓存 TTL(关键:默认 60s 缓存且写入不失效,会让「改了看不到」)
npx wrangler hyperdrive update " <HYPERDRIVE_ID>" -- max- age= 1 -- swr= 0
# 部署
npx wrangler deploy
✅ Hyperdrive 已确认 (2026-09-13;2026-11-05 origin 迁到 sc.aloen.to:6432):实例 otunlink(id d3f06050a92846ca950561f5d37f1232)指向 otunlink 库,
caching 已设为 max_age=1 / stale_while_revalidate=0(见第 2 节与 docs/db-setup.md §6);
✅ 新库(sc.aloen.to)防火墙已放行 CF 出口 —— 2026-11-05 远端 Worker 实测读到 PG 18.6
域名 :otun.musi.land(Pages 自定义域,已 active,SPA 主站);api.otun.musi.land(API Worker 自定义域,已 active);
无需额外 app. 子域(SPA 直接跑在 otun.musi.land)
Entra App Registration :按 docs/auth-setup.md 完成注册并配置 Redirect URI(见第 4 节)
OBS 策略 :确认 bucket 允许 Programmatic 访问(AK/SK 已给;如跨域/策略需放行)
apps/api/.dev.vars、.cf/api-token.txt 已被 .gitignore 忽略(git check-ignore 已验证)
CI/他人机器上使用密钥时,使用 GitHub Secrets / 环境变量,勿复制进仓库