comparison xml/he/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
489:2abd1998a0cc 490:9913f1d51c07
15 ניתן להגדירם באמצעות שמות מדוייקים, שמות Wildcard, או באמצעות ביטויים רגולריים: 15 ניתן להגדירם באמצעות שמות מדוייקים, שמות Wildcard, או באמצעות ביטויים רגולריים:
16 16
17 <programlisting> 17 <programlisting>
18 server { 18 server {
19 listen 80; 19 listen 80;
20 server_name nginx.org www.nginx.org; 20 server_name example.org www.example.org;
21 ... 21 ...
22 } 22 }
23 23
24 server { 24 server {
25 listen 80; 25 listen 80;
26 server_name *.nginx.org; 26 server_name *.example.org;
27 ... 27 ...
28 } 28 }
29 29
30 server { 30 server {
31 listen 80; 31 listen 80;
33 ... 33 ...
34 } 34 }
35 35
36 server { 36 server {
37 listen 80; 37 listen 80;
38 server_name ~^(?&lt;user&gt;.+)\.nginx\.net$; 38 server_name ~^(?&lt;user&gt;.+)\.example\.net$;
39 ... 39 ...
40 } 40 }
41 </programlisting> 41 </programlisting>
42 42
43 השמות נבדקים בסדר הבא: 43 השמות נבדקים בסדר הבא:
47 <listitem> 47 <listitem>
48 שמות מדוייקים; 48 שמות מדוייקים;
49 </listitem> 49 </listitem>
50 50
51 <listitem> 51 <listitem>
52 שמות Wildcard המתחילים בכוכבית: <url>*.nginx.org</url>; 52 שמות Wildcard המתחילים בכוכבית: <url>*.example.org</url>;
53 </listitem> 53 </listitem>
54 54
55 <listitem> 55 <listitem>
56 שמות Wildcard המסתיימים בכוכבית: <url>mail.*</url>; 56 שמות Wildcard המסתיימים בכוכבית: <url>mail.*</url>;
57 </listitem> 57 </listitem>
70 <section id="wildcard_names" 70 <section id="wildcard_names"
71 name="שמות Wildcard"> 71 name="שמות Wildcard">
72 72
73 <para> 73 <para>
74 שם wildcard יכול להכיל כוכבית רק בתחילת או בסוף השם, וחייב להיות בגבול של נקודה. 74 שם wildcard יכול להכיל כוכבית רק בתחילת או בסוף השם, וחייב להיות בגבול של נקודה.
75 השמות <literal>www.*.nginx.org</literal> 75 השמות <literal>www.*.example.org</literal>
76 ו <literal>w*.nginx.org</literal> הם שגויים. 76 ו <literal>w*.example.org</literal> הם שגויים.
77 למרות זאת, ניתן לציין שמות כאלה באמצעות ביטויים רגולריים, 77 למרות זאת, ניתן לציין שמות כאלה באמצעות ביטויים רגולריים,
78 לדוגמא, <literal>~^www\..+\.nginx\.org$</literal> ו 78 לדוגמא, <literal>~^www\..+\.example\.org$</literal> ו
79 <literal>~^w.*\.nginx\.org$</literal>. 79 <literal>~^w.*\.example\.org$</literal>.
80 סימן הכוכבית יכול להחליף מספר חלקי שם. 80 סימן הכוכבית יכול להחליף מספר חלקי שם.
81 השם <literal>*.nginx.org</literal> מתאים לא רק ל 81 השם <literal>*.example.org</literal> מתאים לא רק ל
82 <url>www.nginx.org</url> אלא גם ל <url>www.sub.nginx.org</url>. 82 <url>www.example.org</url> אלא גם ל <url>www.sub.example.org</url>.
83 </para> 83 </para>
84 84
85 <para> 85 <para>
86 ניתן להשתמש ב wildcard מיוחד בצורה של <literal>.nginx.org</literal> 86 ניתן להשתמש ב wildcard מיוחד בצורה של <literal>.example.org</literal>
87 כדי להתאים גם לשם המדוייק <literal>nginx.org</literal> 87 כדי להתאים גם לשם המדוייק <literal>example.org</literal>
88 וגם לשם ה wildcard הבא: <literal>*.nginx.org</literal>. 88 וגם לשם ה wildcard הבא: <literal>*.example.org</literal>.
89 </para> 89 </para>
90 90
91 </section> 91 </section>
92 92
93 93
98 הביטויים הרגולריים ש nginx משתמש בהם, תואמים לאלה אשר נמצאים בשימוש 98 הביטויים הרגולריים ש nginx משתמש בהם, תואמים לאלה אשר נמצאים בשימוש
99 בשפת פרל (PCRE). 99 בשפת פרל (PCRE).
100 כדי להשתמש בביטוי רגולרי, על שם השרת להתחיל עם סימן הטילדה (~), כך: 100 כדי להשתמש בביטוי רגולרי, על שם השרת להתחיל עם סימן הטילדה (~), כך:
101 101
102 <programlisting> 102 <programlisting>
103 server_name ~^www\d+\.nginx\.net$; 103 server_name ~^www\d+\.example\.net$;
104 </programlisting> 104 </programlisting>
105 105
106 אחרת nginx יתייחס אליו כשם מדוייק, או אם הביטוי מכיל כוכבית, כשם wildcard (וסביר 106 אחרת nginx יתייחס אליו כשם מדוייק, או אם הביטוי מכיל כוכבית, כשם wildcard (וסביר
107 להניח שיהיה שגוי). 107 להניח שיהיה שגוי).
108 אל תשכחו להגדיר עוגני 108 אל תשכחו להגדיר עוגני
111 כמו כן שימו לב שהנקודות של שם המתלם צריכות להיות מוברחות (escaped) על ידי לוכסן הפוך (\). 111 כמו כן שימו לב שהנקודות של שם המתלם צריכות להיות מוברחות (escaped) על ידי לוכסן הפוך (\).
112 ביטוי רגולרי המכיל את התווים &ldquo;{&rdquo; 112 ביטוי רגולרי המכיל את התווים &ldquo;{&rdquo;
113 ו &ldquo;}&rdquo; צריך להיות במרכאות: 113 ו &ldquo;}&rdquo; צריך להיות במרכאות:
114 114
115 <programlisting> 115 <programlisting>
116 server_name "~^(?&lt;name&gt;\w\d<b>{</b>1,3<b>}</b>+)\.nginx\.net$"; 116 server_name "~^(?&lt;name&gt;\w\d<b>{</b>1,3<b>}</b>+)\.example\.net$";
117 </programlisting> 117 </programlisting>
118 118
119 אחרת nginx יכשל בעלייה, ויציג את הודעת השגיאה הבאה: 119 אחרת nginx יכשל בעלייה, ויציג את הודעת השגיאה הבאה:
120 120
121 <programlisting> 121 <programlisting>
197 בבלוק שרת שאינו ברירת המחדל, עליכם לציין שם ריק: 197 בבלוק שרת שאינו ברירת המחדל, עליכם לציין שם ריק:
198 198
199 <programlisting> 199 <programlisting>
200 server { 200 server {
201 listen 80; 201 listen 80;
202 server_name nginx.org www.nginx.org ""; 202 server_name example.org www.example.org "";
203 ... 203 ...
204 } 204 }
205 </programlisting> 205 </programlisting>
206 </para> 206 </para>
207 207
211 שימוש בכתובת IP בשם השרת: 211 שימוש בכתובת IP בשם השרת:
212 212
213 <programlisting> 213 <programlisting>
214 server { 214 server {
215 listen 80; 215 listen 80;
216 server_name nginx.org 216 server_name example.org
217 www.nginx.org 217 www.example.org
218 "" 218 ""
219 <b>192.168.1.1</b> 219 <b>192.168.1.1</b>
220 ; 220 ;
221 ... 221 ...
222 } 222 }
258 258
259 <programlisting> 259 <programlisting>
260 server { 260 server {
261 listen 80; 261 listen 80;
262 listen 8080 default_server; 262 listen 8080 default_server;
263 server_name nginx.net; 263 server_name example.net;
264 ... 264 ...
265 } 265 }
266 266
267 server { 267 server {
268 listen 80 default_server; 268 listen 80 default_server;
269 listen 8080; 269 listen 8080;
270 server_name nginx.org; 270 server_name example.org;
271 ... 271 ...
272 } 272 }
273 </programlisting> 273 </programlisting>
274 </para> 274 </para>
275 275
292 אם שם לא נמצא בגיבוב השמות המדוייק, מתחיל חיפוש בגיבוב השמות המתחילים 292 אם שם לא נמצא בגיבוב השמות המדוייק, מתחיל חיפוש בגיבוב השמות המתחילים
293 בכוכבית. 293 בכוכבית.
294 אם הוא לא נמצא גם שם, מתחיל חיפוש בגיבוב השמות המסתיימים בכוכבית. 294 אם הוא לא נמצא גם שם, מתחיל חיפוש בגיבוב השמות המסתיימים בכוכבית.
295 חיפוש בגיבובי שמות wildcard הוא איטי יותר מחיפוש שם בגיבוב השמות המדוייקים 295 חיפוש בגיבובי שמות wildcard הוא איטי יותר מחיפוש שם בגיבוב השמות המדוייקים
296 כיוון ששמות עוברים חיפוש על פי חלקי שם המתחם. 296 כיוון ששמות עוברים חיפוש על פי חלקי שם המתחם.
297 שימו לב שצורת ה wildcard המיוחדת <literal>.nginx.org</literal> 297 שימו לב שצורת ה wildcard המיוחדת <literal>.example.org</literal>
298 שמורה גם היא בגיבוב שמות ה wildcard ולא בגיבוב השמות המדוייקים. 298 שמורה גם היא בגיבוב שמות ה wildcard ולא בגיבוב השמות המדוייקים.
299 ביטויים רגולריים נבדקים באופן סדרתי, ועל כן הם השיטה האיטית ביותר 299 ביטויים רגולריים נבדקים באופן סדרתי, ועל כן הם השיטה האיטית ביותר
300 ואינם סקאלאביליים. 300 ואינם סקאלאביליים.
301 </para> 301 </para>
302 302
303 <para> 303 <para>
304 בהתחשב בנסיבות אלה, הכי טוב להשתמש בשמות מדוייקים בכל מקום שהדבר אפשרי. 304 בהתחשב בנסיבות אלה, הכי טוב להשתמש בשמות מדוייקים בכל מקום שהדבר אפשרי.
305 לדוגמה, אם השמות הנפוצים ביותר לשרת הם <url>nginx.org</url> ו <url>www.nginx.org</url>, 305 לדוגמה, אם השמות הנפוצים ביותר לשרת הם <url>example.org</url> ו <url>www.example.org</url>,
306 יותר יעיל להגדיר אותם באופן מפורש: 306 יותר יעיל להגדיר אותם באופן מפורש:
307 307
308 <programlisting> 308 <programlisting>
309 server { 309 server {
310 listen 80; 310 listen 80;
311 server_name nginx.org www.nginx.org *.nginx.org; 311 server_name example.org www.example.org *.example.org;
312 ... 312 ...
313 } 313 }
314 </programlisting> 314 </programlisting>
315 315
316 מאשר להשתמש בשיטה המופשטת: 316 מאשר להשתמש בשיטה המופשטת:
317 317
318 <programlisting> 318 <programlisting>
319 server { 319 server {
320 listen 80; 320 listen 80;
321 server_name .nginx.org; 321 server_name .example.org;
322 ... 322 ...
323 } 323 }
324 </programlisting> 324 </programlisting>
325 </para> 325 </para>
326 326
329 ייתכן ויהיה עליכם לכוונן את המאפיינים <literal>server_names_hash_max_size</literal> 329 ייתכן ויהיה עליכם לכוונן את המאפיינים <literal>server_names_hash_max_size</literal>
330 ו <literal>server_names_hash_bucket_size</literal> ברמת ה <i>http</i>. 330 ו <literal>server_names_hash_bucket_size</literal> ברמת ה <i>http</i>.
331 ערך ברירת המחדל של <literal>server_names_hash_bucket_size</literal> 331 ערך ברירת המחדל של <literal>server_names_hash_bucket_size</literal>
332 יכול להיות שווה ל 32, ל 64, או לערך אחר, בהתאם לגודל קו המטמון של המעבד שלכם. 332 יכול להיות שווה ל 32, ל 64, או לערך אחר, בהתאם לגודל קו המטמון של המעבד שלכם.
333 אם ברירת המחדל היא 32 ותגדירו 333 אם ברירת המחדל היא 32 ותגדירו
334 &ldquo;too.long.server.name.nginx.org&rdquo; בתור שם שרת, 334 &ldquo;too.long.server.name.example.org&rdquo; בתור שם שרת,
335 אזי nginx ייכשל בעלייה ויציג את הודעת השגיאה הבאה: 335 אזי nginx ייכשל בעלייה ויציג את הודעת השגיאה הבאה:
336 336
337 <programlisting> 337 <programlisting>
338 could not build the server_names_hash, 338 could not build the server_names_hash,
339 you should increase server_names_hash_bucket_size: 32 339 you should increase server_names_hash_bucket_size: 32
398 <listitem> 398 <listitem>
399 שמות שרת כביטוי רגולרי נתמכו החל מגירסה 0.6.7. 399 שמות שרת כביטוי רגולרי נתמכו החל מגירסה 0.6.7.
400 </listitem> 400 </listitem>
401 401
402 <listitem> 402 <listitem>
403 צורות Wildcard מסוג <url>nginx.*</url> נתמכו החל מגירסה 0.6.0. 403 צורות Wildcard מסוג <url>example.*</url> נתמכו החל מגירסה 0.6.0.
404 </listitem> 404 </listitem>
405 405
406 <listitem> 406 <listitem>
407 הצורה המיוחדת <url>.nginx.org</url> נתמכה החל מגירסה 0.3.18. 407 הצורה המיוחדת <url>.example.org</url> נתמכה החל מגירסה 0.3.18.
408 </listitem> 408 </listitem>
409 409
410 <listitem> 410 <listitem>
411 הצורה <url>*.nginx.org</url> נתמכה החל מגירסה 0.1.13. 411 הצורה <url>*.example.org</url> נתמכה החל מגירסה 0.1.13.
412 </listitem> 412 </listitem>
413 413
414 </list> 414 </list>
415 </para> 415 </para>
416 416