Nginx Proxy Manager

Nginx Proxy Manager(常简称 NPM)是一个开源的图形化反向代理管理工具。它在强大的 Nginx Web 服务器之上,封装出一个友好的 Web 管理界面,让用户无需手写 Nginx 配置文件,就能轻松地把多个内部服务通过域名对外发布,并自动申请与续期 Let's Encrypt 免费 SSL 证书。NPM 极大降低了反向代理与 HTTPS 的配置门槛,是 homelab 与自托管玩家把内网服务安全暴露到公网的标志性工具。

发展背景

在自托管场景中,人们常在一台服务器上运行多个 Web 服务(NAS 界面、媒体库、博客、各类面板等),希望用不同域名访问并统一启用 HTTPS。手工编写并维护 Nginx 的 server 块与证书既繁琐又易错。NPM 应运而生,以 Docker 一键部署、图形界面增删代理、自动化证书管理的方式,把这一过程简化为点选操作,因而在自托管社区广泛流行。

核心功能

• 图形化反向代理:通过界面添加 Proxy Host,把域名转发到内部服务的 IP 与端口。
• 自动 SSL 证书:一键申请 Let's Encrypt 证书并自动续期,支持 DNS 验证以签发泛域名证书。
• 访问控制:为站点设置 HTTP Basic Auth 访问列表,限制可访问的来源 IP。
• 重定向与自定义:配置 301/302 重定向、自定义 Nginx 配置片段、自定义错误页。
• 流转发(Stream):支持 TCP/UDP 端口转发。
• 多用户:支持多个管理员账户与权限管理。

技术架构

NPM 本质上是一个面向 Nginx 的配置生成器与管理面板。它通常以 Docker 容器部署,内部包含 Nginx(以 OpenResty 为基础)、一个 Node.js 后端与前端管理界面,数据存于 SQLite 或外接 MySQL/MariaDB。当用户在界面中创建代理主机时,NPM 会生成对应的 Nginx server 配置并重载 Nginx 生效;证书部分则集成 acme.sh / certbot 流程,向 Let's Encrypt 完成 ACME 验证、签发与定期续期。所有改动都通过界面完成,底层配置对用户透明。

部署与硬件要求

• 部署方式:以 Docker / docker-compose 部署最为常见,几条配置即可启动。
• 资源:占用很低,普通家用主机、NAS、小型云服务器均可。
• 端口:需占用 80/443 用于 Web 流量与 ACME 验证,以及一个管理界面端口。
• 前置条件:对外发布需有可解析到本机公网 IP 的域名;家庭宽带需做端口转发或借助 DNS 验证签证书。

典型使用场景

• 统一入口:把 NAS 界面、媒体库、监控面板等多个服务用不同子域名集中发布并加 HTTPS。
• 自动 HTTPS:为自托管服务一键获得受信任证书,免去手动续期。
• 内网服务安全暴露:配合访问列表与认证,限制谁能访问后端服务。
• homelab 网关:作为家庭服务器对外的反代统一层。

与同类对比

相较直接手写 Nginx 配置,NPM 牺牲了一部分灵活性与可版本化管理,换来极低的上手门槛与自动化证书。相较 Traefik(以标签/动态服务发现见长,适合容器编排环境),NPM 更直观、面向人工点选管理,但缺少自动服务发现。相较 Caddy(配置简洁且默认自动 HTTPS),NPM 提供图形界面,Caddy 则以极简配置文件取胜。对偏好图形化、不熟命令行的用户,NPM 体验最友好。

优缺点与注意事项

• 优点:图形化易用、自动签发与续期 SSL、Docker 一键部署、适合多服务统一发布、开源免费。
• 缺点:高级 Nginx 特性需写自定义片段、配置不便纳入版本管理、缺少容器自动发现。
• 注意:管理界面应设强密码并避免直接暴露公网;对外发布服务务必配合认证与访问控制;升级前备份其数据卷(含证书与配置)。