schenkd/nginx-ui

镜像概述和主要用途

Nginx UI是一款基于Web的图形化工具，旨在简化Nginx服务器的配置管理流程。通过直观的用户界面，用户可以无需使用命令行工具，直接访问、编辑、预览和应用Nginx配置文件，降低Nginx配置的技术门槛，提高管理效率。

核心功能和特性

• 图形化配置管理：提供直观的Web界面，支持Nginx配置文件的可视化编辑
• 无需命令行操作：完全通过界面完成配置文件的创建、修改、删除等操作
• 实时预览：编辑配置后可实时预览效果，减少配置错误
• 配置生效控制：支持一键应用配置变更，无需手动执行nginx -s reload
• 配置文件版本管理：可查看历史配置记录，支持回滚操作（视具体版本支持情况）
• 跨平台兼容：可部署在任何支持Docker的环境中，与Nginx服务无缝集成

使用场景和适用范围

• 开发环境：开发者快速调整Nginx反向代理、静态资源配置等
• 中小型服务器管理：系统管理员无需记忆复杂命令即可维护Nginx配置
• 教学场景：帮助初学者通过可视化方式理解Nginx配置结构
• 频繁配置变更场景：需要频繁调整Nginx规则的业务场景，提高操作效率

使用方法和配置说明

基本部署（Docker Run）

通过以下命令快速启动Nginx UI容器：

bash
docker run -d \
  --name nginx-ui \
  -p 8080:8080 \
  -v /path/to/nginx/conf:/etc/nginx \
  -e NGINX_UI_USER=admin \
  -e NGINX_UI_PASSWORD=password \
  docker.xuanyuan.run/nginxui/nginx-ui:latest

参数说明：

• -p 8080:8080：映射容器内Web界面端口到主机8080端口
• -v /path/to/nginx/conf:/etc/nginx：挂载本地Nginx配置目录到容器内，实现配置文件的持久化和同步
• -e NGINX_UI_USER：设置Web界面登录用户名（默认：admin）
• -e NGINX_UI_PASSWORD：设置Web界面登录密码（默认：需要在首次启动时设置）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  nginx-ui:
    image: docker.xuanyuan.run/nginxui/nginx-ui:latest
    container_name: nginx-ui
    ports:
      - "8080:8080"
    volumes:
      - /path/to/nginx/conf:/etc/nginx
    environment:
      - NGINX_UI_USER=admin
      - NGINX_UI_PASSWORD=your_secure_password
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问和使用

1. 部署完成后，通过浏览器访问 http://<主机IP>:8080
2. 使用设置的用户名和密码登录
3. 在界面中导航至"配置文件"模块，即可查看、编辑Nginx配置文件
4. 编辑完成后，点击"应用"按钮使配置生效

环境变量配置