#!/usr/bin/env node /** * fmode-storage uploader — 对象存储上传/公开链接/ACL * 零依赖(Node ≥18)。凭据按 5 级优先级自动解析,永不入库。 * * 第0级(自举):sessionToken + projectId → POST /api/apig/deploy/huaweicloud 换 STS 临时凭证, * 内存持有直传 OBS(不落盘、不进日志)。后续级为回落链(自建 OBS / 已有 * obsutil config 的用户不受影响)。 * * 用法: * node uploader.mjs put --key [--acl public-read] [--endpoint ...] [--bucket ...] * node uploader.mjs setacl --key --acl public-read [-r] * node uploader.mjs config */ import fs from 'fs'; import os from 'os'; import path from 'path'; import { execSync, spawnSync } from 'child_process'; const HOME = os.homedir(); // fmode 网关基址(签发 STS / 下载 URL) const FMODE_API_BASE = process.env.FMODE_API_BASE || 'https://server.fmode.cn'; // 自举(权威,2026-09-12 生产实测 200):sessionToken + projectId → STS // POST /api/apig/deploy/huaweicloud → {accessKey, secretKey, securityToken, obsPath} // obsPath 形如 obs://nova-cloud/dev//(bucket=nova-cloud, prefix=dev//) // 服务端权限链: token→用户身份 → Project.user/owner 或 ProjectTeam 三查 → 华为云委托 Agency 签发 STS // 注意: 旧设计中的 POST /api/storage/credentials 端点在生产**不存在**(Cannot POST 404),已移除。 const DEPLOY_STS_URL = `${FMODE_API_BASE.replace(/\/$/, '')}/api/apig/deploy/huaweicloud`; /** * 解析 storage 专用 projectId(非密钥)。 * 来源优先级:FMODE_STORAGE_PROJECT_ID 环境变量 * → ~/.fmode/config.json 的 storageProjectId * → ~/.fmode/config/user.json 的 storageProjectId * → ./.fmode/deploy.json 的 projectId(当前项目自己的发布身份) */ export function resolveStorageProjectId() { if (process.env.FMODE_STORAGE_PROJECT_ID) return process.env.FMODE_STORAGE_PROJECT_ID.trim(); const candidates = [ path.join(HOME, '.fmode', 'config.json'), path.join(HOME, '.fmode', 'config', 'user.json'), path.join(process.cwd(), '.fmode', 'deploy.json'), ]; for (const p of candidates) { try { if (!fs.existsSync(p)) continue; const j = JSON.parse(fs.readFileSync(p, 'utf8').replace(/^/, '')); const id = j.storageProjectId || j.projectId || null; if (id && String(id).trim()) return String(id).trim(); } catch { /* try next source */ } } return null; } /** * 第0级:解析 sessionToken。 * 来源(优先级):FMODE_SESSION_TOKEN 环境变量 * → ~/.fmode/config.json 的 sessionToken / user.sessionToken * → ~/.fmode/config/user.json 的 sessionToken * 找到即返回字符串,找不到返回 null(不报错——交给上层决定是否回落)。 */ export function resolveSessionToken() { if (process.env.FMODE_SESSION_TOKEN) return process.env.FMODE_SESSION_TOKEN.trim(); // user.json 优先:登录流程(07-git「平台 sessionToken 失效恢复」)写入的最新 token const candidates = [ path.join(HOME, '.fmode', 'config', 'user.json'), path.join(HOME, '.fmode', 'config.json'), path.join(process.cwd(), '.fmode', 'config.json'), ]; for (const p of candidates) { try { if (!fs.existsSync(p)) continue; const j = JSON.parse(fs.readFileSync(p, 'utf8').replace(/^/, '')); const t = j.sessionToken || (j.user && j.user.sessionToken) || null; if (t && String(t).trim()) return String(t).trim(); } catch { /* try next source */ } } return null; } /** * 第0级:sessionToken + projectId → STS 临时凭证(AK/SK/SecurityToken,作用域限定项目 prefix)。 * * 权威链路(future-server api/api-ncloud/apig/routes-deploy.js,2026-09-12 生产实测 200): * POST /api/apig/deploy/huaweicloud {token, projectId} * → { code:200, data:{ accessKey, secretKey, securityToken, obsPath } } * → obsPath "obs://nova-cloud/dev//" 解析出 bucket/prefix * → 客户端直传 OBS * 服务端权限:token→用户身份 → Project.user / Project.owner / ProjectTeam 三查。 * * ⚠️ 返回的 STS 仅内存持有:不写文件、不打日志、不进错误信息。 * * @returns {Promise<{ ak: string, sk: string, securityToken: string, * endpoint: string, bucket: string, prefix: string } | null>} * 签发失败返回 null(调用方回落第1-4级)。 */ export async function fetchStsCredentials(sessionToken, projectId) { if (!sessionToken || !projectId) return null; try { const res = await fetch(DEPLOY_STS_URL, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ token: sessionToken, projectId }), signal: AbortSignal.timeout(20000), }); if (!res.ok) return null; const body = await res.json().catch(() => null); const data = body && body.data; if (!body || body.code !== 200 || !data || !data.success) return null; const obsPath = String(data.obsPath || ''); const m = obsPath.match(/^obs:\/\/([^/]+)\/(.*)\/$/); return { ak: String(data.accessKey || ''), sk: String(data.secretKey || ''), securityToken: String(data.securityToken || ''), expiresAt: data.expiresAt || null, endpoint: 'obs.cn-south-1.myhuaweicloud.com', // nova-cloud 桶在 cn-south-1(实测 2026-09-12; north-4 会 NoSuchBucket) bucket: m ? m[1] : 'nova-cloud', prefix: m ? m[2] + '/' : `dev/${projectId}/`, }; } catch { /* 网络/签名失败一律回落,不泄露错误细节 */ } return null; } /** * 用 STS 临时凭证构造一次性 obsutil 配置目录,执行命令后即删。 * 配置只写进临时目录(0700),命令结束立即删除——STS 不落盘留存、不进日志。 * * @param {object} sts fetchStsCredentials() 的返回值 * @param {string[]} args obsutil 参数(不含 -e/-i/-k/-t) */ export function runWithSts(sts, args, timeout = 300000) { const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'fmode-sts-')); fs.chmodSync(tmpDir, 0o700); const cfgFile = path.join(tmpDir, '.obsutilconfig'); // STS 写入临时配置仅供 obsutil 本次调用读取,结束后立刻删除 fs.writeFileSync(cfgFile, [ `endpoint=${sts.endpoint}`, `ak=${sts.ak}`, `sk=${sts.sk}`, `token=${sts.securityToken}`, '', ].join('\n'), { mode: 0o600 }); try { // obsutil 只认 -config= 参数(不认 OBSUTIL_CONFIG_FILE 环境变量—— // 2026-09-12 实测:环境变量方式会静默回落默认配置导致 NoSuchBucket)。 // 桶级命令在位置参数后追加 -config;endpoint 已写进 config 文件。 const withCfg = [...args, '-config', cfgFile]; const r = spawnSync('obsutil', withCfg, { encoding: 'utf8', timeout }); const out = (r.stdout || '') + (r.stderr || ''); return { ok: /Upload successfully|Download successfully|Set the acl/i.test(out) || r.status === 0, out }; } finally { try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch { /* best effort */ } } } /** 5 级凭据/配置解析:第0级 sessionToken 自举 → env → ~/.fmode → ./.fmode → obsutil 默认链 */ export async function resolveStorageConfig() { const cfg = { obsUtilPath: 'obsutil', endpoint: 'obs.cn-south-1.myhuaweicloud.com', bucket: null, cdnDomain: null, sts: null, // 第0级自举得到的 STS(内存持有) via: null, // 命中的解析级别(诊断用,不含任何密钥) }; // ---- 第0级自举(权威):sessionToken + projectId → deploy/huaweicloud → STS ---- const sessionToken = resolveSessionToken(); if (sessionToken) { const projectId = resolveStorageProjectId(); const sts = projectId ? await fetchStsCredentials(sessionToken, projectId) : null; if (sts) { cfg.sts = sts; cfg.bucket = sts.bucket || cfg.bucket; cfg.endpoint = sts.endpoint || cfg.endpoint; cfg.cdnDomain = process.env.FMODE_CDN_DOMAIN || 'app.fmode.cn'; cfg.via = 'level0:sessionToken+projectId->deploySTS'; return cfg; // 自举成功,无需回落 } // 自举未命中:给出可操作的明确指引 if (!projectId) { console.error('sessionToken 存在但缺少 storageProjectId——请设置 FMODE_STORAGE_PROJECT_ID 或在 ~/.fmode/config.json 配 storageProjectId(须为本人有权限的 Project objectId)'); } else { console.error('sessionToken 存在但 STS 签发失败(/api/apig/deploy/huaweicloud 未 200)——token 失效或该 projectId 不属于当前用户(服务端校验 Project.user/owner/ProjectTeam 三查)'); } console.error('(将继续尝试第1-4级回落配置)'); } // ---- 第1级:环境变量 ---- if (process.env.FMODE_OBS_CONF) { try { Object.assign(cfg, JSON.parse(fs.readFileSync(process.env.FMODE_OBS_CONF, 'utf8'))); cfg.via = 'level1:FMODE_OBS_CONF'; } catch {} } // ---- 第2/3级:~/.fmode/config.json → ./.fmode/config.json ---- for (const p of [path.join(HOME, '.fmode', 'config.json'), path.join(process.cwd(), '.fmode', 'config.json')]) { try { const j = JSON.parse(fs.readFileSync(p, 'utf8')); if (j.obsUtilPath) cfg.obsUtilPath = j.obsUtilPath; if (j.obsBucket) { cfg.bucket = j.obsBucket; cfg.via = cfg.via || `level:${p}`; } if (j.obsEndpoint) cfg.endpoint = j.obsEndpoint; if (j.cdnDomain) cfg.cdnDomain = j.cdnDomain; } catch {} } // ---- 第4级:obsutil 默认链(已配置则探测 bucket)---- if (!cfg.bucket) { try { const out = execSync(`${cfg.obsUtilPath} ls -limit=1 2>/dev/null`, { encoding: 'utf8', timeout: 15000 }); const m = out.match(/obs:\/\/([^/]+)/); if (m) { cfg.bucket = m[1]; cfg.via = 'level4:obsutil-default'; } } catch {} } return cfg; } /** 公开 URL: cdnDomain 优先, 否则桶域名 */ export function publicUrl(cfg, key) { if (cfg.cdnDomain) return `https://${cfg.cdnDomain}/${key}`; return `https://${cfg.bucket}.${cfg.endpoint}/${key}`.replace('.myhuaweicloud.com', '.myhuaweicloud.com'); } /** v2 STS 的 key 必须限定在签发的 prefix 内(dev//...),防止越权路径 */ function scopedKey(cfg, key) { if (cfg.sts && cfg.sts.prefix) { const pfx = cfg.sts.prefix.endsWith('/') ? cfg.sts.prefix : cfg.sts.prefix + '/'; if (key.startsWith(pfx)) return key; return pfx + key.replace(/^\/+/, ''); } return key; } function obs(args, cfg, timeout = 120000) { // 第0级命中 → STS 一次性临时配置执行(不落盘留存) if (cfg.sts) return runWithSts(cfg.sts, args, timeout); // 回落:用户自己的 obsutil 配置 const r = spawnSync(cfg.obsUtilPath, [...args, '-e', cfg.endpoint], { encoding: 'utf8', timeout }); const out = (r.stdout || '') + (r.stderr || ''); return { ok: /Upload successfully|Download successfully|Set the acl/i.test(out) || r.status === 0, out }; } async function main() { const [cmd, ...rest] = process.argv.slice(2); const cfg = await resolveStorageConfig(); if (!cfg.bucket && cmd !== 'help') { console.error('未解析到 bucket:请登录 FMODE Studio(sessionToken 自举)或配置 ~/.fmode/config.json 的 obsBucket/obsEndpoint 或 obsutil config。'); console.error('(技能绝不内置密钥;自建 OBS 用户用 obsutil config 自行配置)'); process.exit(2); } const arg = (name) => { const i = rest.indexOf(name); return i >= 0 ? rest[i + 1] : null; }; if (cmd === 'put') { const file = rest[0]; let key = arg('--key'); if (!file || !key) { console.error('用法: put --key [--acl public-read]'); process.exit(2); } const acl = arg('--acl') || 'public-read'; const bucketArg = arg('--bucket'); if (bucketArg) cfg.bucket = bucketArg; key = scopedKey(cfg, key); // v2 STS: 强制限定 dev// 前缀 const r = obs(['cp', file, `obs://${cfg.bucket}/${key}`], cfg); if (!r.ok) { console.error('上传失败:', r.out.slice(-300)); process.exit(1); } console.log(JSON.stringify({ ok: true, key, url: publicUrl(cfg, key), bucket: cfg.bucket, via: cfg.via }, null, 2)); return; } if (cmd === 'setacl') { const key = arg('--key'); const acl = arg('--acl') || 'public-read'; const recursive = rest.includes('-r'); const r = obs(['chattri', `obs://${cfg.bucket}/${key}`, '-acl', acl, ...(recursive ? ['-r', '-f'] : ['-f'])], cfg); console.log(JSON.stringify({ ok: r.ok }, null, 2)); return; } if (cmd === 'config') { // 诊断输出:绝不包含 AK/SK/SecurityToken/sessionToken 任何密钥本体 console.log(JSON.stringify({ via: cfg.via, bucket: cfg.bucket, endpoint: cfg.endpoint, cdnDomain: cfg.cdnDomain, stsBootstrapped: Boolean(cfg.sts), stsPrefix: cfg.sts ? cfg.sts.prefix : null, stsProjectId: cfg.sts && cfg.sts.projectId ? cfg.sts.projectId : null, stsExpiresAt: cfg.sts && cfg.sts.expiresAt ? cfg.sts.expiresAt : null, }, null, 2)); return; } console.log('用法: put | setacl | config'); } main();