基础服务集成

为了达到更好的使用效果，RB 集成了一些第三方基础服务，包括云存储、短信、邮件等，它们都是可选的，您可以根据需要配置/启用它们。但请注意，系统中的部分功能需要依赖短信、邮件服务，如未启用，相关功能无法使用（例如给外部人员发送短信或邮件通知）。

云存储

服务厂商：七牛云 https://www.qiniu.com/

云存储可以加速文件（如图片、附件）访问速度，节约服务器带宽和存储空间。如果您的系统需要存储大量文件，且对访问速度有较高要求，可以考虑启用云存储。

系统默认使用本地磁盘存储文件，位置在 数据目录 下的 /rb/ 目录

配置七牛云

存储空间

登录七牛云进入管理控制台 - 对象存储 - 空间管理，点击 [新建空间] 按钮进行新建。请特别注意将 访问控制 设置为 私有，否则您的文件将允许被公开访问，存在安全问题。

密钥 AK/SK

录七牛云进入管理控制台，点击右上角头像 - 密钥管理，添加一个密钥或使用已有密钥均可。

? 以上步骤若无法独立完成，请参见七牛云文档或联系七牛云服务人员

配置 RB

进入 RB 管理中心 - 服务集成 - 云存储，如下图所示：

1. 访问域名 输入七牛云存储空间的域名
2. 存储空间 输入七牛云存储空间的名称
3. 密钥 AK/SK 输入七牛云密钥管理中的对应 AK/SK
4. 最后点击 [保存]，RB 会验证参数的正确性，若配置参数有误会出现错误提示，请根据提示修改

! 若您为 RB 启用了 HTTPS 访问，七牛云存储空间的域名也需启用 HTTPS 访问，否则可能因混合内容问题导致文件无法访问

将本地存储迁移至七牛云

如果已经使用了本地存储，您需要把本地存储的文件自行迁移到七牛云，否则之前上传的文件将无法访问。

推荐使用七牛云官方客户端 Kodo Browser 进行迁移，仅需将 RB 数据目录 下的 /rb/ 目录上传至七牛云根目录中即可。具体上传方式请参考 Kodo Browser 文档。

短信/邮件

服务厂商：赛邮 https://www.mysubmail.com/

RB 中的部分功能需要依赖短信或邮件，例如忘记密码时发送重置密码邮件，动态日程中的日程短信/邮件提醒等。如未配置短信/邮件，此类功能将无法使用。

配置赛邮

添加 AppID

登录赛邮后台，点击左上角 服务与产品，选择 短信（或 邮件），然后在菜单中选择 创建/管理 AppID，进入页面后点击 [创建 APPID] 并完成创建。创建完成后您将得到 AppID 参数，如下图所示：

邮件 AppID 与短信类似，此处不再复述。若无法独立完成也可参考赛邮文档或联系赛邮服务人员

配置 RB

邮件

进入 RB 管理中心 - 服务集成 - 短信/邮件 - [邮件服务]，如下图所示：

1. APPID 输入赛邮中创建的邮件 APPID
2. APPKEY 输入赛邮中创建的邮件 APPKEY
3. 发件人地址 输入发件人邮箱地址，注意域名部分必须与赛邮中填写的一致
4. 发件人名称 输入发件人名称
5. 抄送地址 如果需要可配置抄送地址
6. 可以点击 [发送测试] 验证所填参数是否正确无误

除了使用赛邮邮件，您也可以使用 STMP 模式，此模式兼容所有 SMTP 服务，详见下文

短信

进入 RB 管理中心 - 服务集成 - 短信/邮件 - [短信服务]，如下图所示：

1. APPID 输入赛邮中创建的短信 APPID
2. APPKEY 输入赛邮中创建的短信 APPKEY
3. 短信签名 输入短信签名（建议中文 2-6 个字）
4. 可以点击 [发送测试] 验证所填参数是否正确无误

最后，点击 [保存] 完成配置。

使用 SMTP 邮件

RB 同时提供基于 SMTP 的邮件配置，只需提供 SMTP 服务的相关参数即可使用邮件服务。在“SMTP 服务器地址中”除了可以填写地址，您还可以添加额外的参数：

• 指定端口号，如 smtp.qq.com:465
• 使用 SSL，如 smtp.qq.com:465:ssl
• 或使用 StartTLS，如 smtp.qq.com:465:tls

若您需要向外部客户发送邮件，且数量较大（每日超过 100-200 封），建议您使用赛邮等商业发送服务，可显著提高发送成功率

开发人员

第三方服务参数亦可在配置文件（application.yml 或/和 application-dev.yml）中配置，配置参数名称释义如下表：

配置参数	对应解释
rebuild.StorageURL	云存储访问域名
rebuild.StorageBucket	云存储存储空间
rebuild.StorageApiKey	云存储密钥 AK
rebuild.StorageApiSecret	云存储密钥 SK
rebuild.SmsUser	赛邮短信 APPID
rebuild.SmsPassword	赛邮短信 APPKEY
rebuild.SmsSign	赛邮短信签名
rebuild.MailUser	赛邮邮件 APPID
rebuild.MailPassword	赛邮邮件 APPKEY
rebuild.MailAddr	赛邮邮件发件人地址
rebuild.MailName	赛邮邮件发件人名称