Nginx Proxy Manager教程：快速入门指南
Nginx Proxy Manager 快速入门指南
什么是 Nginx Proxy Manager？
Nginx Proxy Manager (NPM) 是一个基于 Nginx 的图形化管理工具，允许用户通过简单的 Web 界面轻松设置反向代理、SSL 证书和访问控制，无需直接编辑 Nginx 配置文件。
安装 Nginx Proxy Manager
Docker 安装方式（推荐）
- 确保已安装 Docker 和 Docker Compose
- 创建
docker-compose.yml 文件：
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
- 启动容器：
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
# 克隆仓库
git clone https://github.com/jc21/nginx-proxy-manager.git
cd nginx-proxy-manager
# 安装依赖
npm install
# 启动
npm start
初始设置
- 访问管理界面：
http://服务器IP:81
- 默认登录凭据：
- 邮箱:
admin@example.com
- 密码:
changeme
- 首次登录后立即更改密码
基本配置
1. 添加代理主机
- 登录后点击 "Hosts" > "Proxy Hosts" > "Add Proxy Host"
- 配置项：
- Domain Names: 你的域名 (如 example.com)
- Scheme: http 或 https
- Forward Hostname/IP: 目标服务器IP或主机名
- Forward Port: 目标服务端口
- 其他选项根据需要配置
2. 配置SSL证书
- 在添加或编辑代理主机时，切换到 "SSL" 标签
- 选择 "Let's Encrypt"
- 输入有效的邮箱地址
- 勾选 "I agree to the Let's Encrypt Terms of Service"
- 选择 "Use a DNS challenge" 或 "HTTP challenge" (根据需求)
- 保存配置，证书将自动申请和安装
3. 设置访问控制
- 在代理主机配置中，切换到 "Access" 标签
- 点击 "Add access control"
- 配置：
- Name: 规则名称
- Username/Password: 访问凭据
- 可设置多个用户
高级功能
重定向配置
- 点击 "Hosts" > "Redirection Hosts" > "Add Redirection Host"
- 配置源域名和目标URL
- 可选择永久(301)或临时(302)重定向
流配置（TCP/UDP转发）
- 点击 "Hosts" > "Streams" > "Add Stream"
- 配置：
- Incoming Port: 外部访问端口
- Forwarding Port: 目标端口
- Forwarding Host: 目标主机
自定义Nginx配置
- 在代理主机配置中，切换到 "Advanced" 标签
- 可添加自定义Nginx配置片段
常见问题解决
1. 端口冲突
确保主机上的80、443和81端口未被其他服务占用。如有冲突：
- 修改docker-compose.yml中的端口映射（如8080:80）
- 或在直接安装时修改NPM的配置文件
2. SSL证书申请失败
- 确保域名已正确解析到服务器IP
- 检查防火墙是否开放了80和443端口
- 对于DNS验证，确保正确配置了API密钥
3. 无法访问管理界面
- 检查容器是否正常运行：
docker ps
- 查看日志：
docker logs <container_name>
- 确保防火墙允许81端口访问
最佳实践
- 定期备份
/data目录（包含所有配置）
- 设置自动更新容器以获取安全补丁
- 为管理界面设置强密码并考虑限制访问IP
- 监控NPM的资源使用情况，高流量网站可能需要调整
升级Nginx Proxy Manager
对于Docker安装方式：
docker-compose down
docker-compose pull
docker-compose up -d
通过本指南，您应该能够快速设置并运行Nginx Proxy Manager，轻松管理您的反向代理需求。
