Nginx UI

Yet another Nginx Web UI, developed by0xJackyandHintay.

Documentation

To check out docs, visitnginxui.

Stargazers over time

English |Español|Giản thể tiếng Trung|Phồn thể tiếng Trung|Tiếng Việt

Table of Contents

1. About The Project
   • Demo
   • Features
   • Internationalization
   • Built With
2. Getting Started
   • Before Use
   • Installation
   • Usage
     • From Executable
     • With Systemd
     • With Docker
3. Manual Build
   • Prerequisites
   • Build Frontend
   • Build Backend
4. Script for Linux
   • Basic Usage
   • More Usage
5. Example of Nginx Reverse Proxy Configuration
6. Contributing
7. License

About The Project

Demo

URL:https://demo.nginxui

• Username: admin
• Password: admin

Features

• Online statistics for server indicators such as CPU usage, memory usage, load average, and disk usage.
• Online ChatGPT Assistant
• One-click deployment and automatic renewal Let's Encrypt certificates.
• Online editing websites configurations with our self-designedNgxConfigEditorwhich is a user-friendly block editor for nginx configurations orAce Code Editorwhich supports highlighting nginx configuration syntax.
• Online view Nginx logs
• Written in Go and Vue, distribution is a single executable binary.
• Automatically test configuration file and reload nginx after saving configuration.
• Web Terminal
• Dark Mode
• Responsive Web Design

Internationalization

• English
• Simplified Chinese
• Traditional Chinese

We welcome translations into any language.

Built With

• The Go Programming Language
• Gin Web Framework
• GORM
• Vue 3
• Vite
• TypeScript
• Ant Design Vue
• vue3-gettext
• vue3-ace-editor
• Gonginx

Getting Started

Before Use

The Nginx UI follows the Debian web server configuration file standard. Created site configuration files will be placed in thesites-availablefolder that under the Nginx configuration folder (auto-detected). The configuration files for an enabled site will create a soft link to thesites-enabledfolder. You may need to adjust the way the configuration files are organised.

For non-Debian (and Ubuntu) systems, you may need to change the contents of thenginx.confconfiguration file to the Debian style as shown below.

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

For more information:debian/conf/nginx.conf

Installation

Nginx UI is available on the following platforms:

• macOS 11 Big Sur and later (amd64 / arm64)
• Linux 2.6.23 and later (x86 / amd64 / arm64 / armv5 / armv6 / armv7)
  • Including but not limited to Debian 7 / 8, Ubuntu 12.04 / 14.04 and later, CentOS 6 / 7, Arch Linux
• FreeBSD
• OpenBSD
• Dragonfly BSD
• Openwrt

You can visitlatest releaseto download the latest distribution, or just useinstallation scripts for Linux.

Usage

In the first runtime of Nginx UI, please visithttp://<your_server_ip>:<listen_port> in your browser to complete the follow-up configurations.

From Executable

Run Nginx UI in Terminal

nginx-ui -config app.ini

PressControl+Cin the terminal to exit Nginx UI.

Run Nginx UI in Background

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

Stop Nginx UI with the follow command.

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

With Systemd

If you are using theinstallation script for Linux,the Nginx UI will be installed asnginx-uiservice in systemd. Please use thesystemctlcommand to control it.

Start Nginx UI

systemctl start nginx-ui

Stop Nginx UI

systemctl stop nginx-ui

Restart Nginx UI

systemctl restart nginx-ui

With Docker

Our docker imageuozi/nginx-ui:latestis based on the latest nginx image and can be used to replace the Nginx on the host. By publishing the container's port 80 and 443 to the host, you can easily make the switch.

Note

1. When using this container for the first time, ensure that the volume mapped to /etc/nginx is empty.
2. If you want to host static files, you can map directories to container.

Deploy with Docker

1. Install Docker.

2. Then deploy nginx-ui like this:

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

3. When your docker container is running, Log in to nginx-ui panel withhttp://<your_server_ip>:8080/install.

Deploy with Docker-Compose

1. Install Docker-Compose.

2. Create a docker-compose.yml file like this:

services:
nginx-ui:
stdin_open:true
tty:true
container_name:nginx-ui
restart:always
environment:
-TZ=Asia/Shanghai
volumes:
-'/mnt/user/appdata/nginx:/etc/nginx'
-'/mnt/user/appdata/nginx-ui:/etc/nginx-ui'
-'/var/www:/var/www'
ports:
-8080:80
-8443:443
image:'uozi/nginx-ui:latest'

3. Then creat your container by:

docker compose up -d

4. When your docker container is running, Log in to nginx-ui panel withhttp://<your_server_ip>:8080/install.

Manual Build

On platforms that do not have an official build version, they can be built manually.

Prerequisites

• Make

• Golang 1.23+

• node.js 21+

  npx browserslist@latest --update-db

Build Frontend

Please execute the following command inappdirectory.

pnpm install
pnpm build

Build Backend

Please build the app first, and then execute the following command in the project root directory.

go build -tags=jsoniter -ldflags"$LD_FLAGS-X 'github /0xJacky/Nginx-UI/settings.buildTime=$(date +%s)'"-o nginx-ui -v main.go

Script for Linux

Basic Usage

Install and Upgrade

bash<(curl -L -s https://raw.githubusercontent /0xJacky/nginx-ui/master/install.sh)install

The default listening port is9000,and the default HTTP Challenge port is9180. If there is a port conflict, please modify/usr/local/etc/nginx-ui/app.inimanually, then usesystemctl restart nginx-uito reload the Nginx UI service.

Remove Nginx UI, except configuration and database files

bash<(curl -L -s https://raw.githubusercontent /0xJacky/nginx-ui/master/install.sh)remove

More Usage

bash<(curl -L -s https://raw.githubusercontent /0xJacky/nginx-ui/master/install.sh)help

Example of Nginx Reverse Proxy Configuration

server{
listen80;
listen[::]:80;

server_name<your_server_name>;
rewrite^(.*)$https://$host$1permanent;
}

map$http_upgrade$connection_upgrade{
defaultupgrade;
''close;
}

server{
listen443ssl;
listen[::]:443 ssl;
http2on;

server_name<your_server_name>;

ssl_certificate/path/to/ssl_cert;
ssl_certificate_key/path/to/ssl_cert_key;

location/{
proxy_set_headerHost$host;
proxy_set_headerX-Real-IP$remote_addr;
proxy_set_headerX-Forwarded-For$proxy_add_x_forwarded_for;
proxy_set_headerX-Forwarded-Proto$scheme;
proxy_http_version1.1;
proxy_set_headerUpgrade$http_upgrade;
proxy_set_headerConnection$connection_upgrade;
proxy_passhttp://127.0.0.1:9000/;
}
}

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make aregreatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is provided under a GNU Affero General Public License v3.0 license that can be found in theLICENSEfile. By using, distributing, or contributing to this project, you agree to the terms and conditions of this license.