本页内容
- 前提条件
- 第 1 步 - 配置防火墙 Cent OS/Rocky Linux/Alma Linux Ubuntu/Debian
- 第 2 步 - 安装 Docker Cent OS/Rocky Linux/Alma Linux Ubuntu Debian
- 第 3 步 - 安装 Docker Compose
- 第 4 步 - 创建 Docker Compose 文件
- 第 5 步 - 运行 Nginx Proxy Manager
- 第 6 步 - 访问 Nginx Proxy Manager
- 第 7 步 - 为 Nginx Proxy Manager 设置域名和 SSL
- 第 8 步 - 将 Nginx Proxy Manager 与另一个 Docker Web 应用程序配合使用 在 Nginx Proxy Manager 中配置 Ghost
- 第 9 步 - 将 Nginx Proxy Manager 用作重定向服务 Nginx Proxy Manager 的其他用途 使用 Nginx Proxy Manager 托管静态网站
- 第 10 步 - 其他功能 使用 Nginx Proxy Manager 的访问控制功能 启用对更多域名的支持 重定向默认着陆页
- 第 11 步 - 更新 Nginx Proxy Manager
- 结论
- Cent OS/Rocky Linux/Alma Linux
- Ubuntu/Debian
- Cent OS/Rocky Linux/Alma Linux
- Ubuntu
- Debian
- 在 Nginx Proxy Manager 中配置 Ghost
- Nginx Proxy Manager 的其他用途
- 使用 Nginx Proxy Manager 托管静态网站
- 使用 Nginx Proxy Manager 的访问控制功能
- 启用对更多域名的支持
- 重定向默认着陆页
反向代理是一种可以位于另一台 Web 服务器或 Web 服务前面的 Web 服务器。它可以加密传出流量、充当负载均衡器、重定向流量并提供保护。Nginx Web 服务器可用作传统服务器前面的代理服务器,但有时配置它可能很繁琐,如果操作不当还会引发问题。
Nginx Proxy Manager 是一款通过提供图形用户界面(GUI)让将 Nginx 设置为代理服务器变得更容易的应用程序,其功能包括使用 Let's Encrypt 的内置 SSL 支持、多主机支持、HTTP 身份验证、访问列表和用户管理。
本教程将教你如何使用 Docker 在 Linux 服务器上安装 Nginx Proxy Manager。我们将在一篇教程中涵盖所有流行的 Linux 发行版。
前提条件
- 一台运行 Ubuntu/Debian/CentOS/Alma Linux/Rocky Linux 且至少配备 1 GB 内存的 Linux 服务器。
- 一个具有 sudo 权限的非 root 用户。
- 一个指向该服务器的完全限定域名(FQDN),例如 npm.example.com。
第 1 步 - 配置防火墙
Cent OS/Rocky Linux/Alma Linux
你应该已经安装了 Firewalld 防火墙。检查防火墙的状态。
$ sudo firewall-cmd --state
running
开放端口 80、81 和 443。
$ sudo firewall-cmd --permanent --add-service=http
$ sudo firewall-cmd --permanent --add-service=https
$ sudo firewall-cmd --permanent --add-port=81/tcp
重新加载防火墙以使更改生效。
$ sudo firewall-cmd --reload
Ubuntu/Debian
Ubuntu 和 Debian 系统默认使用 ufw(Uncomplicated Firewall)。
检查防火墙是否正在运行。
$ sudo ufw status
如果它正在运行,则开放端口 80、81 和 443。
$ sudo ufw allow 80
$ sudo ufw allow 81
$ sudo ufw allow 443
如果防火墙未运行,则开放 SSH 端口。
$ sudo ufw allow "OpenSSH"
如果防火墙未运行,则启用它。
$ sudo ufw enable
如果它正在运行,则重新加载它以应用更改。
$ sudo ufw reload
第 2 步 - 安装 Docker
Cent OS/Rocky Linux/Alma Linux
运行以下命令来安装 Docker。
$ sudo yum install -y yum-utils
$ sudo yum-config-manager \
--add-repo \
https://download.docker.com/linux/centos/docker-ce.repo
$ sudo yum install docker-ce docker-ce-cli containerd.io
Ubuntu
$ sudo apt install ca-certificates curl gnupg lsb-release
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
$ sudo apt update
$ sudo apt install docker-ce docker-ce-cli containerd.io
Debian
$ sudo apt install ca-certificates curl gnupg lsb-release
$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
$ sudo apt update
$ sudo apt install docker-ce docker-ce-cli containerd.io
启用并启动 Docker 服务。
$ sudo systemctl start docker --now
将你的用户名添加到 Docker 组。
$ sudo usermod -aG docker $USER
退出系统并重新登录以应用更改。
第 3 步 - 安装 Docker Compose
下载并安装 Docker Compose 二进制文件。
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
为该二进制文件赋予可执行权限。
$ sudo chmod +x /usr/local/bin/docker-compose
第 4 步 - 创建 Docker Compose 文件
为 Nginx Proxy Manager 创建一个目录。
$ mkdir ~/nginx-proxy
切换到该目录。
$ cd ~/nginx-proxy
为用户数据和 SSL 证书创建目录。
$ mkdir {data,letsencrypt}
创建并打开 docker-compose.yml 文件进行编辑。
$ nano docker-compose.yml
在其中粘贴以下代码。
version: "3"
services:
npm-app:
image: 'jc21/nginx-proxy-manager:latest'
container_name: npm-app
restart: unless-stopped
ports:
- '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:
DB_MYSQL_HOST: "npm-db"
DB_MYSQL_PORT: 3306
DB_MYSQL_USER: "npm"
DB_MYSQL_PASSWORD: "npm"
DB_MYSQL_NAME: "npm"
# Uncomment the line below if IPv6 is not enabled on your host
# DISABLE_IPV6: 'true'
volumes:
- ./data:/data
- ./letsencrypt:/etc/letsencrypt
depends_on:
- npm-db
networks:
- npm-nw
- npm-internal
npm-db:
image: 'mariadb:latest'
container_name: npm-db
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: 'npm'
MYSQL_DATABASE: 'npm'
MYSQL_USER: 'npm'
MYSQL_PASSWORD: 'npm'
volumes:
- ./data/mysql:/var/lib/mysql
networks:
- npm-internal
networks:
npm-internal:
npm-nw:
external: true
按 Ctrl + X 并在出现提示时输入 Y 来保存文件。
让我们来看一下这个文件。文件的第一部分是我们导入 Nginx Proxy Manager 镜像并以数据库凭据的形式设置一些环境变量的地方。我们还将端口 80、81 和 443 暴露给服务器以供访问。你可以暴露更多端口,例如 21,用于 FTP 访问。你可以通过取消注释 DISABLE_IPV6: 'true' 这一行来禁用 IPV6 支持。我们已将几个目录从主机映射到 Docker 用于数据和 SQL 存储。
我们在这里使用了两个网络。一个是内部网络 npm-internal,用于连接代理管理器和数据库。这个是可选的,因为它会自动创建。但在这里,我们通过给它一个我们自己选择的名称来手动完成。
我们为代理管理器容器添加了一个名为 npm-nw 的外部网络。这个网络是必不可少的,因为你可以用它把代理管理器连接到你安装的任何其他 Docker 容器。使用网络可以让你直接连接任何容器,而无需将其端口暴露给服务器。
第 5 步 - 运行 Nginx Proxy Manager
在启动 Docker 容器之前,我们需要创建外部网络 npm-nw。内部网络会自动创建。运行以下命令来创建外部网络。
$ docker network create npm-nw
使用以下命令启动 Docker 容器。
$ docker-compose up -d
检查容器的状态。
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
c91ca0ddca97 jc21/nginx-proxy-manager:latest "/init" About a minute ago Up About a minute 0.0.0.0:80-81->80-81/tcp, :::80-81->80-81/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp npm-app
1738d71b95da mariadb:latest "docker-entrypoint.s…" About a minute ago Up About a minute 3306/tcp npm-db
第 6 步 - 访问 Nginx Proxy Manager
你现在可以通过 URL http://yourserverIP:81 访问你的 Nginx Proxy Manager。你应该会看到以下登录界面。

