Nginx Proxy Manager 轻松搭建反向代理指南

什么是Nginx Proxy Manager

Nginx Proxy Manager (NPM) 是一个基于Nginx的图形化管理工具，它让反向代理的配置变得非常简单直观，无需手动编辑复杂的Nginx配置文件。

为什么选择Nginx Proxy Manager

1. 用户友好：提供Web界面管理，告别命令行配置
2. 功能全面：支持HTTP/HTTPS、WebSocket、负载均衡等
3. 证书管理：内置Let's Encrypt自动证书申请和续期
4. 轻量高效：基于Nginx，性能优异

安装Nginx Proxy Manager

Docker方式安装（推荐）

# 创建数据目录
mkdir -p ~/nginx-proxy-manager/data
mkdir -p ~/nginx-proxy-manager/letsencrypt

# 使用docker-compose运行
cat > ~/nginx-proxy-manager/docker-compose.yml <<EOF
version: '3'
services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    ports:
      - '80:80'
      - '81:81'
      - '443:443'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
EOF

cd ~/nginx-proxy-manager
docker-compose up -d

传统安装方式

# 安装依赖
sudo apt update
sudo apt install -y curl git nginx

# 安装Node.js
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt install -y nodejs

# 安装NPM
git clone https://github.com/jc21/nginx-proxy-manager.git
cd nginx-proxy-manager
npm install
npm run build
npm start

初始配置

1. 访问管理界面：http://服务器IP:81
2. 默认管理员账号：
   • Email: admin@example.com
   • Password: changeme
3. 首次登录后立即修改密码

配置反向代理

基本反向代理设置

1. 登录管理界面
2. 点击"Hosts" > "Proxy Hosts" > "Add Proxy Host"
3. 填写配置：
   • Domain Names: 你的域名 (如 example.com)
   • Scheme: http 或 https
   • Forward Hostname/IP: 目标服务器IP或主机名
   • Forward Port: 目标服务端口
4. 点击"Save"保存

HTTPS配置

1. 在添加或编辑Proxy Host时，切换到SSL标签
2. 选择"Request a new SSL Certificate"
3. 填写邮箱地址并勾选"同意条款"
4. 确保域名已正确解析到服务器IP
5. 点击"Save"申请证书

高级功能

1. WebSocket支持：在Advanced标签中开启
2. 访问控制：可以设置基本认证或IP限制
3. 自定义Nginx配置：在Advanced标签中添加
4. 重定向：支持URL重定向和域名重定向
5. 负载均衡：可以配置多个后端服务器

常见问题解决

1. 端口冲突

如果80或443端口被占用：

# 查看占用端口的进程
sudo netstat -tulnp | grep ':80\|:443'
# 停止相关服务或修改NPM的映射端口

2. Let's Encrypt证书申请失败

• 确保域名已正确解析到服务器
• 检查防火墙是否开放80和443端口
• 确保没有其他服务占用这些端口

3. WebSocket连接问题

在Advanced配置中添加：

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;

4. 性能优化

对于高流量站点，可以调整Nginx参数：

client_max_body_size 100M;
proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;

最佳实践

1. 定期备份/data目录下的配置文件
2. 为管理界面(81端口)设置防火墙规则，限制访问IP
3. 监控NPM的日志文件，及时发现异常
4. 使用单独的Docker网络隔离服务
5. 定期更新到最新版本

总结

Nginx Proxy Manager大大简化了Nginx反向代理的配置过程，特别适合不熟悉Nginx配置的用户。通过图形化界面，几分钟内就能完成复杂的代理配置和SSL证书部署，是个人开发者和小型团队的理想选择。