-- Views
November 20, 26
スライド概要
はじめまして、yukikoと申します。 IT教育支援や、DX推進が可能です。 ◆ スキル LPIC レベル2 AI / Python Splunk BI(データ可視化・分析) ◆ その他 新卒・未経験の学生向けに、エンジニア転職を応援する資料を趣味で作成しています。 もしよろしければご活用ください。
法人研修レベル|脆弱性対応|公式参考 講師用(スピーカーノート付き) ★ Dify nginx 更新講座 (nginxだけ) ★ Q. 戻れる形で、nginxだけを入れ替えられますか? Q. 公式で確認したことと、未確認のことを、分けて言えますか? STEP 1 → 8 公式確認日 2026-11-20|うさうさ研修工房
スタート この講座の約束と、確認状況の見方 Q. 「公式」と「講師の整理」を、見分けられますか? 整理 札の使い方は講師の整理 公式 講師の整理 確認 未確認 公式ドキュメントで確認 した事実。ページ名と確 認日を付ける 講師の解釈・設計案。公 式の記述ではない この教材の環境で、実際 に動かして確かめた 確かめていない。お客様 に出す前に、自分の環境 で確認する 答えの目安 各スライドの上の色の札で、確認状況が分かる うさうさ研修工房|Dify nginx更新講座 2
STEP 1|難易度 ●○○○○○○○○ 何を、どこまで更新するか Q. 更新するのは、Difyですか? nginxですか? 整理 範囲の切り分けは講師の整理。Difyの公式の更新手順とは別の作業 更新する 更新しない 残す nginxのコンテナ(イメージ) だけ。入口の役割をするとこ ろ Dify本体(api・web・worker ・DBなど)。今回は触らない 設定(.env・nginx設定)、デ ータ(volumes)。戻れる状態 も残す 答えの目安 nginxだけ。Dify本体と設定・データは、触らない うさうさ研修工房|Dify nginx更新講座 3
STEP 1|難易度 ●○○○○○○○○ 更新の全体の流れ:5ステップ Q. どの順番で進める? 整理 流れは講師の整理。個々の公式の確認は、後のスライドで 1 診断を読む 2 記録と退避 3 版を決める 4 入れ替え 5 確認 どの版?どこの? 版・設定を残す 公式で確認 pull → up 版・応答・再診断 守ること:Dify本体の更新と混ぜない。戻せる状態(今の版の記録)を先に作る 答えの目安 読む → 記録 → 版を決める → 入れ替え → 確認 うさうさ研修工房|Dify nginx更新講座 4
STEP 2|難易度 ●●●○○○○○○ 診断の指摘を、3つに分けて読む Q. 指摘の「どこの」nginxかを、確認しましたか? 整理 読み方は講師の整理。診断ツールごとの表示は、お使いのツールで確認する 1. どの版か 2. どこのものか 3. 直す版は何か 指摘された版(例:1.30.4)。 診断の出力から控える ホストに入れたnginx? Difyの コンテナの中? 別の機器? 診断の説明を鵜呑みにせず、 nginx公式で確認する(次のス ライド) 答えの目安 版・場所・直す版。場所が違えば、この講座の対象外 うさうさ研修工房|Dify nginx更新講座 5
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
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
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
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
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
STEP 5|難易度 ●●●●●●○○○ 反映前に確認する:config と pull Q. imageは、狙った版になっている? 公式 Docker docs(compose pull/up/merge):pull は SERVICE を指定でき、コンテナは起動しない(2026-11-20) # dify/docker で docker compose config > 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
STEP 5|難易度 ●●●●●●○○○ ★チェックポイント1:入れ替えの準備 Q. 準備は、全部できている? 整理 チェック項目は講師の整理 調べた・残した 準備した 診断の指摘の版・場所・直す版を、控えた overrideで、版を固定した 直す版を、nginx公式で確認した config で、image を確認した 今の版・イメージ・戻し方を、控えた pull nginx で、イメージを取得した 設定の保存ファイルを、非公開で保管した Dify本体は、触っていない 答えの目安 全部にチェックできたら、ハンズオンへ。付かない項目は戻る うさうさ研修工房|Dify nginx更新講座 12
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 {"status": "unknown", ...}
need = max(same)
if version >= need:
return {"status": "ok", ...}
return {"status": "update", ...}
設計
系列(主.副)が同じ「直す版」と比べる。系列
が無ければ「不明」とする
設計
直す版は引数。公式の値は変わるので、ツールに
埋め込まない
安全
configの出力は秘密を含む。image行以外は表示
しない
答えの目安
公式の値は変わる。古い値を、ツールが持つと、誤判定するため
うさうさ研修工房|Dify nginx更新講座
13
STEP 6|難易度 ●●●●●●●○○ 実行結果の読み方 Q. 「→ update」が出たら、どうする? 確認 実行確認済み(ダミー入力)。数字は例 $ python nginx_check.py --compose-config config.txt \ --version "nginx version: nginx/1.30.4" \ --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
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
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
STEP 7|難易度 ●●●●●●●●● ★チェックポイント2:更新完了 Q. 更新は、完了している? 整理 チェック項目は講師の整理 動いている 残した・伝えた nginxの版が、直す版以上 再診断で、指摘が消えた(または理由を記録) nginxが起動中で、他は変わっていない overrideファイルを、残した Difyの画面が、表示される 旧版の記録を、保管した ログに、エラーが続いていない 未確認だった点を、お客様に伝えた 答えの目安 全部にチェックできたら完了。付かない項目は、戻して確認 うさうさ研修工房|Dify nginx更新講座 17
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
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
下山 ふりかえり:ここまで登ったあなたへ Q. 今日の登山で、何が一番の発見でしたか? 【書く】わかったこと 【書く】自分の案件で使えそう なこと 【書く】次にやること 1つだけ書く 具体的に いつ・何を(例:来週、 nginx_check.py を案件の環境で動か す) ここまで来たあなたは、お客様に渡せる形で作れる人です 未確認を隠さず伝えることも、納品の一部です うさうさ研修工房|Dify nginx更新講座 20
下山 出典と、確認状況 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