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

# AWS 上的 Dify Premium

> 在 AWS 上部署、自定义和升级 Dify Premium

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/self-host/deploy/platform-guides/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 之前运行概念验证。

## 访问与设置

AMI 部署后，通过 EC2 控制台中找到的实例公共 IP 访问 Dify（默认使用 HTTP 端口 80）。

如果这是你首次访问 Dify，输入管理员初始化密码（你的 EC2 实例 ID）来开始设置过程。

## 自定义

### 配置

<Steps>
  <Step title="编辑环境变量">
    在 EC2 实例中，编辑相关文件中的环境变量：

    * **必要的启动值** 位于 `/dify/.env` 文件中。直接编辑即可。

    * **可选或特定提供商的设置** 在 `/dify/envs/` 下有对应模板。要覆盖默认值，复制相应模板（去掉 `.example` 后缀），然后编辑副本。

      例如：

      ```bash theme={null}
      cd /dify
      cp envs/vectorstores/opensearch.env.example envs/vectorstores/opensearch.env
      ```

    `/dify/.env` 中的值优先于任何 `/dify/envs/*.env` 文件中的值。

    如果你的 AWS 部署通过 `docker-compose.override.yaml` 注入变量，将这些设置保留在该文件中。Compose 中服务级别的 `environment:` 值优先于 env 文件中的值。
  </Step>

  <Step title="重启 Dify">
    ```bash theme={null}
    docker compose down
    docker compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
    ```
  </Step>
</Steps>

### Web 应用标志和品牌

在 **设置** > **自定义** 中，可移除 `Powered by Dify` 品牌标识或替换为你自己的标志。

## 升级

<Warning>
  * 升级前，查看 GitHub 上的 [Release Notes](https://github.com/langgenius/dify/releases) 了解特定版本的升级说明。某些版本可能需要额外步骤，例如数据库迁移或配置更改。

  * Dify 的 Docker Compose 文件现在需要 Docker Compose 2.24.0 或更高版本。升级前运行 `docker compose version` 确认。
</Warning>

在 EC2 实例中，运行以下命令：

<Steps>
  <Step title="停止运行中的服务">
    ```bash theme={null}
    cd /dify
    docker compose down
    ```
  </Step>

  <Step title="备份数据">
    备份 `.env` 文件、`envs/` 下你创建的任何可选 env 文件，以及包含数据库、存储和其他持久化数据的 `volumes` 目录：

    ```bash theme={null}
    cp /dify/.env /dify/.env.bak
    tar -cvf envs-$(date +%s).tgz envs
    tar -cvf volumes-$(date +%s).tgz volumes
    ```
  </Step>

  <Step title="更新 Dify">
    <Warning>
      升级过程将覆盖配置模板，但不会影响 `.env` 文件、本地的 `/dify/envs/*.env` 文件或 `volumes/` 目录中的运行时数据（如数据库和上传的文件）。

      如果你手动修改过 `.env` 和 `/dify/envs/*.env` 以外的任何配置文件，请在升级前备份它们。
    </Warning>

    拉取最新代码并同步配置文件：

    ```bash theme={null}
    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` 或 `envs/` 下的可选模板中引入新变量。将每个模板与对应的本地 env 文件进行比较，并添加任何你需要的缺失变量：

    ```bash theme={null}
    diff /dify/.env /dify/.env.example
    find /dify/envs -name "*.env" -print | while read -r env_file; do
      diff "$env_file" "$env_file.example"
    done
    ```

    如需自定义新增的可选模板，复制该文件（去掉 `.example` 后缀）后再编辑。详见 [配置](#配置)。
  </Step>

  <Step title="启动服务">
    ```bash theme={null}
    docker compose pull
    docker compose -f docker-compose.yaml -f docker-compose.override.yaml up -d
    ```
  </Step>
</Steps>