mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-03-27 13:28:32 +07:00
* 🌐 Initial translations for PR #695 Auto-generated translations for documentation changes in PR #695. Last-Processed-Commit: 04b557387312d022e382a3d9177e267bf268ca86 Original-PR: #695 Languages: Chinese (zh), Japanese (ja) 🤖 Generated with GitHub Actions * Update section headers and access instructions * Update section title --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Riskey <36894937+RiskeyL@users.noreply.github.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
212ca6b18f
commit
6912690f45
@@ -4,126 +4,82 @@ title: AWS上のDify Premium
|
||||
|
||||
<Note> ⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/self-host/platform-guides/dify-premium)を参照してください。</Note>
|
||||
|
||||
Dify Premiumは、カスタムブランディングを可能にし、EC2としてAWS VPCにワンクリックでデプロイできるAWS AMIサービスです。[AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6)にアクセスして購読してください。以下のようなシナリオで有用です：
|
||||
Dify Premiumは、カスタムブランディングを可能にし、EC2インスタンスとしてAWS VPCにワンクリックでデプロイできるAWS AMIサービスです。[AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6)にアクセスして購読してください。以下のようなシナリオで有用です：
|
||||
|
||||
* 中小企業として1つまたは少数のアプリケーションを作成したく、データレジデンシーを重視している。
|
||||
* [Dify Cloud](https://cloud.dify.ai)に興味があるが、あなたのユースケースが[プラン](https://dify.ai/pricing)でサポートされているよりも多くのリソースを必要とする。
|
||||
* 組織内でDify Enterpriseを採用する前にPOCを実行したい。
|
||||
- 中小企業として1つまたは少数のアプリケーションを作成したく、データレジデンシーを重視している。
|
||||
- [Dify Cloud](https://cloud.dify.ai)に興味があるが、あなたのユースケースが[プラン](https://dify.ai/pricing)でサポートされているよりも多くのリソースを必要とする。
|
||||
- 組織内でDify Enterpriseを採用する前にPOCを実行したい。
|
||||
|
||||
## セットアップ
|
||||
## アクセス & セットアップ
|
||||
|
||||
初めてDifyにアクセスする場合は、Admin初期化パスワード（EC2のインスタンスIDに設定）を入力してセットアップ処理を開始します。
|
||||
AMIがデプロイされた後、EC2コンソールで確認できるインスタンスのパブリックIPを通じてDifyにアクセスします（デフォルトではHTTPポート80を使用）。
|
||||
|
||||
AMIがデプロイされた後、EC2コンソールで見つけたインスタンスのパブリックIPを通じてDifyにアクセスします（デフォルトではHTTPポート80を使用）。
|
||||
|
||||
## アップグレード
|
||||
|
||||
EC2インスタンスで、以下のコマンドを実行します：
|
||||
|
||||
```
|
||||
git clone https://github.com/langgenius/dify.git /tmp/dify
|
||||
mv -f /tmp/dify/docker/* /dify/
|
||||
rm -rf /tmp/dify
|
||||
docker-compose down
|
||||
docker-compose pull
|
||||
docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
|
||||
```
|
||||
|
||||
<Accordion title="Community Editionをv1.0.0+にアップグレード">
|
||||
|
||||
> このセクションでは、古いCommunity EditionをDify v1.0.0+に移行する方法を説明します。この特定の移行範囲*より後*のバージョンへのDify PremiumまたはCommunity Editionの一般的なアップグレードについては、それぞれのメインアップグレード手順を参照してください。
|
||||
|
||||
アップグレードプロセスには以下のステップが含まれます：
|
||||
|
||||
1. データのバックアップ
|
||||
2. プラグインの移行
|
||||
3. メインのdifyプロジェクトのアップグレード
|
||||
|
||||
### 1. データのバックアップ
|
||||
|
||||
1.1 `cd`コマンドを実行してDifyプロジェクトディレクトリに移動し、バックアップブランチを作成します。
|
||||
|
||||
1.2 以下のコマンドを実行してdocker-compose YAMLファイルをバックアップします（オプション）。
|
||||
|
||||
```bash
|
||||
cd docker
|
||||
cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak
|
||||
```
|
||||
|
||||
1.3 コマンドを実行してdockerサービスを停止し、Dockerディレクトリでバックアップデータコマンドを実行します。
|
||||
|
||||
```bash
|
||||
docker compose down
|
||||
tar -cvf volumes-$(date +%s).tgz volumes
|
||||
```
|
||||
|
||||
### 2. バージョンのアップグレcker Composeによるデプロイをサポートしています。Difyプロジェクトパスに移動し、以下のコマンドを実行してDifyバージョンにアップグレードします：
|
||||
|
||||
```bash
|
||||
git checkout 1.0.0 # 1.0.0ブランチに切り替え
|
||||
cd docker
|
||||
docker compose -f docker-compose.yaml up -d
|
||||
```
|
||||
|
||||
### 3. ツールをプラグインに移行
|
||||
|
||||
> **コマンド実行とパッケージ管理に関する重要な注意（v1.0.0移行用）：**
|
||||
> * **デフォルトコンテナ名：** `docker exec`コマンドの例では`docker-api-1`を使用しています。APIコンテナが異なる名前またはID（`docker ps`を使用して確認可能）を持つ場合は、それに応じてコマンドを調整してください。
|
||||
> * **Pythonパッケージマネージャー（`uv` vs. `poetry`）：**
|
||||
* Difyは、パフォーマンス向上のためにバージョン[v1.3.0](https://github.com/langgenius/dify/releases/tag/1.3.0)からPythonパッケージ管理を`poetry`から`uv`に切り替えました。Dify v1.3.0以降の一般的な操作では、標準コマンドは`uv run flask ...`です。
|
||||
* **このセクションはDify v1.0.0へのアップグレードに焦点を当てています。** Dify v1.0.0からv1.3.0未満までの期間では、`poetry`がパッケージマネージャーでした。したがって、以下の例の`flask`コマンドは正しく`poetry run ...`を使用しています。コードの例では、コメントで現在の`uv`標準を最初に強調し、次にこの特定のv1.0.0移行範囲に関連する`poetry`コマンドを示します。
|
||||
|
||||
このステップの目的は、以前にCommunity Editionで使用されていたツールとモデルベンダーを自動的に移行し、新しいプラグイン環境にインストールすることです。
|
||||
|
||||
1. `docker ps`コマンドを実行してAPIコンテナ名またはIDを確認します。デフォルトは多くの場合`docker-api-1`です。
|
||||
|
||||
例：
|
||||
|
||||
```bash
|
||||
docker ps
|
||||
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
|
||||
417241cd**** nginx:latest "sh -c 'cp /docker-e…" 3 hours ago Up 3 hours 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp docker-nginx-1
|
||||
f84aa773**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-worker-1
|
||||
a3cb19c2**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-api-1
|
||||
```
|
||||
|
||||
コマンド`docker exec -it docker-api-1 bash`を実行してコンテナターミナルに入り（コンテナ名が異なる場合はそれを使用）、次に実行します：
|
||||
|
||||
```bash
|
||||
# Dify v1.3.0+環境では、標準コマンドは'uv run ...'です。
|
||||
uv run flask extract-plugins --workers=20
|
||||
#
|
||||
# ゲット移行バージョンがDify v1.0.0からv1.3.0未満の場合は、'poetry'を使用してください：
|
||||
# poetry run flask extract-plugins --workers=20
|
||||
```
|
||||
|
||||
> v1.0.0移行用のこのガイドに従ってコマンドを実行しようとする際にエラーが発生した場合（例：`uv`または`poetry`が見つからない）、そのバージョンの元の前提条件に従って`poetry`環境がサーバー上で正しく設定されていることを確認してください。`poetry`コマンドの実行後にターミナルで入力を求められた場合は、**「Enter」**を押してスキップしてください。
|
||||
|
||||
このコマンドは、現在環境で使用中のすべてのモデルとツールを抽出します。workersパラメータは抽出中に使用される並列プロセス数を制御し、必要に応じて調整できます。コマンド実行後、現在のDifyインスタンス内のすべてのワークスペース用のプラグイン情報を含む`plugins.jsonl`ファイルが生成されます。
|
||||
|
||||
ネットワークがパブリックインターネットにアクセスでき、`https://marketplace.dify.ai`へのアクセスをサポートしていることを確認してください。`docker-api-1`コンテナ内で以下のコマンドを続けて実行します：
|
||||
|
||||
```bash
|
||||
# Dify v1.3.0+環境では、標準コマンドは'uv run ...'です。
|
||||
uv run flask install-plugins --workers=2
|
||||
#
|
||||
# ここで説明するCommunity Edition部分のターゲット移行バージョンがDify v1.0.0からv1.3.0未満の場合は、'poetry'を使用してください：
|
||||
# poetry run flask install-plugins --workers=2
|
||||
```
|
||||
|
||||
このコマンドは、必要なすべてのプラグインを最新のCommunity Editionにダウンロードしてインストールします。ターミナルに`Install plugins completed.`が表示されると、移行が完了します。
|
||||
|
||||
</Accordion>
|
||||
初めてDifyにアクセスする場合は、Admin初期化パスワード（EC2のインスタンスID）を入力してセットアップ処理を開始します。
|
||||
|
||||
## カスタマイズ
|
||||
|
||||
セルフホストデプロイと同様に、EC2インスタンス内の`.env`の環境変数を必要に応じて変更できます。その後、以下でDifyを再起動します：
|
||||
### 設定
|
||||
|
||||
セルフホストデプロイと同様に、EC2インスタンス内の`.env`ファイルの環境変数を必要に応じて変更できます。その後、以下でDifyを再起動します：
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
|
||||
```
|
||||
|
||||
## WebAppロゴ & ブランディングのカスタマイズ
|
||||
### WebAppロゴ & ブランディング
|
||||
|
||||
設定の**カスタマイズ**でこの機能を有効にし、**Remove Powered by Dify**を有効にして独自のロゴをアップロードできます。
|
||||
**設定** > **カスタマイズ**で、`Powered by Dify`ブランディングを削除するか、独自のロゴに置き換えることができます。
|
||||
|
||||
## アップグレード
|
||||
|
||||
<Warning>
|
||||
アップグレードする前に、GitHubの[リリースノート](https://github.com/langgenius/dify/releases)でバージョン固有のアップグレード手順を確認してください。一部のバージョンでは、データベースの移行や設定変更などの追加手順が必要な場合があります。
|
||||
</Warning>
|
||||
|
||||
EC2インスタンスで、以下のコマンドを実行します：
|
||||
|
||||
<Steps>
|
||||
<Step title="実行中のサービスを停止">
|
||||
```bash
|
||||
cd /dify
|
||||
docker-compose down
|
||||
```
|
||||
</Step>
|
||||
<Step title="データをバックアップ">
|
||||
`.env`ファイルと`volumes`ディレクトリをバックアップします。これにはデータベース、ストレージ、その他の永続データが含まれています：
|
||||
|
||||
```bash
|
||||
cp /dify/.env /dify/.env.bak
|
||||
tar -cvf volumes-$(date +%s).tgz volumes
|
||||
```
|
||||
</Step>
|
||||
<Step title="Difyを更新">
|
||||
<Warning>
|
||||
アップグレードプロセスは設定ファイルを上書きしますが、`.env`ファイルや`volumes/`ディレクトリ内のランタイムデータ（データベースやアップロードされたファイルなど）には影響しません。
|
||||
|
||||
`.env`以外の設定ファイルを手動で変更している場合は、アップグレード前にバックアップしてください。
|
||||
</Warning>
|
||||
|
||||
最新のコードをプルし、設定ファイルを同期します：
|
||||
|
||||
```bash
|
||||
git clone https://github.com/langgenius/dify.git /tmp/dify
|
||||
rsync -av /tmp/dify/docker/ /dify/
|
||||
rm -rf /tmp/dify
|
||||
```
|
||||
</Step>
|
||||
<Step title="新しい環境変数を確認">
|
||||
新しいバージョンでは`.env.example`に新しい環境変数が導入される場合があります。現在の`.env`と比較し、不足している変数を追加してください：
|
||||
|
||||
```bash
|
||||
diff /dify/.env /dify/.env.example
|
||||
```
|
||||
</Step>
|
||||
<Step title="サービスを開始">
|
||||
```bash
|
||||
docker-compose pull
|
||||
docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
@@ -6,126 +6,80 @@ title: AWS 上的 Dify Premium
|
||||
|
||||
Dify Premium 是我们的 AWS AMI 产品，支持自定义品牌，可一键部署到你的 AWS VPC 作为 EC2 实例。前往 [AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6) 进行订阅。它在以下几种场景中很有用：
|
||||
|
||||
* 你是中小型企业，希望创建一个或几个应用程序，并且关心数据驻留问题。
|
||||
* 你对 [Dify Cloud](https://cloud.dify.ai) 感兴趣，但你的用例需要比 [定价计划](https://dify.ai/pricing) 支持的更多资源。
|
||||
* 你希望在组织内采用 Dify Enterprise 之前运行概念验证。
|
||||
- 你是中小型企业，希望创建一个或几个应用程序，并且关心数据驻留问题。
|
||||
- 你对 [Dify Cloud](https://cloud.dify.ai) 感兴趣，但你的用例需要比 [定价计划](https://dify.ai/pricing) 支持的更多资源。
|
||||
- 你希望在组织内采用 Dify Enterprise 之前运行概念验证。
|
||||
|
||||
## 设置
|
||||
|
||||
如果这是你首次访问 Dify，请输入管理员初始化密码（设置为你的 EC2 实例 ID）来开始设置过程。
|
||||
## 访问与设置
|
||||
|
||||
AMI 部署后，通过 EC2 控制台中找到的实例公共 IP 访问 Dify（默认使用 HTTP 端口 80）。
|
||||
|
||||
## 升级
|
||||
|
||||
在 EC2 实例中，运行以下命令：
|
||||
|
||||
```
|
||||
git clone https://github.com/langgenius/dify.git /tmp/dify
|
||||
mv -f /tmp/dify/docker/* /dify/
|
||||
rm -rf /tmp/dify
|
||||
docker-compose down
|
||||
docker-compose pull
|
||||
docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
|
||||
```
|
||||
|
||||
<Accordion title="将社区版升级到 v1.0.0+">
|
||||
|
||||
> 本节描述将较旧的社区版迁移到 Dify v1.0.0+。对于 Dify Premium 或社区版到此特定迁移范围之后版本的一般升级，请参考各自的主要升级说明。
|
||||
|
||||
升级过程包括以下步骤：
|
||||
|
||||
1. 备份你的数据
|
||||
2. 迁移插件
|
||||
3. 升级主要的 dify 项目
|
||||
|
||||
### 1. 备份数据
|
||||
|
||||
1.1 执行 `cd` 命令导航到你的 Dify 项目目录并创建备份分支。
|
||||
|
||||
1.2 运行以下命令备份你的 docker-compose YAML 文件（可选）。
|
||||
|
||||
```bash
|
||||
cd docker
|
||||
cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak
|
||||
```
|
||||
|
||||
1.3 运行命令停止 docker 服务，然后在 Docker 目录中执行备份数据命令。
|
||||
|
||||
```bash
|
||||
docker compose down
|
||||
tar -cvf volumes-$(date +%s).tgz volumes
|
||||
```
|
||||
|
||||
### 2. 升级版本
|
||||
|
||||
`v1.0.0` 支持通过 Docker Compose 部署。导航到你的 Dify 项目路径并运行以下命令升级到 Dify 版本：
|
||||
|
||||
```bash
|
||||
git checkout 1.0.0 # 切换到 1.0.0 分支
|
||||
cd docker
|
||||
docker compose -f docker-compose.yaml up -d
|
||||
```
|
||||
|
||||
### 3. 将工具迁移到插件
|
||||
|
||||
> **关于命令执行和包管理的重要说明（针对 v1.0.0 迁移）：**
|
||||
> * **默认容器名称：** `docker exec` 命令示例使用 `docker-api-1`。如果你的 API 容器有不同的名称或 ID（你可以使用 `docker ps` 找到），请相应调整命令。
|
||||
> * **Python 包管理器（`uv` vs. `poetry`）：**
|
||||
* Dify 从版本 [v1.3.0](https://github.com/langgenius/dify/releases/tag/1.3.0) 开始将 Python 包管理器从 `poetry` 切换到 `uv` 以提高性能。对于 Dify v1.3.0 或更新版本的一般操作，标准命令是 `uv run flask ...`。
|
||||
* **本节专门针对升级到 Dify v1.0.0。** 在 Dify v1.0.0 到（但不包括）v1.3.0 期间，`poetry` 是包管理器。因此，下面示例中的 `flask` 命令正确地使用 `poetry run ...`。代码示例首先在注释中强调当前的 `uv迁移范围相关的 `poetry` 命令。
|
||||
|
||||
此步骤的目的是自动迁移之前在社区版中使用的工具和模型供应商，并将它们安装到新的插件环境中。
|
||||
|
||||
1. 运行 `docker ps` 命令检查 API 容器名称或 ID。默认通常是 `docker-api-1`。
|
||||
|
||||
示例：
|
||||
|
||||
```bash
|
||||
docker ps
|
||||
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
|
||||
417241cd**** nginx:latest "sh -c 'cp /docker-e…" 3 hours ago Up 3 hours 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp docker-nginx-1
|
||||
f84aa773**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-worker-1
|
||||
a3cb19c2**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-api-1
|
||||
```
|
||||
|
||||
运行命令 `docker exec -it docker-api-1 bash` 进入容器终端（如果你的容器名称不同，请使用相应的名称），然后运行：
|
||||
|
||||
```bash
|
||||
# 对于 Dify v1.3.0+ 环境，标准命令是 'uv run ...'。
|
||||
uv run flask extract-plugins --workers=20
|
||||
#
|
||||
# 如果此处描述的社区版部分的目标迁移版本是 Dify v1.0.0 到（但不包括）v1.3.0，请使用 'poetry'：
|
||||
# poetry run flask extract-plugins --workers=20
|
||||
```
|
||||
|
||||
> 如果按照此 v1.0.0 迁移指南尝试执行命令时发生错误（例如，找不到 `uv` 或 `poetry`），请确保服务器上正确设置了该版本的原始先决条件的 `poetry` 环境。如果终端在运行 `poetry` 命令后要求输入，请按 **"Enter"** 键跳过。
|
||||
|
||||
此命令将提取环境中当前使用的所有模型和工具。workers 参数控制提取过程中使用的并行进程数，可根据需要调整。命令运行后，将生成一个 `plugins.jsonl` 文件，包含当前 Dify 实例中所有工作区的插件信息。
|
||||
|
||||
确保你的网络可以访问公共互联网并支持访问：`https://marketplace.dify.ai`。在 `docker-api-1` 容器中继续运行以下命令：
|
||||
|
||||
```bash
|
||||
# 对于 Dify v1.3.0+ 环境，标准命令是 'uv run ...'。
|
||||
uv run flask install-plugins --workers=2
|
||||
#
|
||||
# 如果此处描述的社区版部分的目标迁移版本是 Dify v1.0.0 到（但不包括）v1.3.0，请使用 'poetry'：
|
||||
# poetry run flask install-plugins --workers=2
|
||||
```
|
||||
|
||||
此命令将下载并安装所有必要的插件到最新的社区版中。当终端显示 `Install plugins completed.` 时，迁移完成。
|
||||
|
||||
</Accordion>
|
||||
如果这是你首次访问 Dify，请输入管理员初始化密码（你的 EC2 实例 ID）来开始设置过程。
|
||||
|
||||
## 自定义
|
||||
|
||||
就像自托管部署一样，你可以根据需要修改 EC2 实例中 `.env` 下的环境变量。然后，使用以下命令重启 Dify：
|
||||
### 配置
|
||||
|
||||
就像自托管部署一样，你可以根据需要修改 EC2 实例中 `.env` 文件下的环境变量。然后，使用以下命令重启 Dify：
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
|
||||
```
|
||||
|
||||
## WebApp 标志和品牌自定义
|
||||
### Web 应用标志和品牌
|
||||
|
||||
你可以在设置下的**自定义**中启用此功能，启用**移除 Powered by Dify**并上传你自己的标志。
|
||||
在**设置** > **自定义**中，你可以移除 `Powered by Dify` 品牌标识或替换为你自己的标志。
|
||||
|
||||
## 升级
|
||||
|
||||
<Warning>
|
||||
在升级之前，请查看 GitHub 上的 [Release Notes](https://github.com/langgenius/dify/releases) 了解特定版本的升级说明。某些版本可能需要额外的步骤，例如数据库迁移或配置更改。
|
||||
</Warning>
|
||||
|
||||
在 EC2 实例中，运行以下命令：
|
||||
|
||||
<Steps>
|
||||
<Step title="停止运行中的服务">
|
||||
```bash
|
||||
cd /dify
|
||||
docker-compose down
|
||||
```
|
||||
</Step>
|
||||
<Step title="备份数据">
|
||||
备份你的 `.env` 文件和 `volumes` 目录，其中包含你的数据库、存储和其他持久化数据：
|
||||
|
||||
```bash
|
||||
cp /dify/.env /dify/.env.bak
|
||||
tar -cvf volumes-$(date +%s).tgz volumes
|
||||
```
|
||||
</Step>
|
||||
<Step title="更新 Dify">
|
||||
<Warning>
|
||||
升级过程会覆盖配置文件，但不会影响你的 `.env` 文件或 `volumes/` 目录中的运行时数据（如数据库和上传的文件）。
|
||||
|
||||
如果你手动修改过 `.env` 以外的任何配置文件，请在升级前备份它们。
|
||||
</Warning>
|
||||
|
||||
拉取最新代码并同步配置文件：
|
||||
|
||||
```bash
|
||||
git clone https://github.com/langgenius/dify.git /tmp/dify
|
||||
rsync -av /tmp/dify/docker/ /dify/
|
||||
rm -rf /tmp/dify
|
||||
```
|
||||
</Step>
|
||||
<Step title="检查新的环境变量">
|
||||
新版本可能会在 `.env.example` 中引入新的环境变量。将其与你当前的 `.env` 进行比较，并添加任何缺失的变量：
|
||||
|
||||
```bash
|
||||
diff /dify/.env /dify/.env.example
|
||||
```
|
||||
</Step>
|
||||
<Step title="启动服务">
|
||||
```bash
|
||||
docker-compose pull
|
||||
docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
Reference in New Issue
Block a user