0xJacky/nginx-ui
运维与部署在浏览器里管理 Nginx:编辑配置、签发证书、查看日志并监控服务器,面向自建 Nginx 的运维者。
项目介绍
Nginx UI 是一个自托管的 Nginx 管理面板,后端用 Go、前端用 Vue,打包成单个可执行文件。它把日常运维 Nginx 的常见操作搬到浏览器里:在线编辑站点配置,保存后自动测试配置并重载 Nginx;查看 Nginx 日志;监控 CPU、内存、负载和磁盘等指标;一键申请并自动续期 Let's Encrypt 证书。配置修改后会自动备份,支持版本对比和恢复;还能导出加密的 Nginx / Nginx UI 配置,方便迁移到新环境;集群管理可把操作镜像到多个节点。
配置编辑有两种方式:自研的块编辑器 NgxConfigEditor 用来编辑站点配置,Ace 编辑器支持 Nginx 语法高亮和 LLM 代码补全。面板内还有一个在线聊天助手,支持多个模型,并能展示 DeepSeek-R1 的思维链;同时提供 MCP 接口,供 AI agent 与 Nginx UI 交互。它适合自己在服务器上运行 Nginx、希望用界面代替手工改文件的人,而不是需要引入 Nginx 库的开发者。
快速使用
Linux 上最省事的安装方式是官方脚本,它会把 Nginx UI 安装为 systemd 服务 nginx-ui:
bash -c "$(curl -L https://cloud.nginxui.com/install.sh)" @ install
安装完成后用浏览器打开面板完成初始化。默认监听端口是 9000,默认 HTTP Challenge 端口是 9180。如果端口冲突,手动修改 /usr/local/etc/nginx-ui/app.ini,再执行 systemctl restart nginx-ui。
如果想用面板直接替代宿主机上的 Nginx,可以改用 Docker。uozi/nginx-ui:latest 镜像基于最新 Nginx 镜像构建,把容器的 80、443 端口发布到宿主机;首次使用时,映射到 /etc/nginx 的卷必须是空目录:
docker run -dit \
--name=nginx-ui \
--restart=always \
-e TZ=Asia/Shanghai \
-v /mnt/user/appdata/nginx:/etc/nginx \
-v /mnt/user/appdata/nginx-ui:/etc/nginx-ui \
-v /var/run/docker.sock:/var/run/docker.sock \
-p 8080:80 -p 8443:443 \
uozi/nginx-ui:latest
然后访问 http://<your_server_ip>:8080/install 登录(8080 换成你映射到容器 80 端口的主机端口)。不想先安装的话,可以先在 demo.nginxui.com 用 admin / admin 体验。macOS、Windows、Linux、FreeBSD、OpenBSD、Dragonfly BSD 和 OpenWrt 的预编译版本在 latest release 下载,可执行文件通过 nginx-ui -config app.ini 启动;首次运行后访问 http://<your_server_ip>:<listen_port> 完成后续配置。
使用约束
面板沿用 Debian 的 Web 服务器配置布局:新建的站点配置文件放在自动探测到的 Nginx 配置目录下的 sites-available,启用站点时在 sites-enabled 中创建软链接。非 Debian 系统可能需要把 nginx.conf 改成类似的 include 结构,例如:
http {
# ...
include /etc/nginx/conf.d/*.conf;
include /etc/nginx/sites-enabled/*;
}
从较旧的 Docker 镜像升级时,conf.d/nginx-ui.conf 可能需要按 Docker WebSocket 修复说明 更新。从源码构建需要 Make、Go、Bun 和 Node.js,先在 app 目录构建前端,再在项目根目录构建后端。项目采用 AGPL-3.0 许可证,使用、分发或贡献即表示接受该许可证条款。
HotRepo 点评
在 2026-11-01 的 Go 语言日榜记录中,Nginx UI 单日新增 32 个 Star,在该榜的最好名次是第 13 名。这只是单日记录,说明它仍然受到 Go 生态读者的关注,不足以判断长期增长趋势;本站记录中也没有该仓库的全部语言日榜名次。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。