ProxMenux:面向 Proxmox VE 的選單驅動工具包
專案速覽:選單驅動的 Proxmox VE 工具包、安裝後、備份/還原以及適用於家庭實驗室的即時 Web 儀表板。
秒懂
- 它是什麼?
- 一個命令列工具包,附帶可選的 Web 儀表板,用於管理 Proxmox VE 伺服器。
- 適合誰用?
- ProxMenux 適合希望依 README 明確入口開始的使用者,不適合把素材未說明的相容性或生產保證當成既定事實;先依專案專屬命令與設定檔核對輸入、輸出和權限。
- 可以商用嗎?
- 可以,但有條件。GPL-3.0 是 copyleft 授權:如果你散布包含它的軟體,就必須以同一授權公開該軟體的原始碼。只在內部執行、不對外散布,則不會觸發這項義務。
- 還在維護嗎?
- 有在維護。儲存庫在最近一天內有新的提交。
- 用什麼語言寫的?
- 主要是 TypeScript(依據 GitHub 的語言統計)。
以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。
開源專案深度解析
面向 Proxmox VE 的選單驅動 CLI 和 Web 儀表板
ProxMenux 是一個面向 Proxmox VE 的互動式工具包。它提供選單驅動的命令列介面和可選的 Web 儀表板,用於安裝後配置、備份和恢復操作,以及家庭實驗室的持續健康監控。該儀表板名為 ProxMenux Monitor,作為標準安裝的一部分自動安裝,並以 systemd 服務運行。倉庫元資料將項目描述為「選單驅動的 Proxmox VE 工具包,,安裝後、備份/恢復和家庭實驗室的即時 Web 儀表板」。該描述與 README 的自我描述一致。
ProxMenux 的操作邊界相當具體:安裝腳本來自 main,安裝後入口是 `menu`,Monitor 則固定在 8008 埠。這使它適合已有 Proxmox VE 主機、希望把常見管理動作集中到選單的人;README 沒有承諾跨發行版或高可用叢集的行為。 macrimi-proxmenux-deep-analysis 第1節的判斷必須與這個專案的文件內容相互對照。
安裝 ProxMenux
README 記錄了從主分支安裝 ProxMenux 的單一命令:`bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)"`。該命令直接從倉庫下載並執行安裝腳本。README 明確警告從網際網路複製腳本時要小心,並建議在運行前查看提供的連結中的原始碼。它還引用了涵蓋安全和程式碼責任的《行為準則》,但 README 並未描述該準則除連結之外的具體內容。
核驗時可先檢查 `systemctl status proxmenux-monitor`,再查看 `journalctl -u proxmenux-monitor -n 50`,確認服務啟動、登入保護與 VM/LXC 狀態是否符合預期。若測試 Beta,應使用 develop 的 `install_proxmenux_beta.sh` 並把日誌與版本分開保存,因為 README 明確提醒 Beta 可能不完整。 macrimi-proxmenux-deep-analysis 第2節的判斷必須與這個專案的文件內容相互對照。
在 MacRimi/ProxMenux 的這個核對點,應記錄第1次觀察:輸入是否被專案接受、輸出是否符合 README 描述、失敗時是否留下可定位的錯誤。這三項紀錄要和 main 分支的文件版本放在一起,才能分辨設定問題、版本差異與程式行為。
啟動選單
安裝完成後,在 Proxmox 伺服器終端中運行 `menu` 即可啟動 ProxMenux。README 指示「按照螢幕上的選項高效管理你的 Proxmox 伺服器」。它沒有列舉具體的選單項或選項,因此 README 中除了安裝後、備份/恢復和監控的總體描述外,並未詳細說明 CLI 的確切操作。
ProxMenux 的操作邊界相當具體:安裝腳本來自 main,安裝後入口是 `menu`,Monitor 則固定在 8008 埠。這使它適合已有 Proxmox VE 主機、希望把常見管理動作集中到選單的人;README 沒有承諾跨發行版或高可用叢集的行為。 macrimi-proxmenux-deep-analysis 第3節的判斷必須與這個專案的文件內容相互對照。
在 MacRimi/ProxMenux 的這個核對點,應記錄第2次觀察:輸入是否被專案接受、輸出是否符合 README 描述、失敗時是否留下可定位的錯誤。這三項紀錄要和 main 分支的文件版本放在一起,才能分辨設定問題、版本差異與程式行為。
ProxMenux Monitor Web 儀表板
ProxMenux Monitor 是一個整合的 Web 儀表板,可從網路上的任何瀏覽器即時查看 Proxmox 基礎設施。README 列出了其功能:即時監控 CPU、RAM、磁碟使用和網路流量;運行中的虛擬機和 LXC 容器概覽及狀態指示;登入認證;支援 TOTP 的雙因素認證;支援 Nginx 和 Traefik 的反向代理;以及針對桌面和行動裝置的響應式設計。儀表板可透過 `http://<你的Proxmox IP>:8008` 訪問。它作為名為 `proxmenux-monitor.service` 的 systemd 服務運行,並在啟動時自動啟動。README 提供了檢查服務狀態、查看日誌和重啟服務的命令。
核驗時可先檢查 `systemctl status proxmenux-monitor`,再查看 `journalctl -u proxmenux-monitor -n 50`,確認服務啟動、登入保護與 VM/LXC 狀態是否符合預期。若測試 Beta,應使用 develop 的 `install_proxmenux_beta.sh` 並把日誌與版本分開保存,因為 README 明確提醒 Beta 可能不完整。 macrimi-proxmenux-deep-analysis 第4節的判斷必須與這個專案的文件內容相互對照。
早期功能 Beta 計劃
項目運行一個 Beta 計劃,可提前訪問新功能,包括來自 `develop` 分支的最新 ProxMenux Monitor 構建。README 包含一個單獨的命令來安裝 Beta 版本,該命令從 develop 分支獲取 `install_proxmenux_beta.sh`。它警告 Beta 構建可能包含錯誤或不完整功能,並鼓勵用戶透過 GitHub Issues 報告問題。README 稱,當發布穩定版本時,ProxMenux 將在下次啟動 `menu` 時通知用戶,並提供自動切換的選項。README 並未指定發布的時間表或當前哪些功能處於 Beta 階段。
ProxMenux 的操作邊界相當具體:安裝腳本來自 main,安裝後入口是 `menu`,Monitor 則固定在 8008 埠。這使它適合已有 Proxmox VE 主機、希望把常見管理動作集中到選單的人;README 沒有承諾跨發行版或高可用叢集的行為。 macrimi-proxmenux-deep-analysis 第5節的判斷必須與這個專案的文件內容相互對照。
依賴項和翻譯
在設定過程中,以下 Debian 套件會自動安裝:`dialog` 用於互動式終端選單,`curl` 用於下載和連線檢查,`jq` 用於 JSON 處理,`git` 用於倉庫克隆和更新,以及 `python3` 和 `python3-pip` 用於使用 Flask 的 ProxMenux Monitor。UI 翻譯以預構建的 JSON 檔案形式提供,支援英語、西班牙語、法語、德語、義大利語和葡萄牙語。README 聲明沒有執行時期翻譯依賴,意味著翻譯已編譯到發行版中,而不是在執行時期獲取。
核驗時可先檢查 `systemctl status proxmenux-monitor`,再查看 `journalctl -u proxmenux-monitor -n 50`,確認服務啟動、登入保護與 VM/LXC 狀態是否符合預期。若測試 Beta,應使用 develop 的 `install_proxmenux_beta.sh` 並把日誌與版本分開保存,因為 README 明確提醒 Beta 可能不完整。 macrimi-proxmenux-deep-analysis 第6節的判斷必須與這個專案的文件內容相互對照。
貢獻、支援和許可證
README 邀請各種形式的貢獻,並指向涵蓋項目結構、UI 設計策略、訊息輔助函數、翻譯策略和提交約定的《貢獻指南》。幫助方式包括程式碼貢獻、錯誤報告、想法和回饋、翻譯、Beta 測試以及給倉庫加星標。項目採用 GPL-3.0 許可證。許可證摘錄指出,它是一個自由、copyleft 許可證,保障共享和修改軟體的自由,並明確表示該自由軟體不提供任何保固。README 未提及任何商業支援或安全保證。
ProxMenux 的操作邊界相當具體:安裝腳本來自 main,安裝後入口是 `menu`,Monitor 則固定在 8008 埠。這使它適合已有 Proxmox VE 主機、希望把常見管理動作集中到選單的人;README 沒有承諾跨發行版或高可用叢集的行為。 macrimi-proxmenux-deep-analysis 第7節的判斷必須與這個專案的文件內容相互對照。
編輯結論
ProxMenux 適合希望依 README 明確入口開始的使用者,不適合把素材未說明的相容性或生產保證當成既定事實;先依專案專屬命令與設定檔核對輸入、輸出和權限。
社群筆記