输入以下默认凭据进行登录。
电子邮件地址:[email protected] 密码:changeme
接下来,系统会立即要求你设置姓名和电子邮件地址。

点击 Save 按钮,系统会要求你设置新密码。

再次点击 Save 按钮,现在你就可以开始使用该应用程序了。

如果你在浏览器中打开 URL http://yourserverIP,你将被带到代理管理器设置的默认页面。

第 7 步 - 为 Nginx Proxy Manager 设置域名和 SSL
让我们为访问 Nginx Proxy Manager 设置一个域名。这一步是可选的,但如果你想把该应用程序置于 SSL 之后,它会很有用。
从仪表板菜单中点击 Hosts >> Proxy Hosts 以打开 Proxy Hosts 页面。在那里,点击 Add Proxy Host 按钮继续。

添加 FQDN 名称(npm.example.com)并点击它。输入你服务器的 IP 地址,并将 81 作为 Forward Port。
切换到 SSL 选项卡。

从下拉菜单中选择 Request a new SSL Certificate。勾选 Force SSL 和 HTTP/2 support 选项。如果你想启用 HSTS,也可以一并启用。如果你的域名是通过 Cloudflare 配置的,请不要启用 Force SSL 选项,否则你会陷入重定向循环。
输入你的电子邮件地址,同意 Let's Encrypt 服务条款(TOS),然后点击 Save 按钮完成。

