NGINX 配置清单

以下内容来自 SimulatedGREG/nginx-cheatsheet。

通用设置

端口

listen

server {
# standard HTTP protocol
listen 80;

# standard HTTPS protocol
listen 443 ssl;

# listen on 80 using IPv6
listen [::]:80;

# listen only on IPv6
listen [::]:80 ipv6only=on;
}

域名

server_name

server {
# Listen to yourdomain.com
server_name yourdomain.com;

# Listen to multiple domains
server_name yourdomain.com www.yourdomain.com;

# Listen to all sub-domains
server_name *.yourdomain.com;

# Listen to all top-level domains
server_name yourdomain.*;

# Listen to unspecified hostnames (listens to IP address itself)
server_name "";
}

访问日志

access_log

server {
# Relative or full path to log file
access_log /path/to/file.log;

# Turn 'on' or 'off'
access_log on;
}

gzip

,

client_max_body_size

server {
# Turn gzip compression 'on' or 'off'
gzip on;

# Limit client body size to 10mb
client_max_body_size 10M;
}

响应文件

静态文件

server {
listen 80;
server_name yourdomain.com;

location / {
root /path/to/website;
}
}

支持前端路由

server {
listen 80;
server_name yourdomain.com;
root /path/to/website;

location / {
try_files $uri $uri/ /index.html;
}
}

重定向

301

永久重定向

用于比如

www.yourdomain.com

yourdomain.com

http

https

server {
listen 80;
server_name www.yourdomain.com;
return 301 http://yourdomain.com$request_uri;
}

302

临时重定向

server {
listen 80;
server_name yourdomain.com;
return 302 http://otherdomain.com;
}

重定向指定页面

server {
listen 80;
server_name yourdomain.com;

location /redirect-url {
return 301 http://otherdomain.com;
}
}

反向代理

基本

server {
listen 80;
server_name yourdomain.com;

location / {
proxy_pass http://0.0.0.0:3000;
# where 0.0.0.0:3000 is your Node.js Server bound on 0.0.0.0 listing on port 3000
}
}

进阶

upstream node_js {
server 0.0.0.0:3000;
# where 0.0.0.0:3000 is your Node.js Server bound on 0.0.0.0 listing on port 3000
}

server {
listen 80;
server_name yourdomain.com;

location / {
proxy_pass http://node_js;
}
}

socket 相关

upstream node_js {
server 0.0.0.0:3000;
}

server {
listen 80;
server_name yourdomain.com;

location / {
proxy_pass http://node_js;
proxy_redirect off;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;

# not required but useful for applications with heavy WebSocket usage
# as it increases the default timeout configuration of 60
proxy_read_timeout 80;
}
}

TLS/SSL (HTTPS)

以下仅是简单 HTTPS 示例，并不是可用于生产环境的最优配置。

相关资源：

• 免费证书
• Ubuntu 上配置 TLS/SSL 的教程

server {
listen 443 ssl;
server_name yourdomain.com;

ssl on;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/privkey.pem;

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /path/to/fullchain.pem;

ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_session_timeout 1d;
ssl_session_cache shared:SSL:50m;
add_header Strict-Transport-Security max-age=15768000;
}

# Permanent redirect for HTTP to HTTPS
server {
listen 80;
server_name yourdomain.com;
return 301 https://$host$request_uri;
}

大型应用

负载均衡

upstream node_js {
server 0.0.0.0:3000;
server 0.0.0.0:4000;
server 123.131.121.122;
}

server {
listen 80;
server_name yourdomain.com;

location / {
proxy_pass http://node_js;
}
}