BuildingAI 帮助文档
BuildingAI 官网
  1. 使用教程
  • 欢迎使用 BuildingAI
  • 演示环境
  • 用户社群
  • 产品线路图
  • 更新日志
  • 开源与商业化
  • API 赞助商
  • 积分获取方式
  • 安装教程
    • 宝塔面板部署
    • Windows 环境下 Docker 部署
    • Docker方式安装
    • 手动安装
  • 使用教程
    • 功能使用教程
    • 智能体
    • DIY中心
    • 计费管理
    • 支付配置
    • 公众号配置
    • OSS存储配置
    • 应用安装教程
  • 开发文档
    • 网络接口
      • 登录注册
        • 账号密码登录
        • 账号密码注册
      • 前台
        • 文件上传/下载
          • 单个上传
          • 多个上传
          • 列表
          • 详情
          • 下载
          • 删除
        • 用户
          • 算力明细
          • 登录配置
        • AI聊天
          • 对话(非流式)
          • 流式对话
          • 对话记录
          • 对话详情
          • 修改记录
          • 删除记录
          • 获取记录对话
        • MCP
          • 列表
          • 所有记录
          • 详情:id
          • 创建
          • 修改
          • 可见状态
          • 添加
          • 关联详情
          • 系统MCP
          • json导入
          • 移除
          • 删除
          • 获取快捷菜单
          • 系统MCP详情:id
          • 连通性
          • 批量连通性
        • 充值中心
          • 充值中心
          • 充值提交订单
          • 充值记录
          • 预支付
          • 获取支付结果
        • 模型厂商
          • 列表
          • 详情:id
          • 详情:code
        • AI模型
          • 列表
          • 详情:id
          • 默认模型
        • 数据分析
          • 数据记录
        • 会员中心
          • 会员中心信息
          • 获取套餐列表
          • 预支付
          • 订阅提交订单
      • 后台
        • 工作空间
          • MCP
            • 列表
            • 详情
            • 创建
            • 修改
            • 删除
            • 批量删除
            • 启用状态
            • json导入
            • 连通性
            • 批量连通性
            • 获取快捷菜单
            • 设置快捷菜单
          • AI模型
            • 厂商管理
              • 列表
              • 新增
              • 详情:id
              • 详情:provider
              • 修改
              • 删除
              • 状态
            • 模型管理
              • 列表
              • 新增
              • 详情:id
              • 修改
              • 删除:id
              • 批量删除
              • 设为默认
              • 模型类型
              • 模型支持能力
              • 父级模型类型
          • AI知识库
            • 知识库列表
            • 知识库详情
            • 转移知识库
            • 知识库删除
            • 知识库文档列表
            • 知识库文档详情
            • 知识库文档删除
            • 知识库分段列表
            • 知识库分段详情
            • 知识库分段删除
            • 数据列表接口
          • AI智能体
            • 智能体创建
            • 智能体列表
            • 智能体详情
            • 智能体对话记录列表
            • 智能体对话记录详情
            • 智能体对话
            • 智能体发布API接口对话
            • 智能体发布API获取对话列表
            • 智能体发布API获取对话消息
            • 智能体发布API更新对话
            • 智能体发布API删除对话
          • 密钥管理
            • 密钥模板
              • 列表
              • 全部列表
              • 详情
              • 创建
              • 修改
              • 删除
              • 批量删除
              • 修改状态
              • json导入
            • 密钥配置
              • 列表
              • 列表:templateId
              • 创建
              • 统计
              • 详情
              • 完整详情
              • 修改
              • 修改状态
              • 删除
              • 批量删除
        • 用户管理
          • 列表
          • 创建
          • 详情:id
          • 删除
          • 批量删除
          • 重置密码
          • 更新状态
          • 重置随机密码
          • 登录设置
          • 登录设置
        • 角色管理
          • 创建
          • 详情:id
          • 修改
          • 删除
          • 列表
        • 菜单管理
          • 创建
          • 详情:id
          • 修改
          • 删除
          • 列表
        • 插件管理
          • 我的插件
            • 列表
            • 修改
            • 详情:id
            • 创建
            • 启用列表
            • 批量删除
            • 删除:id
            • 批量状态
            • 禁用:id
            • 启用:id
            • 是否存在:identifier
            • 详情:identifier
            • 入库插件详情:identifier
            • 本地列表
            • 类型列表
            • 版本列表:identifier
            • 安装
            • 卸载
          • 插件操作
            • 下载
            • 安装
          • 平台密钥
            • 获取开发者密钥
            • 设置开发者密钥
        • 权限管理
          • 列表
          • 扫描权限
          • 同步到库
          • 扫描接口
          • 清理废弃权限
          • 详情:code
        • 字典配置
          • 列表
        • 系统操作
          • 支付配置
            • 列表
            • 详情:id
            • 状态
            • 更新
          • 系统信息
            • 安装状态
            • 安装状态
          • pm2
            • 进程列表
            • 日志
            • 重启
            • 重载
            • 停止进程
            • 进程详情
            • 进程状态
            • 清空日志
            • 保存进程
            • 健康检查
            • 删除进程
        • 套餐充值
          • 获取套餐充值配置
          • 获取套餐充值配置 Copy
        • 财务
          • 财务中心
          • 用户余额明细
        • 订单管理
          • 充值订单列表
          • 充值订单详情
          • 充值订单退款
          • 会员订单列表
        • 渠道管理
          • 公众号配置
            • 详情
            • 修改
        • 数据分析
          • 数据看板
        • VIP 会员
          • 会员等级
            • 新增会员等级
            • 会员等级列表
            • 修改会员等级
            • 会员等级详情
            • 删除会员等级
          • 订阅计划
            • 新增订阅计划
            • 订阅计划设置
            • 设置会员功能状态
            • 更改订阅计划状态
            • 订阅计划详情
            • 修改订阅计划
            • 删除订阅计划
            • 更新订阅计划排序
      • 插件
        • 文章插件
          • 前台
            • 列表
          • 后台
            • 文章
              • 列表
              • 创建
            • 分类
              • 列表
              • 创建
        • 智能体-企业微信插件
          • 对话接口
        • 配图大师
          • 后台
            • 配图记录
            • 获取配图插件
            • 插件设置
    • 插件与框架开发
      • 技术规范
      • 前置准备
      • 本地部署与开发
      • 目录结构
      • 项目配置
      • 应用开发
        • 介绍
        • 创建应用
        • 模板结构
        • 应用开发
        • 打包发布
        • 插件更新
      • PC 客户端
        • 开发文档
        • 构建文档
  • 设计资源
    • 官方素材库
  • 政策
    • 开源许可
    • 服务条款
    • 隐私政策
BuildingAI 官网
  1. 使用教程

OSS存储配置

阿里云存储#

注意事项
本地切换成OSS
1.需要把storage/uploads 目录下所有文件上传到对应OSS空间里。
2.需要把extensions目录下插件的uploads目录下所有文件上传到对应OSS空间里。
上传完毕后,OSS 目录如下:
├── uploads----- //从storage/uploads目录迁移
├── 插件1/uploads----- //从extensions/插件1/uploads目录迁移
├── 插件2/uploads----- //从extensions/插件2/uploads目录迁移
├── 插件x/uploads----- //具体看系统安装了几款插件,以此类推

创建存储空间 (Bucket)#

步骤1:打开并登录阿里云官网https://www.aliyun.com/ ,单击进入【控制台】。
image.png
步骤2:点击左上角,输入搜索“对象存储”,点击【对象存储OSS】。
image.png
步骤3:点击【创建Bucket】,填写相关信息,点击【完成创建】。记录好Bucket名称,即存储空间名称,后台配置需要填写。
image.png
步骤4:点击【概览】,保存好Bucket 域名,即空间域名,后台配置需要填写。
image.png
步骤5:点击【阻止公共访问】,填写相关信息,关闭【阻止公共访问】。
image.png
步骤6:点击【读写权限】,设置为【公共读】。
image.png

创建 AccessKey#

