Nginx upstream指令配置說明

upstream

定義服務(wù)器組,服務(wù)器可以監(jiān)聽不通的端口,也可以同時(shí)監(jiān)聽TCP和UNIX-domain套接字。

upstream backend {
    server backend1.example.com weight=5;
    server 127.0.0.1:8080       max_fails=3 fail_timeout=30s;
    server unix:/tmp/backend3;

    server backup1.example.com  backup;
}

server

語法:server address [parameters];

parameters列表
  • weight=number

    服務(wù)器的權(quán)重值,默認(rèn)是1;

  • max_conns=number

    設(shè)置允許的最大活動(dòng)連接數(shù)。默認(rèn)是0,表示不限制。(設(shè)置keepalive時(shí),如果有多個(gè)worker共享內(nèi)存,則連接數(shù)可能會(huì)超過設(shè)置的值)

  • max_fails=number

    設(shè)置在fail_timeout參數(shù)設(shè)置的時(shí)間段內(nèi)允許的失敗最大嘗試次數(shù),默認(rèn)是1,設(shè)置0表示失敗不會(huì)嘗試。

  • fail_timeout=time

    fail_timeout的值包含兩層意思:1.在這個(gè)時(shí)間段內(nèi)服務(wù)器通信失敗次數(shù)決定服務(wù)狀態(tài)是否為不可用;2.服務(wù)器被視為不可用狀態(tài)的時(shí)間段。

    默認(rèn)是10秒。

  • backup

    標(biāo)記服務(wù)器是備用服務(wù)器,只有在其他服務(wù)器都不可用的情況下,才會(huì)請求該服務(wù)器。(在哈希、IP哈希、隨機(jī)三種負(fù)載均衡模式下不可用)

  • down

    標(biāo)記服務(wù)器永久不可用狀態(tài)。

在商用版本還增加的參數(shù)
  • resolve

    監(jiān)控服務(wù)器IP地址和域名的對(duì)應(yīng)關(guān)系,可以自動(dòng)重載upstream的配置,不需要重啟nginx,服務(wù)器組必須共享內(nèi)存。

    需要在http或者upstream塊中設(shè)置resolver指令后,resolve參數(shù)才能有效

  • route=string

    設(shè)置服務(wù)器路由名稱

  • service=name

    起用DNS SRV記錄并設(shè)置服務(wù)名稱(1.9.13版本開始增加)。需要指定resolve參數(shù)和不帶端口的主機(jī)名才能使用。

    如果服務(wù)器名稱中不包含點(diǎn)(.),則構(gòu)造符合RFC規(guī)范的名稱,將TCP協(xié)議添加到服務(wù)前綴中,例如要查找_http._tcp.backend.example.com的SRV記錄,則必須配置:

    server backend.example.com service=http resolve;
    

    如果服務(wù)名中包含一個(gè)或多個(gè)點(diǎn)(.),會(huì)通過將服務(wù)名作為前綴與服務(wù)器名拼接在一起構(gòu)造名稱,例如要查找_http._tcp.backend.example.com和server1.backend.example.com的SRV記錄,則需要配置:

    server backend.example.com service=_http._tcp resolve;
    server example.com service=server1.backend resolve;
    

    最高優(yōu)先級(jí)的SRV記錄(具有相同最低優(yōu)先值的記錄)被解析為主服務(wù)器,其它的服務(wù)器被解析為備用服務(wù)器,如果服務(wù)器指定了backup參數(shù),則將高優(yōu)先級(jí)SRV記錄解析為備用服務(wù)器,其它SRV記錄將被忽略。

  • slow_start=time

    當(dāng)服務(wù)器從不可用狀態(tài)恢復(fù)過來時(shí),通過slow_start設(shè)置的值決定將服務(wù)器權(quán)重從0逐漸恢復(fù)到正常設(shè)置值的時(shí)間。(在哈希、IP哈希、隨機(jī)三種負(fù)載均衡模式下不可用)

  • drain

    將服務(wù)器設(shè)置為“draining"模式,這種模式下,只有綁定到服務(wù)器的請求才會(huì)被代理到該服務(wù)器上(1.13.6版本其實(shí)起用)。

如果服務(wù)組中只有一臺(tái)服務(wù)器,server指令的max_failsfail_timeoutslow_start 參數(shù)都是無效的,nginx不會(huì)認(rèn)為服務(wù)器不可用。

