Dify_nginx入門講座_講師用 (2)

>100 Views

November 20, 26

スライド概要

profile-image

はじめまして、yukikoと申します。 IT教育支援や、DX推進が可能です。 ◆ スキル LPIC レベル2 AI / Python Splunk BI(データ可視化・分析) ◆ その他 新卒・未経験の学生向けに、エンジニア転職を応援する資料を趣味で作成しています。 もしよろしければご活用ください。

シェア

またはPlayer版

埋め込む »CMSなどでJSが使えない場合

(ダウンロード不可)

関連スライド

各ページのテキスト
1.

法人研修レベル|脆弱性対応|公式参考 講師用(スピーカーノート付き) ★ Dify nginx 入門講座 (仕組みと関係) ★ Q. Dify の中で、nginx は何をしていますか? Q. 診断で、どこを見ればよいですか? STEP 1 → 8 公式確認日 2026-11-20|うさうさ研修工房

2.

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

3.

STEP 1|難易度 ●○○○○○○○○ Dify は、複数のコンテナの集まり Q. Difyは、1つのプログラムですか? 公式 Dify docker-compose.yaml(GitHub)。取得できた範囲のサービス名 画面と処理 データ 安全のため 入口 web(画面)、api(処理 )、worker(裏の処理) db_postgres・db_mysql 、redis、weaviate など sandbox、ssrf_proxy な ど nginx。利用者が最初に届 く場所 答えの目安 違う。複数のコンテナが、連携して動く 出典:github.com/langgenius/dify docker/docker-compose.yaml(2026-11-20)。取得が途中で切れ、全サービスの一覧は未確認 うさうさ研修工房|Dify nginx入門講座 3

4.

STEP 1|難易度 ●○○○○○○○○ なぜ、入口に nginx を置くのか Q. 入口が無いと、何が困る? 整理 設計意図は講師の整理。Dify開発元の意図を書いた公式の記述は、確認できなかった 1. 入口を1つにする 2. 振り分ける 3. 入口で設定する 利用者が届くのは、80番と443 番だけ。api・webの内部ポー トは、外に見せない(公式 yamlの公開ポートより) 画面はweb、処理はapiへ。利 用者は、どちらも同じアドレ スで使える HTTPS、アップロードの上限 、待ち時間を、入口でまとめ て決められる 答えの目安 入口が複数になる。設定も、バラバラになる 出典:講師の整理。参考:docs.dify.ai(troubleshooting/docker-issues):nginx は api:5001 と web:3000 へ転送 うさうさ研修工房|Dify nginx入門講座 4

5.

STEP 2|難易度 ●●●○○○○○○ nginx とは(公式の説明) Q. nginxは、ただのWebサーバーですか? 公式 nginx.org(公式) 公式の説明 リバースプロキシとは Difyでは HTTPのWebサーバー、リバー スプロキシ、コンテンツキャ ッシュ、ロードバランサー、 TCP/UDPプロキシ、メールプ ロキシ リクエストを、別のサーバー に送り、応答を取得して、ク ライアントに返す(公式の管 理ガイド) リバースプロキシとして、api ・webへ転送する(Difyの公式 ドキュメントの説明) 答えの目安 いいえ。Difyでは、リバースプロキシとして使われている 出典:nginx.org/en/(2026-11-20)。Difyでの使われ方:docs.dify.ai troubleshooting うさうさ研修工房|Dify nginx入門講座 5

6.

STEP 2|難易度 ●●●○○○○○○ Dify の nginx サービス(公式の定義) Q. どの設定が、入口の性格を決めている? 公式 Dify docker-compose.yaml(GitHub)。取得できた範囲 項目 公式の内容 意味(講師の整理) image nginx:latest 公式の nginx イメージ。版は固定されない ports 80:80、443:443(EXPOSE_NGINX_PORT などで変更可) 外から届く入口 depends_on api、web 転送先。起動の順の依存 volumes 設定テンプレート(nginx.conf・proxy.conf・https.conf) 、conf.d、起動スクリプト、証明書のディレクトリ 設定は、ホスト側のファイルから取り込む restart always 落ちても自動で再起動 出典:github.com/langgenius/dify docker/docker-compose.yaml(2026-11-20)。右列は講師の整理 うさうさ研修工房|Dify nginx入門講座 6

7.

