インストールとデプロイ
Docker、Helm、テンセントクラウドなど、企業規模に応じた柔軟な導入方式を提供します。
🤖 Cherry Studio Agent でデプロイ
プライベート導入では、まずサーバー側のインストールを完了してからエンタープライズクライアントにログインできます。Cherry Studio コミュニティ版の Agent を使ってデプロイを自動化できます。
手順:
-
Cherry Studio コミュニティ版をダウンロードしてインストール
-
クライアントを開き、「エージェント」に入って既存または新規エージェントを選択
-
以下のプロンプトをエージェントに送信:
/docs/ja/setup の指示に従い、cherry-enterprise-deploy-skill をインストールしてデプロイしてください。 -
エージェントの指示に従ってサーバー情報(IP、SSH 認証情報)を提供し、デプロイを完了します。
スキルパッケージのダウンロード:cherry-enterprise-deploy-skill.zip
手動導入の場合は、下記の内容を読んで導入方式を選択してください。
🚀 事前準備
システム要件
ハードウェア要件
- CPU: 2 コア以上
- メモリ: 4GB RAM(推奨 8GB)
- ストレージ: 20GB の空き容量(データ量に応じて調整)
- ネットワーク: 安定したネットワーク接続
ソフトウェア要件
- OS: 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 に対応
☸️ Kubernetes Helm 導入
利用シーン:
- 大規模企業の本番環境
- 高可用性と自動スケーリングが必要
- 既存の Kubernetes クラスター
メリット:
- 運用の自動化
- 水平スケーリング
- 充実したヘルスチェックと障害復旧
📋 導入手順の概要
ステップ 1: 導入方式を選択
上記ガイドから最適な方法を選択します。
ステップ 2: データベースを設定
- PostgreSQL をインストール
- データベースとユーザーを作成
- 接続パラメータを設定
ステップ 3: アプリケーションを導入
選択した導入方式に応じて手順を実行します:
- Docker: docker-compose で起動
- Kubernetes: Helm でインストール
ステップ 4: 認証を設定(任意)
企業 SSO が必要な場合:
- Casdoor を導入
- アプリと組織を設定
- Cherry Studio に統合
ステップ 5: 導入確認
- API ヘルスチェックにアクセス:
http://your-domain:3670/health - 管理コンソールにアクセス:
http://your-domain:3680 - 既定の管理者アカウントでログイン
- 初期設定を完了
初回のセルフホスト環境では、管理者アカウントが初期化されます。ユーザー名は
admin、初期パスワードはsecretです。クラウドアプリ導入の場合は、アプリ設定ページに表示される管理アカウント情報を利用し、初回ログイン後すぐにパスワードを変更してください。
次のステップ
導入方法を選び、インストールを開始してください:
- ☁️ クラウドアプリ導入(推奨) - ワンクリック導入、技術的な障壁なし
- 🐳 Docker 導入 - Docker で素早く導入
- ☸️ Helm 導入 - Kubernetes に導入
- 🗄️ データベース設定 - PostgreSQL を設定