nginx-site: xml/ja/docs/http/server

comparison xml/ja/docs/http/server_names.xml @ 490:9913f1d51c07

Replaced "nginx" domain names with example domains.

author	Ruslan Ermilov <ru@nginx.com>
date	Thu, 19 Apr 2012 12:30:24 +0000
parents	6135f3c95bf6
children	130fad6dc1b4

comparison

equal deleted inserted replaced

-:2abd1998a0cc
+:9913f1d51c07
 サーバ名は <literal>server_name</literal> ディレクティブを使用して定義され、リクエストに対してどのサーバブロックが使われるかを決定します。「<link doc="request_processing.xml" />」もお読みください。これらは完全一致名、ワイルドカード名、正規表現で定義されます:
 <programlisting>
 server {
 listen       80;
-server_name  nginx.org  www.nginx.org;
+server_name  example.org  www.example.org;
 ...
 }
 server {
 listen       80;
-server_name  *.nginx.org;
+server_name  *.example.org;
 ...
 }
 server {
 listen       80;
 ...
 }
 server {
 listen       80;
-server_name  ~^(?&lt;user&gt;.+)\.nginx\.net$;
+server_name  ~^(?&lt;user&gt;.+)\.example\.net$;
 ...
 }
 </programlisting>
 サーバ名は次の順序で考査されます:
 <listitem>
 完全一致名
 </listitem>
 <listitem>
-アスタリスクで始まるワイルドカード名: <url>*.nginx.org</url>
+アスタリスクで始まるワイルドカード名: <url>*.example.org</url>
 </listitem>
 <listitem>
 アスタリスクで終わるワイルドカード名: <url>mail.*</url>
 </listitem>
 <section id="wildcard_names"
 name="ワイルドカード名">
 <para>
-ワイルドカード名にはそのサーバ名の最初か最後のみ、そしてドットに隣接したところのみにアスタリスクが含まれます。サーバ名 <literal>www.*.nginx.org</literal> や <literal>w*.nginx.org</literal> は無効です。しかし、これらのサーバ名は正規表現を使用して、例えば  <literal>~^www\..+\.nginx\.org$</literal> や <literal>~^w.*\.nginx\.org$</literal> として指定することができます。アスタリスクは複数部分にマッチさせることができます。<literal>*.nginx.org</literal> は <url>www.nginx.org</url> だけでなく <url>www.sub.nginx.org</url> にもマッチします。
+ワイルドカード名にはそのサーバ名の最初か最後のみ、そしてドットに隣接したところのみにアスタリスクが含まれます。サーバ名 <literal>www.*.example.org</literal> や <literal>w*.example.org</literal> は無効です。しかし、これらのサーバ名は正規表現を使用して、例えば  <literal>~^www\..+\.example\.org$</literal> や <literal>~^w.*\.example\.org$</literal> として指定することができます。アスタリスクは複数部分にマッチさせることができます。<literal>*.example.org</literal> は <url>www.example.org</url> だけでなく <url>www.sub.example.org</url> にもマッチします。
 </para>
 <para>
-特別なワイルドカードの形式 <literal>.nginx.org</literal> は、完全一致名 <literal>nginx.org</literal> とワイルドカード名 <literal>*.nginx.org</literal> の両方にマッチさせるように利用できます。
+特別なワイルドカードの形式 <literal>.example.org</literal> は、完全一致名 <literal>example.org</literal> とワイルドカード名 <literal>*.example.org</literal> の両方にマッチさせるように利用できます。
 </para>
 </section>
 <para>
 nginx で使用される正規表現は Perl プログラミング言語（PCRE）で使用されているものと互換性があります。正規表現を使用するには、サーバ名を必ずチルダで始めます:
 <programlisting>
-server_name  ~^www\d+\.nginx\.net$;
+server_name  ~^www\d+\.example\.net$;
 </programlisting>
 チルダで始まっていないと完全一致名として、またはその正規表現にアスタリスクが含まれている場合はワイルドカード名として（そしてたいていの場合は無効なものとして）扱われてしまいます。&ldquo;^&rdquo; と &ldquo;$&rdquo; アンカーをセットし忘れないようにしてください。これらは構文的には必須ではありませんが論理的に必須です。また、ドメイン名のドットはバックスラッシュで必ずエスケープしてください。&ldquo;{&rdquo; と &ldquo;}&rdquo; 文字を含む正規表現は必ずダブルクォーテーションで囲ってください:
 <programlisting>
-server_name  "~^(?&lt;name&gt;\w\d<b>{</b>1,3<b>}</b>+)\.nginx\.net$";
+server_name  "~^(?&lt;name&gt;\w\d<b>{</b>1,3<b>}</b>+)\.example\.net$";
 </programlisting>
 さもないと、nginx は起動に失敗し次のエラーメッセージを表示します:
 <programlisting>
 デフォルトではないサーバブロックで &ldquo;Host&rdquo; ヘッダ無しのリクエストを処理させたい場合は、空のサーバ名を指定します:
 <programlisting>
 server {
 listen       80;
-server_name  nginx.org  www.nginx.org  "";
+server_name  example.org  www.example.org  "";
 ...
 }
 </programlisting>
 </para>
 サーバ名ではなく IP アドレスを使用したリクエストが送られてきた場合、そのリクエストの &ldquo;Host&rdquo; ヘッダには IP アドレスが含まれているので、その IP アドレスをサーバ名として利用してそのリクエストを処理できます:
 <programlisting>
 server {
 listen       80;
-server_name  nginx.org
+server_name  example.org
-www.nginx.org
+www.example.org
 ""
 <b>192.168.1.1</b>
 ;
 ...
 }
 <programlisting>
 server {
 listen       80;
 listen       8080  default_server;
-server_name  nginx.net;
+server_name  example.net;
 ...
 }
 server {
 listen       80  default_server;
 listen       8080;
-server_name  nginx.org;
+server_name  example.org;
 ...
 }
 </programlisting>
 </para>
 <section id="optimization"
 name="最適化">
 <para>
-完全一致名とワイルドカード名はハッシュで保存されます。このハッシュは待ち受けポートに結び付けられ、各待ち受けポートは、完全一致名のハッシュ、アスタリスクで始まるワイルドカード名のハッシュ、アスタリスクで終わるワイルドカード名のハッシュの３つまでのハッシュを持つことができます。ハッシュのサイズは構成フェーズで最適化されるので、CPU キャッシュのミスは最低でもサーバ名を見つけることができます。最初に完全一致名のハッシュが検索されます。完全一致名のハッシュを使って見つからなければ、次にアスタリスクで始まるワイルドカード名のハッシュが検索されます。さらにまだ見つからなければ、アスタリスクで終わるワイルドカード名のハッシュが検索されます。ワイルドカード名のハッシュの検索は完全一致名のハッシュの検索よりも遅くなります。これはサーバ名の検索がドメイン部分によって検索されるからです。特別なワイルドカード形式の <literal>.nginx.org</literal> は完全一致名のハッシュではなくワイルドカード名のハッシュで保存されます。正規表現は順番に考査されるので、これがもっとも遅い方式ですし、非スケーラブルでもあります。
+完全一致名とワイルドカード名はハッシュで保存されます。このハッシュは待ち受けポートに結び付けられ、各待ち受けポートは、完全一致名のハッシュ、アスタリスクで始まるワイルドカード名のハッシュ、アスタリスクで終わるワイルドカード名のハッシュの３つまでのハッシュを持つことができます。ハッシュのサイズは構成フェーズで最適化されるので、CPU キャッシュのミスは最低でもサーバ名を見つけることができます。最初に完全一致名のハッシュが検索されます。完全一致名のハッシュを使って見つからなければ、次にアスタリスクで始まるワイルドカード名のハッシュが検索されます。さらにまだ見つからなければ、アスタリスクで終わるワイルドカード名のハッシュが検索されます。ワイルドカード名のハッシュの検索は完全一致名のハッシュの検索よりも遅くなります。これはサーバ名の検索がドメイン部分によって検索されるからです。特別なワイルドカード形式の <literal>.example.org</literal> は完全一致名のハッシュではなくワイルドカード名のハッシュで保存されます。正規表現は順番に考査されるので、これがもっとも遅い方式ですし、非スケーラブルでもあります。
 </para>
 <para>
