NginxProxyManager如何配置代理服务负载均衡？
NginxProxyManager (NPM) 作为一个基于Nginx的强大反向代理管理工具，但配置服务端负载均衡却有些麻烦。
渲染中...
NginxProxyManager (NPM) 作为一个基于Nginx的强大反向代理管理工具，以其直观的Web界面深受用户喜爱。虽然NPM本身主要用于管理单个后端服务的代理，但通过巧妙地结合Nginx的自定义配置能力，我们同样可以实现强大的负载均衡功能。
本文将详细介绍如何通过修改/新增自定义配置文件，并结合NginxProxyManager看板中的“Custom Nginx Configuration”设置，为您的代理服务配置负载均衡。我们将专注于这种方案，不涉及其他实现方式。
## 1. 准备工作
在开始配置之前，请确保您已完成以下准备：
* **NginxProxyManager已安装并正常运行**：您可以通过Docker或直接安装。
* **多个后端服务实例**：您需要至少两个或更多提供相同服务的后端服务器（例如，运行在不同IP或端口上的Web应用实例）。
* **NPM的数据目录访问权限**：您需要能够访问NPM容器内部的`/data/nginx/`目录，通常通过Docker卷挂载实现。
## 2. 方案核心操作
本方案的核心思想是：
1. 在NPM的数据目录中创建一个自定义Nginx配置文件，用于定义一个或多个“上游服务器组”（`upstream`）。
2. 在NPM的代理主机配置中，利用“Custom Nginx Configuration”选项，将请求代理到我们自定义的上游服务器组。
### 2.1.创建自定义上游服务器配置文件
首先，我们需要在NPM的Nginx配置目录中创建一个自定义文件，用于定义负载均衡的上游服务器组。
1. **访问NPM数据目录**：
通常，NPM的Nginx配置位于其Docker容器内的`/etc/nginx/conf.d/`或`/data/nginx/`。为了持久化和方便管理，NPM会将自定义配置加载自`/data/nginx/custom/`目录。
如果您使用Docker运行NPM，您可以通过挂载卷的方式访问此目录。例如，如果您的NPM容器将本地的`./npm_data`目录挂载到容器内的`/data`，那么您应该在`./npm_data/nginx/custom/`路径下创建文件。
2. **创建或修改配置文件**：
在`/data/nginx/custom/`目录下创建一个新的`.conf`文件，例如命名为`http_upstream.conf`。
```bash
# 示例：如果您在宿主机上，且npm_data是挂载目录
cd /path/to/your/npm_data/nginx/custom/
touch http_upstream.conf
```
3. **编辑`http_upstream.conf`文件**：
使用您喜欢的文本编辑器打开`http_upstream.conf`，并添加以下内容：
```nginx
# 定义一个名为 'my_backend_servers' 的上游服务器组
upstream server_cluster {
# 后端服务器1：IP地址和端口，权重为5
server 192.168.1.100:8080 weight=5 max_fails=3 fail_timeout=30s;
# 后端服务器2：IP地址和端口，权重为3
server 192.168.1.101:8080 weight=3 max_fails=3 fail_timeout=30s;
# 后端服务器3：IP地址和端口，默认权重为1
server 192.168.1.102:8080;
# 备用服务器：当所有主服务器都不可用时，流量会转发到此服务器
# server 192.168.1.103:8080 backup;
# 标记为不可用：通常用于临时维护
# server 192.168.1.104:8080 down;
# 负载均衡算法（可选，默认为轮询）：
# round-robin (默认)
# least_conn; # 最少连接数
# ip_hash; # 基于客户端IP的哈希，实现会话粘滞
# hash $request_uri consistent; # 基于URI的哈希
}
# 如果您有其他需要负载均衡的服务，可以定义更多 upstream 块
# upstream server_cluster {
# server 192.168.1.200:9000;
# server 192.168.1.201:9000;
# }
```
**参数解释**：
* `upstream my_backend_servers { ... }`：定义一个名为`my_backend_servers`的上游服务器组。这个名称将在NPM的自定义配置中使用。
* `server IP:PORT`：指定后端服务器的IP地址和端口。
* `weight=N`：设置服务器的权重。权重越高，Nginx转发给它的请求越多。默认权重为1。
* `max_fails=N`：在`fail_timeout`时间内，如果Nginx与后端服务器通信失败N次，则认为该服务器不可用。默认值为1。
* `fail_timeout=Ns`：在N秒内，如果服务器失败次数达到`max_fails`，则该服务器将被标记为不可用，并在`fail_timeout`时间后再次尝试。默认值为10秒。
* `backup`：将服务器标记为备用服务器。当所有非`backup`服务器都不可用时，请求才会被转发到`backup`服务器。
* `down`：将服务器标记为永久不可用。通常用于临时禁用某个服务器。
* **负载均衡算法**：
* `round-robin` (默认)：按顺序将请求分发到每个服务器。
* `least_conn`：将请求发送到当前连接数最少的服务器。
* `ip_hash`：根据客户端IP地址的哈希值将请求分发到服务器，确保同一客户端的请求始终发送到同一台服务器，实现会话粘滞。
### 2.2.在NginxProxyManager中配置代理主机
接下来，我们将在NPM的Web界面中创建一个新的代理主机，并利用其“Custom Nginx Configuration”功能来引用我们定义好的上游服务器组。
1. **登录NginxProxyManager**：
打开您的NPM Web界面，并登录。
2. **添加新的代理主机**：
导航到“Proxy Hosts”页面，点击“Add Proxy Host”。
3. **填写“Details”选项卡**：
* **Domain Names**：输入您希望通过此代理访问服务的域名（例如：`myapp.example.com`）。
* **Scheme**：选择`http`或`https`，这取决于您的后端服务监听的协议。
* **Forward Hostname / IP**：**此处填写一个占位符即可，例如`127.0.0.1`。** 因为我们将在“Custom Nginx Configuration”中覆盖实际的转发目标，所以这里的设置不会生效，但NPM要求此字段必须填写。
* **Forward Port**：**同样填写一个占位符，例如`80`。**
* 根据您的需求勾选`Cache Assets`、`Block Common Exploits`、`Websockets Support`等选项。
4. **配置“SSL”选项卡**：
根据您的域名和证书情况，配置SSL证书。建议使用Let's Encrypt自动申请。
5. **配置“Advanced”**：
这是最关键的一步。在Advanced选项卡中，找到 `Custom Nginx Configuration` 在此文本框中，输入以下Nginx配置代码：
```nginx
location / {
proxy_pass http://server_cluster;
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_set_header X-Forwarded-Proto $scheme;
}
```
**解释**：
* `proxy_pass http://my_backend_servers;`：这条指令告诉Nginx，将所有到达此代理主机的请求转发到名为`my_backend_servers`的上游服务器组。Nginx会根据您在`http_upstream.conf`中定义的负载均衡算法和服务器列表进行分发。
* `proxy_set_header ...`：这些指令用于设置HTTP请求头，确保后端服务器能够正确识别客户端的真实IP地址、原始请求域名和协议等信息。这对于日志记录、安全策略和某些应用程序的正常运行至关重要。
6. **保存代理主机**：
点击“Save”按钮保存您的代理主机配置。NPM会自动重新加载Nginx配置，使更改生效。
### 2.3.验证负载均衡配置
配置完成后，您需要验证负载均衡是否正常工作。
1. **访问您的域名**：
在浏览器中访问您配置的域名（例如`http://myapp.example.com`或`https://myapp.example.com`）。
2. **检查后端服务器响应**：
如果您的后端服务能够显示其所在服务器的标识（例如服务器IP、主机名或一个独特的页面内容），您可以多次刷新页面，观察请求是否被分发到了不同的后端服务器。
3. **查看NginxProxyManager日志**：
检查NPM的日志，确认没有配置错误。
4. **后端服务器日志**：
查看后端服务器的访问日志，确认请求确实来自NPM，并且请求被分发到了不同的服务器。
## 4. 总结与注意事项
通过上述步骤，您已经成功地在NginxProxyManager中配置了代理服务的负载均衡。这种方法充分利用了NPM管理界面的便利性和Nginx底层配置的灵活性。
**注意事项**：
* **会话粘滞（Session Stickiness）**：如果您的应用程序需要保持用户会话与特定后端服务器的连接（例如，用户登录后必须访问同一台服务器），您可能需要使用`ip_hash`负载均衡算法，或者在应用程序层面实现会话共享（如使用Redis）。
* **健康检查**：Nginx的`max_fails`和`fail_timeout`提供了基本的健康检查功能。对于更高级的健康检查（例如检查特定URL的响应内容），您可能需要结合其他工具或更复杂的Nginx配置。
* **配置更新**：当您修改`http_upstream.conf`文件后，NPM不会自动重新加载Nginx配置。您需要进入NPM的Web界面，找到任意一个代理主机，编辑并保存它（无需做任何实际修改），NPM就会重新加载所有Nginx配置。或者，如果您直接操作Docker，可以重启NPM容器。
> 你有什么其他方案吗？END
评论
登录后查看和发表评论
前往登录