# nginxWebEditorPrj

**Repository Path**: lggsuper/nginx-web-editor-prj

## Basic Information

- **Project Name**: nginxWebEditorPrj
- **Description**: 一个轻量级的 Nginx 配置文件可视化编辑工具，提供 Web 界面管理 Nginx 配置。只用一个JSP主文件来实现逻辑,尽可能简化代码/尽可能减少外部包依赖/简化部署/减少服务器性能开销及安全问题.
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nginx WebEditor

一个轻量级的 Nginx 配置文件可视化编辑工具，提供 Web 界面管理 Nginx 配置。

## 功能特性

- **在线编辑**：直接在 Web 界面中编辑 Nginx 配置文件
- **用户认证**：支持用户名密码登录验证
- **配置备份**：一键备份当前配置文件
- **配置测试**：执行 `nginx -t` 测试配置有效性
- **服务重载**：执行 `nginx -s reload` 重新加载配置
- **实时预览**：即时查看配置文件内容

## 安装与运行

http://127.0.0.1:9999
使用账号密码登陆
账号密码在src/main/resources/application.properties配置

### 环境要求

- Java 8 或更高版本
- Maven 3.0 或更高版本
- Nginx 服务


### 运行应用

```bash
java -jar target/nginxPrj-1.0-SNAPSHOT.jar
```

## 配置说明

配置文件位于 `src/main/resources/application.properties`：

```properties
# 服务器端口
server.port=9999

# 管理员登录凭据
nginx.admin.username=nginx
nginx.admin.password=dwloJD_

# Nginx 配置文件路径
nginx.config.path=/etc/nginx/nginx.conf
```

## 使用说明

1. **备份配置**：点击"备份"按钮创建当前配置的备份
2. **编辑配置**：在文本框中修改 Nginx 配置
3. **保存配置**：点击"保存"按钮将更改写入配置文件
4. **测试配置**：点击"测试"按钮验证配置语法正确性
5. **重载服务**：点击"重载"按钮使新配置生效

## 安全提示

- 建议修改默认的管理员用户名和密码
- 确保只有授权人员可以访问此管理界面
- 注意 Nginx 配置文件的权限设置

## 技术架构

- **后端**：Java + Jetty 嵌入式服务器
- **前端**：JSP + JavaScript + HTML/CSS
- **打包**：Maven + Shade Plugin

## 项目结构

```
nginxWebEditorPrj/
├── src/main/java/
│   └── Main.java                 # 项目启动类
├── src/main/resources/
│   ├── webapp/
│   │   └── index.jsp             # 主页面及业务逻辑
│   └── application.properties    # 配置文件
└── pom.xml                       # Maven 项目配置
```

## 常见问题

1. **权限问题**：确保运行程序的用户有权读写 Nginx 配置文件
2. **端口冲突**：如果端口被占用，请修改配置文件中的 server.port
3. **Nginx 服务**：确保系统中已安装并配置好 Nginx

## 开发维护

- 作者：ligg
- 日期：2026/01/25
- 版本：1.0-SNAPSHOT

![img_2.png](img_2.png)

![img.png](img.png)

![img_1.png](img_1.png)

![输入图片说明](30e4ad0069c602a4bcf31a8db3983aeb.png)