-これらの理由から、可能な場合は完全一致名を利用するのがよいでしょう。例えば、もっとも頻繁にリクエストされるサーバ名が <url>nginx.org</url> と <url>www.nginx.org</url> だとすると、これらを明示的に定義するとより効率的です:
+これらの理由から、可能な場合は完全一致名を利用するのがよいでしょう。例えば、もっとも頻繁にリクエストされるサーバ名が <url>example.org</url> と <url>www.example.org</url> だとすると、これらを明示的に定義するとより効率的です:
 <programlisting>
 server {
 listen       80;
-server_name  nginx.org  www.nginx.org  *.nginx.org;
+server_name  example.org  www.example.org  *.example.org;
 ...
 }
 </programlisting>
 上記は次の単純化された形式を使用するよりも効率的です:
 <programlisting>
 server {
 listen       80;
-server_name  .nginx.org;
+server_name  .example.org;
 ...
 }
 </programlisting>
 </para>
 <para>
-たくさんの数のサーバ名を定義したり非常に長いサーバ名を定義したりする場合は、http レベルの <literal>server_names_hash_max_size</literal> と <literal>server_names_hash_bucket_size</literal> ディレクティブを調整する必要があるかもしれません。<literal>server_names_hash_bucket_size</literal> のデフォルト値は 32、もしくは 64、あるいはお使いの CPU キャッシュラインのサイズによってはその他の値になっているかもしれません。もしデフォルト値が 32 でサーバ名として &ldquo;too.long.server.name.nginx.org&rdquo; のような非常に長いサーバ名を定義している場合、nginx は起動に失敗し、次のエラーメッセージを表示させます:
+たくさんの数のサーバ名を定義したり非常に長いサーバ名を定義したりする場合は、http レベルの <literal>server_names_hash_max_size</literal> と <literal>server_names_hash_bucket_size</literal> ディレクティブを調整する必要があるかもしれません。<literal>server_names_hash_bucket_size</literal> のデフォルト値は 32、もしくは 64、あるいはお使いの CPU キャッシュラインのサイズによってはその他の値になっているかもしれません。もしデフォルト値が 32 でサーバ名として &ldquo;too.long.server.name.example.org&rdquo; のような非常に長いサーバ名を定義している場合、nginx は起動に失敗し、次のエラーメッセージを表示させます:
 <programlisting>
 could not build the server_names_hash,
 you should increase server_names_hash_bucket_size: 32
 </programlisting>
 <listitem>
 正規表現サーバ名のサポートは 0.6.7 からです。
 </listitem>
 <listitem>
-ワイルドカードの形式 <url>nginx.*</url> のサポートは 0.6.0 からです。
+ワイルドカードの形式 <url>example.*</url> のサポートは 0.6.0 からです。
 </listitem>
 <listitem>
-特別な形式 <url>.nginx.org</url> のサポートは 0.3.18 からです。
+特別な形式 <url>.example.org</url> のサポートは 0.3.18 からです。
 </listitem>
 <listitem>
-ワイルドカードの形式 <url>*.nginx.org</url> のサポートは 0.1.13 からです。
+ワイルドカードの形式 <url>*.example.org</url> のサポートは 0.1.13 からです。
 </listitem>
 </list>
 </para>

Mercurial > hg > nginx-site

comparison xml/ja/docs/http/server_names.xml @ 490:9913f1d51c07