小红书云服务支持多种方式凭证管理,您可以在开发平台后台云服务中找到秘钥选项。
临时密钥(cli_token)是通过
命令行登录:
rcb login --secretId <secretId> --secretKey <secretKey>
或使用简写形式:
rcb login -s <secretId> -k <secretKey>
登录成功示例:
✓ 正在验证小红书云服务密钥信息... 获取 access_token 成功: xxxxxxxx access_token 过期时间: 2024-12-31 23:59:59 🎉 登录成功!欢迎使用小红书云服务 CLI
使用以下命令查看当前登录状态和临时密钥信息:
rcb login get
输出示例:
📋 当前登录信息 ──────────────────────────────────────── Token: ●●●●●●●●xxxxxxxx 过期时间: 2024-12-31 23:59:59 云服务环境信息: xhs-widget-prod (env-7k2m9n4p) 当前 env 已生效,后续命令将默认使用该云环境。 如需修改,可执行: rcb env set -e <envId> ────────────────────────────────────────
清除本地保存的临时密钥:
rcb logout
注意:临时密钥过期后需要重新登录。CLI 会在执行命令时自动检查密钥是否过期,如果过期会提示重新登录。
永久密钥(secretId 和 secretKey)是小红书云服务的长期访问凭证,不会自动过期。您需要从小红书小程序开发平台获取这些密钥。
⚠️ 安全提示:API 密钥可以操作您名下的所有小红书云服务资源,请妥善保存和定期更换密钥。当您更换密钥后,请及时删除旧密钥。
在每次执行命令时通过参数传入:
rcb login --secretId <secretId> --secretKey <secretKey>
注意:环境变量支持功能正在开发中,当前版本暂不支持。建议使用命令行参数方式传递永久密钥。
未来版本将支持通过环境变量配置永久密钥,配置方式如下:
Linux/macOS:
export XHS_SECRET_ID="your-secret-id" export XHS_SECRET_KEY="your-secret-key" rcb login
Windows:
set XHS_SECRET_ID=your-secret-id set XHS_SECRET_KEY=your-secret-key rcb login
环境变量说明(计划支持):
环境变量 | 说明 | 是否必填 |
|---|---|---|
XHS_SECRET_ID | 小红书云服务 API 秘钥 Id | 是 |
XHS_SECRET_KEY | 小红书云服务 API 秘钥 Key | 是 |
CLI 按照以下优先级获取凭证:
推荐使用临时密钥方式:
# 首次登录 rcb login --secretId <secretId> --secretKey <secretKey> # 后续使用 CLI 命令时,会自动使用已保存的临时密钥 rcb env list rcb fun deploy
在 CI/CD 环境中,推荐使用命令行参数方式:
# 从 CI/CD 系统的密钥管理服务读取密钥,通过命令行参数传递
rcb login --secretId $CI_SECRET_ID --secretKey $CI_SECRET_KEY
# 或者直接使用 CI/CD 系统提供的环境变量(如果支持)
rcb login --secretId ${XHS_SECRET_ID} --secretKey ${XHS_SECRET_KEY}
提示:大多数 CI/CD 平台(如 GitHub Actions、GitLab CI、Jenkins)都提供了密钥管理功能,可以将密钥配置为环境变量,然后在命令中引用。
如果需要管理多个账号,可以:
A: 使用
A: 临时密钥过期后,CLI 会提示重新登录。执行
A:
A: 不建议关注或修改本地登录信息的落盘位置与内容;如需清理或切换账号,请使用