一、项目简介

Nginx Proxy Manager（NPM）是一个非常流行的可视化反向代理管理工具，可以让你无需手写 Nginx 配置文件，就能完成：

• 域名绑定
• 反向代理
• HTTPS 证书申请
• 网站转发管理

本项目：

👉 https://github.com/xiaoxinpro/nginx-proxy-manager-zh

是基于官方 NPM 的中文汉化版本，更适合国内用户使用。

---

✨ 项目特点

• 🌐 Web 可视化界面管理 Nginx
• 🔐 自动申请 SSL 证书（Let's Encrypt）
• 🔁 支持反向代理多个网站
• 📦 Docker 一键部署
• 🇨🇳 中文界面（降低学习成本）
• ⚡ 支持 80 / 443 / 81 端口管理

---

二、系统架构说明

Nginx Proxy Manager 本质是：

“Nginx + Web UI + SSL 自动化管理系统”

结构如下：

用户访问域名
      ↓
Nginx Proxy Manager
      ↓
反向代理规则
      ↓
内部服务（Docker / API / Web）

---

三、环境要求

安装前请确认：

• Docker 已安装（推荐 20+）
• Docker Compose（推荐）
• Linux / Windows / NAS / VPS
• 端口开放：
  • 80（HTTP）
  • 443（HTTPS）
  • 81（管理后台）

---

四、Docker 一键安装（推荐）

1. 创建数据目录

mkdir -p /opt/nginx-proxy-manager
cd /opt/nginx-proxy-manager

---

2. 编写 docker-compose.yml

version: "3"

services:
  npm:
    image: chishin/nginx-proxy-manager-zh:latest
    container_name: npm-zh
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "81:81"
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt

---

3. 启动服务

docker compose up -d

---

五、访问管理后台

启动成功后访问：

http://服务器IP:81

---

默认账号（首次登录）

部分版本默认：

Email:    admin@example.com
Password: changeme

首次登录后系统会强制你修改密码。

---

六、添加反向代理（核心功能）

1. 添加 Proxy Host

进入后台：

👉 Proxy Hosts → Add Proxy Host

填写：

---

2. 开启 HTTPS（推荐）

在 SSL 选项中：

• 勾选 “Request a new SSL Certificate”
• 勾选 “Force SSL”
• 输入邮箱
• 保存

系统会自动申请证书。

---

七、典型使用场景

1. 反代本地服务

例如：

• Docker 面板
• API 服务
• Web 项目

---

2. 多服务统一域名

---

3. HTTPS 自动化

无需手动配置证书：

• 自动申请
• 自动续期
• 全程 GUI 操作

---

八、Docker Compose 高级配置（推荐）

version: "3.8"

services:
  npm:
    image: chishin/nginx-proxy-manager-zh:latest
    container_name: npm
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "81:81"
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    environment:
      TZ: Asia/Shanghai

---

九、端口说明

---

十、常见问题（FAQ）

Q1：无法访问 81 端口？

检查：

• Docker 是否启动
• 防火墙是否放行
• 端口是否被占用

---

Q2：SSL 证书申请失败？

原因：

• 域名未解析到服务器
• 80 端口未开放
• DNS 未生效

---

Q3：反向代理访问 502？

检查：

• 后端服务是否启动
• IP/端口是否正确
• Docker 网络是否正常

---

十一、适用场景

Nginx Proxy Manager 非常适合：

• VPS 建站
• 家庭 NAS
• 内网穿透替代方案
• 多项目统一管理
• API 网关前置代理

---

十二、总结

Nginx Proxy Manager 中文版的核心价值：

🔥 用“点点鼠标”代替“写 Nginx 配置”

它让反向代理变成：

• 可视化
• 自动化
• 低门槛

对于新手来说非常友好，是 VPS 建站必备工具之一。