当前位置：首页 > news >正文

轻松上手Nginx Proxy Manager：安装、配置与实战

news 2026/5/12 12:04:57

轻松上手Nginx Proxy Manager：安装、配置与实战

安装部署
- 概述
- 安装Docker和Docker Compose
- 创建项目目录
- 创建Docker Compose文件
- 启动
- 数据存储方式说明
Web管理控制台
- 访问Web界面
- 登录
基本使用
- 域名与IP绑定
- 添加代理主机
- 配置说明
- 保存并应用配置
- 一键申请SSL证书
申请泛域名SSL证书
- 获取API令牌
- 添加泛域名证书
- 新建代理
- 验证

安装部署

概述

Nginx Proxy Manager (NPM) 是一个基于 Nginx 的反向代理管理工具，旨在简化 Nginx 的配置和管理。它提供了一个直观的 Web 界面，使用户可以轻松地设置和管理反向代理、SSL 证书、访问控制等功能。

官网：https://nginxproxymanager.com/

GitHub：https://github.com/NginxProxyManager/nginx-proxy-manager

安装Docker和Docker Compose

如果你的系统上还没有安装Docker和Docker Compose，你可以根据你的操作系统参考官方文档进行安装：

Docker安装文档

Docker Compose安装文档

创建项目目录

创建一个目录来存放Docker Compose文件和相关配置文件：

mkdir nginx-proxy-manager cd nginx-proxy-manager

创建Docker Compose文件

在项目目录中创建一个名为docker-compose.yml的文件，并添加以下内容：

services: app: image: 'jc21/nginx-proxy-manager:latest' restart: unless-stopped ports: - '80:80' - '81:81' - '443:443' volumes: - ./data:/data - ./letsencrypt:/etc/letsencrypt

启动

在项目目录中运行以下命令启动Nginx Proxy Manager，这将下载所需的Docker镜像并启动容器。

docker-compose up -d # 如果使用docker-compose-plugin docker compose up -d

数据存储方式说明

Nginx Proxy Manager默认使用SQLite数据库来存储其数据，包括配置、代理主机信息、SSL 证书等。除此之外，Nginx Proxy Manager还可以使用MySQL来进行数据存储。

以下是一个docker-compose.yml文件，Nginx Proxy Manager使用MySQL进行数据存储的示例

version: '3.8' services: app: image: 'jc21/nginx-proxy-manager:latest' restart: unless-stopped ports: # These ports are in format <host-port>:<container-port> - '80:80' # Public HTTP Port - '443:443' # Public HTTPS Port - '81:81' # Admin Web Port # Add any other Stream port you want to expose # - '21:21' # FTP environment: # Mysql/Maria connection parameters: DB_MYSQL_HOST: "db" DB_MYSQL_PORT: 3306 DB_MYSQL_USER: "npm" DB_MYSQL_PASSWORD: "npm" DB_MYSQL_NAME: "npm" # Uncomment this if IPv6 is not enabled on your host # DISABLE_IPV6: 'true' volumes: - ./data:/data - ./letsencrypt:/etc/letsencrypt depends_on: - db db: image: 'jc21/mariadb-aria:latest' restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: 'npm' MYSQL_DATABASE: 'npm' MYSQL_USER: 'npm' MYSQL_PASSWORD: 'npm' MARIADB_AUTO_UPGRADE: '1' volumes: - ./mysql:/var/lib/mysql

Web管理控制台

访问Web界面

一旦容器启动，你可以通过浏览器访问Nginx Proxy Manager的Web界面。默认地址是http://<your-server-ip>:81。

基本使用

域名与IP绑定

在域名管理服务商那里添加域名与IP的绑定关系。

这里添加一条DNS解析，也就是创建一个二级域名：类型：A、名称：npm、IP：服务器IP。

这表示：访问二级域名npm.域名即可访问服务IP。

添加代理主机

在Web界面中，可以添加新的代理主机来管理反向代理配置。

点击Proxy Hosts选项卡

然后点击Add Proxy Host按钮

在添加代理主机的页面中，填写以下信息：

配置说明

Domain Names ：填写网站域名，需要上面做好DNS解析，把域名绑定到服务器IP Scheme ： 选择HTTP或HTTPS。默认http即可，除非有自签名证书 Forward Hostname/IP ：填写要代理到的目标主机名或IP地址，或者Docker容器内部IP（NPM和程序服务在同一台服务器上） Forward Port：填写目标主机的端口号，这里是NPM管理界面81端口 Cache Assets ：缓存，根据需求选择打开 Block Common Exploits： 阻止常见的漏洞，根据需求选择打开 Websockets Support ：WS支持，根据需求选择打开 Access List： NPM自带的一个限制访问功能

注意：
这里填的是172.17.0.1，为Docker容器内部的IP地址。可以通过下面的命令查询：

[root@vm ~]# ip addr show docker0 3: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN group default link/ether 02:42:39:63:84:15 brd ff:ff:ff:ff:ff:ff inet 172.17.0.1/16 brd 172.17.255.255 scope global docker0 valid_lft forever preferred_lft forever

保存并应用配置

填写完所有必要的信息后，点击Save按钮保存配置。Nginx Proxy Manager会自动生成并应用Nginx 配置文件。

此时，浏览器访问二级域名http://<your-server-domain>即可访问到Nginx Proxy Manager的管理界面

一键申请SSL证书

申请SSL证书，让网站支持https访问。

选择创建一个新的证书，勾选强制SSL，填写邮件、同意条款，点击Save即可申请SSL证书

此时，浏览器就可以使用https访问，并提示连接安全

申请泛域名SSL证书

泛域名SSL证书就是指：申请一个二级域名*.xxx.com证书，这样二级域名无论是什么都可以用这个证书，不再需要为每一个二级域名申请一个SSL证书。

获取API令牌

这里使用Cloudflare托管域名，故登录Cloudflare，获取域名服务商的API令牌

API令牌：在Cloudflare仪表板中，点击右上角的头像，然后选择我的个人资料，在左侧菜单中，选择API 令牌 创建新的API令牌：点击创建令牌按钮 选择API令牌模板：Cloudflare提供了一些预定义的模板，可以选择其中之一，也可以自定义令牌。 根据API令牌用途选择不同模板：对于Nginx Proxy Manager，通常选择编辑区域DNS模板是一个不错的选择。

使用模板后，只需要修改区域资源项，选择要操作的域名即可

得到如下提示，获得API令牌