yiniot/nginx-ui

Nginx UI (OpenResty) 镜像文档

镜像概述

本镜像基于OpenResty构建，集成了Nginx UI管理工具，提供可视化界面用于Nginx服务的配置管理、状态监控和反向代理设置。通过Web界面可简化Nginx配置流程，无需手动编辑配置文件，适合个人开发者、小型服务器管理员及需要快速部署Nginx服务的场景。

核心功能与特性

• 可视化配置管理：通过Web界面直观管理Nginx配置文件，支持配置语法高亮和错误检查
• 反向代理设置：图形化配置反向代理规则，支持多域名、路径转发等场景
• 用户认证：支持预定义管理员账户，保障管理界面安全访问
• 状态监控：实时查看Nginx运行状态、请求统计和日志信息
• 灵活部署：支持自定义配置目录、端口映射和环境变量配置

使用场景

• 个人开发者快速搭建和管理Nginx服务
• 小型服务器环境中简化Nginx配置维护
• 需要可视化管理多个Nginx虚拟主机的场景
• 对Nginx配置不熟悉但需要快速部署反向代理的用户

使用方法

1. Docker Compose部署（推荐）

创建docker-compose.yml文件，内容如下：

yaml
version: "3.8"
services:
  nginx:
    stdin_open: true
    tty: true
    container_name: nginx
    restart: always
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - NGINX_UI_SERVER_NODE_SECRET=my-node-secret-123456  # 节点密钥，用于安全通信
      - NGINX_UI_SERVER_SKIP_INSTALLATION=true  # 跳过安装向导
      - NGINX_UI_PREDEFINED_USER_NAME=hsy  # 预定义管理员用户名
      - NGINX_UI_PREDEFINED_USER_PASSWORD=123456  # 预定义管理员密码
      - NGINX_UI_SERVER_HTTP_PORT=9001  # Web管理界面端口
      - NGINX_UI_NGINX_CONFIG_DIR=/etc/nginx  # Nginx配置文件目录
      - NGINX_UI_SERVER_RUN_MODE=release  # 运行模式（release/production）
    volumes:
      - /etc/nginx:/etc/nginx  # 挂载Nginx配置目录（宿主机:容器）
      - /etc/nginx-ui:/etc/nginx-ui  # 挂载Nginx UI配置目录
      - /var/www:/var/www  # 挂载网站根目录
      - /var/log/nginx:/var/log/nginx  # 挂载Nginx日志目录
    image: docker.xuanyuan.run/yiniot/nginx-ui:latest
    network_mode: host  # 使用主机网络模式，便于端口映射

启动服务：

bash
docker-compose up -d

2. Docker Run命令部署

bash
docker run -d \
  --name nginx \
  --restart always \
  --network host \
  -e TZ=Asia/Shanghai \
  -e NGINX_UI_SERVER_NODE_SECRET=my-node-secret-123456 \
  -e NGINX_UI_SERVER_SKIP_INSTALLATION=true \
  -e NGINX_UI_PREDEFINED_USER_NAME=hsy \
  -e NGINX_UI_PREDEFINED_USER_PASSWORD=123456 \
  -e NGINX_UI_SERVER_HTTP_PORT=9001 \
  -e NGINX_UI_NGINX_CONFIG_DIR=/etc/nginx \
  -e NGINX_UI_SERVER_RUN_MODE=release \
  -v /etc/nginx:/etc/nginx \
  -v /etc/nginx-ui:/etc/nginx-ui \
  -v /var/www:/var/www \
  -v /var/log/nginx:/var/log/nginx \
  docker.xuanyuan.run/yiniot/nginx-ui:latest

配置参数说明

环境变量

卷挂载

访问管理界面

部署完成后，通过浏览器访问 http://<服务器IP>:9001（默认端口为9001，若修改NGINX_UI_SERVER_HTTP_PORT则使用对应端口），使用预定义的用户名和密码登录即可开始管理Nginx服务。