本页内容

  • 前提条件
  • 第 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。你应该会看到以下登录界面。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

输入以下默认凭据进行登录。

电子邮件地址:[email protected] 密码:changeme

接下来,系统会立即要求你设置姓名和电子邮件地址。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

第 7 步 - 为 Nginx Proxy Manager 设置域名和 SSL

让我们为访问 Nginx Proxy Manager 设置一个域名。这一步是可选的,但如果你想把该应用程序置于 SSL 之后,它会很有用。

从仪表板菜单中点击 Hosts >> Proxy Hosts 以打开 Proxy Hosts 页面。在那里,点击 Add Proxy Host 按钮继续。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

切换到 SSL 选项卡。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

从下拉菜单中选择 Request a new SSL Certificate。勾选 Force SSL 和 HTTP/2 support 选项。如果你想启用 HSTS,也可以一并启用。如果你的域名是通过 Cloudflare 配置的,请不要启用 Force SSL 选项,否则你会陷入重定向循环。

输入你的电子邮件地址,同意 Let's Encrypt 服务条款(TOS),然后点击 Save 按钮完成。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

你的域名应该已经生效并正常工作。尝试在浏览器中打开 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。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

添加你为 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;。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

第 9 步 - 将 Nginx Proxy Manager 用作重定向服务

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

输入你要转发的域名。然后输入转发目标域名。转发目标域名应该已经配置好。将 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 托管静态网站

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

第 10 步 - 其他功能

使用 Nginx Proxy Manager 的访问控制功能

你可以使用 NPM 的 Access Lists 功能来启用 HTTP 身份验证或阻止 IP 范围。打开 NPM 并访问 Dashboard >> Access Lists 页面。

点击 Add Access List 按钮开始。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

你可以为你的 Access List(ACL)配置命名。如果勾选 Satisfy Any 选项卡,只要客户端满足所指定的任意一个条件,就会被允许访问。如果客户端通过了 HTTP 身份验证但可能未通过基于 IP 的访问,它仍将被允许。但如果未勾选 Satisfy Any 选项,客户端则需要满足所有条件。

Pass Auth to Host 功能会将身份验证功能转发给主机服务器。

接下来,切换到 Authorization 选项卡。在这里你可以为 HTTP 身份验证方法创建用户名和密码。要添加多个用户,请点击 Add 按钮。你最多只能添加 5 个用户。而且 Add 按钮存在一个 bug,所以请先使用该按钮,然后再填写详细信息。如果你先填写详细信息,之后再点击该按钮添加另一个用户,它会清除之前的用户数据。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

点击 Save 完成。

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

启用对更多域名的支持

随着主机和域名数量的增长,你的 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:// 时会看到默认页面。如果你想更改它,是可以做到的。为此,请访问 Settings Page。点击右侧的三个点,然后点击 Edit 按钮。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

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

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

这是我们为此目的使用的自定义 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 完成。你的着陆页应该会变成类似下面的样子。

安装配置 Nginx Proxy Manager 反向代理管理工具完整教程

第 11 步 - 更新 Nginx Proxy Manager

要更新 NPM,首先停止容器。

$ cd ~/nginx-proxy
$ docker-compose down --remove-orphans

拉取最新的镜像。

$ docker-compose pull

再次启动容器。

$ docker-compose up -d

结论

本教程到此结束,你已经安装了 Nginx Proxy Manager,并学习了如何使用它为另一个 Docker 容器添加代理主机、将其用作重定向服务,以及使用它来控制访问。如果你有任何问题,请在下面的评论中发表。