[!info] related notes

• 所属 MOC: Nginx Proxy Manager MOC
• 上位主题: Nginx MOC, Nginx
• 相关概念: 正向代理与反向代理

Nginx Proxy Management 的基本原理

概览（Overview）

• 这是一个什么东西？

  • Nginx Proxy Manager (NPM) 是一个基于 Node.js、MySQL/MariaDB 和 Nginx 的图形化反向代理管理工具。它被封装在一个易于部署的 Docker 容器中。

• 它解决什么问题？适用场景是什么？

  • 解决问题： 解决了手动编写、管理和更新复杂 Nginx 配置文件（尤其是涉及多服务、多域名和 SSL 证书时）的痛点。
  • 适用场景：
    1. 多服务部署 (Docker/VM)： 在一台主机上运行多个 Web 服务（如后端 API、前端网站、各种面板），需要一个统一入口。
    2. HTTPS 自动化： 快速、自动地为所有代理主机申请和续订 Let’s Encrypt 证书。
    3. 非技术用户： 为不熟悉 Linux 命令行或 Nginx 语法的用户提供一个简单的 Web 界面来配置反向代理。

• 一句话总结

  NPM 是一个 Docker 化的一站式 Web 界面，用于轻松管理 Nginx 反向代理、自定义配置和 Let’s Encrypt SSL 证书。

---

关键概念（Core Concepts）

• 代理主机 (Proxy Host)：
  • 说明：NPM 中最核心的配置单元。它定义了 一个域名 应该如何被代理到 一个目标地址（IP:Port）。
  • 例子：将 https://api.mydomain.com 转发到 Docker 网络中的 my-backend-service:3000。
• 自定义配置 (Custom Nginx Config)：
  • 说明：允许用户为特定的代理主机插入自定义的 Nginx 配置片段（例如：增加缓存头、CORS 设置、特定的限速规则），这些配置会被 NPM 自动整合到最终的 Nginx 配置中。
• Let’s Encrypt (免费 SSL/TLS)：
  • 说明：NPM 内置了对 Let’s Encrypt 的支持，可以一键自动化申请、配置和续订免费的 SSL 证书，实现 HTTPS。
• Access Lists (访问控制列表)：
  • 说明：用于限制特定代理主机的访问权限，可以基于 IP 地址或设置 HTTP 基本认证（用户名/密码）。
• 重定向主机 (Redirection Host)：
  • 说明：将一个域名重定向到另一个 URL（例如：将 http://old.com 永久重定向到 https://new.com/page）。

他到底有没有自带nginx？还有，他在部署一个静态的前端项目的时候，一般情况下，前端项目是要作为一个Docker容器来部署。那这个Docker容器中，只需要包含他自己本身吗？还是同时需要一个 nginx？

这是一个很好的问题，它涉及到了 Nginx Proxy Management (NPM) 的运行边界和 Docker 容器的最佳实践。

1. NPM 是否自带 Nginx？

答案是：是的，它自带 Nginx。

• 核心组成： Nginx Proxy Manager (NPM) 本身就是一个 Docker 镜像，这个镜像内部已经预装并配置好了 Nginx。
• 工作机制： 当你运行 NPM 的 Docker 容器时，实际上是运行了一个完整的服务栈，其中包含：
  • Nginx： 负责实际的反向代理和流量转发。
  • Node.js 或其他后端服务： 负责运行 Web 管理界面和处理配置逻辑。
  • 数据库 (如 SQLite 或 MariaDB/MySQL)： 用于存储你通过 Web 界面配置的所有代理规则、SSL 证书信息等。
• 总结： NPM 的本质就是 Nginx + 数据库 + 管理界面的封装。你不需要在运行 NPM 的主机上单独安装 Nginx。

2. 部署静态前端项目时，Docker 容器中是否需要 Nginx？

答案是：强烈建议需要一个 Nginx（或者一个轻量级的 Web 服务器，如 Caddy）。

• NPM 的角色： NPM 的角色是反向代理，它处于最前端，负责将外部请求转发给后端服务。它不会直接提供静态文件服务。
• 前端容器的角色： 你的前端项目容器需要一个 Web 服务器来托管你的 HTML、CSS、JavaScript 文件。
  • 反例（仅包含文件）： 如果你的前端 Docker 容器中只有项目文件（例如 index.html），而没有 Web 服务器，NPM 转发请求过去时，没有人能“听取”这个请求并返回文件，容器会无法响应 HTTP 请求。
  • 正例（包含 Web 服务器）：
    • 你需要使用一个 多阶段构建 (Multi-stage build) 的 Dockerfile，将你的前端代码（例如 Vue/React/Angular 的 dist 目录）复制到一个基于 Nginx 官方镜像的容器中。
    • 这个容器中的 Nginx 负责在特定的端口（例如 80）上提供静态文件服务。

部署架构对比

角色	服务/容器	作用	端口暴露 (给宿主机)
反向代理层	Nginx Proxy Manager (NPM 容器)	接收所有外部请求，根据域名转发。	80/443 (必须暴露)
应用层	前端项目容器 (内含 Nginx)	托管并提供静态文件服务。	80/443 (仅对 Docker 网络暴露)

总结： 在这个场景中，你有两层 Nginx：

1. NPM 内部的 Nginx (反向代理)： 负责接收公网流量，转发请求。
2. 前端容器内部的 Nginx (Web 服务器)： 负责提供静态文件。

这是标准且推荐的 Docker 微服务架构实践，因为它实现了职责分离，使得每个容器只专注于一个任务。