実行する前に、
戻せる状態を作る。

PR本記事はA8.netのアフィリエイト広告を含みます。アップデート成功や無停止を保証せず、実行時は最新の公式マニュアルとリリースノートを優先します。

「update.shだけ」で始めない

公式マニュアルは基本手順と同じページに、過去のDify仕様変更に伴う不具合と回避手順を掲載しています。環境変数、データベース、ベクトルDB、保存領域の権限、アップデート用スクリプト自体が対象になった例があります。

そのため、古いブログ記事のコマンドをそのまま実行せず、XServer VPSのDifyマニュアルで、契約日またはアプリイメージの再インストール日が各注意事項の対象かを確認します。

安全なアップデートの順番

更新前に記録するもの

• 現在のDifyバージョンと更新先バージョン
• XServer VPSの利用開始日・再インストール日
• Dockerコンテナの状態と利用中プロファイル
• 使用中のデータベース・ベクトルDB・プラグイン
• 独自ドメイン、HTTPS、公開APIの疎通
• カスタマイズした環境変数とCompose構成
• 復元に使うイメージ・データ・担当者

値そのものを公開メモへ貼り付けず、秘密情報を含む設定はアクセス制御された場所で管理します。

更新前バックアップは「戻せる」まで確認

XServer VPSのイメージ保存は、OS、ソフトウェア設定、保存データを含むサーバー状態を保存できます。公式手順は保存前にVPSをシャットダウンするため、停止時間を計画に含めます。

DifyはPostgreSQL、アプリ保存領域、ベクトルDB、プラグインなど複数の永続データを持ちます。VPSイメージだけで十分か、個別バックアップも必要かを構成に応じて判断し、復元後に何を確認するか決めます。

XServer公式の時期別注意を確認する

現在の公式マニュアルには、特定時期の環境で起きる可能性がある事象として、アップデート処理失敗、ベクトルDBの未起動、PostgreSQLの未起動、管理者ログイン不能、保存領域の権限、アップデート用スクリプトの変更などが掲載されています。

一部は特定日以降の新規申込み・再インストールで修正済みと案内されています。自分の環境が対象外と決めつけず、実行当日に公式ページの対象日と手順を確認してください。

Dify公式リリースノートも確認する

Difyのリリースによっては、通常のCompose更新に加えて、データベース移行、プラグイン関連の処理、環境変数の追加・削除、Compose構成の変更が案内されます。更新先タグのリリースノートを読み、追加手順の有無を確認します。

「最新版」という言葉だけでmainブランチへ追随せず、現在版から更新先までの変更量、既知の問題、ロールバック可能性を比較します。

更新後の確認項目

1. 必要なDockerコンテナが起動している
2. HTTPSでログイン画面を表示できる
3. 管理者アカウントでログインできる
4. 既存アプリとワークフローが残っている
5. ナレッジ文書を検索できる
6. プラグインとモデル接続が動く
7. 公開API・埋め込み画面が応答する
8. エラーログに継続的な異常がない

最初の画面が開くだけで完了にせず、実際に使う主要経路を一つずつ実行します。

ロールバック条件を先に決める

• 決めた時間内に主要コンテナが正常化しない
• 管理者がログインできない
• アプリ・ナレッジ・プラグインが欠落する
• 公開APIの主要テストが失敗する
• データ移行エラーの原因を安全に特定できない

その場で無制限に修正を続けず、判断期限を超えたら更新前の復元点へ戻す計画にします。

参照した一次情報

• XServer VPS公式：Difyアプリイメージ・アップデート
• XServer VPS公式：イメージの保存
• Dify公式：リリース一覧と更新時の注意
• Dify公式：Docker Compose構成

情報確認日: 2026年8月17日。更新手順、対象日、回避策、Difyの移行処理は変更されるため、実行直前にXServer VPS公式マニュアルと更新先のDify公式リリースノートを確認してください。