你的域名应该已经生效并正常工作。尝试在浏览器中打开 https://npm.example.com,你应该会看到 Nginx Proxy Manager 的登录界面。
你也可以类似地为默认着陆页这样做,并将其分配给一个域名,例如 https://example.com。只需在设置代理主机时将端口从 81 改为 81。
第 8 步 - 将 Nginx Proxy Manager 与另一个 Docker Web 应用程序配合使用
现在我们已经安装了代理管理器,是时候让它发挥一些作用了。我们要做的第一件事是用它来托管另一个 Docker Web 应用程序。为此,我们将安装 Ghost 博客。如果你想了解更多,请查阅我们在 Ubuntu 服务器上使用 Docker 安装 Ghost 的教程。
为你的 Ghost 博客创建另一个目录。
$ mkdir ~/ghost
切换到 Ghost 目录。
$ cd ~/ghost
为内容和数据库创建两个目录。
$ mkdir {content,mysql}
即使你使用的是同一个 MySQL 镜像,也应该将数据及其容器与代理管理器的分开。这将有助于隔离你可能遇到的任何问题,并允许你在需要时移动这些内容。
创建并打开 Docker Compose 文件进行编辑。
$ nano docker-compose.yml
粘贴以下代码。将 example.com 替换为你的 Ghost 博客的实际域名。如果你想接收电子邮件,请输入 SMTP 详细信息。如果不需要,可以将其删除。
version: '3.3'
services:
ghost-app:
image: ghost:latest
container_name: ghost-app
restart: always
depends_on:
- ghost-db
environment:
url: https://ghost.example.com
database__client: mysql
database__connection__host: ghost-db
database__connection__user: ghost
database__connection__password: ghostdbpass
database__connection__database: ghostdb
mail__transport: SMTP
mail__options__host: {Your Mail Service host}
mail__options__port: {Your Mail Service port}
mail__options__secureConnection: {true/false}
mail__options__service: {Your Mail Service}
mail__options__auth__user: {Your User Name}
mail__options__auth__pass: {Your Password}
volumes:
- /home/<username>/ghost/content:/var/lib/ghost/content
networks:
- npm-nw
- ghost-network
ghost-db:
image: mariadb:latest
container_name: ghost-db
restart: always
environment:
MYSQL_ROOT_PASSWORD: your_mysql_root_password
MYSQL_USER: ghost
MYSQL_PASSWORD: ghostdbpass
MYSQL_DATABASE: ghostdb
volumes:
- /home/<username>/ghost/mysql:/var/lib/mysql
networks:
- ghost-network
networks:
ghost-network:
npm-nw:
external: true
按 Ctrl + X 并在出现提示时输入 Y 来保存文件。
如你所见,我们使用外部网络 npm-nw 将 Ghost 容器与 Nginx Proxy Manager 连接起来。这样,我们就不会将 Ghost 的端口暴露给系统。我们还使用了一个内部网络 ghost-network 来连接我们的 Ghost 应用程序和相应的数据库容器。
启动容器。
$ docker-compose up -d
在 Nginx Proxy Manager 中配置 Ghost
现在,我们需要为我们的 Ghost 安装设置反向代理。在浏览器中打开 Nginx Proxy Manager,转到 Dashboard >> Hosts >> Proxy Host,并添加一个新的 Proxy Host。

