项目介绍
Nginx Proxy Manager 用网页界面管理反向代理和证书。代理入口、管理面与后端应用应分别配置权限和网络可达性。
代理主机记录把域名连接到内网服务,证书管理为 HTTPS 提供配套配置。管理端口与用户访问的 80、443 是不同入口。
适合不想频繁手写 Nginx 配置的家庭服务器。源站地址、证书验证和应用登录分别检查,能更快定位访问问题。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 代理主机 | 按域名选择后端 |
| 证书管理 | 申请导入与续签证书 |
| 访问列表 | 限制部分入口 |
| 连接设置 | 按需支持 WebSocket |
| 日志查看 | 检查代理与回源错误 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | NAS 与运维 |
| 项目仓库 | NginxProxyManager/nginx-proxy-manager |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 检查宿主机的 80、81、443 端口占用,在群晖环境尤其注意 DSM 或其他代理服务。
- 按示例启动后通过 81 管理端口初始化账号,添加一个内网后端并检查 HTTP 代理。
- 域名与验证条件就绪后申请证书,检查 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。只回退镜像不一定能回退已经迁移过的数据库。