---
title: Dify_nginx入門講座_講師用 (2)
tags: 
author: [Yukiko](https://docswell.com/user/yukiko_it)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/DJYDGZK6JM.jpg?width=480
description: Dify_nginx入門講座_講師用 (2) by Yukiko
published: November 20, 26
canonical: https://docswell.com/s/yukiko_it/ZX2JRM-2026-11-20-212803
---
# Page. 1

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

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


# Page. 2

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

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


# Page. 3

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

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


# Page. 4

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

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


# Page. 5

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

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


# Page. 6

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

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


# Page. 7

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

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


# Page. 8

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

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


# Page. 9

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

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


# Page. 10

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

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


# Page. 11

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

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


# Page. 12

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

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


# Page. 13

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

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


# Page. 14

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

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


# Page. 15

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

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


# Page. 16

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

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


# Page. 17

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

STEP 6｜難易度 ●●●●●●●○○
診断に見える面を、一覧にする
Q. 「注意」は、何を意味する？
確認
ダミーの設定で、試験5件に成功。本物のDifyでは未実行
$ docker compose config &gt; 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


# Page. 18

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

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


# Page. 19

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

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


# Page. 20

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

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


# Page. 21

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

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


# Page. 22

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

下山
出典と、確認状況
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