STEP 2|難易度 ●●●○○○○○○ 設定は、環境変数で変わる Q. どの値が、診断に関係する? 公式 既定値はDify docker-compose.yaml。nginx自体の既定はnginx.org。変数ごとの意味は、Difyのenvドキュメントで確認(今回は未確認) 環境変数 Difyの既定(公式yaml) 診断との関係(講師の整理) NGINX_HTTPS_ENABLED false HTTPSが有効でない構成は、指摘されうる NGINX_SSL_PROTOCOLS TLSv1.2 TLSv1.3 古いTLSが無いかを見る NGINX_CLIENT_MAX_BODY_SIZE 100M(nginxの既定は1m) 超えると413。業務に合う値かを見る NGINX_PROXY_READ/ SEND_TIMEOUT 3600s 待ち時間が長い。意図した値かを見る NGINX_SERVER_NAME _ 公開するホスト名の設定。値の意味は未確認 出典:github.com/langgenius/dify docker/docker-compose.yaml(既定値)、nginx.org/en/docs/http/ngx_http_core_module.html(client_max_body_size)。右列は講師の整理 うさうさ研修工房|Dify nginx入門講座 7

8.

STEP 2|難易度 ●●●○○○○○○ Dify の中の、nginx の位置 Q. 外から、直接届くのは、どこ? 公式 公開ポートはDify docker-compose.yaml(取得範囲)。転送先はdocs.dify.ai 利用者 nginx web api DB・redis ブラウザ 80 / 443 画面 :3000 処理 :5001 内部のみ 取得できた範囲で、ホストへ公開しているのは nginx の80・443と、plugin_daemon のデバッグ用ポート(既定 5003)。パスごとの振り分けは、設定テンプレートを取得できず、未確認 出典:github.com/langgenius/dify docker/docker-compose.yaml(公開ポート)、docs.dify.ai troubleshooting(転送先)。パスごとの振り分けは未確認 うさうさ研修工房|Dify nginx入門講座 8

9.

STEP 3|難易度 ●●●●○○○○○ リクエストが通る流れ Q. リクエストは、どの順で通る? 公式 nginx 管理ガイド(Reverse Proxy)。転送先の決まり方は講師の整理 1 1 接続 利用者が、サーバーの80番か443番に接続する 2 2 受ける nginx が、リクエストを受け取る 3 3 決める 設定の location の条件で、転送先を決める(講師の整理) 4 4 転送 proxy_pass で、api または web に送る(公式) 5 5 返す 応答を受け取り、利用者に返す(公式) 答えの目安 接続 → 受ける → 決める → 転送 → 返す 出典:nginx.org 管理ガイド(Reverse Proxy)。2・3は講師の整理 うさうさ研修工房|Dify nginx入門講座 9

10.

