NAS 与运维

Nginx Proxy Manager:反向代理与 HTTPS

  • 0 次阅读
  • 0 条评论
文章摘要

Nginx Proxy Manager 用网页界面管理反向代理和证书。代理入口、管理面与后端应用应分别配置权限和网络可达性。 代理主机记录把域名连接到内网服务,证书管理为 HTTPS 提供配套配置。管理端口与用户访问的 80、443 是不同入口。 适合不想频繁手写 Nginx 配置的家庭服务器。源站地址、证书验证和应用登录分别检查,能更快定位访问问题。

项目介绍

Nginx Proxy Manager 用网页界面管理反向代理和证书。代理入口、管理面与后端应用应分别配置权限和网络可达性。

代理主机记录把域名连接到内网服务,证书管理为 HTTPS 提供配套配置。管理端口与用户访问的 80、443 是不同入口。

适合不想频繁手写 Nginx 配置的家庭服务器。源站地址、证书验证和应用登录分别检查,能更快定位访问问题。

核心功能

功能 作用与使用方式
代理主机 按域名选择后端
证书管理 申请导入与续签证书
访问列表 限制部分入口
连接设置 按需支持 WebSocket
日志查看 检查代理与回源错误

功能示意

Nginx Proxy Manager 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 NginxProxyManager/nginx-proxy-manager
官方入口或文档 直接访问
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 检查宿主机的 80、81、443 端口占用,在群晖环境尤其注意 DSM 或其他代理服务。
  2. 按示例启动后通过 81 管理端口初始化账号,添加一个内网后端并检查 HTTP 代理。
  3. 域名与验证条件就绪后申请证书,检查 HTTPS 和续签;应用需要 WebSocket 时按实际情况启用。

首次使用与操作检查

先用 HTTP 代理一个测试服务,确认静态资源正常,再申请证书。HTTPS 成功后测试登录、上传和长连接。

证书申请失败先看 DNS 与验证方式;502 先查代理容器能否访问源站。群晖默认服务可能占用端口,修改映射前记录现有用途。

Docker Compose

以下为整理后的配置示例。使用前替换目录、端口和凭据;浮动镜像标签会随上游变更,正式使用时应记录实际镜像摘要。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/nginx-proxy-manager/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/nginx-proxy-manager /volume1/docker/nginx-proxy-manager/data /volume1/docker/nginx-proxy-manager/letsencrypt
cd /volume1/docker/nginx-proxy-manager
HALO_PREPARE
cd /volume1/docker/nginx-proxy-manager
services:
  npm:
    image: jc21/nginx-proxy-manager:latest
    restart: unless-stopped
    ports:
      - "80:80"
      - "81:81"
      - "443:443"
    volumes:
      - /volume1/docker/nginx-proxy-manager/data:/data
      - /volume1/docker/nginx-proxy-manager/letsencrypt:/etc/letsencrypt

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 如果 80/443 已占用,应规划替代入口或端口转发,不能直接覆盖现有服务。
  • 81 是管理端,不应仅凭默认账号暴露到公网。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

同时备份 data 与 letsencrypt,保留域名和代理规则;浮动镜像升级前记录摘要。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料