---
title: 【期間限定無料公開】Dify_nginx更新講座_講師用
tags: 
author: [Yukiko](https://www.docswell.com/user/yukiko_it)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/LE1RKKXZEG.jpg?width=480
description: 【期間限定無料公開】Dify_nginx更新講座_講師用 by Yukiko
published: November 20, 26
canonical: https://www.docswell.com/s/yukiko_it/K6NPXV-2026-11-20-064817
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/LE1RKKXZEG.jpg)

法人研修レベル｜脆弱性対応｜公式参考
講師用（スピーカーノート付き）
★
Dify nginx
更新講座
（nginxだけ）
★
Q. 戻れる形で、nginxだけを入れ替えられますか？
Q. 公式で確認したことと、未確認のことを、分けて言えますか？
STEP 1 → 8
公式確認日 2026-11-20｜うさうさ研修工房


# Page. 2

![Page Image](https://bcdn.docswell.com/page/GEW1DDN672.jpg)

スタート
この講座の約束と、確認状況の見方
Q. 「公式」と「講師の整理」を、見分けられますか？
整理
札の使い方は講師の整理
公式
講師の整理
確認
未確認
公式ドキュメントで確認
した事実。ページ名と確
認日を付ける
講師の解釈・設計案。公
式の記述ではない
この教材の環境で、実際
に動かして確かめた
確かめていない。お客様
に出す前に、自分の環境
で確認する
答えの目安
各スライドの上の色の札で、確認状況が分かる
うさうさ研修工房｜Dify nginx更新講座
2


# Page. 3

![Page Image](https://bcdn.docswell.com/page/47ZPGG3RE3.jpg)

STEP 1｜難易度 ●○○○○○○○○
何を、どこまで更新するか
Q. 更新するのは、Difyですか？ nginxですか？
整理
範囲の切り分けは講師の整理。Difyの公式の更新手順とは別の作業
更新する
更新しない
残す
nginxのコンテナ（イメージ）
だけ。入口の役割をするとこ
ろ
Dify本体（api・web・worker
・DBなど）。今回は触らない
設定（.env・nginx設定）、デ
ータ（volumes）。戻れる状態
も残す
答えの目安
nginxだけ。Dify本体と設定・データは、触らない
うさうさ研修工房｜Dify nginx更新講座
3


# Page. 4

![Page Image](https://bcdn.docswell.com/page/YJ6MYYX17V.jpg)

STEP 1｜難易度 ●○○○○○○○○
更新の全体の流れ：5ステップ
Q. どの順番で進める？
整理
流れは講師の整理。個々の公式の確認は、後のスライドで
1 診断を読む
2 記録と退避
3 版を決める
4 入れ替え
5 確認
どの版？どこの？
版・設定を残す
公式で確認
pull → up
版・応答・再診断
守ること：Dify本体の更新と混ぜない。戻せる状態（今の版の記録）を先に作る
答えの目安
読む → 記録 → 版を決める → 入れ替え → 確認
うさうさ研修工房｜Dify nginx更新講座
4


# Page. 5

![Page Image](https://bcdn.docswell.com/page/GJ5ZGGXLE4.jpg)

STEP 2｜難易度 ●●●○○○○○○
診断の指摘を、3つに分けて読む
Q. 指摘の「どこの」nginxかを、確認しましたか？
整理
読み方は講師の整理。診断ツールごとの表示は、お使いのツールで確認する
1. どの版か
2. どこのものか
3. 直す版は何か
指摘された版（例：1.30.4）。
診断の出力から控える
ホストに入れたnginx？ Difyの
コンテナの中？ 別の機器？
診断の説明を鵜呑みにせず、
nginx公式で確認する（次のス
ライド）
答えの目安
版・場所・直す版。場所が違えば、この講座の対象外
うさうさ研修工房｜Dify nginx更新講座
5


# Page. 6

![Page Image](https://bcdn.docswell.com/page/9E2RYYX3JR.jpg)

STEP 2｜難易度 ●●●○○○○○○
nginx公式の勧告ページの読み方
Q. 「直す版」は、どこで決める？
公式
nginx security advisories（nginx.org。2026-11-20）。個別の内容は変わるため、この講座では固定しない
1. 一覧で探す
2. 系列ごとに見る
勧告ごとに、影響を受ける版（Vulnerable）と、受けない版（Not
vulnerable）が並ぶ
Not vulnerable に、系列ごとの「この版以上」が書かれる。自分の
系列の行を読む
3. 署名つきパッチ
4. 報告の窓口
パッチはPGP公開鍵で署名されると、ページに書かれている
セキュリティ問題の報告方法は、ページのリンク先に書かれている
答えの目安
自分の系列で「Not vulnerable」の版以上。値は最新の公式で確認
うさうさ研修工房｜Dify nginx更新講座
6


# Page. 7

![Page Image](https://bcdn.docswell.com/page/D7YDGG887M.jpg)

STEP 3｜難易度 ●●●●○○○○○
Difyの構成の中のnginx
Q. 更新に関係する設定は、どれ？
公式
Dify docker/docker-compose.yaml（GitHub）（2026-11-20）。サービスの一覧は、取得できた範囲
項目
公式の内容
更新での意味（講師の整理）
image
nginx:latest
版が固定されていない。pullで変わる
volumes
設定テンプレ・conf.d・エントリポイント・SSL証明
書のディレクトリ
設定はホスト側にある。入れ替えても残る
depends_on
api と web
nginxだけ更新しても、これらは触らない
ports
HTTP・HTTPSを環境変数でホスト側へ公開
入れ替え中は、入口が一時的に止まる
restart
always
落ちても自動で再起動する
うさうさ研修工房｜Dify nginx更新講座
7


# Page. 8

![Page Image](https://bcdn.docswell.com/page/VEN6GGQ9E8.jpg)

STEP 3｜難易度 ●●●●○○○○○
nginxイメージのタグの選び方
Q. 版を、どのタグで固定する？
公式
Docker Hub 公式 nginx イメージ（2026-11-20）。サポート期間・更新頻度の記載は、ページに無かった
タグ
公式の説明
講師の整理
latest／mainline
mainline系の現行版を指す
指す版が変わる。固定には向かない
stable／1.30
stable系。完全な版番号のタグもある
系列を保つなら、stable系の版固定が候補
1.30.7 のような固定タグ
完全な版番号で指定する
戻しやすい。記録もしやすい
alpine
Alpine Linuxベース。musl libcの注意あり
系統を変えると別の問題が出うる。変えない
-slim など
必要最小限のパッケージのみ
今のタグの系統を、まず保つ
うさうさ研修工房｜Dify nginx更新講座
8


# Page. 9

![Page Image](https://bcdn.docswell.com/page/Y79LWWD3J3.jpg)

STEP 4｜難易度 ●●●●●○○○○
入れ替える前に、残すもの
Q. 戻れる状態とは、何が残っていること？
整理
残す項目は講師の整理。Difyのバックアップは、公式のUpgrade手順に従う（前講座）
1
今の版
コンテナ内で版を表示し、メモする（nginx -v）
2
今のイメージ
imageのタグと、イメージIDを控える
3
設定の出力
docker compose config を保存（秘密を含むので非公開）
4
設定ファイル
docker/nginx の設定、.env、SSL証明書のディレクトリ
5
戻し方メモ
旧版のタグ。戻すときに使う
答えの目安
今の版・今のイメージ・設定・戻し方。この4つが戻れる状態
うさうさ研修工房｜Dify nginx更新講座
9


# Page. 10

![Page Image](https://bcdn.docswell.com/page/G78XNN3LED.jpg)

STEP 4｜難易度 ●●●●●○○○○
版を固定する：overrideファイル
Q. docker-compose.yaml を直接書き換えていい？
確認
Compose v5.6.1 のconfigで確認（2026-11-20）。merge規則は公式（Docker docs）
# dify/docker/docker-compose.override.yaml
services:
nginx:
image: nginx:1.30.7
公式
imageのような単一値は、後のファイルの値が前
の値を置き換える。configで最終の結果を確認で
きる
確認（この環境）
# 版の数字は例（ダミー）。公式で確認した値にする
# 確認：docker compose config | grep image
docker-compose.override.yaml と .yml の両方が
自動で読まれ、imageが置き換わった。-f無しで
も
講師の整理
本体のyamlを直すと、Difyの更新で衝突しうる。
別ファイルに分ける
答えの目安
ダメ。別ファイルで上書きする。本体のyamlは触らない
うさうさ研修工房｜Dify nginx更新講座
10


# Page. 11

![Page Image](https://bcdn.docswell.com/page/L7L8PPVQJR.jpg)

STEP 5｜難易度 ●●●●●●○○○
反映前に確認する：config と pull
Q. imageは、狙った版になっている？
公式
Docker docs（compose pull／up／merge）：pull は SERVICE を指定でき、コンテナは起動しない（2026-11-20）
# dify/docker で
docker compose config &gt; config.txt
python nginx_check.py --compose-config config.txt
# image: nginx:1.30.7（pinned）と出ればよい
公式
docker compose pull SERVICE は、そのサービ
スのイメージだけを取得する。コンテナは起動し
ない
確認
docker compose pull nginx
# nginxのイメージだけを取得。起動はしない
nginx_check.py は、ダミーのconfigで実行確認済
み。image行以外は表示しない
未確認
実際のDify環境でのpull。レジストリへの接続は
、お客様の環境の制限を確認
答えの目安
config で image を見て、pull nginx で、nginxだけ取得する
うさうさ研修工房｜Dify nginx更新講座
11


# Page. 12

![Page Image](https://bcdn.docswell.com/page/4EM644NK7W.jpg)

STEP 5｜難易度 ●●●●●●○○○
★チェックポイント1：入れ替えの準備
Q. 準備は、全部できている？
整理
チェック項目は講師の整理
調べた・残した
準備した
診断の指摘の版・場所・直す版を、控えた
overrideで、版を固定した
直す版を、nginx公式で確認した
config で、image を確認した
今の版・イメージ・戻し方を、控えた
pull nginx で、イメージを取得した
設定の保存ファイルを、非公開で保管した
Dify本体は、触っていない
答えの目安
全部にチェックできたら、ハンズオンへ。付かない項目は戻る
うさうさ研修工房｜Dify nginx更新講座
12


# Page. 13

![Page Image](https://bcdn.docswell.com/page/PERPWWD679.jpg)

STEP 6｜難易度 ●●●●●●●○○
判定を自動化：nginx_check.py
Q. なぜ、直す版の一覧を持たせない？
確認
実行確認済み（ダミーの入力で、試験7件に成功）。実際のDify・Dockerでは未実行
def judge(version, fixed):
same = [f for f in fixed if f[:2] == version[:2]]
if not same:
return {&quot;status&quot;: &quot;unknown&quot;, ...}
need = max(same)
if version &gt;= need:
return {&quot;status&quot;: &quot;ok&quot;, ...}
return {&quot;status&quot;: &quot;update&quot;, ...}
設計
系列（主.副）が同じ「直す版」と比べる。系列
が無ければ「不明」とする
設計
直す版は引数。公式の値は変わるので、ツールに
埋め込まない
安全
configの出力は秘密を含む。image行以外は表示
しない
答えの目安
公式の値は変わる。古い値を、ツールが持つと、誤判定するため
うさうさ研修工房｜Dify nginx更新講座
13


# Page. 14

![Page Image](https://bcdn.docswell.com/page/P7X3PP1DEX.jpg)

STEP 6｜難易度 ●●●●●●●○○
実行結果の読み方
Q. 「→ update」が出たら、どうする？
確認
実行確認済み（ダミー入力）。数字は例
$ python nginx_check.py --compose-config config.txt \
--version &quot;nginx version: nginx/1.30.4&quot; \
--fixed 1.30.7 1.31.9
image: nginx:latest（floating）latest は指す版が変わる…
版: 1.30.4 → update：直す版より古い: 1.30.7 以上が必要
# 終了コード 0=ok 1=update 2=unknown
update
直す版より古い。入れ替えの対象。STEP 7へ
ok
直す版以上。今回の指摘への対応は不要。診断の
再実施へ
unknown
系列が違う・版が読めない。公式で確認して、直
す版を渡し直す
答えの目安
updateは入れ替えの対象。okなら不要。unknownは公式で確認
うさうさ研修工房｜Dify nginx更新講座
14


# Page. 15

![Page Image](https://bcdn.docswell.com/page/37KYDD2DED.jpg)

STEP 7｜難易度 ●●●●●●●●●
入れ替える：nginxだけ
Q. up のとき、api や web は止まる？
公式
Docker docs（compose pull／up／merge）：--no-deps は、リンクされたサービスを起動しない（2026-11-20）
# dify/docker で（pull は済んでいる）
docker compose up -d --no-deps nginx
docker compose ps --all
docker compose exec nginx nginx -v
公式
--no-deps は、リンクされたサービスを起動しな
い。-d はバックグラウンド起動
未確認
# 版が、狙った版になっているか確認
サービス指定upの再作成の挙動は、公式に明記を
確認できず。psの作成時刻で確かめる
未確認
実Dify環境での入れ替えは未実行
答えの目安
--no-deps は、リンク先を起動しない。再作成の挙動は、自分の環境で確認
うさうさ研修工房｜Dify nginx更新講座
15


# Page. 16

![Page Image](https://bcdn.docswell.com/page/LJ39RR4PJ5.jpg)

STEP 7｜難易度 ●●●●●●●●●
うまくいったかの確認表
Q. 何を見れば、成功と言える？
整理
確認項目は講師の整理。コマンドは、お客様の環境で確認する
確認すること
方法の例
期待する状態
1版
docker compose exec nginx nginx -v
直す版以上（nginx_check.py でも）
2 起動
docker compose ps --all
nginxが起動中。他は変わらない
3 応答
ブラウザ、または curl -I で入口を見る
Difyの画面が表示される
4 ログ
docker compose logs nginx
エラーが続いていない
5 再診断
同じ診断を、もう一度実行
該当の指摘が消えた
うさうさ研修工房｜Dify nginx更新講座
16


# Page. 17

![Page Image](https://bcdn.docswell.com/page/8JDGYYQ3JG.jpg)

STEP 7｜難易度 ●●●●●●●●●
★チェックポイント2：更新完了
Q. 更新は、完了している？
整理
チェック項目は講師の整理
動いている
残した・伝えた
nginxの版が、直す版以上
再診断で、指摘が消えた（または理由を記録）
nginxが起動中で、他は変わっていない
overrideファイルを、残した
Difyの画面が、表示される
旧版の記録を、保管した
ログに、エラーが続いていない
未確認だった点を、お客様に伝えた
答えの目安
全部にチェックできたら完了。付かない項目は、戻して確認
うさうさ研修工房｜Dify nginx更新講座
17


# Page. 18

![Page Image](https://bcdn.docswell.com/page/VEP366LP78.jpg)

STEP 8｜難易度 ●●●○○○○○○
うまくいかないときの確認表
Q. いちばん最初に、何を見る？
整理
原因の候補と確認方法は講師の整理。公式の記述ではない
症状
原因の候補
最初の確認
nginxが起動しない
設定の誤り・版の差
docker compose logs nginx。コンテナ内で nginx -t
画面が出ない（502など）
api・webが起動していない
docker compose ps --all で他の状態を見る
版が戻っている
override が読まれていない
docker compose config | grep image
指摘が消えない
別の部品・別の機器の指摘
診断の対象と場所を、もう一度読む
Dify更新後に版が戻る
overrideが消えた／別の-f
overrideの有無と、config を確認
うさうさ研修工房｜Dify nginx更新講座
18


# Page. 19

![Page Image](https://bcdn.docswell.com/page/27V433QVEQ.jpg)

STEP 8｜難易度 ●●●○○○○○○
戻し方と、これからの運用
Q. 戻すとき、何を変える？
整理
戻し方と運用は講師の整理。実環境での手順確認は未実施
1
戻す
overrideのタグを、旧版（記録した版）に戻す
2
反映
docker compose up -d --no-deps nginx
3
確認
nginx -v と、画面の表示を見る
4
次回の対応
同じ手順で、直す版だけを変える
5
Dify更新
Dify本体の更新は別作業。overrideの扱いを確認
答えの目安
overrideのタグを旧版に戻して、up -d --no-deps nginx
うさうさ研修工房｜Dify nginx更新講座
19


# Page. 20

![Page Image](https://bcdn.docswell.com/page/5JG133W17L.jpg)

下山
ふりかえり：ここまで登ったあなたへ
Q. 今日の登山で、何が一番の発見でしたか？
【書く】わかったこと
【書く】自分の案件で使えそう
なこと
【書く】次にやること
1つだけ書く
具体的に
いつ・何を（例：来週、
nginx_check.py を案件の環境で動か
す）
ここまで来たあなたは、お客様に渡せる形で作れる人です
未確認を隠さず伝えることも、納品の一部です
うさうさ研修工房｜Dify nginx更新講座
20


# Page. 21

![Page Image](https://bcdn.docswell.com/page/47QD553NEP.jpg)

下山
出典と、確認状況
Q. 迷ったら、最新の公式に戻れていますか？
公式
確認日 2026-11-20
nginx security advisories
nginx.org/en/security_advisories.html
確認済
1. 実際のDify環境での、nginxの入れ替え
Docker Hub 公式 nginx イメージ
hub.docker.com/_/nginx
確認済
Dify docker-compose.yaml
github.com/langgenius/dify/blob/main/docker/docker-compose.yaml
確認済
docker compose pull／up
docs.docker.com/reference/cli/docker/compose/
確認済
Merge Compose files
docs.docker.com/compose/how-tos/multiple-compose-files/merge
うさうさ研修工房｜Dify nginx更新講座
未確認（お客様に出す前に確認）
確認済
2. サービス指定upの再作成の挙動（公式に明記
を確認できず）
3. Dify公式のnginx単独更新の手順（確認できず
）
4. HTTPS・certbot構成での動作
5. Difyの.envとnginxの設定の読み込みの詳細（
取得が途中で切れた）
6. 勧告の個別内容（講座では固定しない。原文
で確認）
21


