nginxWebUI

## NginxWebUI 简介与安装部署指南

##  项目简介
[NginxWebUI](https://www.nginxwebui.cn/index.html) 是一款强大的 **Nginx 可视化管理工具**，通过 Web 界面即可方便地：
- 管理和编辑 Nginx 配置文件  
- 添加、修改、删除虚拟主机  
- 查看 Nginx 状态与访问/错误日志  
- 一键生成和配置 SSL 证书（支持 Let's Encrypt）  
- 控制 Nginx 的启停与重载  
- 提供用户/权限管理，支持多用户协作

它极大地简化了 Nginx 的使用，让运维和开发人员不需要频繁手动修改配置文件。

---

##  功能特点
- **可视化管理**：通过浏览器操作，无需手写复杂配置文件  
- **一键控制**：支持启动、停止、重载 Nginx 服务  
- **配置校验**：修改配置后自动执行 `nginx -t` 检查语法  
- **日志查看**：实时查看 `access.log` 和 `error.log`  
- **SSL 管理**：可自动申请/更新 HTTPS 证书  
- **轻量易用**：基于 Java 开发，占用内存较小，安装部署简单

---

##  安装部署

### 方法一：Docker 部署（推荐）
1. 拉取镜像：
   ```
   docker pull cym1102/nginxwebui:latest

2. 启动容器：
```
docker run -d \
  --name=nginxwebui \
  -p 8080:8080 \
  -v /etc/nginx:/usr/local/nginx/conf \
  -v /var/log/nginx:/usr/local/nginx/logs \
  -v /home/nginxwebui:/home/nginxWebUI \
  cym1102/nginxwebui:latest
```

WebUI 访问地址：http://服务器IP:8080

默认账号密码：admin / admin

### 方法二：Jar 包部署

确保服务器已安装 JDK 8+ 与 Nginx。

1. 下载 Jar 包：

下载地址：https://gitee.com/cym1102/nginxWebUI/releases

2. 启动服务：

```
java -Xms128m -Xmx512m -jar nginxWebUI-4.3.2.jar --server.port=8080
```

WebUI 访问地址：http://服务器IP:8080

默认账号密码：admin / admin

#### 后台运行示例：
如果是使用Supervisor部署可以整合
```
nohup java -Xms128m -Xmx512m -jar nginxWebUI-4.3.2.jar --server.port=8080 > webui.log 2>&1 &
```

##  注意事项

必须安装 Nginx，WebUI 仅是管理工具，不自带 Nginx

确保 WebUI 运行用户对 /etc/nginx/ 和日志目录有读写权限

建议初次登录后立即修改默认密码

如需长期运行，可配置 systemd 服务或使用 Docker

## 配置 NginxWebUI 与 Nginx

登录 WebUI 后，进入 系统设置
* Nginx 主配置文件路径：/etc/nginx/nginx.conf
* 配置目录路径：/etc/nginx/conf.d/
* 日志目录路径：/var/log/nginx/

保存后，WebUI 将能够：
* 修改并保存 Nginx 配置
* 自动执行 nginx -t 语法校验
* 使用 nginx -s reload 重载配置
* 查看日志文件