
如果说 v0.30.x ~ v0.33.x 的主题是「生产级可靠性收口」，那么 v0.34.x 解决的是更根本的问题：**谁能在这个系统里做什么**。v0.34.0 交付了完整的 RBAC 授权模型、角色与分配管理、服务专属身份和资源执行边界，并完成了从 legacy 数字角色到 IAM 的离线迁移与生产停写交接；随后的 v0.34.1 ~ v0.34.4 五轮 PATCH，修复交接后暴露的调用链缺项、前端可见性问题与依赖安全告警。

整个系列 5 个版本、42 个非合并提交、583 个文件、+58.3k/-5.8k 行，涉及全部九个服务、前端、API/proto、三库迁移 110–123 及部署配置。这是项目迄今单次跨度最大的权限体系变更。

**关键特点**：API 全部为增量扩展，无破坏性变更；IAM 切换后管理权限来自服务端分配、会话和固定目录，旧数字角色、静态 `ADMIN_TOKEN` 与共享服务令牌不再能替代 IAM 管理授权。

## 版本总览

| 版本 | 日期 | 类型 | 关键词 |
|------|------|------|--------|
| [v0.34.0](https://github.com/mengbin92/micro-one-api/tree/main/docs/releases/release-v0.34.0.md) | 2026-10-06 | MINOR | RBAC 授权模型、服务身份、IAM 离线迁移与生产交接 |
| [v0.34.1](https://github.com/mengbin92/micro-one-api/tree/main/docs/releases/release-v0.34.1.md) | 2026-10-06 | PATCH | 订阅用量 502、用户字段可见性、公开模型价格过滤 |
| [v0.34.2](https://github.com/mengbin92/micro-one-api/tree/main/docs/releases/release-v0.34.2.md) | 2026-10-06 | PATCH | 本人订阅进度会话转发、前端生成类型同步 |
| [v0.34.3](https://github.com/mengbin92/micro-one-api/tree/main/docs/releases/release-v0.34.3.md) | 2026-10-06 | PATCH | IAM 权限目录详情弹窗 |
| [v0.34.4](https://github.com/mengbin92/micro-one-api/tree/main/docs/releases/release-v0.34.4.md) | 2026-10-06 | PATCH | 配置查询告警澄清、前端依赖漏洞清零 |

## 核心亮点

### 1. RBAC 授权模型（v0.34.0）

旧数字角色（0/1/10/100）和共享令牌不能表达权限来源、资源范围、受限委派与会话激活。v0.34.0 引入：

- **固定权限目录**：用户、渠道/账号/模型/路由组、资金/订单/订阅、日志/配置/健康/通知的读写、导出、批量和复合动作逐条编号。
- **角色继承与组合授权**：allow/deny 来源与范围组合、角色/用户分配和委派约束、SSD/DSD 与成员数约束。
- **事务一致性**：会话/密码版本校验、策略 CAS、原子成功审计；授权判断在业务 owner 执行，查询范围先于总数与分页应用，事务重试重新核验授权。

**收益**：权限变更与业务写入具备一致性保证，授权失败不再依赖「调用方自觉」。

### 2. 服务专属身份（v0.34.0）

九个服务安装专属 outbound 身份与固定 caller 清单，取代此前所有内部服务共用的共享令牌：

- 每个服务只能调用清单内的 RPC（例如 relay 可读取路由事实与订阅用量，但不能改写账户）。
- 写入使用 owner CAS 与资源审计；错误 caller、共享凭证与匿名入口一律拒绝。
- 普通服务不得持有 DDL、共享 root 或跨 owner 写权限；billing 财务列权限独立核准。

**收益**：服务间调用可逐条审计、独立撤权，单个服务被攻破不再等于全部内部通道失守。

### 3. IAM 离线迁移与生产停写交接（v0.34.0）

只切换 feature flag 无法证明旧写者退出、全量用户映射一致与财务记录完整。`iam-migrate` 工具提供完整流程：

```
清点 → 候选 → shadow → 停写 → 重建 → 签名 manifest → 核验 → activate → complete
```

绑定 batch、root 签名、源码摘要和最新 policy CAS，支持幂等 resume。生产于 2026-10-05 完成交接为 `iam/complete`（policy revision 7、catalog revision 2），旧共享远程 root 通道已撤权锁定。

### 4. 权限治理界面（v0.34.0 / v0.34.3）

- 新增角色、权限目录、分配、委派、约束、审计与本人会话角色管理界面；财务与秘密字段独立授权，脱敏模型编辑保留未获授权的价格。
- 权限目录新增说明/排序字段；v0.34.3 修复详情编辑器固定渲染在长列表下方、点击无可见反馈的问题，改为视口内响应式弹窗。

### 5. 交接后的调用链快速补齐（v0.34.1 / v0.34.2）

固定 caller 表在真实流量下暴露了若干遗漏，一天内逐轮修复：

- **v0.34.1**：relay 查询订阅用量返回 502（caller 表遗漏 `GetSubscriptionUsage`）；用户管理页余额/已用字段误删、空邮箱误标「受限」；公开价格页展示禁用模型——新增只允许专属 admin caller 的 `ListPublicModels` RPC，价格接口只返回启用、公开、已注册价格的模型及输入/输出模态。
- **v0.34.2**：本人订阅进度入口漏转发已验证会话导致 401；异用户访问仍为 403，本人范围核对不变。

每一轮都遵循同一纪律：**owner 独立验证会话与范围，转发不扩大权限，缺什么补什么，绝不放宽校验**。

### 6. 依赖与扫描安全清零（v0.34.0 / v0.34.4）

- v0.34.0：axios 升级至 1.20.0 修复 CVE；gosec 信任边界复审并逐条标注 `#nosec`；全历史 Gitleaks 复现四条测试误报后以精确指纹豁免，1022 个提交零发现。
- v0.34.4：config 查询改为固定 SQL 文本 + 显式占位符，CodeQL 三条告警自动标记 fixed（行为不变，仍走绑定参数）；前端移除未使用的 shadcn CLI 依赖链（`braces`、`proxy-addr`、`postcss-selector-parser` 三个 CVE），override `source-map-js` 1.2.2，npm audit 归零，Trivy 对 Go 与前端全部依赖零漏洞。GitHub Code Scanning 开放告警清零。

## 升级步骤

⚠️ v0.34.0 不是「替换镜像」级别的升级，**尚在 legacy 的部署必须按 [IAM 交接执行手册](https://github.com/mengbin92/micro-one-api/tree/main/docs/runbooks/rbac-iam-cutover.md) 独立执行**，任何一步都不能跳过：

```bash
git fetch --tags
git checkout v0.34.4
```

1. **备份**：owner 数据库、Compose/.env、九服务 IAM 兼容回滚镜像和前端。
2. **迁移**：按迁移 ownership 应用 110–123（SQLite/MySQL/PostgreSQL 三库），核对实际最小数据库权限。
3. **身份**：配置九个独立 `SERVICE_CALLER_TOKENS` / outbound 服务身份、各 owner DSN 和接收方固定 caller map，救援配置保持关闭；按执行手册完成预检。
4. **构建**：本机交叉构建 `linux/amd64` 九服务与离线工具，服务器不构建；前端独立发布 `/opt/web/dist`（替换 admin 镜像不会更新挂载的静态资源）。
5. **交接**：准备签名证据、停写屏障、事务排空、旧进程/DB 通道撤权与财务核验，执行 `block → rebuild/verify → activate → complete` 后恢复入口。
6. **核对**：root 管理、普通用户本人用量、错误 caller/共享令牌拒绝、九服务健康、前端和财务摘要；撤销临时迁移/DDL 通道。

已经在 v0.34.1+ 的部署：按各 PATCH 说明只更新受影响服务即可，均为无迁移、无 IAM 重新切换的增量修复。

## 适合哪些场景

- **多管理员协作运营**：RBAC 让「谁能看财务报表、谁能改渠道价格、谁能管理用户」可以精确到人、到操作、到对象范围。
- **对内部攻击面有要求**：服务专属身份 + 固定 caller 清单让服务间权限最小化、可审计、可独立撤权。
- **需要合规审计**：授权变更要求变更原因、当前版本与精确权限，原子成功审计留痕。
- **从 legacy one-api 风格数字角色迁移**：`iam-migrate` 提供带签名 manifest 与幂等 resume 的完整交接路径，而非黑盒切换。

## 兼容性说明

- **API/proto**：全部为增量扩展；新增 IAM API、权限目录元数据及资源 CAS 字段。现有客户端可忽略新增字段。
- **数据库**：新增迁移 110–123，按 owner 清单应用。
- **IAM 语义**（重要）：
  - IAM 管理写入需提供变更原因、当前版本和对应精确权限。
  - 新增 operation 不自动进入 root 或历史内置角色的 grant。
  - IAM complete 后**不得**回退旧 legacy 二进制或历史角色回填；仅使用已验证的 IAM 兼容镜像和前端回滚。
- **配置**：无新增必填运行时配置；`SERVICE_CALLER_TOKENS`、各 owner identity 地址为交接所需。

## 验证与测试

最终源代码的 CI 全部 25 个 job 通过（后端单元/race、真实集成、前端 lint/test/build、MySQL/PostgreSQL 迁移、部署文档检查、九服务双架构共 18 个镜像构建），Security Pipeline 通过（gosec、govulncheck、Gitleaks、Trivy、CodeQL、许可证与 SBOM）。

v0.34.0 交接验收：SQLite 订阅购买/续期幂等、事务授权重试定向测试重复十次通过；真实 HTTP 超时回归验证本人购买从 401 恢复为正常输入校验；完整桌面/手机浏览器 smoke 65 项通过；Responses/SSE/WebSocket 续接、绑定源撤权、raw 协议、Redis 故障/恢复全阶段 Nightly E2E 通过。

v0.34.1 ~ v0.34.4 每轮均含「先复现、再修复、后验证」的生产受控记录：用量 502→200、本人进度 401→200、权限详情弹窗桌面/手机 Chrome 验证、npm audit 与 Trivy 双归零，脱敏证据见 `https://github.com/mengbin92/micro-one-api/tree/main/docs/runbooks/evidence/patch-v0.34.*-2026-10-06.json`。

## 下一步

- 真实多副本部署下的服务身份与 caller 清单演练
- 权限目录随新功能持续扩编与默认 grant 策略评审
- 继续按下一阶段计划推进：供应商账单核对、O5 延迟根因复测、性能门禁对照

欢迎关注、试用和参与改进：[github.com/mengbin92/micro-one-api](https://github.com/mengbin92/micro-one-api)

如果说 v0.30.x ~ v0.33.x 的主题是「生产级可靠性收口」，那么 v0.34.x 解决的是更根本的问题：谁能在这个系统里做什么。v0.34.0 交付了完整的 RBAC 授权模型、角色与分配管理、服务专属身份和资源执行边界，并完成了从 legacy 数字角色到 IAM 的离线迁移与生产停写交接；随后的 v0.34.1 ~ v0.34.4 五轮 PATCH，修复交接后暴露的调用链缺项、前端可见性问题与依赖安全告警。

Micro-One-API v0.34.x 发布：RBAC 权限体系落地与 IAM 生产交接

v0.34.0 交付了完整的 RBAC 授权模型、角色与分配管理、服务专属身份和资源执行边界，并完成了从 legacy 数字角色到 IAM 的离线迁移与生产停写交接；随后的 v0.34.1 ~ v0.34.4 五轮 PATCH，修复交接后暴露的调用链缺项、端可见性问题与依赖安全告警。

后端

v0.34.0-0.34.4完成RBAC权限体系大版本升级，实现服务专属身份、IAM离线迁移与生产交接，权限治理界面落地。API增量扩展无破坏性变更，五个PATCH修复调用链与安全告警，CI与安全扫描全部通过。适合多管理员协作、内部攻击面控制与合规审计场景，提供完整升级迁移路径。

代码解释

PostgreSQL

WebSocket

数据库

服务器

路由

SQLite

MySQL

Redis

2026上云采购 | AI焕新·智启新局

apigw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Micro-One-API v0.34.x 发布：RBAC 权限体系落地与 IAM 生产交接-腾讯云开发者社区-腾讯云

Micro-One-API v0.34.x 发布：RBAC 权限体系落地与 IAM 生产交接

Micro-One-API v0.34.x 发布：RBAC 权限体系落地与 IAM 生产交接

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