STEP 3|難易度 ●●●●○○○○○ proxy_pass とヘッダー(公式) Q. proxy_pass は、何をする? 公式 nginx 管理ガイド(Reverse Proxy)。例の中身は説明用。Difyの設定そのものではない location /some/path/ { proxy_pass http://www.example.com/link/; proxy_set_header Host $host; } # 意味:/some/path/page.html は、 # http://www.example.com/link/page.html に渡される 公式 proxy_pass で転送先を指定。URIを付けると、一 致した部分が置き換わる 公式 既定で Host と Connection が変わる。 proxy_set_header で変えられる 未確認 Difyの設定(default.conf.template)の中身は、 取得できなかった 答えの目安 リクエストを別のサーバーに送り、応答を返す 出典:docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/(2026-11-20)。Difyの実際の設定は未確認 うさうさ研修工房|Dify nginx入門講座 10

11.

STEP 3|難易度 ●●●●○○○○○ 設定ができあがるまで Q. 設定は、どこから来る? 公式 Dify docker-compose.yaml(取得範囲)。テンプレートから設定を作る詳細は未確認 1. テンプレート 2. 環境変数 3. 起動スクリプト ホスト側の設定テンプレート (nginx.conf・proxy.conf・ https.conf・conf.d)を、 volumes で取り込む NGINX_* の値が、compose の environment で渡される entrypoint が、スクリプトを コピーし、改行コードを直し て、実行する 答えの目安 テンプレート・環境変数・起動スクリプトの3つ。生成の詳細は未確認 出典:github.com/langgenius/dify docker/docker-compose.yaml(volumes・entrypoint・environment)。生成の詳細は未確認 うさうさ研修工房|Dify nginx入門講座 11

12.

STEP 3|難易度 ●●●●○○○○○ 困ったときの典型:4つ Q. 症状から、仕組みが言える? 公式 Difyの公式 troubleshooting/nginx.org。対処は公式の案内の要約 症状 仕組み 出典 502 Bad Gateway nginx が、誤ったコンテナのIPへ転送。IPを直して、再 起動かリロード Dify 公式 413 エラー リクエストが、client_max_body_size を超えた nginx.org 80番ポートが使用中 競合するサービスを止めるか、ポートの割り当てを変え る Dify 公式 nginx.conf のマウント失敗 dify/docker から実行していない Dify 公式 出典:docs.dify.ai(self-host/troubleshooting/docker-issues)、nginx.org(client_max_body_size)。2026-11-20 うさうさ研修工房|Dify nginx入門講座 12

13.

STEP 4|難易度 ●●●●●○○○○ ★チェックポイント1:仕組みを言える Q. 仕組みは、説明できる? 整理 チェック項目は講師の整理 Why・What How 入口に nginx を置く理由を、3つ言える リクエストの流れを、5つで言える nginx の公式の説明を、言える proxy_pass の役割を、言える Dify の nginx の image・ports・depends_on を言え る 502・413・ポート競合の仕組みを言える 答えの目安 全部にチェックできたら、診断のポイントへ。付かない項目は戻る 出典:講師の整理 うさうさ研修工房|Dify nginx入門講座 13

14.

STEP 5|難易度 ●●●●●●○○○ 脆弱性診断は、何を見ているか Q. 診断は、Difyのどこに届く? 整理 診断の見方は講師の整理。診断ツールごとの動きは、お使いのツールで確認 1. 開いている入口 2. 見える情報 3. 通信の設定 4. 中身の版 外から届くポート。Dify では、80・443が中心 Serverヘッダーやエラー ページの版( server_tokens 既定はon 。公式) HTTPSか。TLSの版は何 か nginxの版や、イメージの 中のパッケージの版(コ ンテナの診断のとき) 答えの目安 外から届く面(ポート・表示・通信・版) 出典:講師の整理。server_tokens:nginx.org/en/docs/http/ngx_http_core_module.html うさうさ研修工房|Dify nginx入門講座 14

15.

STEP 5|難易度 ●●●●●●○○○ Dify の nginx の診断ポイント表 Q. 指摘されたら、何を確認する? 整理 「Difyの既定」は公式yamlの取得範囲。右列の対応の考え方は講師の整理 診断ポイント Difyの既定(公式yaml) 確認と対応の考え方 nginxの版 image: nginx:latest nginx -v で実際の版を見て、勧告で直す版を確認(更 新編) 公開ポート nginxの80・443、plugin_daemonの5003 外から届く必要があるか。不要なら公開範囲を絞る HTTPS・TLS HTTPS無効、TLS 1.2・1.3 外部に公開するなら、HTTPSの有効化を検討 版の表示 server_tokens は既定on(nginx公式) offで隠せるが、脆弱性は直らない アップロード上限 Dify 100M(nginx既定は1m) 業務に合う値か。大きいほど、受ける負荷も増える 他の部品 api・web・DB・ssrf_proxyなど nginxの診断とは別。部品ごとに範囲を切る 出典:github.com/langgenius/dify docker/docker-compose.yaml、nginx.org(server_tokens・client_max_body_size)。右列は講師の整理 うさうさ研修工房|Dify nginx入門講座 15

16.

STEP 5|難易度 ●●●●●●○○○ 版を隠しても、直ったことにならない Q. server_tokens off で、脆弱性は直る? 公式 nginx.org(ngx_http_core_module)。Difyでの設定方法は未確認 # nginx 公式の説明(要約) server_tokens off; # 意味:エラーページと Server ヘッダーに、 # nginxの版を出さない # 既定は on(版を出す) 公式 server_tokens の既定は on。エラーページと Server ヘッダーに版を出す 講師の整理 隠すと、診断が版を読めなくなるだけ。直すのは 、版を上げること(更新編) 未確認 Difyのnginxへ足す方法は、確認できなかった 答えの目安 直らない。版を隠すだけ。直すのは、版を上げること 出典:nginx.org/en/docs/http/ngx_http_core_module.html(server_tokens)(2026-11-20)。右の整理は講師 うさうさ研修工房|Dify nginx入門講座 16

17.

STEP 6|難易度 ●●●●●●●○○ 診断に見える面を、一覧にする Q. 「注意」は、何を意味する? 確認 ダミーの設定で、試験5件に成功。本物のDifyでは未実行 $ docker compose config > config.txt # 最終の設定を保存(秘密を含みうる) $ python surface_check.py config.txt [事実] nginx の image: nginx:latest [注意] image のタグが、指す版の変わるもの。…nginx -v で突き合わせる [事実] ホストへ公開: nginx の 80 / 443 [事実] ホストへ公開: plugin_daemon の 5003 [注意] nginx 以外(plugin_daemon)が…ポート 5003 を公開… [注意] NGINX_HTTPS_ENABLED=false。HTTPS が有効でない… [事実] NGINX_CLIENT_MAX_BODY_SIZE=100M(nginx 自体の既定は 1m) 設計 image・公開ポート・nginxの設定の一部だけを 表示。他の環境変数は、読まず、表示しない 確認 ダミーのDify風config(5サービス)で実行。 SECRET_KEYが出ないことも試験した 未確認 本物のDifyの設定での実行 答えの目安 注意は、診断で指摘されうる所。直すかは、使い方で決める 出典:確認:surface_check.py(この教材。ダミーのconfigで試験)。docker compose config は Docker docs うさうさ研修工房|Dify nginx入門講座 17

18.

STEP 6|難易度 ●●●●●●●○○ 出力の読み方と、次の一手 Q. 注意が出たら、次に何をする? 整理 次の一手は講師の整理。診断の結論は、お客様の使い方と合意して決める 出力 次の一手 関連 image のタグが、指す版の変わるもの nginx -v で実際の版を確認し、勧告で直す版と比 べる 更新編 nginx 以外が、ポートを公開 必要か確認。不要なら、公開範囲を絞る 公開ポート HTTPS が有効でない 外部公開か、内部のみかを確認。外部なら、有効 化を検討 HTTPS・TLS 古い TLS/SSL が含まれる プロトコルの設定を見直す HTTPS・TLS 上限(100M) 業務で必要な大きさか確認 アップロード上限 出典:講師の整理。更新編は、同シリーズの別講座 うさうさ研修工房|Dify nginx入門講座 18

19.

STEP 7|難易度 ●●●●●●●●● ★チェックポイント2:診断に使える Q. 診断のポイントを、説明できる? 整理 チェック項目は講師の整理 説明できる 使える 診断が見る4つの面を、言える surface_check.py を、ダミーで実行できた 版を隠しても、直らない理由を言える 出力から、次の一手を言える 公開ポートを、確認する理由を言える 本物の config は、人に見せない 答えの目安 全部にチェックできたら、まとめへ。付かない項目は戻る 出典:講師の整理 うさうさ研修工房|Dify nginx入門講座 19

20.

STEP 8|難易度 ●●●○○○○○○ Dify の更新と、nginx の更新 Q. 2つの更新は、何が違う? 整理 違いの整理は講師。Dify公式の、nginx単独更新の手順は確認できなかった Dify 本体の更新 nginx だけの更新 対象 Dify全体(api・web など) nginx のコンテナだけ 手順の出典 前講座(Difyの公式のUpgrade手順) 更新編(講師の整理。公式に単独更新の手順は未確 認) image の扱い yamlの版が変わる(git checkout) overrideで版を固定。yamlは触らない 注意 .envの比較、バックアップ、DBの移行 戻し先を版番号で記録。再診断 出典:DifyのUpgrade手順は前講座(公式)。nginxだけの更新は更新編(講師の整理)。image: github.com/langgenius/dify docker/docker-compose.yaml うさうさ研修工房|Dify nginx入門講座 20

21.

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

22.

下山 出典と、確認状況 Q. 迷ったら、最新の公式に戻れていますか? 公式 確認日 2026-11-20 nginx 公式サイト(nginxとは) nginx.org/en/ 確認済 未確認(お客様に出す前に確認) 確認済 1. Difyの設定テンプレート(パスごとの振り分 け) NGINX Reverse Proxy(管理ガイド) docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/ ngx_http_core_module(server_tokens等) nginx.org/en/docs/http/ngx_http_core_module.html 確認済 Dify docker-compose.yaml github.com/langgenius/dify/blob/main/docker/docker-compose.yaml 一部確認 4. NGINX_* 各変数の意味(Dify envドキュメン ト) 5. server_tokens をDifyに設定する方法 6. 本物のDifyでの surface_check.py Dify docker issues(troubleshooting) docs.dify.ai/en/self-host/troubleshooting/docker-issues 2. docker-compose.yaml の全サービス(取得が 途中で切れた) 3. テンプレートから設定を作る仕組みの詳細 確認済 nginx security advisories nginx.org/en/security_advisories.html 確認済 出典:確認日 2026-11-20 うさうさ研修工房|Dify nginx入門講座 22