添加你为 Ghost 博客选择的域名。对于 Hostname/IP 值,输入你的容器名称。在本例中,它是 ghost-app。我们无法在此处添加 IP 地址,因为我们没有将 Ghost 的端口暴露给服务器,Nginx 代理也无法通过 IP 访问 Ghost。因此,我们使用容器名称,NPM 可以使用我们创建的 Docker 网络 npm-nw 访问它。使用 2368 作为端口,这是 Ghost Blog 使用的默认端口。按照上面截图所示勾选其他选项。
接下来,切换到 SSL 选项卡,按照第 6 步创建一个新的 SSL 证书。由于你将向 Ghost 博客上传内容,最好为上传设置最大上传大小。
幸运的是,NPM 允许你添加自定义配置。切换到 Advanced 选项卡,并在框中输入 client_max_body_size 50m;。

点击 Save 按钮完成代理主机的添加。你应该能够通过 URL https://ghost.exampl.com 访问你的 Ghost 博客。

第 9 步 - 将 Nginx Proxy Manager 用作重定向服务
让我们看看如何使用 NPM 轻松地将一个域名重定向到另一个域名。为此,请访问 Dashboard >> Hosts >> Redirection Hosts。在那里,点击 Add Redirection Host 按钮开始。

输入你要转发的域名。然后输入转发目标域名。转发目标域名应该已经配置好。将 scheme 保留为 auto。根据你的需求,你可以选择 http 或 https。选择正确的 HTTP Code,并勾选 Preserve Path 和 Block Common Exploits 选项。如果你使用的是 auto 或 https scheme,请确保已使用 NPM 选择或创建了 SSL 证书。点击 Save 完成重定向主机的添加。
你的域名 example.com 应该会开始重定向到 blog.example.com。
Nginx Proxy Manager 的其他用途
还有另外两种方式可以使用 Nginx Proxy Manager。你可以将它用作 404 主机,这意味着你可以将一个域名用作着陆页,以向搜索引擎表明该域名的页面不存在。该步骤只需输入一个域名并为其设置 SSL。你也可以借此机会跟踪该域名的日志并查看引荐流量。
另一个功能是将 NPM 用作 stream 主机。你可以使用此功能将 TCP/UDP 端口转发到网络上的另一台计算机。如果你在托管游戏服务器,这会很有用。它只要求你输入传入端口、转发域名或 IP 地址、转发端口,并选择端口类型。

使用 Nginx Proxy Manager 托管静态网站
Nginx Proxy Manager 也可以托管简单的静态或动态网站。为此,添加一个新的代理主机,并选择 127.0.0.1 作为 Forward domain,80 作为 port。

在 Advanced 选项卡下,输入指定根目录的配置。确保该站点的根目录已在初始 Docker Compose 配置中挂载。这里我们使用 /data/static 目录来托管我们的静态网站。

点击 Save 完成,你的站点应该就可以访问了。你可以类似地使用代理管理器托管任何类型的站点。

