标签搜索

目 录CONTENT

文章目录

自己开发了一款 Nginx 可视化管理面板!反向代理、SSL 证书自动申请,支持泛域名证书,Docker 一键部署

yyzq
2026-11-21 / 0 评论 / 1 点赞 / 73 阅读 / 2,073 字
广告 广告

前言

对于经常折腾 VPS、NAS 和 Docker 自托管项目的朋友来说,Nginx 应该是再熟悉不过的工具了。

无论是搭建个人网站、部署 Web 应用,还是给各种 Docker 服务配置域名和 HTTPS,基本都离不开 Nginx。

刚开始使用的时候,可能只需要简单配置几条 proxy_pass 就能满足需求。但随着部署的项目越来越多,反向代理、SSL 证书、HTTP 到 HTTPS 跳转、端口转发等配置也会越来越复杂。

所有配置都堆在一个 nginx.conf 文件里,不仅管理起来不方便,每次修改还得小心翼翼,生怕一个配置错误就导致整个 Nginx 服务无法正常运行。

为了解决这些问题,我干脆自己开发了一套 Nginx 可视化管理面板——ywsj-nginx-manager。

它可以通过 Web 页面直观地管理 Nginx,不需要每次都手动编辑配置文件。无论是创建反向代理、申请 SSL 证书,还是查看访问日志和运行状态,都可以直接在面板中完成。

项目主要功能包括:

🐳 Docker 一键部署:支持 AMD64 和 ARM64 多架构。

🔄 反向代理管理:可视化创建和管理站点,自动生成 Nginx 配置。

🔒 SSL 证书管理:集成 acme.sh,支持 DNS API 和 Standalone 模式申请证书,并支持自动续期。

📊 运行状态监控:查看访问请求、状态码分布以及日志统计。

🌐 中英文双语:支持暗色和亮色主题。

🔐 安全防护:首次初始化密码、防暴力破解、TOTP 二步验证。

最重要的是,这是一个完全开源的项目,代码和配置都可以自行查看,不需要依赖第三方闭源管理平台。

接下来,就带大家一起看看这款面板的实际功能,以及如何通过 Docker 快速部署,打造一套属于自己的 Nginx 可视化管理平台。

Nginx的读音

关于Nginx的读音-维基百科的说明
image-1795235917768

项目图示

主界面-仪表盘
image-1795231504531
代理站点
image-1795231566588
添加站点
image-1795231598574
多后端负载均衡
image-1795231802656
SSL证书
image-1795231642234
重定向
image-1795231668268
端口转发
image-1795231696857
日志管理
image-1795231732448
账号支持添加2FA二部验证
image-1795231946316

项目简介

🐳 Nginx WebUI 管理面板 — 可视化管理反向代理、SSL证书、多站点,Docker 部署

✨ 功能特性

  • 🔄 反向代理管理 — 可视化添加/编辑/删除代理站点,自动生成 Nginx 配置
  • 🔒 SSL 证书管理 — 集成 acme.sh,支持 DNS API 验证和 Standalone 模式申请 Let’s Encrypt 证书
  • ↪️ 重定向管理 — 301/302 重定向,支持路径保留
  • 🔀 端口转发 — TCP/UDP stream 代理
  • 📊 状态监控 — Nginx 运行状态、配置检查、一键重载
  • 📋 日志查看 — 访问日志实时查看 + 状态码/IP/URL 统计
  • 🌐 多语言 — 默认支持中文/英文,可扩展其他语言
  • 🌓 暗色/亮色主题 — 自动记忆用户偏好
  • 🔐 安全认证 — 首次初始化密码、防暴力破解、scrypt 哈希,支持2FA二部验证
  • 🐳 Docker 部署 — 多架构(amd64+arm64),一键启动

部署方法

使用Docker安装

本教程使用docker的方式安装部署,简单便捷
164b6ac419e23bc5390dc46601a202bf

X86/Arm双平台

平台 架构 适用场景
linux/amd64 x86_64 VPS、PC服务器、Intel/AMD
linux/arm64 ARM64 树莓派、Mac M系列、ARM 云服务器

准备条件

1)一台服务器

