ソフトウェア更新
管理コンソールのワンクリック更新(Docker Compose)または手動更新で Cherry Studio Enterprise を最新バージョンに更新します。
バージョン要件
ワンクリック更新には v0.3.3 以降が必要です。現在のバージョンが v0.3.3 未満の場合は、まず手動で v0.3.3 に更新してからワンクリック更新を利用してください。
更新方法
方法 1:管理コンソールのワンクリック更新(推奨)
Docker Compose で導入している場合、管理コンソールから直接更新できます。
前提条件
ワンクリック更新を有効にするため、docker-compose.yml に以下を設定します:
- Docker Socket をマウント:コンテナ内から Docker を操作
- docker-compose.yml をマウント:設定ファイルの読み取り/更新を許可
設定例
services:
api:
image: cherrystudio/cherry-studio-enterprise-api:v0.4.10
container_name: cherry-studio-enterprise-api
ports:
- '3670:3670'
- '3680:3680'
environment:
# ... 他の環境変数 ...
volumes:
# アプリデータ
- ./data:/app/data
# ワンクリック更新に必須のマウント
- /var/run/docker.sock:/var/run/docker.sock # Docker Socket をマウント
- ./docker-compose.yml:/app/docker-compose.yml # docker-compose.yml をマウント
restart: unless-stopped手順
- 管理コンソールにログイン
- About ページへ移動
- バージョン情報 セクションの 更新を確認 をクリック
- 新バージョンがあれば 今すぐ更新 ボタンとバージョン一覧が表示
- 更新するバージョンを選択し 更新 をクリック
- システムが自動で以下を実行:
- 新しいイメージを取得
- docker-compose.yml のイメージタグを更新
- 旧コンテナを停止
- 新コンテナを起動
- 更新完了後、ページが自動でリフレッシュ
注意事項
- 更新中はサービスが短時間停止します(通常 10〜30 秒)
- 更新中にブラウザを閉じたり更新しないでください
- 更新に失敗した場合はコンテナログを確認
方法 2:手動更新
ワンクリック更新を使わない場合は以下の手順です:
新しいイメージを取得
# 最新版を取得(Docker Hub)
docker pull cherrystudio/cherry-studio-enterprise-api:latest
# 特定バージョンを取得
docker pull cherrystudio/cherry-studio-enterprise-api:v0.4.10
# 中国大陸のユーザー:国内ミラーで高速取得:
docker pull docker-registry.cherry-ai.com/public/cherry-studio-enterprise-api:latestdocker-compose.yml を更新
docker-compose.yml のイメージタグを変更します:
services:
api:
image: cherrystudio/cherry-studio-enterprise-api:v0.4.10 # バージョン更新
# ... 他の設定はそのまま ...サービス再起動
# 停止して再作成
docker-compose down
docker-compose up -d
# ログで起動確認
docker-compose logs -f更新確認
- 管理コンソールの About でバージョン確認
- サービス正常性を確認:
curl http://localhost:3670/health
バージョン情報の確認
現在のバージョン
- 管理コンソール:ログインして About を開く
- API:
/healthエンドポイントへアクセス - CLI:
docker inspect cherry-studio-enterprise-api | grep "Image"
更新ログの確認
- 管理コンソール:About > 更新ログ
- オンライン文書:リリースノート
よくある質問
1. ワンクリック更新ボタンが表示されない
原因の可能性:
- Docker Socket がマウントされていない
- docker-compose.yml がマウントされていない
- Docker Socket の権限不足
対処方法:
docker-compose.ymlに必要な volume があるか確認- Docker Socket の存在を確認:
ls -la /var/run/docker.sock - コンテナが Docker Socket にアクセスできるか確認
2. イメージ取得に失敗
原因の可能性:
- ネットワーク接続の問題
- Docker Hub へのアクセス制限
対処方法:
- ネットワークを確認
- Docker レジストリミラーを設定
- 手動でイメージ取得後に更新
3. 更新後にサービスが起動しない
確認手順:
# コンテナログを確認
docker logs cherry-studio-enterprise-api
# コンテナ状態を確認
docker ps -a
# ポート競合を確認
netstat -tulpn | grep -E '3670|3680'よくある原因:
- DB 接続設定の誤り
- ポート競合
- 環境変数の不足
関連ドキュメント
- Docker 導入ガイド - Docker 導入の詳細
- データベース設定ガイド - PostgreSQL 設定
- Helm 導入ガイド - Kubernetes 導入