Skip to content
文档

安装与部署

提供 Docker、Helm、腾讯云应用等多种部署方案,满足不同规模企业的需求。

🤖 使用 Cherry Studio Agent 部署

私有化部署需要先完成服务端安装,才能登录企业版客户端。可借助 Cherry Studio 社区版中的 Agent 自动完成部署。

步骤:

  1. 下载并安装 Cherry Studio 社区版

  2. 打开客户端,进入「智能体」,选择或新建一个智能体

  3. 将以下提示词发送给智能体:

    按照 /docs/zh/setup 指引,安装 cherry-enterprise-deploy-skill,帮我部署。
  4. 按 Agent 提示提供服务器信息(IP、SSH 账号),即可完成部署

技能包下载:cherry-enterprise-deploy-skill.zip

如需手动部署,请继续阅读下方内容选择部署方式。


🚀 开始之前

系统要求

硬件要求

  • CPU: 2核心或以上
  • 内存: 4GB RAM(推荐 8GB)
  • 存储: 20GB 可用空间(根据数据量调整)
  • 网络: 稳定的网络连接

软件要求

  • 操作系统: Linux (Ubuntu 20.04+, CentOS 7+)、macOS、Windows
  • 容器环境: Docker 20.10+ (Docker 部署)
  • Kubernetes: 1.19+ (Helm 部署)
  • 数据库: PostgreSQL 12+

准备工作清单

在开始部署前,请确保您已准备好以下内容:

1. 基础环境

  • 选择部署方式(Docker / Kubernetes)
  • 准备服务器或云主机
  • 安装必要的运行环境

2. 数据库配置

  • 选择使用 PostgreSQL
  • 准备数据库连接信息
  • 创建数据库和用户

3. 认证配置(可选)

  • 决定是否使用 SSO 单点登录
  • 准备 Casdoor 配置信息(如需要)
  • 配置企业认证系统对接

4. 网络配置

  • 确定服务访问域名
  • 配置 SSL 证书(生产环境)
  • 开放必要的端口(3670 API, 3680 Admin)

📦 部署方案选择

根据您的需求选择合适的部署方案:

☁️ 云应用一键部署(推荐)

适用场景:

  • 快速上手,零配置部署
  • 中小型企业快速试用
  • 不熟悉技术运维的用户

优势:

  • 一键部署,无需技术门槛
  • 自动化配置网络和安全组
  • 包含数据库和管理面板
  • 云端资源弹性扩容
查看完整云应用部署指南 →

🐳 Docker 部署

适用场景:

  • 快速体验和测试
  • 中小型团队使用
  • 单机部署需求

优势:

  • 部署简单,一键启动
  • 环境隔离,易于维护
  • 支持 Docker Compose 编排
查看完整 Docker 部署指南 →

☸️ Kubernetes Helm 部署

适用场景:

  • 大型企业生产环境
  • 需要高可用和自动扩缩容
  • 已有 Kubernetes 集群

优势:

  • 自动化运维管理
  • 支持水平扩展
  • 完善的健康检查和故障恢复
查看完整 Helm 部署指南 →

📋 部署步骤概览

第一步:选择部署方案

根据上述指南选择适合您的部署方式。

第二步:配置数据库

  1. 安装 PostgreSQL
  2. 创建数据库和用户
  3. 配置连接参数
查看数据库配置指南 →

第三步:部署应用

根据选择的部署方式执行相应步骤:

  • Docker: 使用 docker-compose 启动
  • Kubernetes: 使用 Helm 安装

第四步:配置认证(可选)

如需企业 SSO 单点登录:

  1. 部署 Casdoor 服务
  2. 配置应用和组织
  3. 集成到 Cherry Studio
查看单点登录配置指南 →

第五步:验证部署

  1. 访问 API 健康检查:http://your-domain:3670/health
  2. 访问管理后台:http://your-domain:3680
  3. 使用默认管理员账号登录
  4. 完成初始配置

首次自部署环境会初始化管理员账号:用户名为 admin,初始密码为 secret。如果您使用云应用部署,请以应用设置页面提供的后台管理账号信息为准,并在首次登录后立即修改密码。

下一步

选择您的部署方式,开始安装: