Skip to content
ドキュメント

インストールとデプロイ

Docker、Helm、テンセントクラウドなど、企業規模に応じた柔軟な導入方式を提供します。

🤖 Cherry Studio Agent でデプロイ

プライベート導入では、まずサーバー側のインストールを完了してからエンタープライズクライアントにログインできます。Cherry Studio コミュニティ版の Agent を使ってデプロイを自動化できます。

手順:

  1. Cherry Studio コミュニティ版をダウンロードしてインストール

  2. クライアントを開き、「エージェント」に入って既存または新規エージェントを選択

  3. 以下のプロンプトをエージェントに送信:

    /docs/ja/setup の指示に従い、cherry-enterprise-deploy-skill をインストールしてデプロイしてください。
  4. エージェントの指示に従ってサーバー情報(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 に対応
Docker 導入ガイドを見る →

☸️ Kubernetes Helm 導入

利用シーン:

  • 大規模企業の本番環境
  • 高可用性と自動スケーリングが必要
  • 既存の Kubernetes クラスター

メリット:

  • 運用の自動化
  • 水平スケーリング
  • 充実したヘルスチェックと障害復旧
Helm 導入ガイドを見る →

📋 導入手順の概要

ステップ 1: 導入方式を選択

上記ガイドから最適な方法を選択します。

ステップ 2: データベースを設定

  1. PostgreSQL をインストール
  2. データベースとユーザーを作成
  3. 接続パラメータを設定
データベース設定ガイドを見る →

ステップ 3: アプリケーションを導入

選択した導入方式に応じて手順を実行します:

  • Docker: docker-compose で起動
  • Kubernetes: Helm でインストール

ステップ 4: 認証を設定(任意)

企業 SSO が必要な場合:

  1. Casdoor を導入
  2. アプリと組織を設定
  3. Cherry Studio に統合
SSO 設定ガイドを見る →

ステップ 5: 導入確認

  1. API ヘルスチェックにアクセス:http://your-domain:3670/health
  2. 管理コンソールにアクセス:http://your-domain:3680
  3. 既定の管理者アカウントでログイン
  4. 初期設定を完了

初回のセルフホスト環境では、管理者アカウントが初期化されます。ユーザー名は admin、初期パスワードは secret です。クラウドアプリ導入の場合は、アプリ設定ページに表示される管理アカウント情報を利用し、初回ログイン後すぐにパスワードを変更してください。

次のステップ

導入方法を選び、インストールを開始してください: