nginx-ui

# nginx-ui 介绍

## 项目简介
[nginx-ui](https://github.com/0xJacky/nginx-ui) 是一个现代化的 **NGINX Web 管理面板**，使用 **Golang + Vue3** 开发。  
它提供直观的可视化界面，用于配置、监控和管理 NGINX，支持多站点、SSL 证书、访问日志等功能。  
与传统 Java 面板相比，nginx-ui 更加轻量，资源占用低，适合运行在 **小内存 VPS / NAS / 云服务器** 上。

---

## 功能特点
- **Web 可视化管理**
  - 通过 WebUI 管理和编辑 NGINX 配置文件。
  - 支持虚拟主机、多域名代理配置。
- **SSL 管理**
  - 内置 Let’s Encrypt 集成，支持自动申请和续签证书。
  - 支持手动上传证书和私钥。
- **多用户管理**
  - 内置用户和权限控制（RBAC）。
- **可观察性**
  - 实时监控 NGINX 运行状态。
  - 提供访问日志和错误日志查看。
  - 支持 Prometheus 指标采集。
- **API 支持**
  - 提供 REST API，方便自动化和二次开发。

---

## 系统需求
- 操作系统：Linux / macOS（推荐 Linux 服务器环境）
- NGINX：需已安装并正常运行
- 内存占用：30–80 MB（常驻），对小型 VPS 友好

---

## 部署方式

### Docker 部署（推荐）
```bash
docker run -d \
  --name=nginx-ui \
  -p 8080:8080 \
  -v /etc/nginx:/etc/nginx \
  -v /etc/letsencrypt:/etc/letsencrypt \
  --restart=always \
  0xjacky/nginx-ui:latest
```

### 二进制文件直接部署
[下载地址](https://github.com/0xJacky/nginx-ui/releases)
这次部署使用的是v2.1.17
```
# 校验 SHA256  可以不校验
sha256sum -c nginx-ui-linux-64.tar.gz.digest
# 如果返回 "OK" 说明文件完整且未被篡改

# 解压
tar -xzf nginx-ui-linux-64.tar.gz

# 6. 运行 nginx-ui
./nginx-ui -config app.ini

```
app.ini
[官方初始配置文件](https://github.com/0xJacky/nginx-ui/blob/dev/app.example.ini)

```
[app]
PageSize  = 20
JwtSecret = FUXjeiVNwdtNqh

[server]
Host        = 0.0.0.0
Port        = 9000
RunMode     = release
EnableHTTPS = false
EnableH2    = false
EnableH3    = false

[auth]
IPWhiteList         =
BanThresholdMinutes = 10
MaxAttempts         = 10

[nginx]
AccessLogPath   = /var/log/nginx/access.log
ErrorLogPath    = /var/log/nginx/error.log
LogDirWhiteList = /var/log/nginx
ConfigDir       = /etc/nginx
PIDPath         = /run/nginx.pid
ReloadCmd       = /usr/sbin/nginx -s reload
RestartCmd      = /usr/sbin/nginx -s reload

[node]
Name             = Local
Secret           =
SkipInstallation = false
```