我们使用莱卡云VPS来演示,建议选择境外云服务器(免备案)
需要vps的可以看以下信息,配置尽量选择大点的比如1核心2G内存
预留80/443端口供Nginx使用
莱卡云官网

2)本教程使用到的项目

本教程使用的官方github地址
https://github.com/yyzq-cf/ywsj-nginx-manager
image-1795232187808
项目刚创建, 如果感觉有用,请帮忙点个stars
也可以fork到自己的仓库让各种AI agent增加自己的个性化需要

3)域名

根据自己的需求,
1.web界面建议绑定域名,方便使用,本项目正好适合绑定域名

VPS部署

一、Docker环境部署

在vps安装docker和docker-compose
Docker官方安装文档(英文)
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档(英文)
https://duan.yyzq.eu.org/docker-002
Centos安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//04

推荐直接用一键脚本

docker安装脚本

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

docker-compose安装脚本

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

二、部署命令

登录我们自己的境外VPS使用root账户执行以下步骤

docker-compose命令

创建一个目录,并进入此目录

mkdir  ywsj-nginx-manager ;cd ywsj-nginx-manager

请自行安装vim编辑器
然后再新建docker-compose.yml

vim docker-compose.yml
services:
  nginx-manager:
    image: ywsj/nginx-manager:latest  # Docker 镜像
    container_name: nginx-manager  # 容器名称
    ports:
      - "80:80"      # HTTP 服务端口
      - "443:443"    # HTTPS 服务端口
      - "5400:5000"  # Web 管理面板端口(宿主机 5400)
    volumes:
      - ./data:/data  # 应用数据持久化目录
      - ./conf.d:/etc/nginx/conf.d  # Nginx 站点配置文件目录
      - ./ssl:/etc/nginx/ssl  # SSL 证书存储目录
      - ./logs:/var/log/nginx  # Nginx 日志存储目录
      - ./acme.sh:/home/appuser/.acme.sh  # acme.sh 证书数据及配置持久化目录
    environment:
      - SECRET_KEY=qTTwwxDJesRR2YlK51TQE6xh5YTgmFQT  # 应用密钥,请修改为随机字符串
    restart: always  # 容器退出后自动重启

注意端口如有冲突自行修改
点我随机生成token

三、执行容器运行命令

docker-compose up -d #运行容器
docker-compose ps  #查看是否启动成功

正常启动如下所示

docker-compose ps
NAME            IMAGE                       COMMAND            SERVICE         CREATED         STATUS         PORTS
nginx-manager   ywsj/nginx-manager:latest   "/entrypoint.sh"   nginx-manager   7 seconds ago   Up 6 seconds   0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:443->443/tcp, [::]:443->443/tcp, 0.0.0.0:5400->5000/tcp, [::]:5400->5000/tcp

四、web界面

打开web页面使用
成功以后需要打开自己相应的端口5400)防火墙就可以web端访问了

主界面

http://ip:5400

image-1795233319799
首先初始化管理员信息
登录
image-1795233374901
主页面
image-1795235014061

绑定域名

接下来就是绑定域名和配置SSL证书
首先我们申请SSL证书
为了方便我们直接申请泛域名证书比如

*.yyzq.de5.net

之后凡是这个域名下的子域名都可以使用这一个证书

由于我的域名托管在cloudflare我就以这个为例演示-点击获取
image-1795233671189
登录好自己的cloudflare账号-点击创建令牌
image-1795233729881
输入令牌名称-选择编辑区域DNS
image-1795234064095
选中需要申请的域名-令牌过期时间-继续
image-1795234037772
创建令牌即可
image-1795234158235
如图填入这里即可
image-1795234250199
选择秘钥类型-申请即可
image-1795234316367
稍等大约1分钟就可以申请成功了
image-1795234410670
可以查看证书和下载证书
image-1795234456372
目前证书默认3个月-不足30天自动续期
接下来我们代理这个web界面
新增一个A记录指向本机ip
image-1795234632780
然后新增一个代理-填入信息
image-1795234759862
即可成功代理本web页面
image-1795234798114
成功代理
image-1795234857781
其他功能自行探索即可
或者fork整个项目到自己的仓库让AI给你增加个性化的需求

有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我

欢迎关注我们的微信公众号!
微信公众号

1
广告 广告

评论区