先说问题:端口越开越多,管理越来越乱
自建服务装到第三个,你就会撞上这堵墙:监控在 IP:25774、状态页在 IP:3001、云盘在 IP:5212……每个服务一个端口,全要记、全暴露在公网上、全都没有 HTTPS。浏览器对着密码库的登录页弹出「不安全」警告时,那种感觉尤其糟糕。
上一篇 自建服务入门:从一台 VPS 开始的完整规划 定下的规矩是:整台机器只开 80/443,所有 Web 服务通过反向代理按域名分发。实现这个规矩的工具就是本篇主角 Nginx Proxy Manager(下文简称 NPM):它把 Nginx 的反向代理和 Let’s Encrypt 证书管理包进了一个图形化界面,添加一个服务入口就是填几个框、点几下鼠标,不用手写 Nginx 配置,更不用手动续证书。
选型对比:为什么入门推荐 NPM
| 方案 | 上手难度 | 证书管理 | 适合人群 |
|---|---|---|---|
| 手写 Nginx 配置 | 高,要懂配置语法 | certbot 手动或脚本续期 | 有运维经验、需求复杂 |
| Caddy | 低,配置文件极简 | 全自动 | 喜欢配置文件管理的人 |
| Nginx Proxy Manager | 最低,全图形界面 | 界面一键申请、自动续期 | 自建入门、多服务统一管理 |
三者没有高下之分,本站 Docker 系列有 用 Caddy 给容器服务自动配 HTTPS 的完整教程,喜欢 Caddy 的可以走那条路线。本系列选 NPM 做统一入口,看中的是它的 Access List(访问控制列表)和可视化管理——服务多了之后,在一个面板里看清所有转发规则,价值很大。
部署:一份 Compose 搞定
按系列规范,服务装在 /opt/apps/nginx-proxy-manager/ 下。先把子域名 npm.example.com 的 A 记录解析到 VPS(管理后台也要走域名加 HTTPS),然后写 Compose:
services: npm: image: jc21/nginx-proxy-manager:latest container_name: nginx-proxy-manager restart: unless-stopped ports: - "80:80" - "443:443" - "81:81" volumes: - ./data:/data - ./letsencrypt:/etc/letsencryptcd /opt/apps/nginx-proxy-managerdocker compose up -d端口说明:80 和 443 是对外服务的正门;81 是 NPM 自己的管理后台端口。注意防火墙层面,81 端口不要对公网开放——等下我们会把管理后台也套上 NPM 自己的反代(用域名加 HTTPS 访问),然后把 81 限制为仅本机或干脆只在初始配置时临时放行。数据目录里,/data 存 NPM 的配置数据库与站点配置,/etc/letsencrypt 存证书,两者都在备份范围内。
首次启动后访问 http://你的IP:81,用默认账号登录:
- 邮箱:
admin@example.com - 密码:
changeme
登录后第一件事就是改邮箱和密码,默认凭据是公开信息,拖着不改等于大门敞开。改完凭据,在 NPM 里给它自己先建一条转发:新建 Proxy Host,域名填 npm.example.com,转发到 127.0.0.1 的 81 端口,SSL 页签申请新证书并勾选 Force SSL。完成后改用 https://npm.example.com 访问后台,并到云厂商防火墙/系统防火墙里关掉公网 81。
给服务添加入口:Proxy Host 标准流程
以后每装一个新服务,入口配置都是同一套动作,以后面要装的监控面板为例:
- DNS 先加好子域名解析,如
status.example.com→ VPS 的 IP。 - NPM 后台 → Proxy Hosts → Add Proxy Host。
- Domain Names 填
status.example.com。 - Scheme 选
http,Forward Hostname/IP 与 Forward Port 填服务实际监听地址(见下一节)。 - 打开 Block Common Exploits;服务是实时类应用(如聊天、日志流)再打开 Websockets Support。
- SSL 页签选 Request a new SSL Certificate,勾选 Force SSL 与 HTTP/2 Support,同意 Let’s Encrypt 条款。
- 保存,浏览器访问域名验证。
证书申请走的是 HTTP 验证,申请时 80 端口必须能从公网访问且域名解析已生效,这两条不满足是证书失败的最常见原因。证书有效期 90 天,NPM 会自动续期,不用操心。
转发地址怎么写:三种情形
Forward Hostname/IP 填什么,取决于服务和 NPM 的相对位置:
| 情形 | 填法 | 说明 |
|---|---|---|
| 服务与 NPM 在同一个 Compose/网络 | 容器名,如 komari | Docker 内网 DNS 自动解析,最干净 |
| 服务在同一台机器、端口映射到宿主机 | 172.17.0.1 + 映射端口 | 172.17.0.1 是默认 docker0 网桥上宿主机的地址 |
| 服务在另一台机器 | 那台机器的内网/公网 IP | 跨机器时注意对方防火墙放行来源 |
本系列的部署大多是「各服务独立 Compose、端口映射到宿主机」,所以常用第二种写法:服务 Compose 里把端口映射出来,NPM 转发到 172.17.0.1:端口。同时宿主机防火墙只放行 80/443/SSH,服务端口虽然映射在宿主机上,但被防火墙挡在外面,只有本机的 NPM 能访问到——这正是「只开三个端口」的实现方式。
进阶两件套:访问控制与自定义配置
Access Lists 是 NPM 被低估的功能。给监控、密码库这类敏感服务的 Proxy Host 绑一个 Access List,可以叠加两层保护:IP 白名单(只允许你自己的出口 IP 段访问)和/或 HTTP 基础认证(进服务登录页之前先过一道 NPM 的账号密码)。哪怕某个服务将来爆出登录绕过漏洞,这道前置门也能挡住绝大多数扫描。完整的加固思路在第 11 篇 自建服务安全加固:最小暴露与访问控制 展开。
Advanced 页签 可以给单个站点追加原生 Nginx 配置,常见用途是放行大文件上传。默认 Nginx 对请求体大小有限制,云盘类服务传大文件报 413 时,在对应 Proxy Host 的 Advanced 里加:
client_max_body_size 0;保存即生效,不用重启容器。改之前想清楚作用域:这行只加在需要的站点上,别图省事写进全局。
排障:最常见的三个问题
502 Bad Gateway:NPM 活着但上游不通。依次查:服务容器是否在运行(docker compose ps)、转发 IP 和端口是否写对、在 NPM 容器内能否连通上游(docker exec -it nginx-proxy-manager curl -v http://172.17.0.1:端口)。九成是端口写错或服务没起来。
证书申请失败:先自查 curl http://你的域名 能否从外网打开(哪怕是报错页面),再确认云厂商安全组放行了 80。DNS 刚改完要等生效,用 dig +short 域名 看解析是不是已经指向本机。
跳转死循环/页面资源加载不全:多见于服务本身不知道自己在反代后面。优先在服务侧找「外部访问地址/站点 URL」类设置,填成 https://子域名;个别服务需要在 Advanced 里补 proxy_set_header X-Forwarded-Proto $scheme;,NPM 默认已带大部分转发头,先查服务侧设置再动这里。
改完配置不生效:NPM 保存时会自动 reload Nginx,若页面缓存顽固,先强刷浏览器,再看 docker compose logs -f 里有没有配置校验报错——Advanced 里写错语法会导致该站点配置加载失败,删掉自定义段即可恢复。
WARNINGNPM 的管理后台本身就是全屋服务的钥匙:强密码、不开公网 81、再给它绑一个 Access List 做 IP 白名单,这三件事做完再去装别的服务。入口的安全等级,决定整套自建体系的安全上限。
常见问题
Q:已经用 Caddy/原生 Nginx 了,有必要换 NPM 吗? 没必要为了换而换。统一入口的目的是「只开 80/443 + 证书自动管理」,你现有方案做到了就继续用,本系列后续篇目里「通过 NPM 添加入口」的步骤,换成你自己的反代等价操作即可。
Q:服务在本机跑但不是 Docker 部署的,能转发吗?
可以,Forward 填 127.0.0.1 在 NPM 容器内指向的是容器自己,要填宿主机地址 172.17.0.1 加服务端口(服务需监听 0.0.0.0 或网桥可达的地址)。
Q:一个域名多个路径分给不同服务行不行? NPM 支持 Custom Locations 按路径转发,但很多 Web 应用对子路径部署不友好(静态资源写死根路径)。一人一个子域名是省心做法,不建议用路径硬凑。
Q:NPM 挂了是不是所有服务都进不去? 是的,这就是统一入口的代价。所以 NPM 的数据目录必须进备份清单,并且用第 4 篇的 Uptime Kuma:服务可用性监控与公开状态页 把 NPM 本身也列为监控对象——它值得被最先盯上。
小结
Nginx Proxy Manager 把反向代理这件「概念重要、配置繁琐」的事变成了填表:一条 Proxy Host 记录 = 一个子域名 + 一份自动续期的 HTTPS 证书 + 可选的访问控制。整台机器对外只剩 80/443,服务增减都在一个面板里完成。先有统一入口,后面的每个服务才有资格谈安全与好用。地基打完,接下来给这台机器装上眼睛:Komari 监控面板与 Agent,先把「机器还好吗」这个问题解决掉。