前往 Vapor 2.0 - 文档目录

Nginx是一个非常快速，经过测试，易于配置的HTTP服务器和代理。虽然Vapor支持使用或不使用TLS直接提供HTTP请求，但是Nginx后面的代理可以提供更高的性能，安全性和易用性。

注意
我们建议代理Nginx后面的Vapor HTTP服务器。

概述（Overview）

代理HTTP服务器意味着什么？简而言之，代理人作为公共互联网和HTTP服务器之间的中间人。请求到代理，然后发送到Vapor。

这个中间人代理的一个重要特征是它可以改变甚至重定向请求。例如，代理可以要求客户端使用TLS（https），速率限制请求，甚至可以在不与您的Vapor应用程序通信的情况下提供公共文件。

更多细节（More Detail）

用于接收HTTP请求的默认端口是80端口（HTTPS是443端口）。当您将Vapor服务器绑定到80端口时，它将直接接收并响应到您的服务器的HTTP请求。当添加像Nginx这样的代理程序时，可以将Vapor绑定到内部端口，如8080端口。

注意
大于1024的端口不需要sudo绑定。

当Vapor绑定到80端口或443端口时，外部互联网不可访问。然后，您将Nginx绑定到80端口，并将其配置为将请求路径到8080端口(或您选择的任何端口)上绑定的Vapor服务器。

就是这样 。如果Nginx配置正确，您会看到您的Vapor应用程序响应80端口上的请求。Nginx在不可见的情况下代理请求和响应。

安装Nginx（Install Nginx）

第一步是安装Nginx。Nginx的一个重要部分是围绕它的大量社区资源和文档。因此，我们不会在这里详细介绍Nginx，因为几乎肯定会有一个专门的平台、操作系统和提供程序的教程。

教程：

• 如何在Ubuntu 14.04 LTS上安装Nginx
• 如何在Ubuntu 16.04上安装Nginx
• 如何在Heroku上部署Nginx
• 如何在Ubuntu 14.04的Docker容器中运行Nginx

APT

Nginx可以通过APT安装。

sudo apt-get update
sudo apt-get install nginx

在浏览器中访问服务器的IP地址，检查Nginx是否正确安装

http://server_domain_name_or_IP

服务（Server）

该服务可以启动或停止。

sudo service nginx stop
sudo service nginx start
sudo service nginx restart

引导蒸气（Booting Vapor）

Nginx可以用sudo service nginx ...命令启动一个停止。您将需要类似启动和停止您的Vapor服务器的东西。

有很多方法可以做到这一点，它们取决于您要部署的平台。查看管理员说明，添加启动和停止Vapor应用程序的命令。

配置代理（Configure Proxy）

在/etc/nginx/sites-enabled/里可以找到启用的站点的配置文件。

创建一个新的文件或复制示例模板从/etc/nginx/sites-available/开始。

下面是一个示例配置文件，用于在主目录中名为Hello的Vapor项目。

server {
    server_name hello.com;
    listen 80;

    root /home/vapor/Hello/Public/;

    location @proxy {
        proxy_pass http://127.0.0.1:8080;
        proxy_pass_header Server;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass_header Server;
        proxy_connect_timeout 3s;
        proxy_read_timeout 10s;
    }
}

这个配置文件假设Hello项目在生产模式下启动时绑定到8080端口。

服务文件（Serving Files）

Nginx也可以提供公共文件，而不要求您的Vapor应用程序。这可以通过在重负载下为其他任务释放Vapor的过程来提高性能。

server {
    ...

    # Serve all public/static files via nginx and then fallback to Vapor for the rest
    try_files $uri @proxy;

    location @proxy {
        ...
    }
}

TLS

添加TLS相对简单,只要证书已经被正确地生成的。免费生成TLS证书,请查看 Let's Encrypt。

server {
    ...

    listen 443 ssl;

    ssl_certificate /etc/letsencrypt/live/hello.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/hello.com/privkey.pem;

    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;
    ssl_dhparam /etc/ssl/certs/dhparam.pem;
    ssl_ciphers 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA';
    ssl_session_timeout 1d;
    ssl_session_cache shared:SSL:50m;
    ssl_stapling on;
    ssl_stapling_verify on;
    add_header Strict-Transport-Security max-age=15768000;

    ...

    location @proxy {
       ...
    }
}

上面的配置是使用Nginx的TLS的相对严格的设置。这里的一些设置不是必需的，但增强安全性。