# nginx-manager

**Repository Path**: baoRoot/nginx-manager

## Basic Information

- **Project Name**: nginx-manager
- **Description**: nginx-manager是一个本地使用nginx部署web项目的临时管理方案，支持日志、启停、健康检查、版本控制、临时请求转发地址等功能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-23
- **Last Updated**: 2026-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, Flask, Nginx

## README

# nginx-manager

## 介绍
Nginx Manager 是一个基于 Flask + PyWebView 构建的一个轻量级的 Nginx 本地项目管理工具，用于快速部署和管理 Vue/React 等单页面应用（SPA）。支持项目配置、日志查看、健康检查、版本控制、访问控制等功能。
专为本地开发环境设计。它通过可视化的方式管理 Nginx 配置，让你无需手动编辑配置文件即可快速部署和管理多个前端项目.

## 适用场景
+ 本地多个前端项目的快速部署
+ 前端项目版本管理和健康检查
+ 项目访问控制和启停管理
+ 快速获取内网访问地址供团队成员预览
+ 统一管理 Nginx 配置，避免手动编辑错误

## 功能特性
+ 项目增删改：支持添加、编辑、删除项目配置
+ 批量操作：支持「保存并部署」和「仅保存」两种模式
+ 项目名称自动提取：粘贴前端路径后自动提取项目名称（取自 dist 前一级目录）

## 版本管理
自动版本检测：从 index.html 中自动读取项目版本号  
多种版本标识支持：  
+ data-version属性：` <div id="app" data-version="1.0.0"> `
+ version属性： ` <div id="app" version="1.0.0"> `  
+ window.__VERSION__：` window.__VERSION__ = "1.0.0" `  
+ VUE_APP_VERSION：` 环境变量注入 `  
+ meta 标签：` <meta name="version" content="1.0.0" /> ` 
+ HTML 注释：` <!-- version: 1.0.0 -->`

## 访问控制
+ 项目启停：每个项目独立控制访问状态（启用/暂停）  
+ 一键停止 Nginx：通过算术验证后停止所有服务  

## 日志管理
+ 实时日志查看：支持查看访问日志和错误日志
+ 日志自动刷新：打开日志抽屉后每 3 秒自动刷新
+ 终端风格展示：日志按级别（info/error/warn）高亮显示

## 便捷功能
+ IP 地址复制：一键复制带本机 IP 的访问地址（支持内网访问）  
+ 浏览器快速打开：点击即可在浏览器中打开项目  
+ 路径自动转换：自动将 Windows 反斜杠 \ 转换为正斜杠 /  

## 技术栈
Python 3.11+、 Flask、 PyWebView、 Bootstrap 5、 PyInstaller、JavaScript、html、css

## 安装与使用

### 1、 环境准备
```bash
# 克隆项目
git clone https://github.com/your-repo/nginx-manager.git
cd nginx-manager

# 创建虚拟环境（推荐）
python -m venv venv
venv\Scripts\activate  # Windows

# 安装依赖
pip install flask pywebview
```
### 2、目录结构
```text
nginx-manager/
├── app.py                 # 主程序
├── templates/             # HTML 模板
│   ├── index.html
│   ├── add.html
│   ├── edit.html
│   └── error.html
├── nginx/                 # Nginx 文件夹（需自行复制）
│   ├── nginx.exe
│   ├── conf/
│   │   ├── nginx.conf     # 程序自动生成
│   │   └── mime.types
│   └── logs/              # 日志目录（自动创建）
│       ├── error.log
│       └── {项目名}/
│           ├── access.log
│           └── error.log
└── config.json            # 配置文件（自动创建）
```

### 3、准备 Nginx
```bash
# 复制 Nginx 到项目目录
cp -r /path/to/nginx ./nginx/
```

### 4、启动应用
```bash
python app.py
```

### 方式二
+ 1、下载并解压
+ 2、目录结构
```text
NginxManager/
├── NginxManager.exe       # 主程序
├── nginx/                 # Nginx 文件夹（必须）
│   ├── nginx.exe
│   └── conf/
│       └── mime.types
└── templates/             # 模板文件夹（内置）
```
+ 3、双击 NginxManager.exe 即可运行。

## 示例

### 主界面
![主界面](./doc/list.png)

### 新增界面
![主界面](./doc/add.png)

### 编辑界面
![主界面](./doc/edit.png)

### 停止界面
![主界面](./doc/stop.png)