nginx

upstream

Syntax

upstream name { server addr; } → proxy_pass http://name;

Parameters

ParametersDescriptionExamplesLevel
server server 127.0.0.1:3001; Common
weight ( 1) server 127.0.0.1:3001 weight=3; Common
max_fails server 127.0.0.1:3001 max_fails=3; Common
backup server 127.0.0.1:3003 backup; Advanced
ip_hash IP () ip_hash; Advanced
least_conn least_conn; Advanced

Examples

upstream app {
    server 127.0.0.1:3001;
    server 127.0.0.1:3002;
    server 127.0.0.1:3003;
}
server {
    location / {
        proxy_pass http://app;
    }
}
,

upstream app {
    server 192.168.1.10:8080 weight=5;
    server 192.168.1.11:8080 weight=3;
    server 192.168.1.12:8080 weight=2;
}

+

upstream app {
    server 127.0.0.1:3001 max_fails=3 fail_timeout=30s;
    server 127.0.0.1:3002 max_fails=3 fail_timeout=30s;
    server 127.0.0.1:3003 backup;
}
backup

Common Errors

upstream, and

Tips

Related Commands