Man page - nginx(8)
Packages contains this manual
Available languages:
en jaManual
NGINX (8) System Manager’s Manual NGINX (8)
名 前
nginx — HTTP お よ び リ バ ー ス プ ロ キ シ ー サ ー バ ー 、 メ ー ル プ ロ キ シ ー サ ー バ ー
書 式
[ -?hqTtVv ] [ -c file ] [ -e file ] [ -g directives ] [ -p prefix ] [ -s signal ]
説 明
(発 音 は “engine x”) は 、 HTTP お よ び リ バ ー ス プ ロ キ シ ー サ ー バ ー 、 メ ー ル プ ロ キ シ ー サ ー バ ー 、 汎 用 的 な TCP/UDP プ ロ キ シ ー サ ー バ ー で す 。 高 性 能 、 安 定 性 、 豊 富 な 機 能 セ ッ ト 、 簡 単 な 設 定 、 リ ソ ー ス の 低 消 費 と い う 特 徴 が 知 ら れ て い ま す 。
オ プ シ ョ ン は 以 下 の と お り で す 。
-? , -h
ヘ ル プ を 表 示 し ま す 。
-c file
別 の 設 定 フ ァ イ ル と し て file を 用 い ま す 。
-e file
別 の エ ラ ー ロ グ と し て file を 用 い ま す 。 特 別 な 設 定 値 stderr が あ っ て 、 こ れ は 標 準 エ ラ ー へ の 出 力 が 行 わ れ ま す 。
-g directives
グ ロ ー バ ル 設 定 デ ィ レ ク テ ィ ブ を 設 定 し ま す 。 “例 ” の セ ク シ ョ ン を 参 照 し て く だ さ い 。
-p prefix
プ レ フ ィ ッ ク ス パ ス を 設 定 し ま す 。 デ フ ォ ル ト は /usr で す 。
-q
設 定 テ ス ト を 行 う 際 、 エ ラ ー で は な い メ ッ セ ー ジ は 省 略 し ま す 。
-s signal
マ ス タ ー プ ロ セ ス に シ グ ナ ル を 送 信 し ま す 。 引 数 signal に は 、 stop , quit , reopen , reload の い ず れ か を 指 定 し ま す 。 以 下 に 示 す 一 覧 は 、 こ れ に 対 応 す る シ ス テ ム シ グ ナ ル で す 。
stop
SIGTERM
quit
SIGQUIT
reopen
SIGUSR1
reload
SIGHUP
-T
-t と 同 様 で す 。 た だ し こ れ に 加 え て 、 設 定 フ ァ イ ル 内 容 を 標 準 出 力 に 書 き 出 し ま す 。
-t
実 行 は 行 わ ず に 、 設 定 フ ァ イ ル の テ ス ト だ け を 行 い ま す 。 は 、 設 定 フ ァ イ ル の 文 法 チ ェ ッ ク を 行 い 、 設 定 フ ァ イ ル 内 か ら 参 照 さ れ て い る フ ァ イ ル の 読 み 込 み を 試 し ま す 。
-V
の バ ー ジ ョ ン 、 コ ン パ イ ラ ー バ ー ジ ョ ン 、 configure ス ク リ プ ト の パ ラ メ ー タ ー を 表 示 し ま す 。
-v
の バ ー ジ ョ ン を 表 示 し ま す 。
シ グ ナ ル
の マ ス タ ー プ ロ セ ス は 、 以 下 の シ グ ナ ル を 取 り 扱 い ま す 。
SIGINT, SIGTERM
す ぐ に シ ャ ッ ト ダ ウ ン し ま す 。
SIGHUP
設 定 を 再 ロ ー ド し て 、 新 た な 設 定 を 用 い た 新 た な ワ ー カ ー プ ロ セ ス を 起 動 し ま す 。 そ し て 古 い ワ ー カ ー プ ロ セ ス は 、 適 切 に シ ャ ッ ト ダ ウ ン し ま す 。
SIGQUIT
適 切 に シ ャ ッ ト ダ ウ ン し ま す 。
SIGUSR1
ロ グ フ ァ イ ル を 開 き 直 し ま す 。
SIGUSR2
実 行 フ ァ イ ル を そ の 場 で ア ッ プ グ レ ー ド し ま す 。
SIGWINCH
ワ ー カ ー プ ロ セ ス を 適 切 に シ ャ ッ ト ダ ウ ン し ま す 。
ワ ー カ ー プ ロ セ ス に 対 し て 、 通 常 の 制 御 を 明 示 的 に 行 う 必 要 が な い 場 合 に は 、 さ ら に 以 下 の シ グ ナ ル も サ ポ ー ト し て い ま す 。
SIGTERM
す ぐ に シ ャ ッ ト ダ ウ ン し ま す 。
SIGQUIT
適 切 に シ ャ ッ ト ダ ウ ン し ま す 。
SIGUSR1
ロ グ フ ァ イ ル を 開 き 直 し ま す 。
デ バ ッ グ ロ グ
デ バ ッ グ ロ グ を 有 効 に す る に は 、 デ バ ッ グ 機 能 が 含 ま れ る よ う に ビ ル ド を 再 構 成 し ま す 。
./configure --with-debug ...
そ し て error_log の ロ グ レ ベ ル を debug に 設 定 し ま す 。
error_log /path/to/log debug;
特 定 の IP ア ド レ ス に 対 し て 、 デ バ ッ グ を 有 効 に す る こ と も で き ま す 。
events {
|
debug_connection 127.0.0.1; |
}
環 境 変 数
環 境 変 数 NGINX は 、 が 内 部 で 利 用 し て い ま す 。 こ れ は ユ ー ザ ー が 直 接 設 定 す る も の で は あ り ま せ ん 。
フ ァ イ
ル
/var/run/nginx.pid
の プ ロ セ ス ID を 保 持 し ま す 。 こ の フ ァ イ ル の 内 容 は 機 密 情 報 で は な い た め 、 だ れ で も 見 る こ と が で き ま す (world-readable で す )。
/etc/nginx/nginx.conf
メ イ ン の 設 定 フ ァ イ ル 。
/var/log/error.log
エ ラ ー ロ グ フ ァ イ ル 。
終 了 ス テ ー タ ス
終 了 ス テ ー タ ス は 、 正 常 処 理 時 に 0、 処 理 失 敗 時 に 1 で す 。
例
テ ス ト の 設 定 フ ァ イ ル と し て ˜/mynginx.conf を 指 定 し ま す 。 そ し て PID に 対 す る グ ロ ー バ ル デ ィ レ ク テ ィ ブ を 用 い て 、 ワ ー カ ー プ ロ セ ス 量 を 設 定 し ま す 。
nginx -t -c ˜/mynginx.conf \
|
-g "pid /var/run/mynginx.pid; worker_processes 2;" |
関 連 項 目
ド キ ュ メ ン ト : http://nginx.org/en/docs/
疑 問 や 技 術 サ ポ ー ト の 必 要 が あ る 場 合 は 、 http://nginx.org/en/support.html に 問 い 合 わ せ て く だ さ い 。
開 発 経 緯
の 開 発 は 2002 年 に 開 始 し ま し た 。 初 め て の 公 開 版 は 2004 年 10 月 4 日 に リ リ ー ス し て い ま す 。
著 者
Igor Sysoev < igor@sysoev.ru >
こ の マ ニ ュ ア ル ペ ー ジ は 、 も と も と は Sergey A. Osokin < osa@FreeBSD.org.ru > が 、 世 界 中 か ら 寄 せ ら れ た の ド キ ュ メ ン ト を 取 り ま と め た 結 果 と し て 記 述 し ま し た 。 Debian 2020/11/05 NGINX (8)