Pomelo 使用手冊(Debian 13)

Pomelo 0.41 · 2026-11-14

Pomelo 是一套輕量、省資源的 X11 桌面,包含:

整個桌面不需要 GNOME,閒置時常駐的記憶體只有幾十 MB。

這份手冊說明怎麼在 Debian 13 上安裝、使用與移除 Pomelo。

Pomelo 桌面:上面是選單列,下面是 Dock

手冊裡的畫面是在 Ubuntu 上截的,在 Debian 13 上看起來一樣。


1. 系統需求

2. 安裝

先解開安裝包,進到解開的資料夾:

tar xzf pomelo-0.41-debian13-amd64.tar.gz
cd pomelo-0.41-debian13
sudo apt install --no-install-recommends libwebkitgtk-6.0-4 gstreamer1.0-plugins-good gstreamer1.0-libav
sudo apt install ./*.deb

第一個 apt 先用精簡方式裝小柚瀏覽器的網頁引擎:Debian 的 WebKitGTK 會「建議」整套影音外掛與圖片工具(ImageMagick、Ghostscript……,約 300 MB,瀏覽器用不到)。其他套件照常安裝建議的套件。

想裝到最精簡(不裝任何建議套件):

sudo apt install --no-install-recommends ./*.deb

安裝時不會換掉你原本的桌面或登入畫面。原本的桌面還在,登入時可以選擇要用哪一個。

升級:下載新版的安裝包,用同樣的指令安裝即可,你的設定都會保留。

安裝包裡的「開發用」資料夾是寫 Pomelo 程式用的標頭檔套件(libpomelo-dev),一般使用不用裝。

3. 第一次登入

用原本的登入畫面

先登出,然後在登入畫面選「Pomelo」工作階段:

登入畫面會記住你的選擇,下次會直接進 Pomelo。

改用 Pomelo 登入畫面(選用)

Pomelo 有自己的登入畫面:大時鐘、頭像、背景是你的桌布,常駐只用約 2 MB 記憶體。換之前請一定先試用:

sudo pomelo-dm-switch try      # 在 Ctrl+Alt+F7 開一個 Pomelo 登入畫面試用,不改任何設定
sudo pomelo-dm-switch on       # 確定沒問題,之後開機都用它
sudo pomelo-dm-switch off      # 換回原本的(GDM、LightDM、SDDM)

萬一登不進去:

  1. 按 Ctrl+Alt+F3,用文字畫面登入。
  2. 執行 sudo pomelo-dm-switch off。
  3. 執行 sudo reboot 重新開機。

登入畫面的背景、時鐘、文字大小、要不要顯示使用者清單、自動登入、畫面下方的訊息,都在「系統設定 → 登入畫面」調整。

Pomelo 登入畫面(不顯示使用者清單、背景用漸層、加上歡迎訊息)

Pomelo 登入畫面在 Debian 13 上目前只在虛擬機器測試過,請先用 try 試用,確定能正常登入再用 on。

4. 認識桌面

Super 就是鍵盤上的 Windows 鍵。

左上角的 Pomelo 選單 控制中心

左:左上角的 Pomelo 選單。右:控制中心。

啟動器(Super+A):在圖示上按右鍵可以編輯
搜尋(Super+空白鍵):找不到的話可以直接問小柚

多桌面(虛擬桌面)

Pomelo 預設有 4 個桌面(可以在「系統設定 → 多桌面」改成 2~10 個)。每個桌面有自己的一組視窗,切換時只看得到那個桌面的視窗;選單列、Dock、桌布、小柚、通知在每個桌面都在。視窗的最大化、全螢幕、位置各桌面各自保留,每個桌面也各自記得上次用的是哪個視窗。

按鍵或手勢 功能
Ctrl+Alt+← / Ctrl+Alt+→ 切到前一個 / 下一個桌面(到頭不繞回)
Super+1~9 直接跳到第 1~9 個桌面
Super+Alt+1~9 把目前的視窗移到那個桌面(預設會跟過去;設定可改成留在原桌面)
Ctrl+Alt+Shift+← / → 把目前的視窗移到前一個 / 下一個桌面
Super+Tab、Super+E 或 Ctrl+Alt+↑ 桌面總覽(再按一次或 Esc 離開)
觸控板三指或四指左右滑 跟著手指切換桌面;三指往上滑開桌面總覽
視窗標題列按右鍵 「移到桌面 1/2/3…」(目前的桌面打勾、不能選)、「移到新桌面」、「在所有桌面顯示」、「關閉視窗」

把視窗移到桌面用 Super+Alt+數字,不是 Super+Shift+數字:Super+Shift+3/4/5 已經是截圖的快速鍵。終端機原本的「Super+1~9 跳到第幾個分頁」會被切換桌面取代,分頁請用 Ctrl+Tab、Ctrl+PageUp/PageDown 或直接點分頁。

桌面總覽:每個桌面畫成一張小桌面,裡面是視窗縮小的即時畫面(不是靜態圖,影片、終端機照樣在動),目前的桌面有藍色外框。點一張小桌面切過去;點某個視窗的縮圖切到它所在的桌面並叫出它;拖曳視窗縮圖放到別的桌面就移過去;下面的「新增桌面」按鈕新增(到 10 個為止);在小桌面上按右鍵可以「關閉此桌面」(要先是空的,後面的桌面往前補);在視窗縮圖上按右鍵有「移到桌面」選單。方向鍵+Enter、數字鍵 1~9 也可以選;Esc 離開。

小幫手可以用說的或打字:「切到第二個桌面」「把這個視窗移到桌面三」「現在在第幾個桌面」「下一個桌面」「顯示所有桌面」「新增桌面」「讓這個視窗在所有桌面顯示」。

命令列(寫腳本用):pomelo-msg workspace goto 2、next、prev、move 3(視窗跟過去,加 --stay 就不跟)、stick/unstick/toggle-stick、add、remove N、current(印出目前桌面)、count;pomelo-msg overview 開關桌面總覽。桌面編號從 1 起算。對 X11 程式(例如 wmctrl、xdotool)Pomelo 也照 EWMH 標準提供 _NET_NUMBER_OF_DESKTOPS、_NET_CURRENT_DESKTOP、_NET_WM_DESKTOP(0xFFFFFFFF=所有桌面)、_NET_DESKTOP_NAMES,所以 wmctrl -s 1、wmctrl -r :ACTIVE: -t 2 這類指令照樣有效。

多螢幕:所有螢幕一起切換桌面(每個螢幕都顯示同一個桌面編號)。桌面總覽顯示在滑鼠所在的螢幕。重新登入、重新開機後不會還原視窗所在的桌面(視窗本來就會關閉);工作階段中視窗所在的桌面一直記著。舊的 X11 視窗管理員(pomelo-wm)沒有多桌面。

5. 常用快速鍵

按鍵 功能
Super+空白鍵 搜尋(程式、檔案、指令,可以打中文)
Super+A 啟動器(所有程式)
Super+Tab 桌面總覽(所有桌面與視窗,見上面的「多桌面」)
Ctrl+Alt+← / → 切換到前一個 / 下一個桌面(Super+1~9 直接跳、Super+Alt+1~9 把視窗移過去)
Alt+Tab 切換視窗(預設只在目前的桌面)
Super+Return 終端機
Super+Q 關閉視窗
Super+M 縮到最小
Super+↑ / Super+↓ 放大 / 還原
Super+← / Super+→ 貼齊左半 / 右半邊
Super+Ctrl+F 全螢幕
Super+L 鎖定螢幕(萬一畫面只剩深色底、沒有密碼框,按任何鍵就會出現)
Super+Shift+Space 叫小幫手小柚
Super+Shift+V 跟小柚用說的(說完會自動送出)
Super+Shift+3 截取整個螢幕(存到「圖片」)
Super+Shift+4 拖曳選取範圍截圖(按空白鍵改成點選視窗)
Super+Shift+5 截圖與錄影工具列
截圖時再加 Ctrl 只拷貝到剪貼簿,不存檔
鍵盤上的播放/暫停、上一首、下一首 控制影音播放器
鍵盤上的計算機鍵 打開計算機
Super+Shift+R 重新啟動 Pomelo(選單列或 Dock 有問題時)
Super+Shift+Q 登出

終端機:Ctrl+Shift+C/Ctrl+Shift+V 複製、貼上(選取文字後直接按滑鼠中鍵也可以貼上),Ctrl+Shift+T 新分頁、 Ctrl+Shift+N 新視窗、Ctrl+Shift+加號/減號/0 放大縮小文字、Ctrl+Shift+K 清除畫面。按右鍵有選單,上面這些功能都在裡面,還可以在檔案管理員中開啟目前的資料夾;選取的是網址時可以直接開啟連結。終端機裡的程式(例如 vim、htop)自己要用滑鼠時,右鍵會交給那個程式,這時按住 Shift 再按右鍵就是終端機的選單。

6. 系統設定

從左上角的 Pomelo 選單 →「系統設定…」打開(在桌面上按右鍵也有)。設定程式裡的文字欄位(Wi-Fi 密碼、網址、名稱…)可以用 Ctrl+C/Ctrl+V 複製貼上,按右鍵有剪下、複製、貼上、全部清除(密碼欄只能貼上)。內容如下:

系統設定

需要管理員權限的設定,會跳出密碼視窗。

外觀:深色模式、強調色、文字大小、視窗按鈕的位置

網路、企業 Wi-Fi 與 VPN

系統設定 →「網路」:上面是網路卡(有線、Wi-Fi),下面依序是 VPN 與附近的 Wi-Fi;各項目按右鍵都有選單(網路卡:詳細資訊;Wi-Fi:連線、忘記這個網路;VPN:連線/中斷、自動連線、編輯、刪除)。

主機醫生與健康檢查

健康檢查已經併進「主機醫生」(應用程式選單 → 主機醫生;系統設定的「主機醫生(健康檢查)」、網路設定的「檢查網路」、活動監視器的「找出原因」、電源頁的「檢查電池」都會打開它)。到「體檢」分頁按「立即體檢」,大約 20 秒到兩分鐘檢查完八類,上面一張狀態卡寫出結論與進度,下面每一類一張卡片,紅色是需要處理、橘色是建議注意;點進去看每一項找到了什麼、為什麼重要、建議怎麼做。每次完整體檢都會記進歷史,「趨勢」分頁看走勢與預測,「診斷」分頁找出為什麼變慢,「安全」分頁看連線、登入與防火牆。命令列:pomelo-doctor --check [類別…] [--json] [--admin](舊的 pomelo-system --check 會轉給它)。

健康檢查:結論與八類的狀態

檢查只會讀取。有修正方法的項目右邊有按鈕(例如「開啟防火牆」「改用公共 DNS」「只保留最近的 500 MB」日誌),按了會先在畫面上方問你「要…嗎?」並說明會做什麼,按確定才執行;需要管理員權限的會跳出密碼視窗。

病毒掃描:在主機醫生左邊的「病毒掃描」分頁(原本系統設定的病毒掃描頁已經搬進去);也可以在檔案管理員的資料夾上按右鍵 →「掃描病毒…」,或跟小柚說「幫我掃毒」。用的是開源的 ClamAV,第一次用時會問要不要安裝(程式約 30 MB,病毒碼約 230 MB,裝好後在背景自動更新)。選擇掃描「下載」、整個家目錄或外接裝置,掃描時優先權會調低,不影響正在用的程式;會用掉約 1~1.5 GB 記憶體。找到的檔案可以「隔離」(搬到隔離區、拿掉權限,之後可以還原)或在隔離區永久刪除(會先確認)。 ClamAV 最擅長找 Windows 的病毒,適合在隨身碟或下載的檔案拿給 Windows 電腦用之前先掃一下;只在你按掃描時執行,不會一直在背景監控,偵測率也比商業防毒軟體低,請當作多一層保護。病毒掃描頁會顯示病毒碼幾天前更新的,超過一週會提醒,按「更新病毒碼」可以馬上更新。

套件清單(SBOM):主機醫生左邊的「套件與漏洞」分頁(原本系統設定的套件清單頁已經搬進去)。清單列出這台電腦裝了哪些套件——名稱、版本、授權、一句說明,可以搜尋;按「匯出」會把 CycloneDX 1.5 JSON(資安工具與稽核常用的標準格式)或 CSV 存到「下載」資料夾。想知道裝的套件有沒有已知漏洞(CVE),按「下載漏洞資料」:會把發行版自己公開的漏洞清單整份抓到這台電腦(Ubuntu 約 11 MB、Debian 約 6 MB、Rocky 約 6 MB),在本機比對,不會上傳你的套件清單;之後想更新資料就再按一次,超過一週會提醒。比對結果分兩種:有更新可裝(紅燈)表示修正已經出了、請安裝軟體更新;發行版還沒釋出修正(藍燈)多半是低風險或還在評估的,修正出來會出現在軟體更新。點進套件可以看每個 CVE 的嚴重度、說明、修正版本,「詳細資料」會開發行版的漏洞頁面。安全性檢查也會多一項「已知漏洞」。終端機:pomelo-system --sbom(文字)、 --sbom --json(CycloneDX)、--sbom --csv、--sbom --update(更新漏洞資料)。

在終端機也可以檢查:pomelo-system --check(全部)、pomelo-system --check network security(只查某幾類),加上 --json 輸出給程式讀。

螢幕保護程式

閒置一段時間後,Pomelo 會用畫面蓋住螢幕(保護隱私、也讓面板休息)。系統設定 → 螢幕保護程式(或指令 pomelo-screensaver --settings)可以:

閒置後的順序是:螢幕保護程式 → 鎖定螢幕 → 關閉螢幕 → 休眠,前三項的時間在「電源與鎖定」與「螢幕保護程式」兩頁都看得到,設定互相矛盾(例如關閉螢幕比螢幕保護程式早)時會有提示。指令:pomelo-screensaver --preview --kind 時鐘名稱、--list、--lock-now。也可以對小柚說「啟動螢幕保護程式」「螢幕保護程式改成照片」「10 分鐘後啟動螢幕保護」。

7. 輸入法

Pomelo 自帶輸入法,安裝後就能用,不必另外安裝 fcitx 或 ibus。

打完注音按 ↓ 開候選字,按 6 就換成「柚」

其他語言的輸入法:在「語言與輸入法」的「Pomelo 輸入法」裡點一下就能啟用,可以同時啟用好幾個,按 Ctrl+Shift+空白鍵 輪流切換,或點選單列右邊的指示器選。

Qt 程式(例如 VLC、VirtualBox)也能打字(0.33 起,透過 Qt 內建的 IBus 外掛,不必另外安裝)。用 Pomelo 登入畫面時,GTK、Qt、Firefox、小柚瀏覽器這些直接用 Wayland 顯示的程式也能打字(0.40 起),選字列一樣跟著文字游標;密碼欄自動不轉換。用原本的登入畫面時,GTK4 程式透過 ibus-gtk4 這個小套件打字(裝小柚瀏覽器時會一起裝好)。

限制:Flatpak、Snap 版的程式(例如從軟體商店裝的 VLC)有自己的一套環境,還不能用 Pomelo 輸入法。要在這些程式打中文,請改用: Fcitx 5(sudo apt install fcitx5 fcitx5-chewing),然後在「語言與輸入法」把輸入法框架改成 Fcitx 5。

介面語言:

8. 小幫手「小柚」

小柚是一隻會在桌面上走來走去的小機器人,背後是在你電腦上執行的 AI。你說的話不會傳到網路上;只有查天氣和用瀏覽器搜尋時才會連網(想讓牠能做更多事,可以自己選擇打開「線上大腦」,見本節最後)。

小柚:「今天星期幾」立刻回答;找到兩個報價單時列出來讓你選

9. 截圖與錄影

截圖存到「圖片」資料夾,錄影存到「影片」資料夾。截圖後右下角會出現縮圖,點一下就打開;在縮圖上按右鍵選「用繪圖編輯」,可以加上箭頭、文字或裁切(見第 10 節的「繪圖」)。

截圖與錄影工具列(Super+Shift+5)

螢幕錄影

工具列中間三個有紅點的是錄影:「錄製整個螢幕」「錄製視窗」「錄製選取範圍」。

錄影需要 ffmpeg,由你自己另外安裝(Pomelo 不會預先安裝它)。第一次錄影時會詢問,按「安裝」就會開終端機安裝(ffmpeg;Ubuntu 與 Debian 的版本含 libx264,可存 MP4)。

10. 文字編輯器、計算機、行事曆、看圖、繪圖、影音播放器與 PDF 閱讀器

這些程式在啟動器裡。檔案管理員雙擊文字檔、照片、音樂、影片、PDF 時,也會自動用它們打開。

文字編輯器

文字編輯器:上面是選單列與分頁,左邊是檔案清單

計算機

計算機:工程模式,邊打邊算

行事曆

行事曆:月檢視,有農曆、節氣與多日行程;左邊是迷你月曆與行事曆清單

主機醫生(應用程式選單 → 主機醫生;系統設定的「主機醫生(健康檢查)」;原本的健康檢查已併進它的「體檢」分頁)

入侵檢查、日誌與被攻擊時的處置

主機醫生左邊的「入侵檢查」「日誌」「處置」三個分頁,用來回答「我的電腦有沒有被入侵?」和「如果被入侵了怎麼辦?」。

入侵檢查:按「開始檢查」(約 3~5 秒,只讀、優先權調到最低),會找:系統檔案有沒有被換掉、木馬重開機後還能活著的各種位置(排程、服務、shell 啟動檔、ld.so.preload、PAM、sudoers、SSH 金鑰、新增的帳號…)、可疑或被藏起來的行程、不尋常的網路連線、可疑的核心模組、檔案系統裡的怪東西。結果先給一句結論與嚴重度(紅=高、橘=中、藍=低),每一項展開是「為什麼重要」「證據」「建議做法」與按鈕(標為正常、加入時間線、在日誌中查看)。「完整檢查」會驗證所有系統檔案(較慢);「管理員權限檢查」多看 root 與其他使用者的部分(只讀,會問管理員密碼)。每週會自動做一次輕量檢查,高度可疑時通知你。

請注意這個檢查的限制:它是在這台電腦上做的,只能說「發現跡象」或「沒有發現已知跡象」,不能保證沒有被入侵—— 高明的入侵(例如核心層的 rootkit)可以欺騙在本機上做的檢查。懷疑被入侵時,請用外部乾淨的環境(開機光碟)再檢查一次。

日誌:把系統日誌、登入紀錄(auth.log/secure、wtmp、btmp)、核心訊息、防火牆與套件紀錄放在一個地方看,可以依時間、等級、服務、關鍵字篩選,14 類安全事件(失敗登入、成功登入、sudo、新增帳號、密碼變更、SSH 金鑰、服務啟停、核心錯誤、模組、防火牆、套件、排程…)會用顏色與圖示標出來;點一行看解析出來的欄位與前後文,按右鍵可以複製、用這個來源 IP 或服務過濾、加入「事件時間線」或標為證據;可匯出(可去識別化)。「事件時間線」把你標記的事件排在一條時間軸上,能自動找出同一使用者、同一來源 IP 或前後 10 分鐘內的相關事件。

處置:萬一真的被入侵,這一頁用六個步驟帶你:先別關機也別刪檔 → 暫時斷網(會先問你)→ 建立證據包(含 SHA-256,可加密,不含密碼雜湊與私鑰)→ 換掉所有密碼與金鑰 → 從乾淨的環境重新安裝或還原 → 通報與求助。這一頁只會做兩件事:保存證據、暫時斷網,而且都不會自動執行。

命令列:pomelo-doctor --intrusion [--deep] [--json] [--brief](結束碼 0=沒有發現已知跡象、1=有中低度跡象、2=有高度跡象)、 pomelo-doctor --logs [--since 24h] [--security] [--unit sshd] [--grep 字串] [--json]、pomelo-doctor --evidence 資料夾。小幫手也聽得懂「有沒有被入侵」「最近有誰登入」。

看圖

看圖:右上角是縮放、旋轉、幻燈片、垃圾桶、資訊

繪圖

繪圖:上面是工具、粗細、前景色與背景色、色盤

影音播放器

影音播放器:左邊是封面,右邊是播放清單

PDF 閱讀器

PDF 閱讀器:左邊是頁面縮圖,上面有頁碼、縮放與搜尋
PDF 閱讀器的填寫與簽名:螢光筆、便利貼與手寫簽名

修改 PDF:工具列上手形工具旁邊的四個按鈕(註解、填寫與簽名、整理頁面、編輯內容;選單列的「工具」也有)會在下面多一排工具。改過的文件分頁名稱前面有「•」,記得 Ctrl+S 儲存(Ctrl+Shift+S 另存新檔);Ctrl+Z 復原、Ctrl+Shift+Z 重做。還沒存就關掉時會問你要不要儲存。

11. 遠端桌面

連到 Windows 電腦的桌面(RDP 協定),例如遠端操作公司或家裡的電腦。協定本身用 FreeRDP 函式庫,視窗、設定介面是 Pomelo 自己畫的,不需要另外裝 xfreerdp(也不會跟它衝突,兩個可以同時裝)。

遠端桌面:常用電腦清單、快速連線

12. 文書處理器

開啟、編輯、存檔 Word(.docx)與 OpenDocument(.odt)文件,雙擊這兩種檔案預設就用「文書處理器」(pomelo-writer)開。排版引擎、檔案格式讀寫都是自己寫的,不需要另外裝 LibreOffice 或 Microsoft Office,也能跟它們互相開檔。

文書處理器:標題樣式、圖片與左邊的大綱面板

13. 試算表

開啟、編輯、存檔 Excel(.xlsx)與 OpenDocument(.ods)試算表,雙擊這兩種檔案預設就用「試算表」(pomelo-sheet)開。試算表模型、公式引擎、檔案格式讀寫都是自己寫的,不需要另外裝 LibreOffice 或 Microsoft Office,也能跟它們互相開檔。

試算表:標題列、公式與格式設定

14. 簡報

開啟、編輯、存檔 PowerPoint(.pptx)與 OpenDocument(.odp)簡報,雙擊這兩種檔案預設就用「簡報」(pomelo-slides)開。簡報模型、檔案格式讀寫都是自己寫的,不需要另外裝 LibreOffice 或 Microsoft Office,也能跟它們互相開檔。

簡報:設計主題庫,點一下套用到整份簡報

15. 小柚瀏覽器

小柚瀏覽器:上面是網址列,兩個分頁以上會出現分頁列

小柚瀏覽器是 Pomelo 內建的網頁瀏覽器,開得快、佔用的記憶體少。網頁的排版、JavaScript 與安全性更新來自系統的 WebKitGTK,跟著系統更新。

16. 虛擬機器

虛擬機器:清單上每台都看得到狀態與使用量

「虛擬機器」可以在這台電腦裡執行別的作業系統(例如試裝別的 Linux、跑一台 Windows),不用重開機、不會動到這台電腦的系統。底層是 Linux 內建的 KVM 與 QEMU,不需要另外的核心模組,也不需要 libvirt。

畫面視窗:上面一排是電源、暫停、光碟、USB、快照、按鍵、檢視
使用量:CPU、記憶體、磁碟讀寫、網路收送,最近一分鐘的圖表

17. 容器(Docker)

容器:執行中的容器顯示使用量與連接埠,compose 專案的名稱在括號裡

「容器」用來管理 Docker:容器、映像、資料卷與備份,不用記指令。

18. 容器叢集(Kubernetes)

「容器叢集」是選裝的程式(軟體中心可以裝、移除),給想玩 Kubernetes 但不想研究怎麼架的人:引擎是 k3s(輕量的 Kubernetes, Apache 2.0 授權,第一次建立時才下載,約 70 MB),我們做的是上面那一層——用點選的方式建好、管好叢集。底下就是標準的 Kubernetes: kubectl、Helm chart、別人寫的 YAML 都能直接用。

建立叢集(四步)

  1. 要幾台:「只用這台電腦」一分鐘內能用,適合學習、開發;「多台電腦」填每台的 IP 與 SSH 帳號密碼(帳號要能 sudo;第一次用密碼,之後會改用金鑰),也可以把這台電腦一起加進去。
  2. 體檢與建議:每台 SSH 進去只讀取硬體與系統狀況(核心數、記憶體、磁碟是 SSD 還是硬碟、網卡速度、系統版本、時間有沒有同步、埠有沒有被占、有沒有在跑 Docker 或資料庫),然後每台給一個建議的角色與理由:
  3. 確認:列出哪台裝什麼、會改到哪些檔案。
  4. 建立:逐台顯示進度與日誌:下載 k3s(校驗 sha256)、送到每台、裝 Server 與 Client、取得 kubeconfig、等所有節點 Ready、裝 NFS。失敗停在那一步、說原因、可以重試那一步。日誌也存在 ~/.local/share/pomelo/cluster/<叢集>/deploy.log。

儀表板:最上面是叢集的架構圖——主控台、Server(控制平面,三台以上畫成 etcd 環)、Client,每台掛著 NFS/資料庫/Redis 的標籤、 Ready 燈與 CPU/記憶體用量條,一眼看懂誰在做什麼(精靈勾角色時也會即時畫出規劃中的架構)。接著是叢集燈號(正常/要注意)、節點數與 Ready、Pod 數;六個格子:節點(CPU/記憶體量表、NotReady 會標紅)、Pod(狀態、就緒、重啟次數;點進去看日誌、即時跟著看、進到容器裡的終端機、刪除;底下列出它的警告事件,並用白話解釋常見狀況——「一直當掉重啟」通常是設定錯或連不到資料庫、「抓不到映像」是名稱打錯或連不上網)、工作負載(Deployment/StatefulSet/DaemonSet/Job;點了可以重新啟動、改副本數、刪除)、服務與網址(Ingress 的網址點了直接開瀏覽器)、儲存(磁碟區有沒有接上)、事件(最近兩天的警告)。命名空間可以篩選。每 6 秒自動更新。

進階角色真的會部署:勾了 Redis、資料庫(PostgreSQL/MariaDB/MongoDB 三選一)、映像庫的那台,建立時會用 nodeSelector 把服務釘在那台(Redis 2 GB、資料庫 8 GB、映像庫 20 GB 的磁碟,用預設的 StorageClass),密碼隨機產生、只放在叢集的 Secret 裡;叢集名片會顯示對外位址(節點 IP 的 30379/30432/30306/30017/30500 埠)、叢集內位址(redis.pomelo-redis.svc、db.pomelo-db.svc)與連線字串。映像庫是 http:各節點已經設定成信任它,你電腦的 Docker 要在 insecure-registries 加上那個位址才能 push。

應用:儀表板的「應用」格子。型錄有 Nginx、WordPress(附 MariaDB)、Gitea、MinIO、Nextcloud(附 MariaDB)、Uptime Kuma,點一個、改名稱/磁碟大小/密碼/網址主機名就能部署;「用我的映像」填映像、埠、環境變數(A=1;B=2)、要不要磁碟,幫你生出 Deployment+Service+Ingress。按「預覽」可以看會套用的 YAML(都是標準寫法,之後用 kubectl 也看得懂)。網址用 nip.io(<名稱>..nip.io 會自動解析成那個 IP),同一個網路的電腦打開就能用;要自己的網域就改主機名。已安裝的應用列在同一頁,Pod 就緒後按「打開」。要移除:在「工作負載」刪掉,或終端機 kubectl delete namespace app-<名稱>。

加節點/移除節點:節點頁最下面「加入一台」填 IP 與帳號密碼,體檢沒問題就裝成 Client 加入;每台節點的「移除」會先把 Pod 搬走(drain)、從叢集刪掉,再到那台拆 k3s(要那台的 sudo 密碼)。舊版建的叢集沒有存 token,第一次加節點會先問 Server 的 sudo 密碼把 token 讀回來。

維運(儀表板的「維運」格子):

帳號與權限(儀表板的「帳號與權限」格子):想讓同事或工具看叢集、但不給完整權限時,在這裡建一個帳號——名稱、權限(唯讀、可修改、管理員)、範圍(填一個命名空間,留空就是整個叢集)。建好後按帳號旁邊的「管理」→「匯出 kubeconfig」,把存好的檔案交給對方就能用 kubectl 或 Lens 連進來;刪除帳號它的檔案立刻失效。帳號與權限都是標準的 Kubernetes 物件(pomelo-users 裡的 ServiceAccount 與 RoleBinding),kubectl 看得到也能自己改。匯出的 kubeconfig 等於那個帳號的密碼,請小心交給對方。命令列:accounts、account-add 名稱 view|edit|admin [命名空間]、account-kubeconfig 名稱、account-del 名稱。

總覽、快照與複製(儀表板第一個格子「總覽」):一頁看完叢集——合計幾個應用、Pod、容器在跑,每台機器的 CPU 與記憶體使用率,然後「依應用」(用記憶體最多的排前面)或「依機器」(每台上面跑了哪些 Pod)列出每一個的用量與映像。點一個應用就進詳情:裡面跑哪些容器(映像、埠、資源要求與上限)、每個 Pod 的即時用量、網址與服務、資料放在哪些磁碟區,還有「看日誌」「進到容器(終端機)」,以及重新啟動、副本數 0/1/2/3(0 就是暫停)、刪除。「建立快照」會把應用的設定存在這台電腦,並把它每個磁碟區整份複製成一個新的磁碟區(多占一份空間);預設先把應用暫停再複製、複製完自動恢復,資料庫這類正在寫入的資料才會一致。有了快照可以「還原」(把資料倒回原本的磁碟區)、「複製成新的應用」或刪除。「複製」做出一個名字不同、一模一樣的新應用(可以連資料一起,也可以只建空的磁碟區):標籤、Service、磁碟區的名字都換成新的,新舊兩邊不會搶流量;對外的埠在新應用上改成叢集內部用,ConfigMap 與 Secret 是共用的。總覽最下面可以「部署新應用」或「套用 YAML」。

GitOps(儀表板的「GitOps」格子):把部署檔放進 Git 倉庫,填倉庫網址、分支與資料夾,按「儲存並立即同步」就會抓下來套用到叢集(有 kustomization.yaml 的資料夾用 kustomize)。開「自動同步」之後,背景監看每 5 分鐘看一次,有新的提交才套用(失敗會通知一次)。只會新增與更新,不會把倉庫裡已經拿掉的東西從叢集刪掉。私有倉庫:網址寫成 https://帳號:token@主機/…,或用 SSH 網址(先把這台電腦的 SSH 金鑰加到倉庫)。命令列:gitops-set 網址 [分支] [資料夾]、gitops-sync [--force]、gitops-auto on|off、gitops。

離線安裝包(「維運」頁最下面):沒有網路的環境,先在有網路的電腦按「製作」,把 k3s 與系統映像(x86_64 與 arm64)下載到一個資料夾;把資料夾搬到離線的電腦按「匯入」,之後建叢集不需要網路(系統映像會隨 k3s 一起送到節點)。命令列:bundle 資料夾、bundle-import 資料夾。

多個叢集:首頁會列出所有叢集,每個旁邊顯示節點 Ready 的數量(連不上就寫「連不上」),按下去切換。

問小柚:「叢集怎麼了」會讀出節點與告警;「幫我部署 WordPress」(Gitea、MinIO、Nextcloud、Nginx、Uptime Kuma)會打開那個應用的部署畫面,名稱、網址、密碼在畫面上確認。

套用 YAML:選一個 .yaml 檔或貼網址,等於 kubectl apply;要裝 Helm chart 的話貼一個 HelmChart 資源就會裝(k3s 內建 Helm 控制器,不用另外裝 helm)。匯入:已經有叢集(自己架的或別人給的 kubeconfig)→ 首頁「匯入」選檔案,之後跟自己建的一樣管。叢集名片:API 位址、kubeconfig 路徑、每台的角色、NFS 路徑。移除叢集:會從每台節點移除 k3s 與資料(按兩次確認);匯入的只從清單拿掉。

在終端機用 kubectl:儀表板的「在終端機用 kubectl」會開一個已經接好叢集的終端機。命令列:pomelo-cluster nodes|pods|status、 pomelo-cluster apply 檔案、pomelo-cluster probe 主機 帳號。

安全與隱私:體檢與安裝的每一個指令都寫死在程式裡;密碼只在這次使用時放在記憶體,連線成功就改用主控台的 SSH 金鑰(~/.local/share/pomelo/cluster/id_ed25519);known_hosts 自己一份,不碰你的 ~/.ssh。各節點抓容器映像需要能連網。

19. 壓縮管理員

壓縮、解壓縮、加密,一個程式管 zip、7z、tar 系列、cpio、iso、squashfs、磁碟映像等格式(啟動器裡的「壓縮管理員」)。在檔案管理員的右鍵選單就能直接壓縮與解壓縮,雙擊壓縮檔會用它打開。

壓縮管理員:瀏覽壓縮檔裡的資料夾與檔案,右鍵可以解壓縮選取的項目

在檔案管理員裡用

檔案管理員:在壓縮檔上按右鍵,有「解壓縮到這裡」「用壓縮管理員打開」「壓縮…」
建立壓縮檔視窗:格式、壓縮程度、密碼

支援的格式

格式 讀 建立 加密 備註
zip、jar、apk、epub ✔ ✔ AES-256 最通用,Windows 與手機都能直接開;舊式 ZipCrypto 也能讀寫(標示為較不安全);檔名編碼自動偵測(Big5、GBK、Shift-JIS、EUC-KR)
7z ✔ ✔ AES-256,可連檔名一起加密 沒加密的直接讀寫;加密的 7z 要裝 7-Zip
tar、tar.gz、tar.bz2、tar.xz、tar.zst、tar.lz、tar.lz4 ✔ ✔ OpenPGP(AES-256)整包加密,存成 .gpg 保留 Linux 的權限與符號連結;加密要有 gnupg
cpio、ar、deb、rpm ✔ cpio ✔ cpio 可(gpg)
iso(ISO 9660,含 Joliet、Rock Ridge) ✔ ✔ ✘
squashfs ✔(7-Zip) ✔(要 squashfs-tools) ✘
磁碟映像(FAT、ext、NTFS 的 .img) ✔(7-Zip) ✘ ✘ 看裡面的檔案
單一檔案壓縮:gz、bz2、xz、zst、lz、lzma、lz4、Z ✔ gz、bz2、xz、zst、lz ✔ gpg
cab、lha、xar、dmg、vhd、wim ✔ ✘ ✘
.gpg、.pgp(整包加密的壓縮檔) ✔ 輸入密碼後解開再讀

實際能做什麼要看這台電腦裝了什麼:在終端機執行 pomelo-archive --formats 會列出每個格式能不能建立、能不能加密,缺什麼、怎麼裝;視窗裡做不到的選項會顯示原因,不會默默失敗。

加密

安全

解壓縮是最容易被惡意檔案攻擊的地方,所以壓縮管理員一律先擋再解:

選配的程式(沒裝也能用,只是少幾項功能)

套件 沒裝的時候 怎麼裝
7-Zip(7zip) 不能讀 SquashFS 與磁碟映像,不能開加密的 7z sudo apt install 7zip 或 sudo dnf install 7zip
gnupg 不能建立、開啟 tar 系列的加密檔(.gpg) 多數系統已經有;沒有的話 sudo apt install gnupg 或 sudo dnf install gnupg2
squashfs-tools 不能建立 SquashFS sudo apt install squashfs-tools 或 sudo dnf install squashfs-tools

為什麼不支援 RAR

RAR 的解壓縮程式碼帶有 unRAR 授權限制(不能拿來做出和 RAR 競爭的壓縮程式),不是自由軟體;Pomelo 是自由軟體,也不想讓你在不知情的情況下碰到授權問題。所以壓縮管理員偵測到 RAR(副檔名 .rar、.r00 或檔案開頭是 Rar!)一律回「不支援的格式」,不會交給系統上的 libarchive 或 7-Zip 去讀,也不會呼叫任何 rar、unrar。要開 RAR,請先請對方改傳 zip 或 7z,或自行安裝並使用你信任的其他工具。

關於 7-Zip 的授權

壓縮管理員本身是 GPL-3.0-or-later,7-Zip 是另外執行的選配套件,不是 Pomelo 的一部分,也沒有連結進來。 Ubuntu 24.04/26.04 與 Debian 13 的 7zip 套件裡含有受 unRAR 限制的 RAR 解壓縮碼(套件的 copyright 檔自己有註明),所以我們只把它列為「建議」,不會自動安裝,安裝光碟也不預先放進去;Fedora、Rocky(EPEL)的 7zip 沒有 RAR 碼。就算裝了,壓縮管理員也不會用它讀 RAR。

命令列(給腳本使用)

pomelo-archive [壓縮檔]                         開視窗瀏覽
pomelo-archive --extract-here 壓縮檔…            解壓到壓縮檔旁邊(有進度視窗)
pomelo-archive --compress 檔案或資料夾…          開建立壓縮檔視窗
pomelo-archive --list 壓縮檔                     列出內容
pomelo-archive --test 壓縮檔                     檢查有沒有損壞
pomelo-archive --extract 壓縮檔 -C 目錄          解壓縮(--only 路徑 只解部分;--password-stdin 從標準輸入讀密碼)
pomelo-archive --create 輸出檔 [--format=zip|7z|tar.gz|…] [--level=1-9] [--password-stdin] 檔案…

結束碼:0 成功、1 失敗、2 要密碼、3 密碼不對、4 缺外部程式、5 取消、6 內容不安全、7 空間不夠、8 疑似壓縮炸彈、9 目的地有同名項目。

限制:不支援 RAR;沒有分割壓縮(.001、.002…)、不能修復損壞的壓縮檔、不能刪除壓縮檔裡的單一項目;加密 ZIP 裡的符號連結不會還原;壓縮管理員視窗還不能把檔案「拖出去」到檔案管理員(請用「解壓縮到…」); tar 系列的加密檔不能直接「加入」檔案;加入檔案時要把整個壓縮檔重寫一遍,大檔要等一下。

20. 軟體與更新

21. 檔案、外接裝置與密碼

防火牆管理員:用好用的介面管理 iptables

「防火牆管理員」(pomelo-firewall,在啟動器的「工具」)是 iptables 的圖形管理介面:就地讀取、就地寫回系統現有的規則,不取代、也不接管 ufw、firewalld、Docker。

  1. 第一次開啟會跳出管理員密碼視窗(polkit),授權後在視窗開著的期間不會再問。總覽頂端的橫幅用綠/橘/紅告訴你防火牆現在好不好,下面有七個最常做的動作:新增規則、編輯規則、刪除規則、狀態、基本規則、匯入/匯出、紀錄。
  2. 「規則」頁把每條規則翻成白話(例如「允許 TCP,來自 192.168.1.0/24,目的埠 22(SSH) 連入本機」),可以展開看等價的 iptables 指令。看不懂的規則會標「唯讀」並原樣保留;Docker、ufw、firewalld、k3s 管理的鏈預設唯讀。
  3. 所有修改先放進「待套用」,按「查看差異並套用」才寫進系統:寫回前自動備份、做預檢(會不會切斷你目前的連線),套用後倒數 30 秒,沒按「保留」就自動還原——即使這個視窗當掉也會還原。
  4. 有風險的設定會在下方先給建議:一句話標題、為什麼重要、建議做法與按鈕,可以選「不再提示這一條」。
  5. 「防護」頁可以開啟 SYN 洪水限速、連線數上限、無效封包丟棄、自動封鎖(同一個 IP 連線太頻繁就封鎖,重犯加重);只使用自己的 POMELO_* 鏈,可以一鍵移除。本機防火牆擋不住塞滿頻寬的 DDoS,那要靠上游處理。
  6. 鎖住自己時:pomelo-firewall --reset(移除 Pomelo 的防護鏈)、--revert(還原到寫回前)、--restore 名稱;pomelo-firewall --help 有完整說明。

網路探索:這個網路有哪些設備、有沒有問題

「網路探索」(pomelo-netscan,在啟動器的「工具」)盤點你有權管理的網路:有哪些設備、開了哪些埠、跑什麼系統與型號、大概在網路上的哪個位置,並檢查衝突、可疑設備、不該開的埠、異常封包與整體安全。全程唯讀;只掃描私有網段(公網位址一律拒絕)。

  1. 第一次開啟先閱讀「使用須知」並同意。到「掃描」頁確認範圍(預設是你目前的網段),按「開始掃描」。
  2. 掃描完成後第一個畫面是「網路總覽」:頂端橫幅用綠/橘/紅告訴你網路現在正不正常,並用一句話說最重要的一件事;數字卡點下去會過濾;拓樸圖上有問題的設備會放大並加光暈;右邊是待處理清單,點一項會標出它到閘道的路徑。
  3. 色彩一致:綠=正常、藍=新出現、橘=注意、紅=衝突或問題、灰=離線、紫=不明設備;每種都有不同形狀的徽章。
  4. 點設備看詳情:一句話結論、每個欄位的證據來源、完整的埠表(服務、用途、風險、是否符合埠政策)。右鍵可以標註位置、加入已知設備、重新掃描這台。
  5. 「埠政策」頁可以套用範本(辦公網路、印表機、攝影機、嚴格、寬鬆)或匯入自己的政策;違反的埠會出現在待處理清單。
  6. 沒有進階權限時會以降級模式掃描(看不到 IP 衝突的兩個 MAC、LLDP、DHCP 伺服器)。在「掃描」頁勾「使用 pkexec 取得進階權限」,或請管理員 setcap cap_net_raw+ep /usr/libexec/pomelo/pomelo-netscan-helper。
  7. 命令列:pomelo-netscan --help;例如 pomelo-netscan --assess(整體安全評估,結束碼可給監控用)、--conflicts、--free-ip、--topology --format png(--compare 與上一份掃描比較)。SNMP 只在你自己提供帳密時才用:v1/v2c 用 --snmp-file,v3 用 --snmp-v3-file(密碼不接受命令列參數)。
  8. 位置是「網路上的相對位置」,不是 GPS:有 SNMP 交換器或 LLDP 才能知道設備接在哪個埠;沒有時圖上的虛線只是推論。詳見 docs/網路探索.md。
  9. 拓樸圖可以拖曳節點(位置會記住,右鍵「重新排列」可還原)、切到「框選」模式框住多台設備後批次標註位置/標為已知/隱藏/匯出選取;位置視圖把設備拖到位置方塊上就標註那個位置。方向鍵平移、+/-縮放、F 聚焦上游路徑、/ 搜尋、Esc 清除。有兩份以上的掃描記錄時,上方的時間滑桿可以看歷史快照,「與上一份掃描比較」會用綠光暈標新增、灰色虛線標消失、橘線標連線變更。
  10. 已安裝「封包分析器」時,設備詳情與右鍵選單會多一個「擷取這台的封包…」,封包異常與 IP 衝突項目會多一個「在封包分析器中查看」;它只會開啟封包分析器並帶入過濾條件,需要你在該視窗內自己確認後才會開始擷取。
  11. 服務版本與已公開 CVE 的比對只是依 banner 推斷(可能受影響、未驗證):發行版常把修補回移到舊版號,所以請先查廠商公告;確認沒問題可按「不再提示」。

封包分析器

pomelo-packets(系統設定「網路」頁或啟動器「封包分析器」):開啟 pcap/pcapng(雙擊檔案也可以),或在自己有權管理的網路上擷取封包。第一次使用要閱讀並同意使用須知;預設只做統計(RTP 的抖動、遺失、MOS 估計、SIP 呼叫流程圖),不會把通話還原成可聽的聲音,要還原必須在該工作階段另外勾選「我已取得授權」,播放與匯出會寫入本機稽核紀錄。完整說明見 docs/封包分析器.md。

22. 疑難排解

登入後黑畫面,或登不進去

  1. 按 Ctrl+Alt+F3 用文字畫面登入。
  2. 如果用的是 Pomelo 登入畫面,執行 sudo pomelo-dm-switch off,再 sudo reboot。
  3. 或在原本的登入畫面改選其他工作階段。

選單列或 Dock 不見了、怪怪的按 Super+Shift+R 重新啟動 Pomelo,開著的程式不會被關掉。

中文顯示成方塊安裝中文字型:

虛擬機器很慢,或上面提示沒有硬體虛擬化(KVM)

虛擬機器開不了機虛擬機器的設定頁上,「開機」按鈕下面會寫原因。常見的是記憶體不夠(把虛擬機器的記憶體調小,或關掉一些程式)、硬碟檔正被另一台虛擬機器使用、找不到光碟映像檔(被搬走或刪掉了,到「光碟機」重新選)。

虛擬機器沒有聲音沒有加裝 QEMU 的聲音模組時,聲音是從畫面視窗播出的,畫面視窗關掉(虛擬機器在背景執行)就聽不到;在虛擬機器的設定頁「顯示與聲音」按「安裝」加裝 qemu-system-gui 後,聲音由 QEMU 直接播放。也確認虛擬機器的設定裡「聲音」是打開的,以及虛擬機器裡的系統沒有靜音。

某個程式在 Pomelo 登入畫面的工作階段裡怪怪的(畫面、輸入法、視窗位置) 0.40 起 GTK、Firefox 這類程式直接用 Wayland 顯示。如果某個程式在這種模式下有問題,可以整個退回以前的方式(所有程式都透過 XWayland):用文字編輯器打開 ~/.config/pomelo/settings.conf,加一行

session.wayland = 0

存檔後登出再登入。改回來就把這行刪掉。也請把是哪個程式、什麼狀況回報給我們。

如果只是某一個 Pomelo 程式(例如音效設定)有問題,也可以只讓它退回 XWayland,在終端機這樣開: POMELO_BACKEND=x11 pomelo-sound

容器說「你的帳號還不能管理 Docker」按「加入 docker 群組」,然後登出再登入(剛裝好 Docker 時也一樣要重新登入一次)。

找出問題原因

23. 移除

如果目前用的是 Pomelo 登入畫面,移除時會自動換回原本的登入管理員。

你的個人設定在 ~/.config/pomelo,小幫手的模型與語音、虛擬機器(包括虛擬硬碟)在 ~/.local/share/pomelo,容器的備份預設在 ~/docker-backups。不需要了可以自行刪除。

虛擬機器、容器第一次使用時安裝的 QEMU、Docker 不會跟著 Pomelo 移除,Docker 裡的容器與映像也都還在。不需要的話: sudo apt remove qemu-system-x86 qemu-utils ovmf docker.io

24. 已知限制

25. 授權與第三方元件

Pomelo 是自由軟體,以 GNU 通用公眾授權條款第 3 版或更新的版本(GPL-3.0-or-later)授權,全文在安裝包的 LICENSE 檔(安裝後在 /usr/share/common-licenses/GPL-3 或 /usr/share/licenses/)。可以自由使用、修改、散布;散布修改過的版本時,也要用同樣的授權並提供原始碼。本軟體不提供任何擔保。

開發者:pake@fedora.tw,組織:https://fedora.tw(問題回報與聯絡)。原始碼是跟安裝包放在一起的 pomelo-<版本>-source.tar.gz,也可以寫信索取。

下面這些在你第一次使用對應功能時才會下載,不包含在安裝包裡:

介面使用的其他元件: