Pomelo 0.41 · 2026-11-14
Pomelo 是一套輕量、省資源的 X11 桌面,包含:
整個桌面不需要 GNOME,閒置時常駐的記憶體只有幾十 MB。
這份手冊說明怎麼在 Fedora 44/45 上安裝、使用與移除 Pomelo。
手冊裡的畫面是在 Ubuntu 上截的,在 Fedora 44/45 上看起來一樣。
cat /etc/fedora-release先解開安裝包,進到解開的資料夾:
tar xzf pomelo-0.41-fedora<44 或 45>-x86_64.tar.gz
cd pomelo-0.41-fedora<44 或 45>
sudo dnf install ./*.rpm
想裝到最精簡(不裝任何建議套件):
sudo dnf install --setopt=install_weak_deps=False ./*.rpm
安裝時不會換掉你原本的桌面或登入畫面。原本的桌面還在,登入時可以選擇要用哪一個。
關於 SELinux:安裝前建議先確認有
semanage
指令(command -v semanage;沒有的話執行
sudo dnf install policycoreutils-python-utils)。安裝
Pomelo 登入畫面時,它會用這個指令設定正確的安全標籤。
升級:下載新版的安裝包,用同樣的指令安裝即可,你的設定都會保留。
安裝包裡的「開發用」資料夾是寫 Pomelo 程式用的標頭檔套件(libpomelo-dev),一般使用不用裝。
先登出,然後在登入畫面選「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)
萬一登不進去:
sudo pomelo-dm-switch off。sudo reboot 重新開機。登入畫面的背景、時鐘、文字大小、要不要顯示使用者清單、自動登入、畫面下方的訊息,都在「系統設定 → 登入畫面」調整。
Pomelo 登入畫面在 Fedora 44/45 上還沒有在實體電腦上完整測試過(特別是開著 SELinux 的情況),請先用
try試用,確定能正常登入再用on。
Super 就是鍵盤上的 Windows 鍵。
左:左上角的 Pomelo 選單。右:控制中心。
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)沒有多桌面。
| 按鍵 | 功能 |
|---|---|
| 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 再按右鍵就是終端機的選單。
從左上角的 Pomelo 選單 →「系統設定…」打開(在桌面上按右鍵也有)。設定程式裡的文字欄位(Wi-Fi 密碼、網址、名稱…)可以用 Ctrl+C/Ctrl+V 複製貼上,按右鍵有剪下、複製、貼上、全部清除(密碼欄只能貼上)。內容如下:
/usr/share/pomelo/picom.conf 複製到
~/.config/pomelo/picom.conf 再改。~/.local/share/applications/pomelo-custom-*.desktop(有
X-Pomelo-Custom=true
標記);名稱與指令不能空白,也不能有換行等控制字元。改系統程式(名稱、隱藏、分類…)只會在你自己的資料夾放一份副本,不動系統的檔案;「還原」就是刪掉那份副本。~/.config/pomelo/settings.conf:launcher.cat.<程式ID>(分類
0~5,沒有就是自動)、launcher.order.<0~5>(該分類的程式
ID,逗號分開,排在前面)、 dock.apps(Dock
固定的程式;全部移除時寫成
-)、appmenu.grid(1 = 圖示顯示)。需要管理員權限的設定,會跳出密碼視窗。
系統設定 →「網路」:上面是網路卡(有線、Wi-Fi),下面依序是 VPN 與附近的 Wi-Fi;各項目按右鍵都有選單(網路卡:詳細資訊;Wi-Fi:連線、忘記這個網路;VPN:連線/中斷、自動連線、編輯、刪除)。
.conf,或「匯入 OpenVPN 設定檔」選 .ovpn(X11
工作階段也可以把檔案直接拖進視窗)。匯入後自動打開這個 VPN
的設定頁。ps 看不到):存起來的走
nmcli 編輯器的標準輸入,只連線不存的走權限 0600 的暫存檔(放在
$XDG_RUNTIME_DIR,用完就刪)。OpenVPN
密碼裡有逗號或反斜線的話沒辦法記住(nmcli
的格式限制),請關掉「記住密碼」。network-manager-openvpn(Fedora、Rocky 叫
NetworkManager-openvpn;只裝基本的,不要裝
-gnome 那個)。沒裝的話匯入 OpenVPN
的地方會變成「安裝」按鈕(用管理員權限安裝)。WireGuard 只需要核心有
WireGuard 模組(Linux 5.6 以上都有),不用另外裝套件。健康檢查已經併進「主機醫生」(應用程式選單 →
主機醫生;系統設定的「主機醫生(健康檢查)」、網路設定的「檢查網路」、活動監視器的「找出原因」、電源頁的「檢查電池」都會打開它)。到「體檢」分頁按「立即體檢」,大約
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(更新漏洞資料)。
Fedora 沒有公開的逐套件漏洞資料,這裡用 dnf
的更新資訊比對,只能列出已經有修正的漏洞。
在終端機也可以檢查:pomelo-system --check(全部)、pomelo-system --check network security(只查某幾類),加上
--json 輸出給程式讀。
閒置一段時間後,Pomelo
會用畫面蓋住螢幕(保護隱私、也讓面板休息)。系統設定 →
螢幕保護程式(或指令
pomelo-screensaver --settings)可以:
閒置後的順序是:螢幕保護程式 → 鎖定螢幕 → 關閉螢幕 →
休眠,前三項的時間在「電源與鎖定」與「螢幕保護程式」兩頁都看得到,設定互相矛盾(例如關閉螢幕比螢幕保護程式早)時會有提示。指令:pomelo-screensaver --preview --kind 時鐘名稱、--list、--lock-now。也可以對小柚說「啟動螢幕保護程式」「螢幕保護程式改成照片」「10
分鐘後啟動螢幕保護」。
Pomelo 自帶輸入法,安裝後就能用,不必另外安裝 fcitx 或 ibus。
其他語言的輸入法:在「語言與輸入法」的「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 dnf install fcitx5 fcitx5-chewing fcitx5-gtk3 fcitx5-qt5),然後在「語言與輸入法」把輸入法框架改成
Fcitx 5。
介面語言:
pomelo-desktop 時會一起建議安裝(Debian/Ubuntu 是
fonts-tlwg-loma-ttf,Fedora/Rocky 是
google-noto-sans-thai-fonts;fonts-noto-core
的 Noto Sans Thai 也可以),只裝單一套件的人請自己加裝。glibc-langpack-語言。小柚是一隻會在桌面上走來走去的小機器人,背後是在你電腦上執行的 AI。你說的話不會傳到網路上;只有查天氣和用瀏覽器搜尋時才會連網(想讓牠能做更多事,可以自己選擇打開「線上大腦」,見本節最後)。
~/.config/pomelo
底下,只有你的帳號讀得到)。線上服務通常按用量計費,費用由你的帳號負擔。docs/AI小幫手.md 的「線上大腦」。截圖存到「圖片」資料夾,錄影存到「影片」資料夾。截圖後右下角會出現縮圖,點一下就打開;在縮圖上按右鍵選「用繪圖編輯」,可以加上箭頭、文字或裁切(見第 10 節的「繪圖」)。
螢幕錄影
工具列中間三個有紅點的是錄影:「錄製整個螢幕」「錄製視窗」「錄製選取範圍」。
/dev/video*)時還有「錄影時顯示視訊鏡頭」,可選四個角落(左上、右上、左下、右下)與大小(小、中、大),鏡頭畫面會疊在錄影的角落。設定會記住。錄影需要 ffmpeg,由你自己另外安裝(Pomelo
不會預先安裝它)。第一次錄影時會詢問,按「安裝」就會開終端機安裝(Fedora
官方套件庫的 ffmpeg-free,沒有 libx264,H.264 用
OpenH264,另外有 VP9/Opus,可存 MP4 與 WebM)。
這些程式在啟動器裡。檔案管理員雙擊文字檔、照片、音樂、影片、PDF 時,也會自動用它們打開。
文字編輯器
計算機
12*(3+4),上面那行會先算出結果,按 Enter 或 = 確定。200+10% 會算成 220(加上 200 的 10%)。行事曆
.ics 檔放在
~/.local/share/pomelo/calendar/,從檔案管理員雙擊別處來的
.ics(Google、Nextcloud
匯出的、郵件附件)會跳出匯入視窗。pomelo-calendar --add "標題" --start "2026-11-20 14:00" --remind 10m、pomelo-calendar --list --json。docs/行事曆.md。主機醫生(應用程式選單 → 主機醫生;系統設定的「主機醫生(健康檢查)」;原本的健康檢查已併進它的「體檢」分頁)
pomelo-doctor --help。主機醫生左邊的「入侵檢查」「日誌」「處置」三個分頁,用來回答「我的電腦有沒有被入侵?」和「如果被入侵了怎麼辦?」。
入侵檢查:按「開始檢查」(約 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 資料夾。小幫手也聽得懂「有沒有被入侵」「最近有誰登入」。
看圖
libheif-freeworld。繪圖
影音播放器
在檔案管理員雙擊音樂或影片就開始播放。在資料夾上按右鍵選「用影音播放器播放」,整個資料夾(含子資料夾)會變成一個播放清單。
同時只會開一個播放器:再打開別的檔案,會交給已經開著的那一個。
空白鍵播放/暫停,←/→ 倒退/快轉 5 秒(加 Shift 是 30 秒),↑/↓ 音量,N/P 下一首/上一首,F 全螢幕(影片),L 顯示或隱藏播放清單。
下面有隨機播放與重複(整個清單/這一首)。關掉再打開,會接著上次的清單與位置。
音樂庫:右邊清單上方切到「音樂庫」,會自動整理「音樂」資料夾(含子資料夾),可以依「歌曲」「歌手」「專輯」瀏覽。點進歌手或專輯會列出裡面的歌,按「播放全部」或在歌上按兩下就開始播;右鍵可以「加到播放清單」。第一次整理需要一點時間,之後只會重讀新增或改過的檔案;放了新歌按右上角的重新整理鈕。專輯封面用資料夾裡的
cover.jpg。
播放時頂端選單列會出現音符圖示,點一下可以暫停或換歌。鍵盤上的播放/暫停、上一首、下一首鍵也能用。也可以跟小柚說「下一首」「暫停音樂」「播放音樂」。
支援的格式: | 種類 | 副檔名 | 要不要 ffmpeg |
|——|——–|—————| | 音樂 | MP3、FLAC、Ogg(Vorbis)、Opus、WAV |
不用,裝好就能播 | | 音樂 | M4A、AAC(還有 WMA、APE 等少見的格式) | 要
| | 影片 | MP4、MKV、WebM、AVI、MOV(還有
M4V、OGV、FLV、3GP、WMV、TS、MPEG) | 要 | | 字幕 | 同名的
.srt;MKV、MP4 內嵌的文字字幕 | 要(ffmpeg 要有 subtitles
濾鏡;沒有的話影片照播,只是不顯示字幕) |
播放清單可以用
.m3u、.m3u8。影片的畫面和聲音各用一個 ffmpeg
行程解碼;拖曳進度、暫停、全螢幕、音量都不會互相卡住。
ffmpeg 要自己另外裝:Pomelo 沒有把 ffmpeg
放進預設安裝(也不在光碟裡),因為各發行版的 ffmpeg
授權與能解的編碼不一樣。沒有 ffmpeg 時 MP3、FLAC、Ogg、Opus、WAV
照樣能播;打開影片或 M4A 時畫面上會說明,按「安裝
ffmpeg」會開終端機,執行下面對應的指令(要輸入你的密碼)。裝好之後再按一次播放。這台電腦:sudo dnf install ffmpeg-free(Fedora
官方套件庫)。ffmpeg-free 因為專利授權,沒有
HEVC(H.265)解碼器(例如 iPhone 錄的影片);H.264 靠 Cisco 免費提供的
openh264(ffmpeg-free
會自動裝進來);AAC、VP9、AV1、Opus、Vorbis、MP3、FLAC 都能播。要播
HEVC,可以加上 RPM Fusion 套件庫,再執行
sudo dnf swap ffmpeg-free ffmpeg --allowerasing 換成完整的
ffmpeg。遇到解不了的檔案,播放器會直接在畫面上寫出是哪一種編碼和該執行的指令。
影片播不出來時不會當掉:壞掉或不是影片的檔案會跳出「打不開」的說明並自動換下一首;電腦上的 ffmpeg 缺少某種解碼器時,畫面上會寫出是哪一種(例如 H.265),並告訴你要裝什麼。
在影片、封面或空白處按右鍵:播放/暫停、上一首、下一首、全螢幕、顯示或隱藏播放清單、隨機、重複、靜音、切換字幕、在檔案管理員中顯示。在清單的歌曲上按右鍵可以播放、從清單移除、在檔案管理員中顯示,或清除整個播放清單。
字幕:影片旁邊有同名的 .srt 字幕檔(例如
電影.srt、電影.zh-TW.srt),或 MKV、MP4
裡內嵌的文字字幕,都會自動顯示(優先選中文), Big5 的舊字幕也可以。按 V
依序切換各個字幕與「關閉」,在影片上按右鍵可以直接選。DVD、藍光那種圖片字幕還不支援。
播影片時螢幕不會變暗或自動鎖定。
PDF 閱讀器
libopenjp2、jbig2dec
函式庫(安裝時會一起建議安裝);沒有的話那張圖會顯示成灰色方塊。修改 PDF:工具列上手形工具旁邊的四個按鈕(註解、填寫與簽名、整理頁面、編輯內容;選單列的「工具」也有)會在下面多一排工具。改過的文件分頁名稱前面有「•」,記得 Ctrl+S 儲存(Ctrl+Shift+S 另存新檔);Ctrl+Z 復原、Ctrl+Shift+Z 重做。還沒存就關掉時會問你要不要儲存。
註解:
填寫表單:有可以填的欄位的 PDF(申請表、問卷…),打開時欄位會有淡藍色的框,直接點就能填:
填寫與簽名:
~/.local/share/pomelo/signatures),只有你看得到。數位簽章(用數位識別碼簽署,可以證明文件簽完之後沒被改過):
~/.local/share/pomelo/digital-ids),密碼不會被記住,忘了就不能用了。http://timestamp.digicert.com,可以改)證明簽署的時間,別人驗證時就不必相信你電腦上的時鐘;憑證之後過期,也能證明簽署當時是有效的。只會送出簽章的雜湊值,不會送出文件內容。簽章內容裡會顯示時間戳記的時間與是哪個伺服器證明的。整理頁面:顯示所有頁面的縮圖。點一下選取(Ctrl+點加選、Shift+點選一段),拖曳可以調整順序;上面有向左/向右旋轉、刪除(也可以按 Delete)、擷取(把選取的頁面變成新的文件)、插入檔案(插在選取的頁面後面)、插入空白頁。按兩下某一頁會回到閱讀畫面並跳到那一頁。
合併檔案(工具 → 合併檔案…):按「加入檔案…」輸入路徑(Tab 補完),用 ↑↓ 調整順序,按「合併」會變成新的分頁,每個原本的檔案在書籤裡各有一項。原本的檔案不會改。有開啟密碼的檔案要先在分頁裡打開才能合併。
加上頁碼(工具 → 加上頁碼…):選格式(例如「第 1 頁,共 9 頁」)、位置、字的大小、第一個號碼、從第幾頁開始(封面不想編號時用)。
編輯內容(改頁面上原本的字、移除浮水印):
編輯文字:滑鼠移到頁面上,可以修改的每一行字會有淡淡的框。點一行,在出現的框裡改字,按 Enter 完成;把字全部清掉就是刪掉那一行。字型預設是「自動」:用最接近原本的字型(明體、楷體、黑體,粗體也會跟著粗);也可以在框下面改選黑體、明體、楷體或粗體(只換字型、不改字也可以)。新的字放在原本的位置,同一行後面的字會跟著挪。改好的字可以選取、搜尋、拷貝。
加入文字:選顏色與大小,點頁面上要加字的地方(點的位置是第一行字的左上角),打字後按 Ctrl+Enter(Enter 換行);框下面可以選字型(黑體、明體、楷體)與粗體,下次會記住。跟「註解」的「文字」不同,這是直接寫進頁面內容,可以選取、搜尋,別人也不能把它當註解刪掉。
移除浮水印:按「移除浮水印…」,會列出整份文件裡可能是浮水印的東西(例如斜的半透明大字、每頁都有的同一個圖案、頁首頁尾),以及出現在幾頁;看起來確定是浮水印的已經勾好,確認後按「移除」。
簽過數位簽章的文件改了內容,簽章會顯示「簽署之後內容被修改過」。改錯了可以按 Ctrl+Z 復原。
有開啟密碼的文件存檔後還是同一個密碼;作者限制「不允許修改」的文件,要輸入擁有者密碼才能改。
存檔是把修改接在原本的檔案後面(整理頁面、合併則是重新寫一份),其他 PDF 閱讀器都能正常開啟、看得到註解與簽名。
連到 Windows 電腦的桌面(RDP
協定),例如遠端操作公司或家裡的電腦。協定本身用 FreeRDP
函式庫,視窗、設定介面是 Pomelo 自己畫的,不需要另外裝
xfreerdp(也不會跟它衝突,兩個可以同時裝)。
快速連線:在上面的欄位輸入電腦名稱或 IP(也可以寫「使用者@電腦」),按 Enter 就連線,不會存起來。
我的電腦:把常用的電腦加進清單,之後點一下就能連,點兩下直接連線。點一下可以修改設定。 Windows 那邊要先在「設定 → 系統 → 遠端桌面」打開「啟用遠端桌面」(家用版沒有這個功能,只有專業版以上才能被連線,但不管哪個版本都可以當作用戶端,用 Pomelo 的遠端桌面去連線到別人的電腦)。
新增電腦時可以設定:
密碼存在鑰匙圈(pomelo-keyring),不會寫進設定檔;沒有鑰匙圈或鑰匙圈鎖著的話,每次連線都會問密碼。
第一次連某台電腦,或電腦重灌、換過憑證時,會問你要不要信任它的憑證(Windows 預設的遠端桌面憑證都不是信任的機構簽發的,這是正常的;如果提示「跟上次不一樣」,要先確認不是有人在中間攔截連線,再選擇信任)。
連線中斷時(網路問題、對方登出、或有人從別的地方登入擠掉你)會告訴你原因,並可以直接按「重新連線」。
開啟、編輯、存檔 Word(.docx)與 OpenDocument(.odt)文件,雙擊這兩種檔案預設就用「文書處理器」(pomelo-writer)開。排版引擎、檔案格式讀寫都是自己寫的,不需要另外裝 LibreOffice 或 Microsoft Office,也能跟它們互相開檔。
編輯:直接打字、刪除;Ctrl+Z/Ctrl+Y 復原/重做。
格式:工具列最左邊的「內文/標題 1/標題 2/標題 3」決定段落樣式(標題會自動變粗體、變大字),其餘按鈕設定粗體、斜體、底線、字型、字級、文字顏色;段落可以設左/中/右/左右對齊;可以加項目符號清單或編號清單;也可以插入簡單的表格,並增加或刪除列與欄。
大綱:工具列最右邊的「大綱」按鈕(或「插入」選單裡的「大綱」)在左邊開一個面板,列出文件裡所有的標題,點一下就跳到那一段;面板裡也會標出目前游標在哪個標題下面。
圖片:「插入」選單的「圖片…」可以插入 PNG 或 JPEG 圖片,圖片自己佔一行(不能跟文字同一段混排);點一下圖片會反白選取,按 Backspace/Delete 可以整張刪除。開啟別人用 Word/LibreOffice 做的文件時,裡面的圖片也能正常顯示。
頁碼:「插入」選單裡的「頁碼」打勾後,每一頁的頁尾中間會印出頁碼;再點一次關掉。
尋找與取代:Ctrl+F(尋找)或 Ctrl+H(取代),跳出的對話框可以設定要不要區分大小寫;「找下一個」「找上一個」會在整份文件裡繞著找(含表格儲存格),找到就反白選取;「取代」換掉目前選取的那一個再找下一個,「全部取代」一次換掉整份文件裡所有符合的地方。
版面設定:「檔案」選單的「版面設定…」可以選紙張大小(A4、US Letter、US Legal 或自訂寬高)、直向/橫向,以及上下左右的邊界(公分)。
列印:「檔案」選單的「列印…」(或 Ctrl+P)會先顯示頁面預覽,再選印表機、設定份數列印整份文件。
檔案:
開啟:選單裡的「開啟…」(或
Ctrl+O)會打開檔案瀏覽視窗,可以點資料夾進去、點「上一層」回上層,只列出資料夾跟
.docx/.odt 檔案,點一下檔案就開啟;也可以直接在上面的位置欄貼路徑按
Enter;啟動器/檔案管理員點兩下 .docx/.odt 檔案,或在終端機用
pomelo-writer 檔名,都可以直接開啟。
儲存/另存為:存檔格式看檔名的副檔名(打 .docx 結尾就存成 Word 格式,.odt 結尾就存成 OpenDocument 格式);沒有打副檔名的話,用另存為視窗裡選的格式,並自動補上對應的副檔名。
剪貼簿:跟其他 Pomelo 程式共用剪貼簿,可以貼文字過去或貼過來。
中日韓文輸入:跟文字編輯器一樣用 XIM(見第 7 節),可以搭配 pomelo-input 或 fcitx5。
開啟、編輯、存檔 Excel(.xlsx)與 OpenDocument(.ods)試算表,雙擊這兩種檔案預設就用「試算表」(pomelo-sheet)開。試算表模型、公式引擎、檔案格式讀寫都是自己寫的,不需要另外裝 LibreOffice 或 Microsoft Office,也能跟它們互相開檔。
=
開頭就是公式,可以寫儲存格位址(A1,$A$1
可以鎖住列或欄)、範圍(A1:A10)、跨工作表參照(工作表2!A1),以及四則運算、比較、字串串接(&)。數字後面打
% 會自動存成百分比格式。約 130 個函式:
SUM AVERAGE
COUNT COUNTA COUNTBLANK
MIN MAX MEDIAN MODE
STDEV STDEV.P VAR
VAR.P LARGE SMALL
RANK PERCENTILE QUARTILE
PRODUCT SUMSQ SUMPRODUCT
ROUND ROUNDUP ROUNDDOWN
TRUNC CEILING FLOOR
INT ABS SIGN SQRT
POWER EXP LN LOG
LOG10 MOD QUOTIENT
EVEN ODD FACT GCD
LCM PI SIN COS
TAN ASIN ACOS ATAN
DEGREES RADIANS RAND
RANDBETWEEN。SUMIF COUNTIF
AVERAGEIF SUMIFS COUNTIFS
AVERAGEIFS(條件可以寫
">3"、"<>a"、"小明")。LEN
LEFT RIGHT MID FIND
SEARCH SUBSTITUTE REPLACE
REPT UPPER LOWER
PROPER TRIM EXACT
VALUE TEXT CONCATENATE
CONCAT TEXTJOIN CHAR
CODE。TEXT(值, "格式") 支援
0.00、#,##0、0%、yyyy-mm-dd、hh:mm:ss。IF IFS
SWITCH CHOOSE AND OR
NOT XOR IFERROR IFNA
NA ISNUMBER ISTEXT
ISBLANK ISERROR ISNA
ISEVEN ISODD TRUE
FALSE。VLOOKUP HLOOKUP
XLOOKUP INDEX MATCH
ROW COLUMN ROWS
COLUMNS。TEXT):TODAY NOW
DATE YEAR MONTH DAY
WEEKDAY HOUR MINUTE
SECOND DAYS EDATE
EOMONTH DATEDIF
NETWORKDAYS。1 拖成
1 2 3 4 5…);選兩格以上就依趨勢(2、4 拖成
6、8、10…)。按住 Ctrl
再放開滑鼠,改成只複製。第1名 →
第2名,Item007 →
Item008(保留位數)。星期五 →
星期六、星期日、星期一…)。=A1+B1 往下填成
=A2+B2;$A$1
鎖住的不動)。其他文字照樣重複。=...
開頭,貼到別的程式或從別的程式貼進來也看得出來是公式),但格式不會保留。pomelo-sheet 檔名,都可以直接開啟。開啟、編輯、存檔 PowerPoint(.pptx)與 OpenDocument(.odp)簡報,雙擊這兩種檔案預設就用「簡報」(pomelo-slides)開。簡報模型、檔案格式讀寫都是自己寫的,不需要另外裝 LibreOffice 或 Microsoft Office,也能跟它們互相開檔。
投影片:左側是投影片縮圖側欄,點一下切換;拖曳縮圖可以調整順序,滾輪捲動。工具列的「+ 新增投影片」或 Ctrl+M 新增投影片,可以選版面:標題投影片、標題及內容、兩欄內容、只有標題、空白;新的投影片跟著目前的設計主題排好。在縮圖上按右鍵可以新增、再製、刪除、往上移/往下移,也可以換設計主題、背景色、轉場;在投影片總覽按右鍵也一樣。刪除時至少要留一張。
物件:「插入」選單可以加入文字方塊、矩形、橢圓、線條、圖片(只認得 PNG/JPEG)。點一下選取物件,四個角落的控點可以拖曳調整大小,拖曳物件本身可以移動;方向鍵微調位置(Shift 加大步幅); Delete/Backspace 刪除選取的物件。在物件上按右鍵有剪下、複製、貼上、再製、刪除、移到最上層/最下層、顏色、進場動畫;在投影片空白處按右鍵可以貼上、新增投影片、插入文字方塊或圖片。鍵盤:Ctrl+X/Ctrl+C/Ctrl+V 剪下/複製/貼上,Ctrl+D 再製(複製的物件只能在簡報裡貼上)。
文字編輯:雙擊文字方塊開始編輯,直接打字;Enter 換行,一行太長會自動折行(英文在空白處、中文每個字都能斷,標點不會跑到行首);Esc 或點別的地方結束編輯。工具列可以設定粗體、斜體、底線、文字顏色、字型、字級,以及靠左/置中/靠右對齊。
形狀格式:矩形、橢圓、線條可以分別設定外框顏色與填滿顏色(線條只有外框顏色);也可以設定目前投影片的背景色。
設計主題:工具列的「設計」或「設計」選單的「設計主題庫…」打開主題庫,12 種主題(簡約白、經典藍、暗夜、活力橘、森綠、柔粉、深紫、商務灰、海洋、幾何、科技、晨曦)各有背景與裝飾圖形,標題投影片與內容投影片的版面不一樣,也搭配好字型與顏色;每個主題都有預覽(右下角是內容投影片的樣子)。點一下套用到整份簡報:標題、副標題、內文會搬到主題的位置並換上主題的字型、字級、顏色(有圖片或圖形、自己排過版的投影片只換字型和顏色,不會搬動);按右鍵可以只套用到目前這張。之後新增的投影片、插入的圖形也跟著主題。選「無(白色)」拿掉主題。設定了投影片背景色的那一張,背景色優先。存成 .pptx/.odp 時主題的背景會畫成一張圖放在投影片最底層, PowerPoint、LibreOffice Impress 打開看起來一樣;用 Pomelo 再打開時會認回主題,可以繼續換。
效果:「格式」選單的「投影片轉場…」設定換到這張投影片時的動畫(無/淡入淡出/橫向推入/擦除);選取物件後「物件進場動畫…」設定這個物件出場時的動畫(無/淡入/由左飛入/由下飛入),投影片出現時這張投影片上有設定動畫的物件會一起播放,不是依序逐一播放。轉場跟進場動畫在播放、預覽播放時都看得到。
備忘稿:畫面下方是備忘稿欄,點一下輸入,每張投影片各自記錄;「投影片」選單的「顯示備忘稿欄」可以關掉/打開這一欄。存檔時備忘稿會一起存進 .pptx/.odp,跟 PowerPoint、LibreOffice Impress 互通。
投影片總覽:「投影片」選單的「投影片總覽」切換成縮圖總覽模式,方便看整體順序跟套版效果;點一下選取、雙擊跳回編輯模式;這個模式本身不能拖曳排序,要排序請回到編輯模式用左側縮圖側欄拖曳。
播放:「投影片」選單的「開始播放」或 F5 進入全螢幕播放模式,方向鍵/空白鍵/點一下換下一張, ←/Backspace 換上一張,Esc 離開;「預覽播放…」用一般視窗大小先看一次效果,不用整個螢幕。播放時如果偵測到兩個以上的螢幕,會自動開啟簡報者模式:一個螢幕全螢幕顯示投影片給觀眾看,另一個螢幕(操作用的那台)顯示目前投影片縮圖、下一張縮圖、備忘稿、張數、經過時間,方便台上看稿。
檔案:
pomelo-slides 檔名,都可以直接開啟。已知限制:沒有母片/版面配置可以自訂、沒有表格、圖表;文字方塊只有一種格式套用在整個方塊,不能同一方塊內不同文字不同格式;形狀不能旋轉、不能群組;物件進場動畫播放時機固定是投影片出現時全部一起播放,不支援依點擊順序逐一播放;簡報者模式的雙螢幕畫面配置是自動決定,不能手動指定哪個螢幕當觀眾畫面;設計主題不能自訂(沒有母片編輯),在別的程式裡主題的背景是一張圖,不能改顏色。
中日韓文輸入:跟文字編輯器一樣用 XIM(見第 7 節),可以搭配 pomelo-input 或 fcitx5。
小柚瀏覽器是 Pomelo 內建的網頁瀏覽器,開得快、佔用的記憶體少。網頁的排版、JavaScript 與安全性更新來自系統的 WebKitGTK,跟著系統更新。
「虛擬機器」可以在這台電腦裡執行別的作業系統(例如試裝別的 Linux、跑一台 Windows),不用重開機、不會動到這台電腦的系統。底層是 Linux 內建的 KVM 與 QEMU,不需要另外的核心模組,也不需要 libvirt。
ssh -p 2222 localhost
連(只有這台電腦連得到)。「橋接」讓虛擬機器像區域網路上的另一台電腦,從路由器拿
IP,別台電腦也連得到;需要一個橋接器(例如
br0),沒有的話設定頁有「建立橋接器」按鈕(要用有線網路卡,Wi-Fi
沒辦法橋接;建立時網路會中斷幾秒),第一次使用要按「允許使用」。~/.local/share/pomelo/vm/(硬碟檔、UEFI
設定、快照都在裡面)。設定頁最下面可以在檔案管理員打開,或刪除整台虛擬機器。pomelo-vm --list(列出虛擬機器與狀態)、pomelo-vm --start 名稱、pomelo-vm --stop 名稱(請它關機)、pomelo-vm --kill 名稱(強制關機)。「容器」用來管理 Docker:容器、映像、資料卷與備份,不用記指令。
安裝 Docker:還沒有 Docker 的話,打開後按「安裝」,會開一個終端機視窗(要輸入你的密碼)。安裝系統內建的 moby-engine,設定開機自動執行,再把你加進 docker 群組。裝好之後要登出再登入,加入群組才會生效。Docker 沒在執行、帳號沒權限時,畫面上也會出現對應的按鈕。注意:docker 群組的成員可以透過容器取得整台電腦的管理員權限,只加信任的帳號。
容器:分成執行中與已停止;執行中的會顯示
CPU、記憶體、網路、磁碟使用量與連接埠(本機→容器),用 docker compose
建立的會在名稱後面標出專案。點一下進到容器的頁面。CPU 的 100%
等於一個處理器核心(跟 docker stats 一樣)。
容器的頁面:
docker exec -it 一樣。新增容器:在「容器」分頁最下面按「新增容器」,填映像(例如
nginx、mariadb:11)、名稱、連接埠(本機:容器,例如
8080:80)、資料夾(本機路徑或資料卷名稱:容器裡的路徑,例如
~/網站:/usr/share/nginx/html)、環境變數(用分號分開)、自動啟動,按「建立並啟動」。這台電腦還沒有的映像會先下載。
映像:輸入名稱按 Enter 下載;點映像可以用它建立容器或刪除;「清理」可以刪掉沒有名稱、沒在用的舊映像(通常是更新後留下的)與建置快取。
資料卷:看每個資料卷給哪個容器用;沒在用的可以刪除。資料卷裡的檔案要管理員權限才看得到,要拿出來請用備份。
備份:在容器的頁面按「備份」,會把容器的設定、資料卷與掛載資料夾裡的檔案存成一個資料夾;打開「連映像一起備份」(預設)的話,容器現在的樣子(包括在容器裡改過的東西)也會存起來,可以複製到別台電腦還原。執行中的容器備份時會暫停一下。備份放在「備份」分頁設定的位置(預設是家目錄的
docker-backups),可以改到外接硬碟或網路磁碟。
還原:「備份」分頁點一份備份
→「還原」。會照原本的設定重建容器與資料卷,再把資料放回去;名稱已經有容器在用時會加上
-restored。原本的連接埠被別的容器佔著時,容器照樣還原、只是先不啟動,改好再啟動。
排程備份:可以用指令
pomelo-docker --backup 容器名稱 [資料夾] [--no-image] 放進
cron 或 systemd timer;還原是
pomelo-docker --restore 備份資料夾。
「容器叢集」是選裝的程式(軟體中心可以裝、移除),給想玩 Kubernetes 但不想研究怎麼架的人:引擎是 k3s(輕量的 Kubernetes, Apache 2.0 授權,第一次建立時才下載,約 70 MB),我們做的是上面那一層——用點選的方式建好、管好叢集。底下就是標準的 Kubernetes: kubectl、Helm chart、別人寫的 YAML 都能直接用。
建立叢集(四步)
~/.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(<名稱>.kubectl delete namespace app-<名稱>。
加節點/移除節點:節點頁最下面「加入一台」填 IP 與帳號密碼,體檢沒問題就裝成 Client 加入;每台節點的「移除」會先把 Pod 搬走(drain)、從叢集刪掉,再到那台拆 k3s(要那台的 sudo 密碼)。舊版建的叢集沒有存 token,第一次加節點會先問 Server 的 sudo 密碼把 token 讀回來。
維運(儀表板的「維運」格子):
pomelo-cluster status(節點、告警、憑證)、backup、backups、restore 時間、upgrade、renew-cert、cert、watch。帳號與權限(儀表板的「帳號與權限」格子):想讓同事或工具看叢集、但不給完整權限時,在這裡建一個帳號——名稱、權限(唯讀、可修改、管理員)、範圍(填一個命名空間,留空就是整個叢集)。建好後按帳號旁邊的「管理」→「匯出
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。各節點抓容器映像需要能連網。
壓縮、解壓縮、加密,一個程式管 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
會列出每個格式能不能建立、能不能加密,缺什麼、怎麼裝;視窗裡做不到的選項會顯示原因,不會默默失敗。
加密
安全
解壓縮是最容易被惡意檔案攻擊的地方,所以壓縮管理員一律先擋再解:
..、絕對路徑、指到解壓資料夾外面的符號連結與硬連結都不會還原(會告訴你略過了幾個);setuid/setgid
權限、裝置檔一律去掉。選配的程式(沒裝也能用,只是少幾項功能)
| 套件 | 沒裝的時候 | 怎麼裝 |
|---|---|---|
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 系列的加密檔不能直接「加入」檔案;加入檔案時要把整個壓縮檔重寫一遍,大檔要等一下。
sudo dnf upgradesudo dnf install dnf-automatic,再啟用
dnf-automatic.timer(Fedora 上是
dnf5-automatic.timer)。「防火牆管理員」(pomelo-firewall,在啟動器的「工具」)是
iptables
的圖形管理介面:就地讀取、就地寫回系統現有的規則,不取代、也不接管
ufw、firewalld、Docker。
pomelo-firewall --reset(移除 Pomelo
的防護鏈)、--revert(還原到寫回前)、--restore 名稱;pomelo-firewall --help
有完整說明。「網路探索」(pomelo-netscan,在啟動器的「工具」)盤點你有權管理的網路:有哪些設備、開了哪些埠、跑什麼系統與型號、大概在網路上的哪個位置,並檢查衝突、可疑設備、不該開的埠、異常封包與整體安全。全程唯讀;只掃描私有網段(公網位址一律拒絕)。
setcap cap_net_raw+ep /usr/libexec/pomelo/pomelo-netscan-helper。pomelo-netscan --help;例如
pomelo-netscan --assess(整體安全評估,結束碼可給監控用)、--conflicts、--free-ip、--topology --format png(--compare
與上一份掃描比較)。SNMP 只在你自己提供帳密時才用:v1/v2c 用
--snmp-file,v3 用
--snmp-v3-file(密碼不接受命令列參數)。pomelo-packets(系統設定「網路」頁或啟動器「封包分析器」):開啟
pcap/pcapng(雙擊檔案也可以),或在自己有權管理的網路上擷取封包。第一次使用要閱讀並同意使用須知;預設只做統計(RTP
的抖動、遺失、MOS 估計、SIP
呼叫流程圖),不會把通話還原成可聽的聲音,要還原必須在該工作階段另外勾選「我已取得授權」,播放與匯出會寫入本機稽核紀錄。完整說明見
docs/封包分析器.md。
登入後黑畫面,或登不進去
sudo pomelo-dm-switch off,再
sudo reboot。選單列或 Dock 不見了、怪怪的按 Super+Shift+R 重新啟動 Pomelo,開著的程式不會被關掉。
中文顯示成方塊安裝中文字型:
sudo dnf install google-noto-sans-cjk-fonts
用 Pomelo 登入畫面登入後,有東西不能用(音效、外接裝置…)這可能是 SELinux 擋住了。先換回原本的登入畫面:
sudo pomelo-dm-switch off。sudo ausearch -m avc -ts recent,把結果回報給我們。虛擬機器很慢,或上面提示沒有硬體虛擬化(KVM)
虛擬機器開不了機虛擬機器的設定頁上,「開機」按鈕下面會寫原因。常見的是記憶體不夠(把虛擬機器的記憶體調小,或關掉一些程式)、硬碟檔正被另一台虛擬機器使用、找不到光碟映像檔(被搬走或刪掉了,到「光碟機」重新選)。
虛擬機器沒有聲音也確認虛擬機器的設定裡「聲音」是打開的,以及虛擬機器裡的系統沒有靜音。
某個程式在 Pomelo
登入畫面的工作階段裡怪怪的(畫面、輸入法、視窗位置) 0.40 起
GTK、Firefox 這類程式直接用 Wayland
顯示。如果某個程式在這種模式下有問題,可以整個退回以前的方式(所有程式都透過
XWayland):用文字編輯器打開
~/.config/pomelo/settings.conf,加一行
session.wayland = 0
存檔後登出再登入。改回來就把這行刪掉。也請把是哪個程式、什麼狀況回報給我們。
如果只是某一個 Pomelo 程式(例如音效設定)有問題,也可以只讓它退回
XWayland,在終端機這樣開:
POMELO_BACKEND=x11 pomelo-sound
容器說「你的帳號還不能管理 Docker」按「加入 docker 群組」,然後登出再登入(剛裝好 Docker 時也一樣要重新登入一次)。
找出問題原因
~/.xsession-errors。~/.xsession-errors 或
journalctl --user -b。journalctl -b 可以看這次開機的系統紀錄。sudo dnf remove 'pomelo-*' libpomelo libpomelo-devel
如果目前用的是 Pomelo 登入畫面,移除時會自動換回原本的登入管理員。
你的個人設定在
~/.config/pomelo,小幫手的模型與語音、虛擬機器(包括虛擬硬碟)在
~/.local/share/pomelo,容器的備份預設在
~/docker-backups。不需要了可以自行刪除。
虛擬機器、容器第一次使用時安裝的 QEMU、Docker 不會跟著 Pomelo
移除,Docker 裡的容器與映像也都還在。不需要的話:
sudo dnf remove qemu-system-x86-core qemu-img edk2-ovmf moby-engine
docker compose;還原備份時,原本接的自訂網路如果這台電腦沒有,會改接到預設的
bridge 網路。pomelo-dm-switch try。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,也可以寫信索取。
下面這些在你第一次使用對應功能時才會下載,不包含在安裝包裡:
jyut6ping3.maps 是 ODbL 1.0。下載到
~/.local/share/pomelo/rime-data/。介面使用的其他元件: