Nginx - 版の履歴

Kgx: /* ヒントとテクニック */ 同期

2024-12-28T01:02:33Z

ヒントとテクニック: 同期

← 古い版		2024年12月28日 (土) 10:02時点における版
740行目:		740行目:

	基本認証ではパスワードファイルの作成が必要です。パスワードファイルは、{{Pkg\|apache}} パッケージで提供される {{ic\|htpasswd}} プログラムを使用するか、{{ic\|nginx-passwd}} を提供する {{AUR\|nginx_passwd}} を使用して管理できます。詳細は、次のサイトで確認できます。 [https://github.com/gene-git/nginx_passwd github ソース]		基本認証ではパスワードファイルの作成が必要です。パスワードファイルは、{{Pkg\|apache}} パッケージで提供される {{ic\|htpasswd}} プログラムを使用するか、{{ic\|nginx-passwd}} を提供する {{AUR\|nginx_passwd}} を使用して管理できます。詳細は、次のサイトで確認できます。 [https://github.com/gene-git/nginx_passwd github ソース]

			=== php-legacy の使用 ===

			{{Pkg\|php-fpm}} の代わりに {{Pkg\|php-legacy-fpm}} を [[インストール]] し、[[PHP]] が正しくインストールされ、設定されていることを確認してください。

			PHP-LEGACY-FPM の主な設定ファイルは {{ic\|/etc/php-legacy/php-fpm.conf}} です。基本的な使い方はデフォルトの設定で十分でしょう。

			{{ic\|fastcgi_pass}} 引数の Unix ソケットも調整する必要があります。通常は次のようになります:

			fastcgi_pass unix:/run/php-fpm-legacy/php-fpm.sock;

			次に、{{ic\|php-legacy-fpm.service}} を [[起動/有効化]] して下さい。

	== トラブルシューティング ==		== トラブルシューティング ==

Kusanaginoturugi: 校正（でき・出来）

2024-07-10T11:38:17Z

校正（でき・出来）

← 古い版		2024年7月10日 (水) 20:38時点における版
406行目:		406行目:
	== chroot でインストール ==		== chroot でインストール ==

	[[chroot]] に Nginx をインストールすることでセキュリティレイヤーを追加することができます。セキュリティを最大限に高めるために、Nginx サーバーを動かすのに必要なファイルだけを入れて、全てのファイルは出来る限り最小限の権限にします。例えば、なるべく root が所有するようにして、{{ic\|/usr/bin}} などのディレクトリは読み書きできないようにするなど。		[[chroot]] に Nginx をインストールすることでセキュリティレイヤーを追加することができます。セキュリティを最大限に高めるために、Nginx サーバーを動かすのに必要なファイルだけを入れて、全てのファイルはできる限り最小限の権限にします。例えば、なるべく root が所有するようにして、{{ic\|/usr/bin}} などのディレクトリは読み書きできないようにするなど。

	Arch はデフォルトでサーバーを実行するための {{ic\|http}} ユーザーとグループが設定されています。chroot は {{ic\|/srv/http}} で動作させます。		Arch はデフォルトでサーバーを実行するための {{ic\|http}} ユーザーとグループが設定されています。chroot は {{ic\|/srv/http}} で動作させます。

Kgx: /* インストール */ 情報を更新

2023-05-28T18:31:42Z

インストール: 情報を更新

← 古い版		2023年5月29日 (月) 03:31時点における版
11行目:		11行目:
	== インストール ==		== インストール ==

	[[公式リポジトリ]]から {{Pkg\|nginx-mainline}} (メインラインブランチ: 最新の機能・アップデート・修正) か {{Pkg\|nginx}} (安定ブランチ: 重要な修正のみを適応) のどちらかを[[Pacman\|インストール]]できます。		[[公式リポジトリ]] から {{Pkg\|nginx-mainline}} (メインラインブランチ: 最新の機能・アップデート・修正) か {{Pkg\|nginx}} (安定ブランチ: 重要な修正のみを適応) のどちらかを [[Pacman\|インストール]] できます。

			メインラインブランチを使用することをお勧めします。安定版ブランチを使う主な理由は、サードパーティ製モジュールとの非互換性や、[https://nginx.org/en/download.html 新機能] の不注意によるバグ導入など、新機能の起こりうる影響を懸念するためです。
	{{Note\|
	基本的には[https://www.nginx.com/blog/nginx-1-6-1-7-released/ 最新版の利用が推奨されています]が、
	* サードパーティ製のモジュールとの互換性
	* 新規に追加された機能の未知のバグ
	などによる影響が懸念される場合は、安定版を使用することを検討してください。
	}}

			{{Note\|[[公式リポジトリ]] で利用可能なすべての nginx モジュールは、依存関係として ''nginx'' パッケージ (''nginx-mainline'' ではなく) を必要とします。''nginx'' か ''nginx-mainline'' かを決定する前に、必要なモジュールのリストを確認することをお勧めします。''nginx-mainline'' のモジュールは [[Arch User Repository]] にあります。}}
	''Ruby on Rails'' のためにインストールするには、[[Ruby on Rails#Rails パーフェクトセットアップ]]を参照してください。

	セキュリティを向上させるために chroot によるインストールをするには、[[#chroot でインストール]] を参照してください。		セキュリティを向上させるために chroot によるインストールをするには、[[nginx#chroot でインストール\|chroot でインストール]] を参照してください。

	== サービスの開始 ==		== サービスの開始 ==

Kgx: /* Cannot assign requested address */ 同期

2023-05-28T18:23:28Z

Cannot assign requested address: 同期

← 古い版		2023年5月29日 (月) 03:23時点における版
799行目:		799行目:
	}}		}}

			=== 要求されたアドレスを割り当てることができない ===
	=== Cannot assign requested address ===

	{{ic\|nginx.service}} [[ユニットステータス]]からの完全なエラーは次のとおりです。		{{ic\|nginx.service}} [[ユニットステータス]] からの完全なエラーは次のとおりです。

	[emerg] 460#460: bind() to A.B.C.D:443 failed (99: Cannot assign requested address)		[emerg] 460#460: bind() to A.B.C.D:443 failed (99: Cannot assign requested address)

	nginx ユニットファイルが systemd を使用して {{ic\|network.target}} の後に実行するように設定されている場合でも、nginx は、構成されているがどのインターフェイスにもまだ追加されていないアドレスでリッスンしようとする場合があります。 nginx の [[開始]]を手動で実行して、これが当てはまることを確認します (これにより、IP アドレスが適切に設定されていることが示されます)。任意のアドレスをリッスンするように nginx を設定すると、この問題が解決します。ユースケースで特定のアドレスをリッスンする必要がある場合、考えられる解決策の 1 つは、systemd を再構成することです。		nginx ユニットファイルが systemd を使用して {{ic\|network.target}} の後に実行するように設定されている場合でも、nginx は、構成されているがどのインターフェイスにもまだ追加されていないアドレスでリッスンしようとする場合があります。 nginx の [[開始]] を手動で実行して、これが当てはまることを確認します (これにより、IP アドレスが適切に設定されていることが示されます) 任意のアドレスをリッスンするように nginx を設定すると、この問題が解決します。ユースケースで特定のアドレスをリッスンする必要がある場合、考えられる解決策の 1 つは、systemd を再構成することです。

	設定されたすべてのネットワークデバイスが起動し、IP アドレスが割り当てられた後に nginx を起動するには、{{ic\|nginx.service}} 内の {{ic\|1=After=}} に {{ic\|network-online.target}} を追加し、{{ic\|systemd-networkd-wait-online.service}} を[[起動/有効化]]にします。		設定されたすべてのネットワークデバイスが起動し、IP アドレスが割り当てられた後に nginx を起動するには、{{ic\|nginx.service}} 内の {{ic\|1=After=}} に {{ic\|network-online.target}} を追加し、{{ic\|systemd-networkd-wait-online.service}} を [[起動/有効化]] にします。

	== 参照 ==		== 参照 ==

Kgx: /* {{ic|/var/lib/nginx/}} / 情報を更新

2023-05-28T18:09:23Z

{{ic|/var/lib/nginx/*}}: 情報を更新

← 古い版		2023年5月29日 (月) 03:09時点における版
653行目:		653行目:
	</dd>		</dd>

	==== ~~{{ic\|~~/var/lib/nginx~~/*}}~~ ====		==== /var/lib/nginx ====

			{{Pkg\|nginx}} は、デフォルトで一時ファイルを {{ic\|/var/lib/nginx}} に保存するようにコンパイルされます。
	{{ic\|/var/lib/nginx}} の一部のディレクトリは {{ic\|root}} として nginx でブートストラップする必要があります。サーバー全体を起動する必要はありません。nginx は[[#設定の確認\|設定テスト]]でブートストラップを実行します。一回実行すればそれで十分です。

	</dd>
			{{Tip\|{{ic\|$ nginx -V}} を実行して、すべてのコンパイル済みオプションを表示します}}

			たとえば、{{ic\|StateDirectory}} ({{man\|5\|systemd.exec}}) を使用して、''ユーザー'' にこのディレクトリへの書き込みアクセス権を与えることができます。

			{{hc\|/etc/systemd/system/nginx.service.d/user.conf\|2=
			[Service]
			...
			StateDirectory=nginx
			}}

	==== /var/log/nginx ====		==== /var/log/nginx ====

Kgx: /* ログファイル & ディレクトリのパーミッション */ 同期

2023-05-28T18:06:49Z

ログファイル & ディレクトリのパーミッション: 同期

← 古い版		2023年5月29日 (月) 03:06時点における版
658行目:		658行目:
	</dd>		</dd>

			==== /var/log/nginx ====
	====ログファイル & ディレクトリのパーミッション====

	設定テストの実行時に {{ic\|root}} によって所有される壊れたログが作成されます。{{ic\|/var/log/nginx}} のログを削除して新しく起動してください。
			{{Pkg\|nginx}} は、デフォルトでアクセスログを {{ic\|/var/log/nginx}} に保存するようにコンパイルされます。
	nginx サービスのユーザーから {{ic\|/var/log/nginx}} に書き込む権限が必要です。[[ファイルのパーミッションと属性#パーミッションを変更\|パーミッションを変更]]するかディレクトリの所有者を変更してください。

			たとえば、{{ic\|LogsDirectory}} ({{man\|5\|systemd.exec}}) を使用して、''ユーザー'' にこのディレクトリへの書き込みアクセス権を与えることができます。

			{{hc\|/etc/systemd/system/nginx.service.d/user.conf\|2=
			[Service]
			...
			LogsDirectory=nginx
			}}

	=== systemd の別のスクリプト ===		=== systemd の別のスクリプト ===

Kgx: /* Per-user directories */ 翻訳

2023-05-28T18:04:22Z

Per-user directories: 翻訳

← 古い版		2023年5月29日 (月) 03:04時点における版
205行目:		205行目:
	{{ic\|nginx.service}} を[[再起動]] して変更内容を反映させます。		{{ic\|nginx.service}} を[[再起動]] して変更内容を反映させます。

	==== ~~Per-user directories~~ ====		==== ユーザーごとのディレクトリ ====

			Apache スタイルの {{ic\|~user}} URL をユーザーの {{ic\|~/public_html}} ディレクトリに複製するには、次の手順を試してください。(注: 両方のルールを使用する場合、以下では、より具体的な PHP ルールを最初に置く必要があります。)
	To replicate Apache-style {{ic\|~user}} URLs to users' {{ic\|~/public_html}} directories, try the following. (Note: if both rules are used, below, the more-specific PHP rule must come first.)

	{{hc\|/etc/nginx/nginx.conf\|<nowiki>		{{hc\|/etc/nginx/nginx.conf\|<nowiki>
232行目:		232行目:
	</nowiki>}}		</nowiki>}}

			{{ic\|nginx}} を使用した PHP 設定の詳細については、[[nginx#PHP を動かす\|PHP を動かす]] を参照してください。
	See [[#PHP implementation]] for more information on PHP configuration with {{ic\|nginx}}.

	{{ic\|nginx.service}} を[[再起動]] して新しい設定を有効にします。		{{ic\|nginx.service}} を [[再起動]] して新しい設定を有効にします。

	=== FastCGI ===		=== FastCGI ===

Kgx: /* TLS */ 翻訳

2023-05-28T18:02:16Z

TLS: 翻訳

← 古い版		2023年5月29日 (月) 03:02時点における版
175行目:		175行目:
	* SSL を設定する前に [http://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_certificate ngx_http_ssl_module] のドキュメントを読むことを推奨します。		* SSL を設定する前に [http://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_certificate ngx_http_ssl_module] のドキュメントを読むことを推奨します。
	* [[Let’s Encrypt]] は無料の、自動化されたオープンな証明局です。コマンドラインおよび自動設定から直接有効な SSL 証明書を要求するプラグインを利用可能です。		* [[Let’s Encrypt]] は無料の、自動化されたオープンな証明局です。コマンドラインおよび自動設定から直接有効な SSL 証明書を要求するプラグインを利用可能です。
	* Mozilla ~~has a useful~~ [[MozillaWiki:Security/Server Side TLS\|TLS ~~article~~]] ~~as well as an~~ [https://mozilla.github.io/server-side-tls/ssl-config-generator/ ~~automated tool~~] ~~to help create a more secure configuration.~~		* Mozilla には、便利な [[MozillaWiki:Security/Server Side TLS\|TLS 記事]] と [https://mozilla.github.io/server-side-tls/ssl-config-generator/ 自動化ツール] があります。より安全な設定を作成するのに役立ちます。
	}}		}}

	{{Warning\|~~If you plan on implementing~~ SSL/TLS~~, know that some variations and implementations~~ ~~are~~ [https://weakdh.org/#affected ~~still~~] [[wikipedia:Transport_Layer_Security#Attacks_against_TLS.2FSSL\|~~vulnerable to attack~~]]~~. For details on these current vulnerabilities within~~ SSL/TLS ~~and how to apply appropriate changes to~~ nginx~~, visit~~ http://disablessl3.com/ ~~and~~ https://weakdh.org/sysadmin.html}}		{{Warning\|SSL/TLS の実装を計画している場合は、一部のバリエーションと実装は [https://weakdh.org/#affected まだ] [[wikipedia:Transport_Layer_Security# Attacks_against_TLS.2FSSL\|攻撃に対して脆弱]] であることを知っておいてください。SSL/TLS 内の現在の脆弱性の詳細と、nginx に適切な変更を適用する方法については、http://disablessl3.com/ および https://weakdh.org/sysadmin.html を参照してください。}}

			秘密キーと自己署名証明書を作成します。[[OpenSSL# 証明書署名要求を生成\|CSR]] を必要としないほとんどのインストールにはこれで十分です。
	Create a private key and self-signed certificate. This is adequate for most installations that do not require a [[OpenSSL#Generate a certificate signing request\|CSR]]:

	# mkdir /etc/nginx/ssl		# mkdir /etc/nginx/ssl
188行目:		188行目:
	# chmod 444 server.crt		# chmod 444 server.crt

	{{Note\|~~The~~ {{ic\|-days}} ~~switch is optional and~~ RSA ~~keysize can be as low as~~ 2048 (~~default~~).}}		{{Note\|{{ic\|-days}} スイッチはオプションであり、RSA キーサイズは 2048 (デフォルト) まで小さくできます。}}

			CSR を作成する必要がある場合は、上記の代わりに次の手順に従ってください。
	If you need to create a CSR, follow these instructions instead of the above:

	# mkdir /etc/nginx/ssl		# mkdir /etc/nginx/ssl
199行目:		199行目:
	# openssl x509 -req -days 1095 -in server.csr -signkey server.key -out server.crt		# openssl x509 -req -days 1095 -in server.csr -signkey server.key -out server.crt

	{{Note\|~~For more~~ ''openssl'' ~~options,~~ ~~read its man page~~ {{man\|1ssl\|openssl}} ~~or peruse its~~ [https://www.openssl.org/docs/ ~~extensive~~ ~~documentation].~~}}		{{Note\|その他の ''openssl'' オプションについては、マニュアルページ {{man\|1ssl\|openssl}} を読むか、[https://www.openssl.org/docs/ 豊富なドキュメント] を熟読してください。}}

	~~A starting point for~~ a {{ic\|/etc/nginx/nginx.conf}} ~~with TLS is~~ [https://ssl-config.mozilla.org/#server=nginx Mozilla's SSL ~~Configuration Generator~~].		TLS を使用した {{ic\|/etc/nginx/nginx.conf}} の開始点は、[https://ssl-config.mozilla.org/#server=nginx Mozilla の SSL 設定ジェネレーター] です。

	{{ic\|nginx.service}} を[[再起動]] して変更内容を反映させます。		{{ic\|nginx.service}} を[[再起動]] して変更内容を反映させます。

Kgx: /* 手順2: Nginx の設定 */ 情報を更新

2023-05-28T17:55:49Z

手順2: Nginx の設定: 情報を更新

← 古い版		2023年5月29日 (月) 02:55時点における版
386行目:		386行目:
	{{Warning\|{{ic\|spawn-fcgi}} の {{ic\|-M 660}} オプションを使用すると奇妙な動作が発生するため、ExecStartPost 行が必要です。間違ったモードが設定されています。これはバグかもしれません?}}		{{Warning\|{{ic\|spawn-fcgi}} の {{ic\|-M 660}} オプションを使用すると奇妙な動作が発生するため、ExecStartPost 行が必要です。間違ったモードが設定されています。これはバグかもしれません?}}

	===== ~~手順2: Nginx~~ の設定 =====		===== nginx の設定 =====

			{{ic\|/etc/nginx}} で、ファイル {{ic\|fastcgi_params}} を {{ic\|fcgiwrap_params}} にコピーします。{{ic\|fcgiwrap_params}} で、{{ic\|SCRIPT_NAME}} と {{ic\|DOCUMENT_ROOT}} を設定する行をコメント化するか削除します。
⚫	CGI ~~ウェブ~~アプリケーションを~~置くそれぞれの~~ {{Ic\|server}} ブロックには以下のような {{Ic\|location}} ブロック~~を記述し~~ます:

		⚫	CGI Web アプリケーションを提供する各 {{ic\|server}} ブロック内には、次のような {{ic\|location}} ブロックが表示されます。

	location ~ \.cgi$ {		location ~ \.cgi$ {
	~~root~~ ~~/path/to/server/cgi-bin~~;		include fcgiwrap_params;
			fastcgi_param DOCUMENT_ROOT /srv/www/cgi-bin/;
⚫	fastcgi_pass unix:/run/fcgiwrap.sock;
	~~include~~ ~~fastcgi~~.~~conf~~;		fastcgi_param SCRIPT_NAME myscript.cgi;
		⚫	fastcgi_pass unix:/run/fcgiwrap.sock;
	}		}

	{{Ic\|fcgiwrap}} の~~'''~~デフォルト~~''' (Unix)~~ ソケットは ''/run/fcgiwrap.sock'' です。		{{ic\|fcgiwrap}} のデフォルトのソケットファイルは {{ic\|/run/fcgiwrap.sock}} です。

			{{ic\|fastcgi_param SCRIPT_FILENAME /srv/www/cgi-bin/myscript.cgi}} を使用することは、{{ic\|DOCUMENT_ROOT}} と {{ic\|SCRIPT_NAME}} を設定する代わりのショートカットです。 {{ic\|SCRIPT_FILENAME}} を使用する場合は、{{ic\|fastcgi_params}} を {{ic\|fcgiwrap_params}} にコピーして、{{ic\|DOCUMENT_ROOT}} と {{ic\|SCRIPT_NAME 行をコメントアウトする必要もありません。}}

			{{Warning\|SCRIPT_NAME と DOCUMENT_ROOT が使用されている場合、fcgiwrap は nginx に設定されている他の fastcgi_params を ''破棄'' します。他のパラメータ (PATH_INFO など) を Nginx 設定を通じて設定できるようにするには、SCRIPT_FILENAME を使用する必要があります。[https://github.com/gnosek/fcgiwrap/issues/3 GitHub の問題を参照してください]}}

			{{ic\|502 - bad Gateway}} エラーが繰り返し発生する場合は、CGI アプリケーションが最初に次のコンテンツの MIME タイプをアナウンスするかどうかを確認する必要があります。HTML の場合、これは {{ic\|Content-type: text/html}} である必要があります。

			403 エラーが発生した場合は、CGI 実行可能ファイルが {{ic\|http}} ユーザーによって読み取りおよび実行可能であること、およびすべての親フォルダーが {{ic\|http}} ユーザーによって読み取り可能であることを確認してください。

	== chroot でインストール ==		== chroot でインストール ==

Kgx: /* マルチワーカースレッド */ 警告を翻訳

2023-05-28T17:49:04Z

マルチワーカースレッド: 警告を翻訳

← 古い版		2023年5月29日 (月) 02:49時点における版
384行目:		384行目:
	{{ic\|-f 10}} は生成する子スレッドの数に変更してください。		{{ic\|-f 10}} は生成する子スレッドの数に変更してください。

			{{Warning\|{{ic\|spawn-fcgi}} の {{ic\|-M 660}} オプションを使用すると奇妙な動作が発生するため、ExecStartPost 行が必要です。間違ったモードが設定されています。これはバグかもしれません?}}
	{{Warning\|The ExecStartPost line is required because of strange behaviour I'm seeing when I use the {{ic\|-M 660}} option for {{ic\|spawn-fcgi}}. The wrong mode is set. This may be a bug?}}

	===== 手順2: Nginx の設定 =====		===== 手順2: Nginx の設定 =====