mirrors/nginx-ui

Fork 0

mirror of https://github.com/0xJacky/nginx-ui.git synced 2025-05-10 18:05:48 +02:00

Hintay f526cd0ade

Updated README.

2022-07-27 21:08:25 +08:00

8.6 KiB

Raw Blame History

Nginx UI

Yet another Nginx Web UI

Nginx 網路管理介面，由 0xJacky 與 Hintay 開發。

For English

简体中文

關於專案
入門指南
手動構建
Linux 安裝指令碼
- 基本用法
- 更多用法
Nginx 反向代理配置示例
貢獻
開源軟體授權條款

關於專案

線上預覽

位址：https://nginxui.jackyu.cn

使用者：admin
密碼：admin

特色

線上檢視伺服器 CPU、記憶體、系統負載、磁碟使用率等指標
一鍵申請和自動續簽 Let's encrypt 憑證
線上編輯 Nginx 配置檔案，編輯器支援 Nginx 配置語法突顯
使用 Go 和 Vue 開發，發行版本為單個可執行檔案
保存配置後自動測試配置檔案並重載 Nginx
基於網頁瀏覽器的高級命令行終端
支援暗黑模式
自適應網頁設計

國際化

英語
簡體中文
繁體中文

我們歡迎您將專案翻譯成任何語言。

構建基於

入門指南

使用前注意

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

安裝

Nginx UI 可在以下作業系統中使用：

Mac OS X 10.10 Yosemite 及之後版本（amd64 / arm64）
Linux 2.6.23 及之後版本（x86 / amd64 / arm64 / armv5 / armv6 / armv7）
- 包括但不限於 Debian 7 / 8、Ubuntu 12.04 / 14.04 及後續版本、CentOS 6 / 7、Arch Linux
FreeBSD
OpenBSD
Dragonfly BSD
Openwrt

您可以在最新释出 (latest release) 中下載最新版本，或使用 Linux 安裝指令碼。

使用方法

第一次執行 Nginx UI 時，請在網頁瀏覽器中訪問 http://<your_server_ip>:<listen_port>/install 完成後續配置。

透過執行檔案執行

在終端中執行 Nginx UI

nginx-ui -config app.ini

在終端使用 Control+C 退出 Nginx UI。

在背景執行 Nginx UI

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

使用以下命令停止 Nginx UI。

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

使用 Systemd

如果你使用的是 Linux 安裝指令碼，Nginx UI 將作為 nginx-ui 守護行程安裝在 systemd 中。請使用 systemctl 指令控制。

啟動 Nginx UI

systemctl start nginx-ui

停止 Nginx UI

systemctl stop nginx-ui

重啟 Nginx UI

systemctl restart nginx-ui

使用 Docker

您可以在 docker 中使用我們提供的 uozi/nginx-ui:latest 鏡像，此鏡像基於 nginx:latest 構建。您可以直接將其監聽到 80 和 443 埠以取代宿主機上的 Nginx。

注意：映射到 /etc/nginx 的資料夾應是一個空資料夾。

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

手動構建

對於沒有官方構建版本的作業系統，可以嘗試手動構建。

依賴

Make
Golang 1.18+
node.js 14+
```
npx browserslist@latest --update-db
```

構建前端

請在 frontend 資料夾中執行以下命令。

yarn install
make translations
yarn build

構建後端

請先完成前端編譯，再回到專案的根目錄執行以下命令。

go build -o nginx-ui -v main.go

Linux 安裝指令碼

基本用法

安裝或升級

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

一鍵安裝指令碼預設的監聽埠為 9000，HTTP Challenge 埠預設為 9180，如果出現埠衝突請修改 /usr/local/etc/nginx-ui/app.ini，並使用 systemctl restart nginx-ui 重啟 Nginx UI 守護行程。

解除安裝 Nginx UI 但保留配置和資料庫檔案

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

Nginx 反向代理配置示例

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

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

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen  443       ssl http2;
    listen  [::]:443  ssl http2;

    server_name         <your_server_name>;

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

    location / {
        proxy_set_header    Host                $host;
        proxy_set_header    X-Real-IP           $remote_addr;
        proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
        proxy_set_header    X-Forwarded-Proto   $scheme;
        proxy_http_version  1.1;
        proxy_set_header    Upgrade             $http_upgrade;
        proxy_set_header    Connection          $connection_upgrade;
        proxy_pass          http://127.0.0.1:9000/;
    }
}

貢獻

貢獻使開源社群成為學習、啟發和創造的絕佳場所。我們非常感謝您所做的任何貢獻。

如果您有讓這個專案變得更強的建議，歡迎 fork 這個程式庫 (repository) 並建立一個 Pull Request。您也可以建立一個帶有 enhancement （加強）標籤的 Issue。最後，不要忘記給我們的專案點個 Star！再次感謝！

Fork 專案
建立您的分支 (git checkout -b feature/AmazingFeature)
提交您的修改 (git commit -m 'Add some AmazingFeature')
推送到您的分支 (git push origin feature/AmazingFeature)
建立一個 Pull Request

開源軟體授權條款

此專案基於 GNU Affero Public License v3.0 (AGPLv3) 授權條款，請參閱 LICENSE 檔案。透過使用、分發或對本專案做出貢獻，表明您已同意本許可證的條款和條件。

8.6 KiB Raw Blame History Unescape Escape