第 10 步 - 其他功能
使用 Nginx Proxy Manager 的访问控制功能
你可以使用 NPM 的 Access Lists 功能来启用 HTTP 身份验证或阻止 IP 范围。打开 NPM 并访问 Dashboard >> Access Lists 页面。
点击 Add Access List 按钮开始。

你可以为你的 Access List(ACL)配置命名。如果勾选 Satisfy Any 选项卡,只要客户端满足所指定的任意一个条件,就会被允许访问。如果客户端通过了 HTTP 身份验证但可能未通过基于 IP 的访问,它仍将被允许。但如果未勾选 Satisfy Any 选项,客户端则需要满足所有条件。
Pass Auth to Host 功能会将身份验证功能转发给主机服务器。
接下来,切换到 Authorization 选项卡。在这里你可以为 HTTP 身份验证方法创建用户名和密码。要添加多个用户,请点击 Add 按钮。你最多只能添加 5 个用户。而且 Add 按钮存在一个 bug,所以请先使用该按钮,然后再填写详细信息。如果你先填写详细信息,之后再点击该按钮添加另一个用户,它会清除之前的用户数据。

切换到 Access 选项卡。在这里你可以设置允许或拒绝哪些 IP 地址访问。

点击 Save 完成。
要使用此 Access List,你需要在添加代理主机时选择它。就像下面 Ghost Blog 的示例中一样,我们已经选择了我们的 Access List。

启用对更多域名的支持
随着主机和域名数量的增长,你的 Nginx 可能会耗尽 hash 空间或遇到内存问题。我们可以添加一个将应用于所有主机的自定义配置来解决此问题。
为此,在 ~/nginx-proxy/data/nginx 内创建 custom 目录。
$ sudo mkdir ~/nginx-proxy/data/nginx/custom
在此目录内创建并打开 http.conf 文件。
$ sudo nano ~/nginx-proxy/data/nginx/custom/http.conf
在其中粘贴以下几行。
proxy_headers_hash_max_size 1024;
proxy_headers_hash_bucket_size 128;
按 Ctrl + X 并在出现提示时输入 Y 来保存文件。
Nginx 应该会自动接受这些值。如果没有,你可以使用以下命令重启 NPM 容器。
$ docker restart npm-app
重定向默认着陆页
在第 6 步中,当你输入 URL http://

你可以将着陆页设置为充当 404 页面、重定向页面,或通过使用 Custom Page 选项为其添加自定义 HTML。如果你选择 Redirect,则需要指定目标 URL。

这是我们为此目的使用的自定义 HTML。
<!doctype html>
<html>
<head>
<title>Nothing Here</title>
<meta charset="utf-8"/>
<meta name="robots" content="noindex"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<style>
body {
text-align: center;
padding: 20px;
font: 20px Helvetica, sans-serif;
color: #333;
}
@media (min-width: 768px){
body{ padding-top: 150px;
}
}
h1 {
font-size: 50px;
}
article {
display: block;
text-align: left;
max-width: 650px;
margin: 0 auto;
}
</style>
</head>
<body>
<article>
<h1>Oops!</h1>
<div>
<p>Sorry for the inconvenience but you are not supposed to be here. You won't get anything here. This page was set for HowtoForge Nginx Proxy Manager Guide. Maybe, someday it will show something.</p>
</div>
</article>
</body>
</html>
点击 Save 完成。你的着陆页应该会变成类似下面的样子。

第 11 步 - 更新 Nginx Proxy Manager
要更新 NPM,首先停止容器。
$ cd ~/nginx-proxy
$ docker-compose down --remove-orphans
拉取最新的镜像。
$ docker-compose pull
再次启动容器。
$ docker-compose up -d
结论
本教程到此结束,你已经安装了 Nginx Proxy Manager,并学习了如何使用它为另一个 Docker 容器添加代理主机、将其用作重定向服务,以及使用它来控制访问。如果你有任何问题,请在下面的评论中发表。