cubepoint/nginx-ui

Nginx UI 镜像文档

镜像概述

Nginx UI 镜像提供了一个可视化界面，用于管理Nginx服务器的配置文件，无需通过命令行操作。该工具支持中文界面和资源本地化，降低了Nginx配置的技术门槛，适用于需要便捷管理Nginx配置的用户。

核心功能与特性

• 可视化配置管理：通过Web界面直观查看、编辑、新增和删除Nginx配置文件，无需手动操作文本文件
• 中文界面支持：原生支持中文显示，提升中文用户操作体验
• 资源本地化：静态资源本地化部署，减少外部依赖，提高访问速度和稳定性
• 配置实时生效：修改配置后可一键应用，无需手动执行nginx -s reload
• 配置备份与恢复：自动备份配置文件，支持历史版本恢复，降低配置错误风险
• 语法校验：内置Nginx配置语法检查功能，避免因配置错误导致服务异常

使用场景与适用范围

• Nginx初学者：无需熟悉命令行即可完成基础配置
• 多环境Nginx管理：在开发、测试、生产环境中统一管理Nginx配置
• 快速配置修改：需要频繁调整Nginx规则（如反向代理、SSL配置、缓存策略）的场景
• 团队协作管理：多人协作管理Nginx配置，提供可视化操作界面降低沟通成本

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name nginx-ui \
  -p 8080:8080 \
  -v /path/to/nginx/conf:/etc/nginx \
  -v /path/to/nginx-ui/data:/app/data \
  --restart always \
  docker.xuanyuan.run/nginxui/nginx-ui

参数说明：

• -p 8080:8080：映射容器内Web界面端口到主机
• -v /path/to/nginx/conf:/etc/nginx：挂载Nginx配置文件目录（需替换为实际Nginx配置路径）
• -v /path/to/nginx-ui/data:/app/data：挂载Nginx UI数据目录（用于存储配置备份、用户数据等）

Docker Compose 配置

yaml
version: '3'
services:
  nginx-ui:
    image: docker.xuanyuan.run/nginxui/nginx-ui
    container_name: nginx-ui
    ports:
      - "8080:8080"
    volumes:
      - /etc/nginx:/etc/nginx  # Nginx配置文件目录
      - ./nginx-ui-data:/app/data  # Nginx UI数据持久化
    restart: always
    environment:
      - NGINX_UI_USER=admin  # 登录用户名（默认admin）
      - NGINX_UI_PASSWORD=admin  # 登录密码（首次登录需修改）
      - TZ=Asia/Shanghai  # 时区设置

环境变量配置

访问与使用

1. 部署完成后，通过浏览器访问 http://<主机IP>:8080
2. 使用默认用户名/密码（admin/admin）登录，首次登录需强制修改密码
3. 在界面中可进行以下操作：
   • 查看当前Nginx配置文件结构
   • 新增/编辑server、location等配置块
   • 应用配置并自动重载Nginx
   • 查看Nginx运行状态和日志
   • 管理配置备份与恢复

注意事项

• 确保挂载的Nginx配置目录具有读写权限，否则无法保存配置
• 首次登录后请立即修改默认密码，提高安全性
• 生产环境建议通过HTTPS访问Nginx UI（可配置Nginx反向代理并启用SSL）
• 配置修改前建议先创建备份，避免错误配置导致服务不可用