> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-release-1-17-0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# よくある質問

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/self-host/deploy/quick-start/faqs) を参照してください。

## デプロイ方法

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

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

```bash theme={null}
git clone https://github.com/langgenius/dify.git --branch 0.15.3
```

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

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

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

```bash theme={null}
# 最新リリースをダウンロード
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 をダウンロードして手動で転送することもできます。

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

```bash theme={null}
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 をデプロイする](/ja/self-host/deploy/quick-start/docker-compose) のクローンコマンドは、GitHub API を通じて Dify の最新バージョンを取得します。このリクエストが失敗すると（未認証リクエストに対する GitHub のレート制限が主な原因）、`jq` が `null` を出力し、git は `fatal: Remote branch null not found in upstream origin` を報告します。

代わりに、バージョンを明示してクローンしてください。[Dify releases](https://github.com/langgenius/dify/releases) で最新バージョンを確認し、次のコマンドを実行します：

```bash theme={null}
git clone --branch <version> https://github.com/langgenius/dify.git
```

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

## バックアップ手順

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

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

```bash theme={null}
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 共有が有効になります。

```bash theme={null}
docker compose down
docker compose up -d
```

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