使用 Homebrew 安裝
此安裝方法適用於已經安裝了 Homebrew 的 macOS 和 Linux 使用者。
前提條件
- macOS: macOS 11 Big Sur 或更高版本 (amd64 / arm64)
- Linux: 大多數現代 Linux 發行版（Ubuntu、Debian、CentOS 等）
- 系統已安裝 Homebrew
如果您尚未安裝 Homebrew，可以使用以下命令安裝：
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安裝
安裝 Nginx UI
bash
brew install 0xjacky/tools/nginx-ui此命令將：
- 將
0xjacky/toolstap 新增到您的 Homebrew - 下載並安裝最新穩定版本的 Nginx UI
- 設定必要的相依性
- 建立預設設定檔案和目錄
驗證安裝
安裝完成後，您可以驗證 Nginx UI 是否正確安裝：
bash
nginx-ui --version服務管理
Nginx UI 可以使用 Homebrew 的服務管理功能作為系統服務進行管理。
啟動服務
bash
# 啟動服務並設定開機自啟
brew services start nginx-ui
# 或者僅為目前工作階段啟動服務
brew services run nginx-ui停止服務
bash
brew services stop nginx-ui重啟服務
bash
brew services restart nginx-ui檢查服務狀態
bash
brew services list | grep nginx-ui手動執行
如果您更喜歡手動執行 Nginx UI 而不是作為服務：
bash
# 在前台執行
nginx-ui
# 使用自訂設定執行
nginx-ui serve -config /path/to/your/app.ini
# 在背景執行
nohup nginx-ui serve &設定
設定檔案在安裝過程中自動建立，位於：
- macOS (Apple Silicon):
/opt/homebrew/etc/nginx-ui/app.ini - macOS (Intel):
/usr/local/etc/nginx-ui/app.ini - Linux:
/home/linuxbrew/.linuxbrew/etc/nginx-ui/app.ini
資料儲存在：
- macOS (Apple Silicon):
/opt/homebrew/var/nginx-ui/ - macOS (Intel):
/usr/local/var/nginx-ui/ - Linux:
/home/linuxbrew/.linuxbrew/var/nginx-ui/
預設設定包含：
ini
[app]
PageSize = 10
[server]
Host = 0.0.0.0
Port = 9000
RunMode = release
[cert]
HTTPChallengePort = 9180
[terminal]
StartCmd = login更新
更新 Nginx UI
bash
brew upgrade nginx-ui更新 Homebrew 和所有軟體包
bash
brew update && brew upgrade解除安裝
停止並解除安裝
bash
# 首先停止服務
brew services stop nginx-ui
# 解除安裝軟體包
brew uninstall nginx-ui移除 Tap（可選）
如果您不再需要該 tap：
bash
brew untap 0xjacky/tools刪除設定和資料
警告
這將永久刪除您的所有設定、站點、憑證和資料。請確保在繼續之前備份任何重要資料。
bash
# macOS (Apple Silicon)
sudo rm -rf /opt/homebrew/etc/nginx-ui/
sudo rm -rf /opt/homebrew/var/nginx-ui/
# macOS (Intel)
sudo rm -rf /usr/local/etc/nginx-ui/
sudo rm -rf /usr/local/var/nginx-ui/
# Linux
sudo rm -rf /home/linuxbrew/.linuxbrew/etc/nginx-ui/
sudo rm -rf /home/linuxbrew/.linuxbrew/var/nginx-ui/故障排除
連接埠衝突
如果遇到連接埠衝突（預設連接埠為 9000），您需要修改設定檔案：
編輯設定檔案：
bash# macOS (Apple Silicon) sudo nano /opt/homebrew/etc/nginx-ui/app.ini # macOS (Intel) sudo nano /usr/local/etc/nginx-ui/app.ini # Linux sudo nano /home/linuxbrew/.linuxbrew/etc/nginx-ui/app.ini在
[server]部分更改連接埠：ini[server] Host = 0.0.0.0 Port = 9001 RunMode = release重啟服務：
bashbrew services restart nginx-ui
查看服務日誌
要排查服務問題，您可以使用以下命令查看日誌：
Homebrew 服務日誌
Nginx UI 的 Homebrew 配方包含了正確的日誌配置：
bash
# 查看服務狀態和日誌文件路徑
brew services info nginx-ui
# 查看標準輸出日誌
tail -f $(brew --prefix)/var/log/nginx-ui.log
# 查看錯誤日誌
tail -f $(brew --prefix)/var/log/nginx-ui.err.log
# 同時查看兩個日誌文件
tail -f $(brew --prefix)/var/log/nginx-ui.log $(brew --prefix)/var/log/nginx-ui.err.logsystemd 日誌 (Linux)
對於使用 systemd 的 Linux 系統：
bash
# 查看服務日誌
journalctl -u homebrew.mxcl.nginx-ui -f
# 查看最近的日誌
journalctl -u homebrew.mxcl.nginx-ui --since "1 hour ago"手動調試
如果需要調試服務問題，可以手動運行以查看輸出：
bash
# 在前台運行以查看所有輸出
nginx-ui serve -config $(brew --prefix)/etc/nginx-ui/app.ini
# 檢查服務是否正在執行
ps aux | grep nginx-ui權限問題
如果在管理 Nginx 設定時遇到權限問題：
- 確保您的使用者具有讀寫 Nginx 設定檔案的必要權限
- 對於某些操作，您可能需要以提升的權限執行 Nginx UI
- 檢查檔案權限：bash
# 檢查設定檔案權限 ls -la $(brew --prefix)/etc/nginx-ui/app.ini # 檢查資料目錄權限 ls -la $(brew --prefix)/var/nginx-ui/
服務無法啟動
如果服務啟動失敗：
檢查服務狀態：
bashbrew services list | grep nginx-ui驗證設定檔案是否存在且有效：
bash# 檢查設定檔案是否存在 ls -la $(brew --prefix)/etc/nginx-ui/app.ini # 測試設定 nginx-ui serve -config $(brew --prefix)/etc/nginx-ui/app.ini --help嘗試手動執行以查看錯誤訊息：
bashnginx-ui serve -config $(brew --prefix)/etc/nginx-ui/app.ini檢查連接埠衝突：
bash# 檢查連接埠 9000 是否已被佔用 lsof -i :9000 # 檢查 HTTP 質詢連接埠是否被佔用 lsof -i :9180
獲取幫助
如果遇到任何問題：
下一步
安裝完成後，您可以：
- 存取
http://localhost:9000的 Web 介面 - 完成初始設定精靈
- 開始設定您的 Nginx 站點
- 探索 設定指南 進行進階設定