AccessKey ID 和 AccessKey Secret 一旦泄露可能导致严重安全风险。尤其当 AccessKey 权限较高时,攻击者可能控制您阿里云账号下的所有资源(包括服务器、存储、数据库等)。请务必谨慎保存,切勿泄露给任何未经授权的人员或嵌入前端代码。 以下步骤将指导您按需创建 AccessKey 并配置必要的访问权限。
步骤1:点击阿里云官网【右上角头像】->【访问控制】。
image.png
步骤2:点击【用户】->【创建用户】。
image.png
步骤3:填写用户【登录名称】,选择【使用永久AccessKey】,点击【确定】。
image.png
步骤4:【AccessKeyID】和【AccessKeySecret】仅显示一次,请复制保存好,后面在后台需要填写。点击【用户登录名称】。
image.png
步骤5:点击【权限管理】->【新增授权】-> 添加以下权限,点击【确定新增权限】。
代码块

AliyunOSSFullAccessAliyunICEFullAccessAliyunSTSAssumeRoleAccessAliyunDysmsFullAccessAliyunIMMFullAccess
image.png

地域配置REGION#

💡
其中地域(Region)输入框的内容可以从下面链接中的截图部分获取到
链接:https://help.aliyun.com/zh/oss/user-guide/regions-and-endpoints
如图 所选的地域 【华南 3 (广州)】,所对应的地域ID是 【cn-guangzhou】,把对应的地域ID复制保存好,后面在后台需要填写。
image.png
image.png

创建角色ARN#

步骤1:点击【角色】-> 【创建角色】->【确定】。
image.png
image.png
步骤2:进入创建的角色,点击【新增授权】, 添加以下权限,点击【确定新增权限】。
代码块

AliyunOSSFullAccessAliyunSTSAssumeRoleAccess
image.png
步骤3:进入角色详情,找到ARN的值,点击【复制】保存好,后面在后台需要填写。
image.png

配置 OSS 信息#

登录BuildingAI后台,点击【系统设置】->【存储设置】,选择阿里云OSS【设置】,填写上面步骤保存的信息,状态点击【开启】-> 【确定】。
image.png

数据迁移#

步骤1:
将项目storage/static的文件下载本地。
步骤2:
点击【文件列表】->【扫描文件夹】,把storage/static文件上传,然后点击【上传文件】。
image.png
步骤3:
上传后文件列表显示如下,即操作完成。
image.png

跨域设置#

点击【跨域设置】->【创建规则】,按以下信息填写,点击【确定】。
image.png
image.png

腾讯云存储(开发中)#

说明#

腾讯云OSS的配置不是必须的,按实际需要配置。

配置OSS信息#

步骤1:
打开腾讯云官网网站https://cloud.tencent.com/ ,使用腾讯云账号登录。单击右上角头像,单击【访问管理】。
image.png
步骤2:
在腾讯云后台单击【访问密钥】->【API密钥管理】,如果没有密钥,则新建密钥。同时登录系统管理后台,单击【系统设置】->【存储设置】,找到腾讯云COS,单击【设置】。 从腾讯云后台复制SecretId和SecretKey到系统管理后台相对应选项。
image.png
步骤3:
单击【云产品】->【对象存储】,进入对象存储设置页面。
image.png
步骤4:
单击【创建存储桶】,根据需要选择【所属地址】,填写【名称】,选择【公有读私有写】,单击【下一步】。
image.png
步骤5: 单击【下一步】。
image.png
步骤6: 单击【创建】。
image.png
步骤7:
单击【概况】,复制【存储桶名称】【访问域名】、【所属地区】、到后台相当【存储空间名称】、【空间域名】、【REGION】的输入框,选择【状态】为开启,单击【保存】。 保存以后,即可使用。
image.png

迁移数据#

这块的说明后续有调整,具体等开发完成后再完善
PHP版需要将server/public下面resource目录和uploads目录复制到OSS空间的根目录,原来的资源图片才可以正常显示
Java版需要将/public/uploads目录复制到OSS空间的根目录,原来的资源图片才可以正常显示。新建名称为api目录,需要将server/buildingai-common/src/main/resources/static目录复制api中,上传完成后,图片例:/api/static/xxxxp.png。

跨域设置#

使用了对象存储以后,需要设置资源允许跨域。 打开跨域相关设置,设置如下。
代码块

*access-control-allow-credentials: trueaccess-control-allow-origin: *
image.png
修改于 2026-01-04 08:01:54
上一页
公众号配置
下一页
应用安装教程
Built with