ngx_http_upstream_module 的自帶參數(shù)
  • $upstream_addr

    保存upstream服務(wù)器的IP地址和端口或者UNIX域名套接字;

  • $upstream_bytes_received

    從服務(wù)器接收到的字節(jié)數(shù)(從1.11.4版本開始起用);

  • $upstream_bytes_sent

    發(fā)送到服務(wù)器的字節(jié)數(shù)(從1.15.8版本開始起用);

  • $upstream_cache_status

    保存訪問響應(yīng)緩存的狀態(tài)(從0.8.3版本開始起用),緩存狀態(tài)可能是:“MISS”, “BYPASS”, “EXPIRED”, “STALE”, “UPDATING”, “REVALIDATED”, 或者“HIT”;

  • $upstream_connect_time

    保存于服務(wù)器完成連接話費(fèi)的時(shí)間(從1.9.1版本開始起用),這個(gè)時(shí)間會(huì)保存幾秒鐘內(nèi)以毫秒計(jì)量。在SLL連接的情況下,包含握手話費(fèi)的時(shí)間;

  • $upstream_cookie_name

    由上游服務(wù)器在“ Set-Cookie”響應(yīng)標(biāo)頭字段中發(fā)送的具有指定名稱的cookie(從1.7.1版本開始起用),僅保存來自最后一個(gè)服務(wù)器響應(yīng)的cookie;

  • $upstream_header_time

    保存從服務(wù)器接收響應(yīng)頭的時(shí)間(從1.7.0版本開始起用),這個(gè)時(shí)間會(huì)保存幾秒鐘內(nèi)以毫秒計(jì)量;

  • $upstream_http_name

    保存服務(wù)器響應(yīng)頭字段。例如可以通過upstream_http_server使用響應(yīng)頭中的"Server"字段,將頭字段名稱轉(zhuǎn)換為變量名稱的規(guī)則與以“ http_”為前綴的變量的規(guī)則相同。僅保存來自最后一個(gè)服務(wù)器的響應(yīng)頭字段;

  • $upstream_queue_time

    保存請求在upstream隊(duì)列中花費(fèi)的時(shí)間(從1.13.9版本開始起用),這個(gè)時(shí)間會(huì)保存幾秒鐘內(nèi)以毫秒計(jì)量;

  • $upstream_response_length

    保存從服務(wù)器獲得的響應(yīng)的字節(jié)長度(從0.7.27版本開始起用);

  • $upstream_response_time

    保存從服務(wù)器接收響應(yīng)花費(fèi)的時(shí)間,這個(gè)時(shí)間會(huì)保存幾秒鐘內(nèi)以毫秒計(jì)量;

  • $upstream_status

    保存從服務(wù)器獲得響應(yīng)的狀態(tài)碼,如果無法選擇服務(wù)器,則設(shè)置為502(Bad Gateway);

  • $upstream_trailer_name

    保存從服務(wù)器獲得的響應(yīng)末尾的字段(從1.13.10版本開始起用)。

·upstream指令塊中還有很多其它參數(shù),如zonekeepalive請參考官網(wǎng)

其他文章列表

spring web service系列1
spring web service系列2
spring web service系列3
maven配置文件settings.xml詳解
Nginx轉(zhuǎn)發(fā)請求過程解析
Nginx中的負(fù)載均衡算法
Nginx中虛擬服務(wù)器server指令配置說明
Nginx中proxy_pass/proxy_redirect/proxy_set_header配置說明
Nginx中ngx_http_core_module相關(guān)指令配置說明
Java自帶JVM監(jiān)控工具jstat使用詳細(xì)說明
Java自帶JVM監(jiān)控工具jps使用詳細(xì)說明
Java自帶故障分析工具jmap工具使用說明
Java自帶故障分析工具jhat工具使用說明

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,333評(píng)論 6 531
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 98,491評(píng)論 3 416
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,263評(píng)論 0 374
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,946評(píng)論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 71,708評(píng)論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,186評(píng)論 1 324
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,255評(píng)論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,409評(píng)論 0 288
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 48,939評(píng)論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 40,774評(píng)論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 42,976評(píng)論 1 369
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,518評(píng)論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,209評(píng)論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,641評(píng)論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,872評(píng)論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 51,650評(píng)論 3 391
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 47,958評(píng)論 2 373

推薦閱讀更多精彩內(nèi)容