Rediacc CLI 参考

概述

**Rediacc CLI**（`rdc`）是一个用于管理 Rediacc 平台所有方面的命令行界面 — 身份验证、基础设施、仓库、队列、存储等。

安装

从 [Rediacc 发布页面](https://www.rediacc.com) 下载适用于您平台的最新二进制文件，或通过包管理器安装：

# macOS / Linux
curl -fsSL https://get.rediacc.com | sh

# Or use the packaged binary directly
./rdc --help

全局选项

每个命令都支持以下全局标志：

标志	描述
--output	输出格式（table|json|yaml|csv）
--context	为此命令使用特定上下文
--lang	语言覆盖（{{languages}}）
--force	跳过确认提示

---

1. 身份验证

身份验证命令

1.1 login

使用 Rediacc 进行身份验证

rdc auth login [options]

标志	描述	必填	默认值
-e, --email <email>	电子邮件地址	否	-
-p, --password <password>	密码（用于非交互式登录）	否	-
-m, --master-password <password>	保险箱加密的主密码	否	-
-n, --name <name>	会话名称	否	-
--endpoint <url>	API 端点 URL	否	-
--save-as <context>	将凭证保存到命名上下文	否	-

1.2 logout

清除存储的凭证

rdc auth logout

1.3 status

检查当前身份验证状态

rdc auth status

1.4 register

注册新组织和用户账户

注册后，请检查您的电子邮件以获取激活码。

rdc auth register [options]

标志	描述	必填	默认值
--organization <name>	组织名称	是	-
-e, --email <email>	电子邮件地址	是	-
-p, --password <password>	密码（用于非交互式登录）	是	-
-m, --master-password <password>	保险箱加密的主密码	否	-
--endpoint <url>	API 端点 URL	否	-
--plan <plan>	订阅计划（COMMUNITY、PROFESSIONAL、BUSINESS、ENTERPRISE）	否	COMMUNITY

1.5 activate

使用验证码激活账户

rdc auth activate [options]

标志	描述	必填	默认值
-e, --email <email>	电子邮件地址	是	-
-p, --password <password>	密码（用于非交互式登录）	是	-
--code <code>	来自电子邮件的激活码	是	-
--endpoint <url>	API 端点 URL	否	-

1.6 tfa

双因素认证管理

disable

禁用双因素认证

rdc auth tfa disable [options]

标志	描述	必填	默认值
--code <code>	用于验证的当前双因素认证代码	否	-
-y, --yes	跳过确认提示	否	-

enable

启用双因素认证

rdc auth tfa enable

status

检查双因素认证状态

rdc auth tfa status

1.7 token

令牌管理

fork

为另一个应用程序创建分叉令牌

rdc auth token fork [options]

标志	描述	必填	默认值
-n, --name <name>	令牌名称	否	CLI Fork
-e, --expires <hours>	过期时间（小时数，1-720）	否	24

list

列出活跃的令牌/会话

rdc auth token list

revoke

撤销特定令牌

rdc auth token revoke <requestId>

提示: 您的身份验证令牌存储在本地上下文中。使用 `--save-as` 将凭据存储在命名上下文下，以便用于多个环境。

---

2. 上下文管理

管理命令行界面上下文

上下文存储连接详情（API URL、凭据、默认团队/区域/机器），以便您可以快速在环境之间切换。

2.1 list

列出所有上下文

rdc context list

2.2 show

显示当前上下文详情

rdc context show

2.3 use

切换到不同的上下文

rdc context use

2.4 create

创建新上下文

rdc context create <name> [options]

标志	描述	必填	默认值
-u, --api-url <url>	API 网址	否	-

2.5 delete

删除上下文

rdc context delete <name>

2.6 rename

重命名上下文

rdc context rename <oldName> <newName>

2.7 current

显示当前上下文名称

rdc context current

2.8 set

设置默认值（团队、区域、网桥、机器）

rdc context set <key> <value>

提示: 设置默认值意味着您不需要在每个命令中传递 `--team`、`--region` 或 `--machine`。

2.9 unset

移除上下文默认值

rdc context unset

2.10 clear

清除默认值（全部或特定键）

rdc context clear [key]

2.11 set-language

设置首选语言

rdc context set-language

2.12 create-local

为无中间件操作创建新的本地上下文

在本地模式下，您可以直接添加机器：

rdc context create-local <name> [options]

标志	描述	必填	默认值
--ssh-key <path>	SSH 私钥路径（例如：~/.ssh/id_rsa）	是	-
--renet-path <path>	renet 二进制文件的路径（默认：PATH 中的 renet）	否	-

2.13 add-machine

将机器添加到当前本地上下文

rdc context add-machine <name> [options]

标志	描述	必填	默认值
--ip <address>	机器 IP 地址或主机名	是	-
--user <username>	SSH 用户名	是	-
--port <port>	SSH 端口	否	22
--datastore <path>	机器上的数据存储路径	否	/mnt/rediacc

2.14 remove-machine

从当前本地上下文中移除机器

rdc context remove-machine <name>

2.15 machines

列出当前本地上下文中的机器

rdc context machines

2.16 set-ssh

更新当前本地上下文的 SSH 配置

rdc context set-ssh [options]

标志	描述	必填	默认值
--private-key <path>	SSH 私钥路径	是	-
--public-key <path>	SSH 公钥路径	否	-

2.17 create-s3

创建新的 S3/R2 上下文，用于本地执行的远程状态管理

rdc context create-s3 <name> [options]

标志	描述	必填	默认值
--endpoint <url>	S3 端点 URL	是	-
--bucket <name>	S3 存储桶名称	是	-
--access-key-id <key>	S3 访问密钥 ID	是	-
--ssh-key <path>	SSH 私钥路径	是	-
--secret-access-key <key>	S3 秘密访问密钥（未提供时会提示输入）	否	-
--region <region>	S3 区域	否	auto
--prefix <prefix>	存储桶中的密钥前缀/命名空间	否	-
--renet-path <path>	renet 二进制文件路径	否	-
--master-password <password>	加密主密码（可选，留空跳过）	否	-

2.18 set-renet

设置本地模式下的 renet 二进制文件路径

rdc context set-renet <path>

---

3. 组织管理

组织管理命令

3.1 list

列出组织

rdc organization list

3.2 info

获取组织信息

rdc organization info

3.3 dashboard

获取组织仪表板数据

rdc organization dashboard

3.4 vault

组织保险箱管理

get

获取组织保险箱数据

rdc organization vault get

list

列出所有保险箱类型

rdc organization vault list

update

更新组织保险箱数据

rdc organization vault update [options]

标志	描述	必填	默认值
--vault <json>	保险箱内容为 JSON 字符串	否	-
--vault-version <n>	用于乐观锁定的当前保险箱版本	否	-

3.5 export

导出组织数据

rdc organization export [options]

标志	描述	必填	默认值
--path <path>	保存输出文件的路径	否	-

3.6 import

导入组织数据

rdc organization import <path> [options]

标志	描述	必填	默认值
--mode <mode>	导入模式（merge 或 replace）	否	merge

3.7 maintenance

启用或禁用维护模式（阻止非管理员登录）

rdc organization maintenance <action>

警告: 启用维护模式时，非管理员用户无法登录。

---

4. 用户管理

用户管理命令

4.1 list

列出所有用户

rdc user list

4.2 create

创建新用户

rdc user create <email> [options]

标志	描述	必填	默认值
-p, --password <password>	新用户的密码	否	-

4.3 activate

激活用户账户

rdc user activate <email> <activationCode>

4.4 deactivate

停用用户账户

rdc user deactivate <email> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

4.5 reactivate

重新激活已停用的用户账户

rdc user reactivate <email>

4.6 update-email

更改用户的电子邮件地址

rdc user update-email <currentEmail> <newEmail>

4.7 update-password

更改您的密码

rdc user update-password [options]

标志	描述	必填	默认值
--password <password>	新密码（非交互式模式）	否	-
--confirm <confirm>	确认密码（非交互式模式）	否	-

4.8 update-language

设置当前用户的首选语言

rdc user update-language <language>

4.9 exists

检查用户是否存在

rdc user exists <email>

4.10 vault

用户保险箱管理

get

获取当前用户保险箱数据

rdc user vault get

update

更新当前用户保险箱数据

rdc user vault update [options]

标志	描述	必填	默认值
--vault <json>	保险箱内容为 JSON 字符串	否	-
--vault-version <n>	用于乐观锁定的当前保险箱版本	否	-

4.11 permission

用户权限管理

assign

为用户分配权限组

rdc user permission assign <userEmail> <groupName>

---

5. 团队管理

团队管理

5.1 list

列出团队

rdc team list [options]

标志	描述	必填	默认值
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

5.2 create

创建团队

rdc team create <name>

5.3 member

团队成员管理

list

列出团队成员

rdc team member list <teamName>

add

将用户添加到团队

rdc team member add <teamName> <userEmail>

remove

从团队中移除用户

rdc team member remove <teamName> <userEmail>

---

6. 权限管理

权限管理命令

6.1 list

列出权限

rdc permission list

6.2 group

权限组管理

list

列出所有权限组

rdc permission group list

create

创建新权限组

rdc permission group create <name>

delete

删除权限组

rdc permission group delete <name> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

show

显示权限组详情

rdc permission group show <name>

6.3 add

向组添加权限

rdc permission add <groupName> <permission>

6.4 remove

从组中移除权限

rdc permission remove <groupName> <permission>

---

7. 区域管理

区域管理

7.1 list

列出区域

rdc region list [options]

标志	描述	必填	默认值
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

---

8. 桥接管理

网桥管理

8.1 list

列出网桥

rdc bridge list [options]

标志	描述	必填	默认值
-r, --region <name>	区域名称	否	-
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

8.2 reset-auth

重置网桥授权令牌

rdc bridge reset-auth <name> [options]

标志	描述	必填	默认值
-r, --region <name>	区域名称	否	-

---

9. 机器管理

机器管理

9.1 list

列出机器

rdc machine list [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

9.2 create

创建新机器

rdc machine create <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
-b, --bridge <name>	网桥名称	否	-
--vault <json>	机器保险箱数据为 JSON 字符串	否	-

9.3 delete

删除机器

rdc machine delete <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
-f, --force	跳过确认提示	否	-

9.4 update

更新机器配置

rdc machine update

9.5 health

检查 CI/CD 流水线的机器健康状况

health 命令输出系统指标、容器状态、服务稳定性和存储信息 — 适用于 CI/CD 管道检查。

rdc machine health <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-

9.6 containers

列出机器上的 Docker 容器

rdc machine containers <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--health-check	健康检查模式 - 如果有不健康的容器，将以代码 2 退出	否	-

9.7 services

列出机器上的 systemd 服务

rdc machine services <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--stability-check	稳定性检查模式 - 如果有失败/重启的服务，将以代码 2 退出	否	-

9.8 vault-status

显示机器的已解析保险箱状态

rdc machine vault-status <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-

9.9 repos

列出机器上已部署的仓库

rdc machine repos <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--search <text>	按名称过滤仓库	否	-

9.10 test-connection

测试到机器的 SSH 连接并捕获主机密钥

rdc machine test-connection [options]

标志	描述	必填	默认值
--ip <address>	机器 IP 地址或主机名	是	-
--user <name>	SSH 用户名	是	-
-t, --team <name>	团队名称	否	-
-b, --bridge <name>	网桥名称	否	-
--port <number>	SSH 端口	否	22
--password <pwd>	用于初始身份验证的 SSH 密码	否	-
--datastore <path>	机器上的数据存储路径	否	/mnt/rediacc
-m, --machine <name>	机器名称（用于测试后更新保险箱）	否	-
--save	测试成功后将 known_hosts 保存到机器保险箱	否	-

提示: 使用 `--save-known-hosts` 在测试成功后自动将主机密钥持久化到机器保险库中。

---

10. 仓库管理

仓库管理命令

10.1 list

列出仓库

rdc repository list [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-

10.2 create

创建新仓库

rdc repository create <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
--parent <name>	父仓库（用于分叉）	否	-
--parent-tag <tag>	父仓库标签	否	-

10.3 rename

重命名仓库

rdc repository rename <oldName> <newName> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest

10.4 delete

删除仓库

rdc repository delete <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
-f, --force	跳过确认提示	否	-

10.5 promote

将分叉提升为主状态

rdc repository promote <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
-f, --force	跳过确认提示	否	-

注意: 提升 fork 会将其从父（grand）仓库中分离出来，使其独立。

10.6 vault

仓库保险箱管理

get

获取仓库保险箱数据

rdc repository vault get <repositoryName> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest

update

更新仓库保险箱数据

rdc repository vault update <repositoryName> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
--vault <json>	保险箱内容为 JSON 字符串	否	-
--vault-version <n>	用于乐观锁定的当前保险箱版本	否	-

---

11. 存储管理

存储管理

11.1 list

列出存储提供商

rdc storage list [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

---

12. 队列操作

队列管理

队列系统是 Rediacc 任务执行的核心。每个操作（部署、备份、脚本执行）都通过队列运行。

12.1 list

列出队列项

rdc queue list [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--status <status>	按状态过滤	否	-
--priority-min <n>	最小优先级（1-5）	否	-
--priority-max <n>	最大优先级（1-5）	否	-
--search <text>	在任务 ID、团队、机器、网桥中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-
--limit <n>	最大结果数	否	50

12.2 create

创建队列项

rdc queue create [options]

标志	描述	必填	默认值
-f, --function <name>	要执行的函数名称	是	-
-t, --team <name>	团队名称	否	-
-m, --machine <name>	机器名称	否	-
-b, --bridge <name>	网桥名称	否	-
-p, --priority <1-5>	优先级（1=最高）	否	3
--param <key=value>	函数参数	否	-
--vault <json>	原始保险箱 JSON（用于脚本/CI）	否	-

12.3 cancel

取消队列项

rdc queue cancel <taskId>

12.4 retry

重试失败的队列项

rdc queue retry <taskId>

12.5 trace

跟踪队列项执行

rdc queue trace <taskId> [options]

标志	描述	必填	默认值
-w, --watch	监视更新	否	-
--interval <ms>	轮询间隔（毫秒）	否	2000

提示: 使用 `--watch` 实时跟踪任务直到完成。

12.6 delete

删除队列项

rdc queue delete <taskId> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

---

13. 文件同步

使用 rsync 与仓库进行文件同步

13.1 upload

将文件上传到仓库

rdc sync upload [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
-m, --machine <name>	机器名称	否	-
-r, --repository <name>	仓库名称（连接到仓库环境）	否	-
-l, --local <path>	本地目录路径（默认：当前目录）	否	-
--remote <path>	仓库内的远程子目录路径	否	-
--mirror	镜像模式 - 删除本地不存在的远程文件	否	-
--verify	同步后使用校验和验证文件	否	-
--confirm	预览更改并在同步前请求确认	否	-
--exclude <patterns...>	从同步中排除的模式	否	-
--dry-run	显示将传输的内容而不实际同步	否	-

13.2 download

从仓库下载文件

rdc sync download [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
-m, --machine <name>	机器名称	否	-
-r, --repository <name>	仓库名称（连接到仓库环境）	否	-
-l, --local <path>	本地目录路径（默认：当前目录）	否	-
--remote <path>	仓库内的远程子目录路径	否	-
--mirror	镜像模式 - 删除远程不存在的本地文件	否	-
--verify	同步后使用校验和验证文件	否	-
--confirm	预览更改并在同步前请求确认	否	-
--exclude <patterns...>	从同步中排除的模式	否	-
--dry-run	显示将传输的内容而不实际同步	否	-

13.3 status

检查同步状态并比较本地/远程文件

rdc sync status [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
-m, --machine <name>	机器名称	否	-
-r, --repository <name>	仓库名称（连接到仓库环境）	否	-
-l, --local <path>	本地目录路径（默认：当前目录）	否	-
--remote <path>	仓库内的远程子目录路径	否	-

---

14. VS Code 集成

VS Code 远程 SSH 集成

14.1 connect

在 VS Code 中连接到机器或仓库

rdc vscode connect [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
-m, --machine <name>	机器名称	否	-
-r, --repository <name>	仓库名称（连接到仓库环境）	否	-
-f, --folder <path>	远程文件夹路径以打开	否	-
--url-only	打印 VS Code URI 而不是启动	否	-
-n, --new-window	在新 VS Code 窗口中打开	否	-
--skip-env-setup	跳过远程环境设置	否	-
--insiders	使用 VS Code Insiders 设置	否	-

14.2 list

列出已配置的 VS Code SSH 连接

rdc vscode list

14.3 cleanup

移除 VS Code SSH 配置

rdc vscode cleanup [options]

标志	描述	必填	默认值
--all	移除所有 rediacc SSH 配置	否	-
-c, --connection <name>	移除特定连接	否	-

14.4 check

检查 VS Code 安装和配置

rdc vscode check [options]

标志	描述	必填	默认值
--insiders	使用 VS Code Insiders 设置	否	-

---

15. SSH 终端访问

SSH 终端访问机器和仓库

15.1 connect

通过 SSH 连接到机器或仓库

rdc term connect [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
-m, --machine <name>	机器名称	否	-
-r, --repository <name>	仓库名称（连接到仓库环境）	否	-
-c, --command <cmd>	执行命令而不是交互式 shell	否	-
--container <id>	连接到特定 Docker 容器	否	-
--container-action <action>	容器操作：terminal、logs、stats、exec	否	-
--log-lines <lines>	显示的日志行数（默认：50）	否	-
--follow	跟踪日志输出	否	-
--external	强制在外部终端窗口中启动	否	-

---

16. Ceph 存储管理

Ceph 分布式存储管理

16.1 cluster

Ceph 集群管理

list

列出 Ceph 集群

rdc ceph cluster list

create

创建新的 Ceph 集群

rdc ceph cluster create <name> [options]

标志	描述	必填	默认值
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 Ceph 集群

rdc ceph cluster delete <name> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

machines

列出 Ceph 集群中的机器

rdc ceph cluster machines <name>

vault

Ceph 集群保险库管理

get:

获取集群保险库数据

rdc ceph cluster vault get <name>

update:

更新集群保险库数据

rdc ceph cluster vault update <name> [options]

标志	描述	必填	默认值
--vault <content>	保险箱内容为 JSON 字符串	是	-

16.2 pool

Ceph 存储池管理

list

列出 Ceph 存储池

rdc ceph pool list [options]

标志	描述	必填	默认值
--team <name>	团队名称	否	-
--cluster <name>	Ceph 集群名称	否	-

create

创建新的 Ceph 存储池

rdc ceph pool create <name> [options]

标志	描述	必填	默认值
--cluster <name>	Ceph 集群名称	是	-
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 Ceph 存储池

rdc ceph pool delete <name> [options]

标志	描述	必填	默认值
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

vault

Ceph 存储池保险库管理

get:

获取存储池保险库数据

rdc ceph pool vault get <name> [options]

标志	描述	必填	默认值
--team <name>	团队名称	是	-

update:

更新存储池保险库数据

rdc ceph pool vault update <name> [options]

标志	描述	必填	默认值
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	是	-

16.3 image

Ceph RBD 镜像管理

list

列出 RBD 镜像

rdc ceph image list [options]

标志	描述	必填	默认值
--pool <name>	Ceph 池名称	否	-
--team <name>	团队名称	否	-

create

创建新的 RBD 镜像

rdc ceph image create <name> [options]

标志	描述	必填	默认值
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--machine <name>	机器名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 RBD 镜像

rdc ceph image delete <name> [options]

标志	描述	必填	默认值
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

16.4 snapshot

Ceph RBD 快照管理

list

列出 RBD 快照

rdc ceph snapshot list [options]

标志	描述	必填	默认值
--image <name>	RBD 镜像名称	否	-
--pool <name>	Ceph 池名称	否	-
--team <name>	团队名称	否	-

create

创建新的 RBD 快照

rdc ceph snapshot create <name> [options]

标志	描述	必填	默认值
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 RBD 快照

rdc ceph snapshot delete <name> [options]

标志	描述	必填	默认值
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

16.5 clone

Ceph RBD 克隆管理

list

列出 RBD 克隆

rdc ceph clone list [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	否	-
--image <name>	RBD 镜像名称	否	-
--pool <name>	Ceph 池名称	否	-
--team <name>	团队名称	否	-

create

从快照创建新的 RBD 克隆

rdc ceph clone create <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 RBD 克隆

rdc ceph clone delete <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

machines

列出分配给克隆的机器

rdc ceph clone machines <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-

assign

将机器分配给克隆

rdc ceph clone assign <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--machines <names>	机器名称（逗号分隔）	是	-

unassign

从克隆移除机器

rdc ceph clone unassign <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--machines <names>	机器名称（逗号分隔）	是	-

---

17. 审计与合规

审计日志命令

17.1 list

列出审计日志条目

rdc audit list

17.2 log

查看审计日志

rdc audit log [options]

标志	描述	必填	默认值
--limit <n>	最大结果数	否	100

17.3 trace

跟踪实体的审计历史

rdc audit trace <entityType> <entityId>

17.4 history

查看实体历史

rdc audit history <entityType> <entityId>

---

18. 协议处理器

管理 {{scheme}}:// 协议处理程序注册和 URL 处理

18.1 register

在系统上注册协议处理程序

rdc protocol register [options]

标志	描述	必填	默认值
--system	系统范围内注册（需要管理员权限）	否	-
--force	强制重新注册即使已注册	否	-

18.2 unregister

从系统中注销协议处理程序

rdc protocol unregister [options]

标志	描述	必填	默认值
--system	注销系统范围的注册（需要管理员权限）	否	-

18.3 status

显示协议处理程序注册状态

rdc protocol status

18.4 open

打开 {{scheme}}:// URL 并执行操作

rdc protocol open <url>

18.5 build

从组件构建 {{scheme}}:// URL

rdc protocol build [options]

标志	描述	必填	默认值
--token <token>	身份验证令牌	是	-
-t, --team <name>	团队名称	是	-
-m, --machine <name>	机器名称	是	-
-r, --repository <name>	仓库名称（连接到仓库环境）	否	-
-a, --action <action>	操作（{{actions}}）	否	desktop
-p, --params <key=value...>	附加参数	否	-

18.6 parse

解析 {{scheme}}:// URL 并显示组件

rdc protocol parse <url>

---

19. 快捷命令（快捷方式）

19.1 run

运行函数（快捷方式：queue create）

rdc run

19.2 trace

跟踪任务（快捷方式：queue trace）

rdc trace

19.3 cancel

取消任务（快捷方式：queue cancel）

rdc cancel

19.4 retry

重试失败的任务（快捷方式：queue retry）

rdc retry

---

20. CLI 更新

检查并应用CLI更新

rdc update [options]

标志	描述	必填	默认值
--force	即使已是最新也强制更新	否	-
--check-only	仅检查更新，不下载	否	-

---

21. 系统诊断

诊断CLI环境和renet集成

rdc doctor

---

常见错误消息

当出现问题时，CLI 会提供清晰的错误消息：

错误	含义
需要身份验证。运行：rdc login	您需要先登录
没有活跃的上下文。请先创建或选择上下文。	未选择上下文 — 创建或切换到一个上下文
权限被拒绝	您的帐户缺少所需的权限
需要机器名称。使用 --machine 或设置上下文。	使用 `--machine` 指定机器或设置上下文默认值
需要团队名称。使用 --team 或设置上下文。	使用 `--team` 指定团队或设置上下文默认值
需要区域名称。使用 --region 或设置上下文。	使用 `--region` 指定区域或设置上下文默认值

---

输出格式

所有列表/获取命令通过 `--output` 支持多种输出格式：

rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table   # default

这使得将 Rediacc CLI 集成到脚本、CI/CD 管道和自动化工作流中变得容易。