よくある質問

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

​

デプロイ方法

​

旧バージョンのインストール

--branch フラグを使用して特定のバージョンをインストールします：

git clone https://github.com/langgenius/dify.git --branch 0.15.3

残りのセットアップは最新版のインストールと同じです。

​

ZIP アーカイブを使用したインストール

ネットワーク制限がある環境や git が利用できない場合：

# 最新リリースをダウンロード
wget -O dify.zip "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r '.zipball_url')"
unzip dify.zip && rm dify.zip

または、別のデバイスで ZIP をダウンロードして手動で転送することもできます。

アップグレードするには：

wget -O dify-latest.zip "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r '.zipball_url')"
unzip dify-latest.zip && rm dify-latest.zip
rsync -a dify-latest/ dify/
rm -rf dify-latest/
cd dify/docker
docker compose pull
docker compose up -d

​

クローン時の「Remote branch null not found」エラー

Docker Compose で Dify をデプロイする のクローンコマンドは、GitHub API を通じて Dify の最新バージョンを取得します。このリクエストが失敗すると（未認証リクエストに対する GitHub のレート制限が主な原因）、jq が null を出力し、git は fatal: Remote branch null not found in upstream origin を報告します。

代わりに、バージョンを明示してクローンしてください。Dify releases で最新バージョンを確認し、次のコマンドを実行します：

git clone --branch <version> https://github.com/langgenius/dify.git

--branch なしでもクローンできます。main ブランチの Compose ファイルは最新リリース版のイメージを指定しているため、起動されるのはリリース版です。ただし、Compose ファイルや環境変数テンプレートなどのデプロイ用ファイル自体は開発中の内容であり、リリース版と異なる場合があります。

​

バックアップ手順

​

アップグレード前のバックアップ作成

データ損失を防ぐため、アップグレード前は必ずバックアップを行ってください：

cp -r dify "dify.bak.$(date +%Y%m%d%H%M%S)"

これにより、復元しやすいタイムスタンプ付きのバックアップが作成されます。

​

リバースプロキシ設定

​

フロントエンドとバックエンドが異なるサブドメインで動作する場合のログインセッション切れ

Web と API を異なるサブドメインに分けてリバースプロキシ経由で公開している場合、認証 Cookie が両方のホストに届きません。たとえば UI が app.example.com、バックエンドが api.example.com の構成です。ログインは成功したように見えても、次のリクエストでセッションが切れます。

.env で両方の変数を設定し、Dify を再起動してください：

• COOKIE_DOMAIN：共有するトップレベルドメインを指定します（例：example.com）。先頭のドットは省略可能です。
• NEXT_PUBLIC_COOKIE_DOMAIN：1 を設定すると、フロントエンドでサブドメイン間の Cookie 共有が有効になります。

docker compose down
docker compose up -d

Cookie はトップレベルドメインを越えて共有できないため、フロントエンドとバックエンドは同じ登録可能ドメイン内にある必要があります。詳細は 環境変数 を参照してください。