即刻开始

尝试一下

您可以通过 演示 直接试用 Nginx UI。

• 用户名：admin
• 密码：admin

使用前注意

Nginx UI 遵循 Debian 的网页服务器配置文件标准。创建的网站配置文件将会放置于 Nginx 配置文件夹（自动检测）下的 sites-available 中，启用后的网站将会创建一份配置文件软连接到 sites-enabled 文件夹。您可能需要提前调整配置文件的组织方式。

对于非 Debian (及 Ubuntu) 系统，您可能需要将 nginx.conf 配置文件中的内容修改为如下所示的 Debian 风格。

http {
	# ...
	include /etc/nginx/conf.d/*.conf;
	include /etc/nginx/sites-enabled/*;
}

更多信息请参阅：debian/conf/nginx.conf

安装

我们建议Linux用户使用 安装脚本，这样您可以直接控制主机上的 Nginx。您也可以通过 Docker 安装， 我们提供的镜像包含 Nginx 并可以直接使用。对于高级用户，您也可以在 最新发行 (latest release) 中下载最新版本并 通过执行文件运行，或者 手动构建。

第一次运行 Nginx UI 时，请在浏览器中访问 http://<your_server_ip>:<listen_port>/install 完成后续配置。

此外，我们提供了一个使用 Nginx 反向代理 Nginx UI 的 示例，您可在安装完成后使用。

使用 Docker

您可以在 docker 中使用我们提供的 uozi/nginx-ui:latest 镜像 ，此镜像基于 nginx:latest 构建。您可以直接将其监听到 80 和 443 端口以取代宿主机上的 Nginx。

提示

默认情况下，Nginx UI 会被反向代理到容器的 8080 端口。 首次使用时，映射到 /etc/nginx 的目录必须为空文件夹。 如果你想要托管静态文件，可以直接将文件夹映射入容器中。

警告

如果您想要管理主机上的 Nginx，请选择其他安装方式。 如果您在使用 Linux，我们建议使用 安装脚本 安装。

Docker 部署示例

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/www:/var/www \
  -p 8080:80 -p 8443:443 \
  uozi/nginx-ui:latest

在这个示例中，容器的80端口和443端口分别映射到主机的8080端口和8443端口。 您需要访问http://<your_server_ip>:8080来访问 Nginx UI。

通过执行文件运行

不建议直接运行 Nginx UI 可执行文件用于非测试目的。 我们建议在 Linux 上将其配置为守护进程或使用 安装脚本。

配置

echo '[server]\nHttpPort = 9000' > app.ini

提示

在没有 app.ini 时服务器仍然可以启动，它将默认侦听端口 9000。

运行

终端

nginx-ui -config app.ini

后台

nohup ./nginx-ui -config app.ini &

停止

终端

^C   # 按住 Ctrl+C

后台

kill -9 $(ps -aux | grep nginx-ui | grep -v grep | awk '{print $2}')