ddsderek/nginxwebui

nginxWebUI-Docker镜像文档

镜像概述

nginxWebUI-Docker镜像是一个基于Docker容器化的Nginx Web管理工具，旨在通过直观的Web界面实现Nginx服务器的配置、部署与管理。该镜像无需用户手动编辑Nginx配置文件，通过可视化操作即可完成虚拟主机、反向代理、SSL证书等配置，大幅降低Nginx运维门槛。

核心功能与特性

• 可视化配置管理：通过Web界面完成Nginx各类配置（如虚拟主机、反向代理、URL重写等），无需手动编写配置文件。
• 配置持久化：支持配置文件持久化存储，通过挂载宿主机目录确保容器重启后配置不丢失。
• 权限控制：可通过PUID/PGID指定运行用户及用户组，保障容器运行安全性。
• 灵活部署：支持Docker CLI直接部署或docker-compose编排，适配不同场景需求。
• 网络兼容性：支持主机网络模式，确保Web管理界面与Nginx服务网络互通。

使用场景与适用范围

• 个人开发者：快速搭建和管理个人项目的Nginx服务器，简化配置流程。
• 中小企业运维：降低团队Nginx学习成本，实现多人协作管理Nginx服务。
• 测试环境部署：在开发或测试环境中快速配置Nginx反向代理、静态资源服务等。
• 轻量级生产环境：适用于中小型生产环境，通过可视化界面实时调整Nginx配置。

使用方法与配置说明

1. Docker CLI部署

通过以下命令直接启动容器：

bash
docker run -itd \
  -v /home/nginxWebUI:/home/nginxWebUI \
  -e BOOT_OPTIONS="--server.port=8080" \
  -e PUID=1000 \
  -e PGID=1000 \
  --privileged=true \
  --net=host \
  docker.xuanyuan.run/ddsderek/nginxwebui:latest

参数说明：

• -v /home/nginxWebUI:/home/nginxWebUI：挂载宿主机目录到容器内，用于持久化Nginx配置文件及工具数据。
• -e BOOT_OPTIONS="--server.port=8080"：设置启动参数，此处指定Web管理界面端口为8080（可根据需求修改）。
• -e PUID=1000：指定容器运行用户ID（需与宿主机用户ID对应，避免权限问题）。
• -e PGID=1000：指定容器运行用户组ID（同上）。
• --privileged=true：赋予容器特权模式，确保对Nginx服务及宿主机资源的操作权限。
• --net=host：使用主机网络模式，使容器内服务与宿主机共享网络命名空间，便于Nginx服务与Web管理界面通信。

2. Docker Compose部署

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

yaml
version: '3.3'
services:
    nginxwebui:
        volumes:
            - '/home/nginxWebUI:/home/nginxWebUI'
        environment:
            - BOOT_OPTIONS=--server.port=8080
            - PUID=1000
            - PGID=1000
        privileged: true
        network_mode: host
        image: 'docker.xuanyuan.run/ddsderek/nginxwebui:latest'

启动容器：

bash
docker-compose up -d

3. 关键配置参数说明

环境变量

• BOOT_OPTIONS：Java启动参数，用于配置Web服务端口（如--server.port=8080）、日志级别等。
• PUID/PGID：运行容器的用户ID和用户组ID，需与宿主机目录权限匹配，避免文件读写权限问题（默认值1000对应多数Linux系统的普通用户）。

数据持久化

通过-v /home/nginxWebUI:/home/nginxWebUI挂载的目录会存储Nginx配置文件、SSL证书、工具日志等数据，需确保宿主机目录存在且权限正确。

网络配置

--net=host（主机网络模式）确保Web管理界面与Nginx服务在同一网络环境，避免端口映射冲突，简化配置访问。