Nginx UI - 可视化管理平台在现代 Web 架构中Nginx 凭借其高性能、低资源占用和灵活的配置能力成为反向代理、负载均衡和静态资源服务的首选。然而Nginx 的传统配置方式基于文本文件对于非运维人员或初学者来说手动编辑nginx.conf容易出错且缺乏直观的监控和调试手段。为了解决这一痛点Nginx UI 应运而生——它是一个开源的、基于 Web 的可视化管理平台旨在简化 Nginx 的配置、监控和维护。本文将从实战角度出发通过代码示例演示如何部署 Nginx UI 并使用其核心功能。### 什么是 Nginx UINginx UI 是一个轻量级的 Web 界面允许用户通过浏览器管理 Nginx 配置文件、监控服务器状态、管理 SSL 证书以及动态调整负载均衡策略。它支持多用户权限控制、实时日志查看和 API 集成适用于开发、测试和生产环境。相比传统命令行操作Nginx UI 将配置过程图形化降低了运维门槛。### 部署 Nginx UI首先我们需要部署 Nginx UI。以下是一个基于 Docker 的快速部署方案这是最常用的方式因为它避免了依赖冲突并简化了版本管理。#### 1. 使用 Docker 部署dockerfile# Dockerfile 用于构建 Nginx UI 镜像# 基于 Node.js 官方镜像作为基础FROM node:18-alpine AS builder# 设置工作目录WORKDIR /app# 复制 package.json 和 package-lock.json 以利用 Docker 缓存层COPY package*.json ./# 安装依赖RUN npm ci --onlyproduction# 复制源代码COPY . .# 构建应用RUN npm run build# 使用 nginx 作为最终运行时镜像FROM nginx:stable-alpine# 复制构建产物到 nginx 静态目录COPY --frombuilder /app/dist /usr/share/nginx/html# 复制自定义 nginx 配置可选COPY nginx.conf /etc/nginx/nginx.conf# 暴露端口EXPOSE 80# 启动 nginxCMD [nginx, -g, daemon off;]保存上述文件为Dockerfile然后运行以下命令构建并启动容器bash# 构建镜像docker build -t nginx-ui-demo .# 运行容器将主机的 8080 端口映射到容器的 80 端口docker run -d -p 8080:80 --name nginx-ui-app nginx-ui-demo访问http://localhost:8080即可看到 Nginx UI 的登录界面。默认管理员账号和密码通常是admin/admin但建议在生产环境中修改。#### 2. 手动安装非 Docker如果不想使用 Docker也可以直接从 GitHub 下载预编译包。以下是在 Linux 上的手动安装步骤bash# 下载最新版本wget https://github.com/0xJacky/nginx-ui/releases/download/v2.0.0/nginx-ui-linux-amd64.tar.gz# 解压tar -xzf nginx-ui-linux-amd64.tar.gz# 赋予执行权限chmod x nginx-ui# 运行默认监听 9000 端口./nginx-ui此时通过http://your-server-ip:9000即可访问管理界面。### 核心功能演示部署完成后我们将通过两个实战代码示例来演示 Nginx UI 的核心功能配置管理与会话监控。#### 示例 1通过 API 动态添加反向代理规则Nginx UI 提供了 RESTful API允许程序化地管理 Nginx 配置。以下是一个 Python 脚本用于通过 API 添加一个新的反向代理规则将/api/路径转发到后端服务。pythonimport requestsimport json# Nginx UI 服务地址和认证信息BASE_URL http://localhost:8080ADMIN_USER adminADMIN_PASS admin# 1. 登录获取 tokendef get_token(): login_data { username: ADMIN_USER, password: ADMIN_PASS } response requests.post(f{BASE_URL}/api/login, jsonlogin_data) if response.status_code 200: token response.json().get(token) print(f登录成功Token: {token}) return token else: print(登录失败) return None# 2. 添加反向代理配置def add_proxy_rule(token): headers { Authorization: fBearer {token}, Content-Type: application/json } # 配置数据创建一个新的 server block监听 80 端口转发 /api/ 路径 config_data { name: my-api-proxy, listen: 80, server_name: example.com, locations: [ { path: /api/, proxy_pass: http://localhost:5000, # 后端服务地址 proxy_set_header: { Host: $host, X-Real-IP: $remote_addr } } ] } response requests.post(f{BASE_URL}/api/sites, headersheaders, jsonconfig_data) if response.status_code 201: print(反向代理规则添加成功) else: print(f添加失败状态码: {response.status_code}响应: {response.text})# 3. 触发 Nginx 重载以使配置生效def reload_nginx(token): headers {Authorization: fBearer {token}} response requests.post(f{BASE_URL}/api/nginx/reload, headersheaders) if response.status_code 200: print(Nginx 重载成功) else: print(f重载失败: {response.text})if __name__ __main__: token get_token() if token: add_proxy_rule(token) reload_nginx(token)运行此脚本前请确保 Nginx UI 已启动并且 API 端点可用。该脚本通过登录获取 JWT Token然后构造 JSON 配置并提交最后自动重载 Nginx。这种方式特别适合自动化部署场景。#### 示例 2实时监控连接数Nginx UI 提供了图形化的监控仪表板但也可以通过其 WebSocket 接口实时获取服务器状态。以下是一个 Node.js 示例使用 WebSocket 监听 Nginx 的活动连接数。javascript// 引入 WebSocket 库const WebSocket require(ws);// Nginx UI 的 WebSocket 端点 (需要先登录获取 token)const WS_URL ws://localhost:8080/api/ws/nginx/status;const TOKEN your-jwt-token-here; // 替换为从登录接口获取的 token// 创建 WebSocket 连接const ws new WebSocket(WS_URL, { headers: { Authorization: Bearer ${TOKEN} }});// 连接打开时的回调ws.on(open, function open() { console.log(已连接到 Nginx UI 监控 WebSocket); // 发送订阅消息根据 Nginx UI 协议通常需要发送 JSON 格式的订阅请求 const subscribeMessage JSON.stringify({ action: subscribe, channel: nginx_metrics // 订阅指标频道 }); ws.send(subscribeMessage);});// 接收消息ws.on(message, function incoming(data) { try { const metrics JSON.parse(data); // 提取活动连接数假设返回格式为 { active_connections: 123, ... } const activeConn metrics.active_connections || 0; console.log(当前活动连接数: ${activeConn}); // 如果连接数超过阈值触发告警 if (activeConn 1000) { console.warn(⚠️ 警告活动连接数过高请检查服务器); } } catch (e) { console.error(解析数据失败:, e); }});// 错误处理ws.on(error, function error(err) { console.error(WebSocket 错误:, err);});// 定时关闭连接示例运行 10 秒后退出setTimeout(() { ws.close(); console.log(监控结束);}, 10000);运行此脚本需要先安装ws库npm install ws并且获取有效的 JWT Token。在生产环境中你可以将此脚本集成到监控系统中实现自动告警。### 总结Nginx UI 通过可视化界面和丰富的 API极大地简化了 Nginx 的日常管理。本文从部署出发展示了 Docker 和手动安装两种方式然后通过 Python 和 Node.js 代码示例演示了如何利用其 API 和 WebSocket 功能实现自动化配置与实时监控。无论是运维新手还是资深工程师都能从中受益新手可以快速上手配置而专家则能通过 API 集成到现有工作流中。如果你还在手动编辑nginx.conf不妨试试 Nginx UI体验从命令行到可视化的效率飞跃。
