Pomelo 使用手册(Debian 13)

Pomelo 0.41 2026-11-14

这份使用手册由 AI 从繁体中文翻译;命令与快捷键跟原文相同。

Pomelo 0.41 · 2026-11-14

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

  • 顶端菜单栏、Dock、启动器、搜索。
  • 系统设置、文件管理器、终端、文本编辑器。
  • 计算器、看图、绘图、影音播放器、PDF 阅读器、压缩管理器。
  • 输入法(注音、拼音、仓颉、速成、粤拼、日文、韩文、越南文)、屏幕截屏与录像。
  • AI 小助手「小柚」,以及自己的登录画面。

整个桌面不需要 GNOME,闲置时常驻的内存只有几十 MB。

这份手册说明怎么在 Debian 13 上安装、使用与移除 Pomelo。

Pomelo 桌面:上面是菜单栏,下面是 Dock
Pomelo 桌面:上面是菜单栏,下面是 Dock

手册里的画面是在 Ubuntu 上截的,在 Debian 13 上看起来一样。


1. 系统需求

  • 电脑:64 位 x86 电脑(amd64)。
  • 内存:
    • 2 GB 以上。
    • 要用小助手小柚,建议 8 GB 以上;轻量模型运行时约占 1.3 GB。
  • 显示:用 Pomelo 登录界面时,显示核心是 Pomelo 自己的 Wayland compositor(pomelo-compositor): GTK、Firefox 这类支持 Wayland 的程序直接用 Wayland 显示(0.40 起),Pomelo 的各个设置程序、控制中心、通知、启动器、 锁屏界面也是(0.40 起);其他程序(菜单栏、Dock、文件管理器、终端…)通过内置的 XWayland 显示; 在原本的登录界面(GDM 等)选 Pomelo 时,跑在系统的 X11(Xorg)上。
  • 虚拟机(选用):CPU 要有硬件虚拟化(Intel VT-x/AMD-V,在 BIOS 设置里开启),不然会慢很多; 内存要够同时给这台电脑与虚拟机用(例如要跑 4 GB 的虚拟机,建议 8 GB 以上),硬盘空间视虚拟硬盘的大小而定。
  • 容器(选用):Docker 跟 Pomelo 分开安装,「容器」程序第一次打开时有「安装」按钮。
  • 系统版本:Debian 13(trixie)。查看自己的版本:cat /etc/debian_version(显示 13.x)
  • sudo:安装 Debian 时如果有设置 root 密码,你的账号默认不能用 sudo。先用 su - 切到 root, 执行 usermod -aG sudo 你的账号,注销再登录就可以用 sudo 了(或直接在 root 下执行安装命令)。

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」会话:

  • GDM(Debian的默认):点你的用户名,再点右下角的齿轮图标,选「Pomelo」,然后输入密码。
  • LightDM、SDDM:在登录界面的会话菜单选「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 登录界面(不显示用户列表、背景用渐层、加上欢迎消息)

Pomelo 登录界面在 Debian 13 上目前只在虚拟机测试过,请先用 try 试用,确定能正常登录再用 on。

4. 认识桌面

  • 菜单栏(屏幕最上方)
    • 最左边的 Pomelo 图标:关于这台电脑、系统设置、锁定屏幕、睡眠、关机等。
      • 这个菜单可以自己编辑:在图标上按右键 →「编辑菜单…」。
      • 可以加入常用的程序、网站或命令。
    • 目前程序的名称:点一下可以缩小、放大、关闭窗口。
    • 右边的状态栏:输入法(注/英)、外置设备、网络、音量、电量、时钟、控制中心。
      • 控制中心可以快速切换 Wi-Fi、蓝牙、深色模式、勿扰,以及调亮度和音量。
      • 在背景运行的程序(例如 Telegram、Nextcloud、Slack、Discord)的图标也在这里:左键通常是打开程序,右键是它的菜单。
  • Dock(屏幕最下方)
    • 放着固定的程序和正在运行的程序。
    • 在图标上按右键,可以保留在 Dock 或移除。
    • 拖动:固定在 Dock 的程序可以左右拖动换位置(别的图标会让出空位);拖出 Dock 外面(图标角落会出现红色的叉)再放开,就从 Dock 移除。 没有固定的运行中程序和垃圾桶不能拖。也可以从启动器或「系统设置 → 应用程序菜单」把程序拖进 Dock。
    • 最右边是垃圾桶。
  • 启动器(Super+A)
    • 列出所有程序,可以搜索(打字时会在所有分类里找)。
    • 上方有分类页签:全部、工具类、办公类、文书类、娱乐类、生产力类、其他(没有程序的分类不显示)。用鼠标点,或按 Tab/Shift+Tab 切换。 程序依自己的类型自动归类(例如试算表、演示文稿是办公类;文字处理、文本编辑、PDF 阅读是文书类;影音、图片是娱乐类; 浏览器、小助手、容器、虚拟机是生产力类;文件、终端、软件中心、计算器是工具类;各种设置页在其他)。
    • 分得不合意:在图标上按右键,从下面的分类列表选一个(会打勾,下次打开还在);选「自动分类」就恢复。
    • 在图标上按右键 →「编辑…」,可以改名称、图标,或把它从列表隐藏。
    • 拖动:把图标拖到上方的分类页签(页签会亮起来)就改分类;在某个分类页签里拖到别的位置(会出现一条插入线)就调整顺序, 下次打开还在;拖到底下出现的 Dock 列(拖动时才出现)就保留在 Dock。没有拖动、直接放开才是打开程序。按 Esc 可以取消拖动。 「全部」页签和打字搜索时是依名称排,不能调顺序。
    • 右键菜单:打开、保留在 Dock/从 Dock 移除、编辑…、从菜单隐藏、删除…(只有自己加的程序;系统提供的程序灰色,请用「从菜单隐藏」)、移到各分类。 在空白处按右键:「新增程序或命令…」、「编辑应用程序菜单…」(直接开到系统设置的那一页)。
  • 搜索(Super+空白键)
    • 打字就能找程序、文件、命令,也能直接算数学。
    • 输入问题后选「问小助手」,会把问题交给小柚。
  • 桌面(壁纸上)
    • 按右键可以更换背景图片、调整外观、桌面与 Dock、显示器设置,或打开终端、系统设置。
  • 窗口
    • 缩小、放大、关闭按钮在右上角。想放回左边:「系统设置 → 外观 → 窗口按钮的位置」。
    • 双击标题列可以放大或还原。
    • Super+Tab 可以看所有窗口。

Super 就是键盘上的 Windows 键。

左上角的 Pomelo 菜单 控制中心

左:左上角的 Pomelo 菜单。右:控制中心。

启动器(Super+A):在图标上按右键可以编辑
启动器(Super+A):在图标上按右键可以编辑
搜索(Super+空白键):找不到的话可以直接问小柚
搜索(Super+空白键):找不到的话可以直接问小柚

多桌面(虚拟桌面)

Pomelo 默认有 4 个桌面(可以在「系统设置 → 多桌面」改成 2~10 个)。每个桌面有自己的一组窗口,切换时只看得到那个桌面的窗口; 菜单栏、Dock、壁纸、小柚、通知在每个桌面都在。窗口的最大化、全屏幕、位置各桌面各自保留,每个桌面也各自记得上次用的是哪个窗口。

  • 看在哪个桌面:菜单栏中间有一排小圆点(长的那个是目前的桌面)。点圆点切换,在圆点上滚动滚轮切到前一个/后一个,点最左边的小方块开「桌面总览」,右键有桌面列表。
  • 新开的窗口出现在目前的桌面(对话框跟着它的主窗口)。可以在设置改成「跟同一个程序的窗口放在同一个桌面」。
  • 切换动画:新旧桌面的窗口左右滑动约 0.2 秒;觉得晕或电脑比较慢可以在设置关掉。
  • Dock:默认只显示(并标示运行中)目前桌面的窗口;设置打开「Dock 显示所有桌面的窗口」后,点到在别的桌面的程序会自动切过去。 在 Dock 图标上按右键可以把它的窗口「移到桌面 N」或「在所有桌面显示」。
  • Alt+Tab 默认只在目前桌面的窗口之间切换;设置打开「Alt+Tab 也切换到其他桌面的窗口」就会一起切。
按键或手势 功能
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 复制粘贴,点右键有剪切、复制、粘贴、全部清除(密码栏只能粘贴)。内容如下:

系统设置
系统设置
  • 一般:关于这台电脑、软件更新、保存空间、日期与时间、设备管理。
  • 主机医生(原本的健康检查):一次检查整台电脑、看历史趋势、诊断为什么变慢、安全总览(见下面「主机医生与健康检查」)。「健康检查」这一页已经并进主机医生,系统设置里的入口会直接打开它。
  • 外观:深色模式、强调色、文本大小、窗口按钮位置、窗口阴影与动画。
    • 「窗口阴影与动画」是内置的:0.35 起由 Pomelo 的画面核心(pomelo-compositor)直接画,窗口有柔和的阴影与圆角, 开关窗口、菜单时会淡入淡出,一直开着,不用安装 picom。 只有改用旧的 X11 路径(pomelo-wm,例如搭配别的登录管理员或 startx)时,这里才会是开关:第一次打开时会安装 picom(要输入密码);想自己调整,把 /usr/share/pomelo/picom.conf 复制到 ~/.config/pomelo/picom.conf 再改。
  • 背景图片、桌面与 Dock、菜单栏(包括编辑左上角的 Pomelo 菜单)。
  • 显示器:分辨率、旋转、多屏幕排列。改完 15 秒内没有按「保留」,会自动还原。
    • 外置屏幕:登录中插上就会亮起来:设置过的照记住的排列,没设置过的放在主要显示器旁边(右边被占了就放左边、上面、下面)。 拔掉时,原本在那个屏幕上的窗口会移回主要显示器。
    • 每个屏幕上面都有菜单栏;Dock 平常在主要显示器,把鼠标移到别的屏幕最下面,Dock 就会搬过去。
  • 搜索、应用程序菜单(编辑启动器与搜索看到的程序,用法见下面)、小助手、通知。
    • 应用程序菜单:左边是分类(全部、工具类、办公类、文书类、娱乐类、生产力类、其他、已隐藏,各有程序数量),右边是那个分类的程序, 右上角可切换列表或图标两种显示,左上角可以搜索,最下面的 Dock 区块就是目前固定在 Dock 的程序。全部都可以用拖动:
      • 把程序拖到左边的分类 → 改分类(拖到「已隐藏」就是从菜单隐藏;从「已隐藏」拖到分类就是取消隐藏并放进那个分类)。
      • 在同一个分类里拖到别的位置(出现蓝色插入线)→ 调整顺序,启动器的分类页签也照这个顺序;没排过的依名称排在后面。
      • 拖到最下面的 Dock 区块 → 保留在 Dock;在 Dock 区块里左右拖 → 换位置;从 Dock 区块拖出去 → 从 Dock 移除。Dock 马上跟着改。
      • 拖动时有跟着光标的半透明图标、会亮起来的目标、一条插入线和说明放开会发生什么的小标签;按 Esc 取消。
      • 按右键(在程序上):打开、编辑…(Enter)、重命名…(F2)、复制成自订程序、保留在 Dock/从 Dock 移除、从菜单隐藏/取消隐藏、 移到各分类(目前的有打勾)、还原成系统默认(改过系统程序才有)、删除…(Delete;只有自己加的程序能删,会先确认,并一起清掉它在 Dock、分类、顺序的设置; 系统提供的程序灰色,请改用「从菜单隐藏」)。 在空白处:新增程序或命令…(Ctrl+N)、显示隐藏的程序、全部还原…(所有程序的名称、图标、隐藏、分类、顺序都回到系统默认,自己加的程序与 Dock 不动)。 在左边的分类上:依名称排序(清除自订顺序);在「已隐藏」上:全部取消隐藏。在 Dock 区块:往左移、往右移、从 Dock 移除、还原成默认的 Dock、清空 Dock。
      • 键盘:方向键移动选取、Home/End、Enter 编辑、F2 重命名、Delete 隐藏(自己加的程序是删除,会先确认)、Ctrl+N 新增、Esc 取消拖动或取消选取。
      • 新增:右上角「新增…」或 Ctrl+N,填名称、命令(必填)、说明、图标、分类、「启动器的分页」、是否在终端运行,保存后就在启动器与搜索里。 自己加的程序存在 ~/.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),下面依序是 VPN 与附近的 Wi-Fi;各项目按右键都有菜单(网络卡:详细信息;Wi-Fi:连接、忘记这个网络;VPN:连接/中断、自动连接、编辑、删除)。

  • 企业 Wi-Fi(WPA-Enterprise):列表里有「企业」标示、下面写 802.1X 的网络,用公司或学校的账号登录。第一次点它会打开设置页: EAP 方法(PEAP 或 TTLS)、阶段 2 验证(MSCHAPv2 或 PAP)、身分、密码、匿名身分(选填),以及服务器凭证(CA)—— 选网络管理员给的凭证文件最安全;选「不验证」的话别人可以假冒这个网络骗走密码,画面会用红字警告,按连接时还会再问一次。 连不上时(例如密码打错)不会留下错的设置,改完可以直接再试。
  • VPN:支持 WireGuard 与 OpenVPN(不支持 L2TP、PPTP、IPsec;已经在 NetworkManager 里的这类 VPN 仍会列出来,可以连接、中断、删除)。
    • 导入:按「导入 WireGuard 设置文件」选 .conf,或「导入 OpenVPN 设置文件」选 .ovpn(X11 会话也可以把文件直接拖进窗口)。 导入后自动打开这个 VPN 的设置页。
    • 设置页:上面的大按钮连接/中断;「自动连接」;「连上后所有流量走 VPN」(关掉的话只有 VPN 内部的网络走 VPN, WireGuard 要设置文件的 AllowedIPs 有 0.0.0.0/0 才会导入所有流量);名称与 DNS;OpenVPN 要账号密码的话在「账号与密码」填。 「记住密码」打开才会存起来;不记住的话每次连接都要重新输入。
    • 密码的处理:VPN 与企业 Wi-Fi 的密码不会出现在命令参数里(用 ps 看不到):存起来的走 nmcli 编辑器的标准输入, 只连接不存的走权限 0600 的暂存文件(放在 $XDG_RUNTIME_DIR,用完就删)。OpenVPN 密码里有逗号或反斜线的话没办法记住(nmcli 的格式限制),请关掉「记住密码」。
    • 缺软件包:OpenVPN 需要 network-manager-openvpn(Fedora、Rocky 叫 NetworkManager-openvpn;只装基本的,不要装 -gnome 那个)。 没装的话导入 OpenVPN 的地方会变成「安装」按钮(用管理员权限安装)。WireGuard 只需要内核有 WireGuard 模块(Linux 5.6 以上都有),不用另外装软件包。

主机医生与健康检查

健康检查已经并进「主机医生」(应用程序菜单 → 主机医生;系统设置的「主机医生(健康检查)」、网络设置的「检查网络」、 活动监视器的「找出原因」、电源页的「检查电池」都会打开它)。到「体检」分页按「立即体检」,大约 20 秒到两分钟检查完八类, 上面一张状态卡写出结论与进度,下面每一类一张卡片,红色是需要处理、橘色是建议注意;点进去看每一项找到了什么、为什么重要、建议怎么做。 每次完整体检都会记进历史,「趋势」分页看走势与预测,「诊断」分页找出为什么变慢,「安全」分页看连接、登录与防火墙。 命令行:pomelo-doctor --check [类别…] [--json] [--admin](旧的 pomelo-system --check 会转给它)。

健康检查:结论与八类的状态
健康检查:结论与八类的状态
  • 网络:从这台电脑一路查到互联网(网络服务 → Wi-Fi 开关 → 网卡 → IP → 路由器 → DNS → 互联网), 说出断在哪里;也看 Wi-Fi 有没有加密、信号强弱、信道拥不拥挤、VPN 与 Proxy。网络设置里的「检查网络」是同一个检查。
  • 安全性:安全更新、防火墙、哪些服务可以从网络连进来(数据库、Docker 管理接口这类危险的会标红)、 SSH 的登录设置、docker 群组、自动登录、自动锁屏、磁盘加密、安全启动、AppArmor/SELinux、 登录时自动运行的程序、可疑的程序(从临时文件夹运行的、伪装成系统内核的、已知的挖矿程序)、没有密码保护的 SSH 私钥。 点「也检查(需要管理员密码)」还会检查:没有密码的账号、用旧方式加密的密码、用 sudo 不用输入密码的设置、 不属于任何软件包的 setuid 程序、过去 24 小时 SSH 登录失败几次。这部分只会读取,结果只有结论(账号名称),密码不会被读出来。
  • 系统与软件更新:系统版本还有没有支持(停止支持就没有安全更新)、有几个更新、软件包列表多久没更新、 有没有开自动安全更新、有没有装到一半的软件包、要不要重启才能完成更新、固件更新。
  • 启动与系统稳定:启动失败或一直重启的服务、最近崩溃的程序、硬盘读写错误、开机花多久与最慢的步骤、 系统日志是不是太大、磁盘快满了、时间有没有自动校准。
  • 系统服务:SSH、Apache、Nginx、MySQL/MariaDB、PostgreSQL、Docker、Redis、MongoDB、Samba 有装的话, 看有没有在运行、该监听的端口有没有在监听、有没有一直崩溃;网站的证书什么时候过期;Docker 容器有没有一直重启。 「网站打不开」时先看这里。
  • 电脑变慢:测 1.5 秒,看是 CPU、内存还是硬盘忙不过来、是哪个程序;CPU 有没有过热降频、 后台是不是正在更新或建索引、最近有没有因为内存不够被系统强制结束的程序。活动监视器的「找出原因」也是这个。
  • 硬件与驱动:这台电脑的 CPU、内存、主板与 BIOS;显卡有没有用上驱动(没有的话画面是用 CPU 画的,比较慢)、 没有驱动的设备、缺少的固件、找不到声音输出、USB 常常连接失败、硬盘健康。
  • 电池(笔记本):健康度(剩原本容量的几成)、充放电次数、充电上限。「电源与锁定」页也有「检查电池」。
  • 磁盘:健康状态与清理在「存储空间」,这里点了会打开它。

检查只会读取。有修复方法的项目右边有按钮(例如「开启防火墙」「改用公共 DNS」「只保留最近的 500 MB」日志), 点了会先在画面上方问你「要…吗?」并说明会做什么,点确定才执行;需要管理员权限的会弹出密码窗口。

病毒扫描:在主机医生左边的「病毒扫描」分页(原本系统设置的病毒扫描页已经搬进去);也可以在文件管理器的文件夹上按右键 →「扫描病毒…」,或跟小柚说「帮我扫毒」。 用的是开源的 ClamAV,第一次用时会问要不要安装(程序约 30 MB,病毒码约 230 MB,装好后在背景自动更新)。 选择扫描「下载」、整个家目录或外置设备,扫描时优先权会调低,不影响正在用的程序;会用掉约 1~1.5 GB 内存。 找到的文件可以「隔离」(搬到隔离区、拿掉权限,之后可以还原)或在隔离区永久删除(会先确认)。 ClamAV 最擅长找 Windows 的病毒,适合在U盘或下载的文件拿给 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)可以:

  • 开关、选「闲置多久后启动」(1、2、5、10、15、30 分钟,或从不)。
  • 从缩略图格选一种:时钟(慢慢移动、避免烧屏)、照片幻灯片(「图片」文件夹或你选的文件夹,支持 JPEG、PNG、WebP、GIF,坏图自动跳过)、 小柚、流动色彩、星空、气泡、文本消息、纯黑,或每次随机。按「预览」全屏幕看看,按任意键离开。
  • 离开时是否要输入密码:默认「依锁定时间」;选「一律要密码」时,动一下鼠标会先出现锁定画面,桌面不会露出来。
  • 使用电池时可以不启动或改成纯黑;播放视频、全屏幕程序时不会启动;鼠标有一点点抖动(桌子震动)不会唤醒。

闲置后的顺序是:屏幕保护程序 → 锁定屏幕 → 关闭屏幕 → 休眠,前三项的时间在「电源与锁定」与「屏幕保护程序」两页都看得到, 设置互相矛盾(例如关闭屏幕比屏幕保护程序早)时会有提示。命令:pomelo-screensaver --preview --kind 时钟名称、--list、--lock-now。 也可以对小柚说「启动屏幕保护程序」「屏幕保护程序改成照片」「10 分钟后启动屏幕保护」。

7. 输入法

Pomelo 自带输入法,安装后就能用,不必另外安装 fcitx 或 ibus。

  • 切换输入法/英文:轻点一下 Shift,或按 Ctrl+空白键。菜单栏右边会显示目前的输入法(例如「注」),英文时显示「英」。
  • 选字:打完注音按空白键或 ↓ 开候选字。按数字 1~9 选字;也可以用 ←→ 移动高亮、按 Enter 选定, 或用鼠标点、滚轮翻页。没有候选字时按 Enter 送出。
  • 全角/半角:Shift+空白键。
  • 设置:「系统设置 → 语言与输入法」,可以选注音键盘排列(标准、许氏、倚天、拼音…)、每页几个候选字。
打完注音按 ↓ 开候选字,按 6 就换成「柚」
打完注音按 ↓ 开候选字,按 6 就换成「柚」

其他语言的输入法:在「语言与输入法」的「Pomelo 输入法」里点一下就能启用,可以同时启用好几个, 按 Ctrl+Shift+空白键 轮流切换,或点菜单栏右边的指示器选。

  • 拼音(简体)、仓颉、速成、粤拼:第一次启用时会先安装 Rime 引擎(开终端,要输入密码),再从网络下载字典 (拼音约 10 MB、粤拼约 22 MB),下载好就自动启用;第一次打字前要先花十几秒整理字典。
  • 日文:打罗马字(例如 nihongo),按空白键转换成汉字、Enter 送出;←→ 换一段、Shift+←→ 调整段落长度,F7 转片假名。
  • 韩文:两排式(默认)、三排式或罗马字。
  • 越南文:Telex(默认)或 VNI,例如 Telex 打「Vieetj Nam」就是「Việt Nam」。不必另外安装。
  • 还没自己选过时,会照界面语言先启用一个:繁体中文是注音、简体中文是拼音、香港是仓颉与速成,日文、韩文、越南文是各自的输入法。

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。

界面语言:

  • 在「语言与输入法」切换,重新登录后生效。共有 14 种语言:繁体中文、英文、简体中文、日文、韩文、法文、德文、西班牙文、意大利文、巴西葡萄牙文、俄文、越南文、泰文、印尼文。
  • 泰文界面需要泰文字体(默认的 Noto Sans CJK 没有泰文字形,没有泰文字体时整个界面会是方块):安装 pomelo-desktop 时会一起建议安装(Debian/Ubuntu 是 fonts-tlwg-loma-ttf,Fedora/Rocky 是 google-noto-sans-thai-fonts;fonts-noto-core 的 Noto Sans Thai 也可以),只装单一软件包的人请自己加装。
  • 系统还没有的语言,会开终端用 sudo locale-gen 产生。

8. 小助手「小柚」

小柚是一只会在桌面上走来走去的小机器人,背后是在你电脑上运行的 AI。你说的话不会传到网络上;只有查天气和用浏览器搜索时才会连网(想让牠能做更多事,可以自己选择打开「在线大脑」,见本节最后)。

  • 第一次使用:到「系统设置 → 小助手」按「下载」,下载 AI 模型。

    • 轻量版约 1.1 GB;内存 12 GB 以上的电脑默认用标准版,约 2.5 GB。
    • 只需要下载一次。
  • 叫它:点它、按 Super+Shift+Space,或在搜索里输入问题后选「问小助手」。

  • 用说的:按泡泡输入框右边的麦克风,或按 Super+Shift+V,直接说「打开终端」「音量调到 30」。

    • 说完停一下(约一秒)就会自动送出;要提早结束就再按一次麦克风,不要了就按 Esc。
    • 第一次用要在小助手设置的「用说的(麦克风)」按「下载」(约 264 MB),之后完全离线:声音只在你的电脑上识别,识别完就删掉。
    • 设置里可以按「说说看」测试麦克风;也可以改成「听完先放进输入框」,确认或修改后再按 Enter 送出。
    • 支持普通话、粤语、英文、日文、韩文。听成同音的别字(例如把「终端机」听成「中断剂」)时,程序名称、常用命令、 「文档」「桌面」「下载」里的文件名会自动改回来。
    小柚在听:输入框跟着声音跳动,说完停一下就会自动送出
    小柚在听:输入框跟着声音跳动,说完停一下就会自动送出
  • 电脑检查:小柚第一次打开时有「帮我做资安检查」「帮我检查电脑」「网络怎么了?」「电脑为什么变慢?」可以直接点; 也可以说「上不了网」「有没有更新」「开机很慢」「网站打不开」「电池健康」。小柚会跑「健康检查」对应的那一类, 把需要处理、建议注意的项目与建议整理给你;说「打开健康检查」会打开主机医生,到「体检」分页按修正按钮。 检查本身是写好的程序,不是让 AI 自己下命令,结果不会是猜的。

  • 快速命令:常用的说法不用等模型,立刻完成。例如:

    • 开程序、网站、文件:「打开终端」「开浏览器并连到 Yahoo」「打开文档里的报价单」「打开 待办 文件」
    • 关闭、切换程序:「关闭终端」「把浏览器关掉」「切换到 Firefox」「把计算器缩到最小」(同一个程序开了好几个窗口会一起关)
    • 在文本文件最后面加字:「在 待办.txt 最后面加上 买牛奶」「把『缴电话费』加到待办的最后面」; 只说「在 a 文件底下增加文本」的话,小柚会问你要加什么。说「这个文件」就是文本编辑器里正在看的文件。
    • 调整设置:「音量调到 30」「开深色模式」
    • 提醒与查找:「10 分钟后提醒我休息」「今天星期几」「台北天气」
    • 打招呼与简单的问题:「你好」「你是谁」「你是哪个模型」「你会做什么」「谢谢」
    • 找到好几个文件时会列出来,点一下或说「第 2 个」就开。
  • 复杂的问题:其他问题由模型回答,一般电脑大约 1~5 秒。

  • 文件动作会先问你:创建、在文件最后加字、复制、移动、丢到垃圾桶之前,都会先跳出确认窗口。

    • 不会覆盖已有的文件,也不会直接删除。
    • 加字只能加在纯文本文件(.txt、.md 这类)最后面;Word、PDF 还不能改。文件在文本编辑器里还有没保存的修改时,小柚会请你先保存。
  • 样式与声音:在小助手设置里可以选择:

    • 六种配色,每种都有深色版。
    • 眼睛颜色、音效。
    • 把回答念出来。第一次要下载约 90 MB 的脱机语音。中文是大陆口音的女声;日文、泰文目前没有脱机语音。
  • 在线大脑(选用,默认关闭):到「系统设置 → 小助手」的「大脑」区,把「本机(默认)」改成「在线」,小柚就能用在线的 AI 回答复杂的问题, 还能多做查数据、读网页、读你指定的文本文件、换壁纸,以及(另外勾选才有)运行命令。

    • 要有自己的 API 密钥:OpenAI 兼容服务(OpenAI、OpenRouter、Groq、DeepSeek,或自己架的 Ollama 等)、Claude(Anthropic)、Google Gemini 都可以。 到服务商的网站注册、创建 API 密钥、设置付款,再把密钥贴进设置的「API 密钥」,按「测试连接」确认。
    • 切到「在线」之前会先出现说明,同意之后才启用,随时可以切回本机。你输入的问题、小柚为了回答而读到的信息(文件名称、系统状态、网页内容…)会传到你选的服务商; 「打开终端」「音量调到 30」这类常用命令仍然只在你的电脑上处理。小柚不会自动附上整个文件、剪贴板或屏幕截屏;读文件之前每次都会先问你。
    • 密钥只存在你的电脑(~/.config/pomelo 底下,只有你的账号读得到)。在线服务通常按用量计费,费用由你的账号负担。
    • 安装软件包、关机、写文件、换壁纸、运行命令这类动作,就算是在线的 AI 要求的,也一定会先跳确认窗口,由你按。
    • 连不上网络时,会自动改用本机的模型(可以在设置关掉)。详见 docs/AI小幫手.md 的「在线大脑」。
小柚:「今天星期几」立刻回答;找到两个报价单时列出来让你选
小柚:「今天星期几」立刻回答;找到两个报价单时列出来让你选

9. 截屏与录像

  • Super+Shift+3:整个屏幕。
  • Super+Shift+4:选取范围。
  • Super+Shift+5:工具栏(截屏与录像)。
  • Super+Ctrl+Esc:停止录像。

截屏存到「图片」文件夹,录像存到「视频」文件夹。截屏后右下角会出现缩略图,点一下就打开; 在缩略图上按右键选「用绘图编辑」,可以加上箭头、文本或裁切(见第 10 节的「绘图」)。

截屏与录像工具栏(Super+Shift+5)
截屏与录像工具栏(Super+Shift+5)

屏幕录像

工具栏中间三个有红点的是录像:「录制整个屏幕」「录制窗口」「录制选取范围」。

  • 录窗口:点一下要录的窗口。录的是点击当下那个窗口所在的位置与大小;录像中把窗口拖到别的地方或改大小,画面不会跟着走 (要跟着走请录整个屏幕,或之后剪辑)。
  • 录像中,菜单栏右上角有红色的计时,点一下就停止。在计时上按右键有完整的菜单:停止录像、暂停(继续)录像、 在「文件」中显示录像的文件夹、放弃并删除这段录像。暂停时计时变成橘色并停住,暂停的那段时间不会录进去; 停止时前后的片段会自动合并成一个文件。
  • 录完右下角出现缩略图(中间有播放键),点一下播放;按右键有「打开」「在『文件』中显示」「删除」。
  • 按工具栏上的「选项」开设置窗口:保存位置、倒数、麦克风、电脑的声音、鼠标光标、每秒格数(15/30/60)、 文件格式(自动、MP4、WebM、MKV)、品质(小文件、标准、高清),电脑有视频镜头(/dev/video*)时还有「录像时显示视频镜头」, 可选四个角落(左上、右上、左下、右下)与大小(小、中、大),镜头画面会叠在录像的角落。设置会记住。
  • 格式:MP4 是 H.264+AAC,WebM 是 VP9+Opus(自由格式),MKV 什么都能装。「自动」会选 MP4; 如果电脑上的 ffmpeg 没有 H.264 编码器,会改存成 WebM 并在录完时用通知告诉你。选的格式用不了时也一样自动换成可用的,不会直接失败。
  • 出问题时会用通知用中文说明:找不到麦克风或镜头(这次就不录那一路,其他照常录)、磁盘空间不足(录像前先检查; 录到一半快满了会先好好存文件再停止,已录的部分保留)、ffmpeg 意外结束(保留已经录到的)。出错时不会留下 0 字节或播不了的文件。

录像需要 ffmpeg,由你自己另外安装(Pomelo 不会预先安装它)。第一次录像时会询问,按「安装」就会开终端安装 (ffmpeg;Ubuntu 与 Debian 的版本含 libx264,可存 MP4)。

10. 文本编辑器、计算器、日历、看图、绘图、影音播放器与 PDF 阅读器

这些程序在启动器里。文件管理器双击文本文件、照片、音乐、视频、PDF 时,也会自动用它们打开。

文本编辑器

文本编辑器:上面是菜单栏与标签页,左边是文件列表
文本编辑器:上面是菜单栏与标签页,左边是文件列表
  • 上面的菜单栏有「文件」「编辑」「查看」(也可以按 Alt+F/E/V 或 F10 打开,用 ←/→ 换菜单)。
  • 每个文件一个标签页:Ctrl+N 新标签页,Ctrl+W 关闭,Ctrl+Tab 切换,Alt+1~9 直接跳到第几个。从文件管理器再打开别的文本文件,会加到同一个窗口; 要另开窗口用「文件 → 新窗口」。
  • 左边的文件列表是文件夹的树状结构,点一下就打开;右键可以在文件夹里添加文件。Ctrl+B 显示或隐藏,拖动边界可以调宽度。
  • 寻找与取代:Ctrl+F 寻找(所有符合的地方都会标出来,显示「第几个/共几个」,Aa 是区分大小写),F3/Shift+F3 下一个/上一个, Ctrl+H 取代(「取代」换掉目前这个,「全部取代」一次全换,换错了按 Ctrl+Z 复原)。
  • 其他:Ctrl+A 全选、Ctrl+L 跳到第几行、Ctrl+O 打开文件(路径可以按 Tab 补完)、Ctrl+加号/减号 字体大小; 「查看」里可以关掉自动换行、行号,或改用等宽字体。
  • Big5 的旧文本文件会自动转成正确的中文,存盘时照样存回 Big5;Windows 换行(CRLF)的文件也照样存成 CRLF。
  • 文件被别的程序改了(例如请小柚在最后面加字),没修改过的标签页会自动重新加载,按 Ctrl+Z 可以回到之前的内容; 如果你这里也有没保存的修改,下面会提醒你「保存会盖掉别处的修改」。

计算器

计算器:工程模式,边打边算
计算器:工程模式,边打边算
  • 可以直接用键盘打整个算式,例如 12*(3+4),上面那行会先算出结果,按 Enter 或 = 确定。
  • 「基本/工程」切换:工程模式有括号、次方、根号、三角函数、对数、阶乘、π;右上角显示目前用角度或弧度(按 DEG/RAD 切换)。
  • 200+10% 会算成 220(加上 200 的 10%)。
  • 右上角的时钟图标是计算纪录,点一笔就把结果拿来用。Ctrl+C 复制结果,Ctrl+V 可以粘贴算式。

日历

日历:月查看,有农历、节气与多日行程;左边是迷你月历与日历列表
日历:月查看,有农历、节气与多日行程;左边是迷你月历与日历列表
  • 上面可以切换「月、周、日、议程」(Ctrl+1~4),「今天」与左右箭头换日期,点左边迷你月历的日期可以跳过去;T 回到今天,N 新增行程,Ctrl+F 搜索。
  • 新增行程:右上角「+ 新增」、按 N、在月查看的日期格上按两下、或在周/日查看直接拖出一段时间(放开就跳出编辑窗口)。 行程可以设地点、备注、全天、时区、重复(每天、每周选星期、每月、每年,可设结束日期或次数)、提醒(事件前几分钟到几天,可以设好几个)。
  • 已经有的行程:按两下编辑、拖动到别的时间或日期、拖下缘调整长度、按右键(编辑、复制、创建副本、删除、更换日历颜色)。 重复的行程会先问「只改这一次」还是「改所有行程」。
  • 左边可以创建多个日历(个人、工作…),各自一个颜色,点圆点显示或隐藏;数据是标准的 .ics 文件放在 ~/.local/share/pomelo/calendar/, 从文件管理器双击别处来的 .ics(Google、Nextcloud 导出的、邮件附件)会跳出导入窗口。
  • 月查看会标出台湾的国定假日、补假、补班日,以及农历与二十四节气(设置里可以关掉);点击单列右上角的日期时间会弹出迷你月历与当天的行程。
  • 提醒在登录桌面时就由背景程序负责,日历窗口没开也会跳出通知,点通知会打开那个行程;电脑休眠或关机错过的提醒,开机后会补上一次。
  • 小助手:「明天下午三点开会」「我今天有什么行程」「下周有什么事」。命令行:pomelo-calendar --add "标题" --start "2026-11-20 14:00" --remind 10m、pomelo-calendar --list --json。
  • 可以选用 CalDAV 与 Nextcloud、Radicale、Synology、Fastmail 等服务器同步(设置 → CalDAV)。完整说明(文件格式、命令行、假日数据源、同步与冲突怎么处理)见 docs/行事曆.md。

主机医生(应用程序菜单 → 主机医生;系统设置的「主机医生(健康检查)」;原本的健康检查已并进它的「体检」分页)

  • 体检:八类电脑健康检查(网络、安全性、更新、稳定、服务、性能、硬件、电池)的逐项结果与修正按钮、导出结果。
  • 病毒扫描、软件包与漏洞:左边各有一个分页(原本系统设置的病毒扫描页与软件包列表页已搬进来,功能不变)。
  • 总览:健康分数、风险分数、磁盘预计几天后写满、最重要的三件事(附一键修正,修正前一定先问你);「立即体检」跑完整八类检查。
  • 趋势:磁盘、内存、开机耗时、体检分数的折线图,可选 7/30/90/180 天;红点是明显异常的日子,点图上的点看那天前后新增或更新的软件包、内核换版与失败的服务;右键换指针、存成图片、导出报告。数据少于 7 天或波动太大时会直接说「数据还不够」,不乱预测。
  • 诊断:电脑变慢时按「开始诊断」(约 1 秒),列出最可能的原因、证据与建议,并跟这台电脑平常的状况比较;勾「一并分析开机」会看开机时哪个服务最慢。
  • 安全:待办列表、网络连接(谁在听、谁连进来)、登录记录(失败、暴力破解、sudo)、防火墙(可启用、关闭、允许或封锁某个端口)、设置与权限,合成一个风险分数。需要管理员权限的项目要按「以管理员权限扫描」才会做(只读)。
  • 设置:采样频率、历史保留天数、通知、是否记录进程名称(默认不记)、导出 HTML/PDF 报告(可去识别化)。数据只存在这台电脑。
  • 小助手:「电脑好慢」「为什么这么卡」「开机变慢了」「磁盘还够用多久」「这个月体检状况如何」。命令行: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 文件夹。小助手也听得懂「有没有被入侵」「最近有谁登录」。

看图

看图:右上角是缩放、旋转、幻灯片、垃圾桶、信息
看图:右上角是缩放、旋转、幻灯片、垃圾桶、信息
  • 支持 PNG、JPEG、GIF 与 WebP(包括动画)、BMP、TIFF、SVG。手机拍的竖向照片会自动转正。
  • ←/→ 看同一个文件夹的上一张、下一张;滚轮缩放,按住拖动移动,双击切换「适合窗口」与「实际大小」。
  • F 全屏、S 幻灯片、R 旋转、I 照片信息(拍摄时间、相机型号、光圈快门)。
  • Delete 丢到垃圾桶,按 Ctrl+Z 可以马上还原。右键菜单还有「复制图片」「用画图编辑」「设为壁纸」。
  • iPhone 的 HEIC 照片、AVIF:第一次打开时画面上有「安装」按钮,会装上 libheif(大约 5 个软件包),装好回到窗口就会显示。
  • TIFF:系统没有 libtiff 时,画面上有「安装」按钮(大部分的系统本来就有)。多页的 TIFF 只显示第一页。
  • SVG:用内置的 nanosvg 绘制,一般的图标、插图没问题;SVG 里的文字与滤镜效果不会显示。

画图

画图:上面是工具、粗细、前景色与背景色、色盘
画图:上面是工具、粗细、前景色与背景色、色盘
  • 工具(上面一排,括号里是快捷键):选取(S)、铅笔(P)、笔刷(B)、喷枪(A)、橡皮擦(E)、油漆桶(F)、取色(I)、文字(T)、 直线(L)、箭头(W)、矩形(R)、圆角矩形、椭圆(O)。
  • 左键用前景色画、右键用背景色画;在色板上左键选前景色、右键选背景色,点前景色或背景色的方块(或最右边的色轮)可以自己调颜色, 调过的颜色会留在色板右边。X 对调前景色与背景色,[ 与 ] 调粗细。
  • 画的时候按住 Shift:直线、箭头锁定在 45° 的倍数,矩形、椭圆变成正方形、圆形。形状可以选「轮廓」「填充」或「轮廓加填充」。
  • 文字:点一下就能打字(可以用输入法打中文),Enter 换行,点别的地方就放上去;字的大小与粗体在上面选。
  • 选取:框出范围后拖动可以搬动,拉右下角的方块可以放大缩小(按住 Shift 保持比例),方向键一次移一点。 Ctrl+C/X/V 复制、剪切、粘贴(可以粘贴其他程序复制的图,例如截图),Delete 删除,「图像 → 裁剪到选区」只留下选取的部分。
  • 「图像」菜单:调整大小、画布大小、旋转、翻转、反转颜色;有选区时只改选取的部分。拖动图片右下角的方块也可以改画布大小。
  • 查看:Ctrl+滚轮 放大缩小、Ctrl+0 适合窗口、Ctrl+1 实际大小;放得很大时会显示像素网格线。中键或按住空格键拖动可以移动画面。
  • 可以打开 PNG、JPEG、GIF(第一帧)、WebP、BMP、TIFF、SVG;保存时看扩展名存成 PNG、JPEG 或 BMP(默认存在「图片」文件夹)。 Ctrl+Z/Ctrl+Y 撤销、重做。看图的右键菜单、截图缩略图的右键菜单都有「用画图编辑」。

影音播放器

影音播放器:左边是封面,右边是播放列表
影音播放器:左边是封面,右边是播放列表
  • 在文件管理器双击音乐或视频就开始播放。在文件夹上按右键选「用影音播放器播放」,整个文件夹(含子文件夹)会变成一个播放列表。

  • 同时只会开一个播放器:再打开别的文件,会交给已经开着的那一个。

  • 空白键播放/暂停,←/→ 倒退/快转 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 apt install ffmpeg。Debian 的 ffmpeg 在 main,Ubuntu 的在 universe(桌面版默认已启用)。 Debian、Ubuntu 的 ffmpeg 解码器齐全,H.264、HEVC、AAC、VP9、AV1、Opus、Vorbis、MP3 都能播。

  • 视频播不出来时不会当掉:坏掉或不是视频的文件会跳出「打不开」的说明并自动换下一首; 电脑上的 ffmpeg 缺少某种解码器时,画面上会写出是哪一种(例如 H.265),并告诉你要装什么。

  • 在视频、封面或空白处按右键:播放/暂停、上一首、下一首、全屏幕、显示或隐藏播放列表、随机、重复、静音、切换字幕、在文件管理器中显示。 在列表的歌曲上按右键可以播放、从列表移除、在文件管理器中显示,或清除整个播放列表。

  • 字幕:视频旁边有同名的 .srt 字幕文件(例如 电影.srt、电影.zh-TW.srt),或 MKV、MP4 里内嵌的文本字幕,都会自动显示(优先选中文), Big5 的旧字幕也可以。按 V 依序切换各个字幕与「关闭」,在视频上按右键可以直接选。DVD、蓝光那种图片字幕还不支持。

  • 播视频时屏幕不会变暗或自动锁定。

PDF 阅读器

PDF 阅读器:左边是页面缩略图,上面有页码、缩放与搜索
PDF 阅读器:左边是页面缩略图,上面有页码、缩放与搜索
  • 在文件管理器双击 PDF 就会打开;再打开别的 PDF 会变成同一个窗口的新标签页。下次打开同一个文件,会回到上次看的那一页。
  • 左边的侧边栏可以切换「页面缩略图」和「书签」(F4 显示或隐藏),点一下就跳过去;拖动边界可以调宽度。
  • 上面工具栏:上一页/下一页、页码(点一下输入页码,按 Enter 跳过去)、缩小/比例/放大(点比例可以选「符合宽度」「符合页面」)、 旋转、手形工具、搜索。
  • 用鼠标拖动可以选取文本,按两下选一个词、按三下选一整行,Ctrl+C 复制。按住鼠标中键(或开手形工具)可以拖动页面。
  • Ctrl+F 搜索:符合的地方会标成黄色,目前这一个是橘色,右边显示「第几个/共几个」;Enter 或 F3 下一个、Shift+Enter 上一个。 英文不分大小写,全角英数字也找得到。
  • 文档里的链接:页内链接直接跳过去;网址会先问你要不要在浏览器打开。
  • 有密码的 PDF 会先请你输入密码。作者设置「不允许打印」或「不允许复制」的文档会照着限制。
  • 缩放:Ctrl+滚轮、Ctrl+加号/减号;Ctrl+0 符合页面、Ctrl+1 实际大小、Ctrl+2 符合宽度。Ctrl+Shift+加号/减号 旋转。
  • 其他:Ctrl+P 打印(需要 CUPS 与打印机)、Ctrl+D 文档内容(作者、创建程序、页面大小…)、F11 全屏(PageDown/空白键一次一页)。
  • 扫描档常用的 JPEG 2000、JBIG2 图片需要 libopenjp2、jbig2dec 函数库(安装时会一起建议安装);没有的话那张图会显示成灰色方块。
PDF 阅读器的填写与签名:荧光笔、便利贴与手写签名
PDF 阅读器的填写与签名:荧光笔、便利贴与手写签名

修改 PDF:工具栏上手形工具旁边的四个按钮(注解、填写与签名、整理页面、编辑内容;菜单栏的「工具」也有)会在下面多一排工具。改过的文档标签页名称前面有「•」,记得 Ctrl+S 保存 (Ctrl+Shift+S 另存新档);Ctrl+Z 复原、Ctrl+Shift+Z 重做。还没存就关掉时会问你要不要保存。

  • 注解:

    • 荧光笔、下划线、删除线:选好工具后在文字上拖动。也可以先选取文字,再按右键选「荧光笔标示」。
    • 便利贴:点一下页面,写下内容(Enter 换行,Ctrl+Enter 完成)。点便利贴的图标会在旁边显示内容,双击可以修改。
    • 文字:点一下页面,打字直接写在页面上(可以选大、中、小)。
    • 画笔、方框、椭圆、直线、箭头:在页面上拖动。右边可以选颜色与粗细。
    • 用「选取」工具点注解:可以拖动移动、拖右下角改大小、按 Delete 删除,右键也有菜单。
  • 填写表单:有可以填的字段的 PDF(申请表、问卷…),打开时字段会有淡蓝色的框,直接点就能填:

    • 文本字段:点一下开始打字(中文也可以),Tab 跳到下一个字段(Shift+Tab 上一个),Enter 或点别的地方就写进去, Esc 取消。多行的字段 Enter 是换行,字太多会自动换行、缩小。有字数限制、一格一个字的字段也照它的规定。
    • 复选框、单选按钮点一下就切换;下拉菜单、列表点一下会列出选项。
    • 每填一个字段就是一个步骤,可以 Ctrl+Z 撤销;记得 Ctrl+S 保存。在别的程序(例如 Adobe 的阅读器)打开也看得到填的内容。
    • 有数字签名的文档,签署之后填表单不会让签名失效(签名内容会写「只添加了注解、表单」)。
  • 填写与签名:

    • 按「新增签名…」,用鼠标在框里签名后按「保存」;也可以按「从图片…」用签名的照片(白色背景会自动去掉)。
    • 存好的签名会出现在工具栏上,点一下再点页面就放上去;放好后可以拖动、拖右下角放大缩小(比例不变)。 签名在工具栏上按右键可以删除。签名存在自己的主目录(~/.local/share/pomelo/signatures),只有你看得到。
    • 「文字」可以在表格的空格里填字。
    • 这是把签名的样子放到页面上,任何人都可以复制;要证明「是我签的、签完没被改过」请用下面的数字签名。
  • 数字签名(用数字身份签署,可以证明文档签完之后没被改过):

    PDF 阅读器的数字签名:上方的状态栏、左边的签章皮肤与签章内容
    PDF 阅读器的数字签名:上方的状态栏、左边的签章皮肤与签章内容
    • 「填写与签名」的「用证书签署…」(或「工具」菜单):选一个数字身份,输入它的密码,按「下一步」, 在页面上拖动出签名的位置(只点一下就用默认大小),写原因、地点(可以不填),按「签署并保存」。 有存好的手写签名的话,外观会加上它;签好之后会马上存盘。
    • 文档里有空白的签名字段(虚线框写着「点这里签署」)时,直接点它就能签在那里。
    • 数字身份:
      • 还没有的话按「新建…」,输入名称、电子邮件、密码(至少 6 个字符)。 自己创建的身份可以证明文档签完没被改过,但别人无法确认是不是你本人(就像没有公证的印章)。
      • 公司或证书颁发机构发的 .p12/.pfx 文件可以按「导入…」。
      • 数字身份存在自己的主目录(~/.local/share/pomelo/digital-ids),密码不会被记住,忘了就不能用了。
    • 读卡器上的证书(自然人凭证、工商凭证等智能卡):插好读卡器与卡片,按「读取读卡器」,卡片上的签名证书会列在列表里, 选它、输入卡片的 PIN 码(读卡器有键盘的话在读卡器上输入)。私钥不会离开卡片,是卡片自己签的。
      • 需要读卡器的驱动程序(pcscd)和卡片的 PKCS#11 模块:自然人凭证是台湾内政部凭证管理中心的 HiCOS 组件, 其他卡片多半装 opensc 就可以。Pomelo 会自己找;找不到时可以按「指定模块…」选 .so 文件。
      • PIN 码输错太多次卡片会锁住,剩最后一次时会提醒你。
    • 时间戳:签署时勾「加上时间戳」,会向时间戳服务器(默认 http://timestamp.digicert.com,可以改) 证明签署的时间,别人验证时就不必相信你电脑上的时钟;证书之后过期,也能证明签署当时是有效的。 只会发送签名的哈希值,不会发送文档内容。签名内容里会显示时间戳的时间与是哪个服务器证明的。
    • 打开有签名的文档时,上方会有一条状态栏:绿色=所有签名都有效;黄色=签名有效,但签署人的身份无法确认, 或签署之后页面内容被改过;红色=有签名无效(文档在签署后被篡改)。按「签名面板」,左边会列出所有签名, 点一个看详细内容:签署时间、原因、证书是谁发的,还可以「查看签署时的版本」。
    • 签署之后再加注解、荧光笔或其他人的签名,原本的签名仍然有效;但整理页面(删除、重排、插入页面)会让签名失效, 所以会把原本的签名拿掉(还没存盘前可以按 Ctrl+Z 撤销)。
    • 确定是对方本人的证书时,可以在签名内容按「信任这个证书」,之后他签的文档就会显示「身份已确认」。
  • 整理页面:显示所有页面的缩略图。点一下选取(Ctrl+点加选、Shift+点选一段),拖动可以调整顺序; 上面有向左/向右旋转、删除(也可以按 Delete)、提取(把选取的页面变成新的文档)、插入文件(插在选取的页面后面)、插入空白页。 双击某一页会回到阅读画面并跳到那一页。

  • 合并文件(工具 → 合并文件…):按「添加文件…」输入路径(Tab 补全),用 ↑↓ 调整顺序,按「合并」会变成新的标签页, 每个原本的文件在书签里各有一项。原本的文件不会改。有打开密码的文件要先在标签页里打开才能合并。

  • 加上页码(工具 → 加上页码…):选格式(例如「第 1 页,共 9 页」)、位置、字的大小、第一个号码、从第几页开始(封面不想编号时用)。

  • 编辑内容(改页面上原本的字、移除水印):

    PDF 阅读器的编辑内容:每一行字有框,点一下就能修改
    PDF 阅读器的编辑内容:每一行字有框,点一下就能修改
    • 编辑文本:鼠标移到页面上,可以修改的每一行字会有淡淡的框。点一行,在出现的框里改字,按 Enter 完成; 把字全部清掉就是删掉那一行。字体默认是「自动」:用最接近原本的字体(明体、楷体、黑体,粗体也会跟着粗); 也可以在框下面改选黑体、明体、楷体或粗体(只换字体、不改字也可以)。新的字放在原本的位置,同一行后面的字会跟着挪。 改好的字可以选取、搜索、复制。

    • 加入文本:选颜色与大小,点页面上要加字的地方(点的位置是第一行字的左上角),打字后按 Ctrl+Enter(Enter 换行); 框下面可以选字体(黑体、明体、楷体)与粗体,下次会记住。 跟「注解」的「文本」不同,这是直接写进页面内容,可以选取、搜索,别人也不能把它当注解删掉。

    • 移除水印:按「移除水印…」,会列出整份文档里可能是水印的东西(例如斜的半透明大字、每页都有的同一个图案、 页眉页脚),以及出现在几页;看起来确定是水印的已经勾好,确认后按「移除」。

      PDF 阅读器的移除水印:勾选要移除的项目
      PDF 阅读器的移除水印:勾选要移除的项目
    • 签过数字签名的文档改了内容,签章会显示「签署之后内容被修改过」。改错了可以按 Ctrl+Z 复原。

  • 有打开密码的文档存盘后还是同一个密码;作者限制「不允许修改」的文档,要输入拥有者密码才能改。

  • 存盘是把修改接在原本的文件后面(整理页面、合并则是重新写一份),其他 PDF 阅读器都能正常打开、看得到注解与签名。

11. 远程桌面

连到 Windows 电脑的桌面(RDP 协议),例如远程操作公司或家里的电脑。协议本身用 FreeRDP 库,窗口、设置界面是 Pomelo 自己画的, 不需要另外装 xfreerdp(也不会跟它冲突,两个可以同时装)。

远程桌面:常用电脑列表、快速连接
远程桌面:常用电脑列表、快速连接
  • 快速连接:在上面的栏位输入电脑名称或 IP(也可以写「用户@电脑」),按 Enter 就连接,不会存起来。

  • 我的电脑:把常用的电脑加进列表,之后点一下就能连,双击直接连接。点一下可以修改设置。 Windows 那边要先在「设置 → 系统 → 远程桌面」打开「启用远程桌面」(家庭版没有这个功能,只有专业版以上才能被连接, 但不管哪个版本都可以当作客户端,用 Pomelo 的远程桌面去连接别人的电脑)。

  • 添加电脑时可以设置:

    • 画面大小:「适合窗口」会请 Windows 把分辨率改成窗口的大小,拉窗口时跟着变;也可以选「全屏」、常见的固定分辨率, 或「自定义…」自己输入宽与高。连接后按 Ctrl+Alt+Enter 随时切换全屏;全屏时把鼠标移到屏幕最上面会出现工具栏 (窗口化、Ctrl+Alt+Del、断开连接)。
    • 颜色深度:16/24/32 位,带宽不好时选低一点的可以省流量。
    • 网络质量:自动检测/调制解调器/中速宽带/高速宽带/局域网,影响壁纸、窗口拖动预览、动画、主题这些效果要不要自动关掉 (带宽越窄,关得越多),不影响能不能用,只影响顺不顺。
    • 声音:远程电脑的声音要不要在这台电脑播放。
    • 共享剪贴板:开着的话,复制的文字两边都能粘贴(只有文字,图片跟文件不行)。
    • 连接到控制台会话:管理员登录远程服务器维护时用(一般用户不需要勾)。
    • 设备映射:把本机的一个文件夹共享给远程电脑,连接后 Windows 的「此电脑」/文件资源管理器会多一个驱动器,可以在两边之间复制文件; 也可以共享本机的打印机,远程电脑打印出来的文档会从这台电脑的打印机打印出来。
  • 密码存在钥匙圈(pomelo-keyring),不会写进配置文件;没有钥匙圈或钥匙圈锁着的话,每次连接都会问密码。

  • 第一次连某台电脑,或电脑重装、换过证书时,会问你要不要信任它的证书(Windows 默认的远程桌面证书都不是信任的机构签发的,这是正常的; 如果提示「跟上次不一样」,要先确认不是有人在中间拦截连接,再选择信任)。

    远程桌面的登录画面:有些服务器(像 xrdp)不需要先输入账号密码,可以直接按「不输入,在远程画面登录」
    远程桌面的登录画面:有些服务器(像 xrdp)不需要先输入账号密码,可以直接按「不输入,在远程画面登录」
  • 连接中断时(网络问题、对方注销、或有人从别的地方登录把你挤掉)会告诉你原因,并可以直接按「重新连接」。

    连接后的画面:跟操作本机一样,键盘鼠标直接对应过去
    连接后的画面:跟操作本机一样,键盘鼠标直接对应过去

12. 文字处理器

打开、编辑、保存 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。

13. 电子表格

打开、编辑、保存 Excel(.xlsx)与 OpenDocument(.ods)电子表格,双击这两种文件默认就用「电子表格」(pomelo-sheet)打开。 表格模型、公式引擎、文件格式读写都是自己写的,不需要另外装 LibreOffice 或 Microsoft Office,也能跟它们互相打开文件。

电子表格:标题栏、公式与格式设置
电子表格:标题栏、公式与格式设置
  • 选取与编辑:点一下选一格,拖动或 Shift+点选一个范围;双击、按 F2 或直接打字开始编辑那一格, Enter 确认并往下移、Tab 确认并往右移、Esc 放弃这次编辑;上方的公式栏也会同步显示当前这格的内容, 点公式栏一样可以编辑。Delete/Backspace 清空选取范围的内容(格式会留着)。Ctrl+Z/Ctrl+Y 撤销/重做。

  • 公式:单元格以 = 开头就是公式,可以写单元格地址(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。
    • 日期(序列号跟 Excel 相同,要看成日期请用 TEXT):TODAY NOW DATE YEAR MONTH DAY WEEKDAY HOUR MINUTE SECOND DAYS EDATE EOMONTH DATEDIF NETWORKDAYS。

    已知限制:插入或删除行/列时,其他单元格公式里引用的地址不会跟着自动调整;没有数组公式。

  • 右键新增、删除行列:在单元格上点右键有剪切、复制、粘贴、清除内容,以及「在上面/下面插入一行」「在左边/右边插入一列」「删除这一行/列」; 在行号或列标上点右键,会选取整行或整列再出菜单。选了几行(列)就一次插入或删除几行(列),公式的引用会跟着调整,可用 Ctrl+Z 撤销。

  • 填充:选取范围的右下角有个蓝色小方块,往下、往右、往上、往左拖就会按规则填下去,拖的时候会用虚线框预览; 双击小方块会往下填到旁边那一列数据结束的地方。规则:

    • 单一个数字 → 每格加 1(1 拖成 1 2 3 4 5…);选两格以上就按趋势(2、4 拖成 6、8、10…)。按住 Ctrl 再松开鼠标,改成只复制。
    • 结尾有数字的文字会递增:第1名 → 第2名,Item007 → Item008(保留位数)。
    • 星期、月份、季度、天干地支、一二三…十、Mon/Jan 这类列表接着往下,并且循环(星期五 → 星期六、星期日、星期一…)。
    • 公式会照位置调整相对引用(=A1+B1 往下填成 =A2+B2;$A$1 锁住的不动)。其他文字照样重复。
    • Ctrl+D/Ctrl+R(编辑菜单)把选取范围的第一行/列复制到其余格;「数据 → 序列填充…」可以填起始值、间隔和终止值 (例如从 10 开始每次加 5 到 100),往下或往右。
  • 排序:「数据」菜单的「从小到大排序」「从大到小排序」按当前这一列排整个数据区(只选一格会自动找出连在一起的数据,第一行是文字标题就不参与排序); 「排序…」可以指定按哪一列、再按哪一列、各自从大到小,以及第一行是不是标题。数字排在文字前面,空白一律排最后,同值保持原本顺序, 公式跟着搬并调整相对引用。排序和填充都可以用 Ctrl+Z 撤销。

  • 格式:工具栏可以设置粗体、斜体、下划线、文字颜色、背景颜色、字体、字号,以及靠左/居中/靠右对齐; 格式应用在当前选取的范围上。

  • 工作表:窗口下方是工作表标签,点一下切换,点「+」新增;「工作表」菜单可以重命名、删除工作表 (至少要留一张),以及在当前单元格的位置插入或删除行、列。

  • 查找:Ctrl+F 在当前工作表内找文字,找到就跳过去选取;只在当前这张工作表内找,不会跨工作表。

  • 剪贴板:复制/剪切/粘贴一个范围,粘贴时会按照原本的行列位置展开;公式会原封不动粘贴过去 (因为公式文字本身就是 =... 开头,粘贴到别的程序或从别的程序粘贴进来也看得出来是公式),但格式不会保留。

  • 文件:

    • 打开:跟文字处理器一样是图形化的文件浏览窗口,只列出文件夹跟 .xlsx/.ods 文件; 启动器/文件管理器双击 .xlsx/.ods 文件,或在终端用 pomelo-sheet 文件名,都可以直接打开。
    • 保存/另存为:保存格式看文件名的扩展名(.xlsx 存成 Excel 格式,.ods 存成 OpenDocument 格式); 没有写扩展名的话,用另存为窗口里选的格式,并自动补上对应的扩展名。
  • 中日韩文输入:跟文本编辑器一样用 XIM(见第 7 节),可以搭配 pomelo-input 或 fcitx5。

14. 演示文稿

打开、编辑、保存 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 退出;「预览放映…」用一般窗口大小先看一次效果,不用整个屏幕。 放映时如果检测到两个以上的屏幕,会自动打开演讲者模式:一个屏幕全屏显示幻灯片给观众看, 另一个屏幕(操作用的那台)显示当前幻灯片缩略图、下一张缩略图、备注、张数、已用时间,方便台上看稿。

    幻灯片浏览模式:一次看到所有缩略图
    幻灯片浏览模式:一次看到所有缩略图
  • 文件:

    • 打开:跟文字处理器一样是图形化的文件浏览窗口,只列出文件夹跟 .pptx/.odp 文件; 启动器/文件管理器双击 .pptx/.odp 文件,或在终端用 pomelo-slides 文件名,都可以直接打开。
    • 保存/另存为:保存格式看文件名的扩展名(.pptx 存成 PowerPoint 格式,.odp 存成 OpenDocument 格式); 没有写扩展名的话,用另存为窗口里选的格式,并自动补上对应的扩展名。
  • 已知限制:没有母版/版式可以自定义、没有表格、图表;文本框只有一种格式应用在整个框, 不能同一个框内不同文字不同格式;形状不能旋转、不能组合;对象进场动画播放时机固定是幻灯片出现时 全部一起播放,不支持按点击顺序逐一播放;演讲者模式的双屏幕画面布局是自动决定,不能手动指定哪个 屏幕当观众画面;设计主题不能自定义(没有母版编辑),在别的程序里主题的背景是一张图,不能改颜色。

  • 中日韩文输入:跟文本编辑器一样用 XIM(见第 7 节),可以搭配 pomelo-input 或 fcitx5。

15. 小柚浏览器

小柚浏览器:上面是地址栏,两个标签页以上会出现标签栏
小柚浏览器:上面是地址栏,两个标签页以上会出现标签栏

小柚浏览器是 Pomelo 内置的网页浏览器,打开得快、占用的内存少。网页的排版、JavaScript 与安全更新来自系统的 WebKitGTK,跟着系统更新。

  • 打开:Dock 上的小柚浏览器,或在启动器、搜索输入「浏览器」;也可以跟小柚说「打开小柚浏览器」(只说「打开浏览器」会打开系统默认的浏览器)。 已经开着的话会直接多开一个窗口,几乎马上出现。
  • 地址栏:输入网址直接前往(不用输入 https://);输入其他文字就用搜索引擎搜索(默认 Google,右上角「⋯」菜单可以改成 DuckDuckGo 或 Bing)。可以用 Pomelo 输入法打中文,网页里的输入框也可以。 网址前面的锁头表示连接已加密;出现三角形表示没有加密,请不要在那个网站输入密码或信用卡。 点一下锁头(左键或右键)可以看网站的证书:发给谁、哪个单位签发的、有效期、证书链与指纹,也可以复制证书。 只输入网址没写 https:// 时会先用加密连接,网站不支持才改用没有加密的连接。
  • 标签页:Ctrl+T 新建标签页、Ctrl+W 关闭、Ctrl+Shift+T 重新打开刚关掉的标签页、Ctrl+Tab 切换、Ctrl+1~9 跳到第几个标签页。 两个标签页以上才会出现标签栏;在标签页上点中键也可以关闭。链接点中键(或 Ctrl+点)会在后台打开新标签页。
  • 起始页:新标签页会显示小柚、搜索框与你常去的网站。
  • 右键菜单:在网页上点右键可以后退、重新加载、复制网址、在网页中查找、打印、放大缩小、全屏;选取文字后点右键 可以复制,或直接用当前的搜索引擎搜索;在链接上可以在新标签页打开、复制链接、下载;在图片上可以复制或下载图片。
  • 其他:Ctrl+F 在网页中查找、Ctrl+加号/减号/0 缩放(也可以按住 Ctrl 转滚轮)、Ctrl+P 打印、F11 全屏、 Alt+←/→ 上一页/下一页、Ctrl+L 跳到地址栏、F5 重新加载。
  • 下载:文件存到「下载」文件夹,下载完会有通知。下载时右上角会出现下载按钮与进度圈,点一下打开「下载」文件夹。
  • 权限:网站想使用摄像头、麦克风、位置,或想显示通知时,网页上方会出现询问栏,点「允许」或「不允许」。
  • 清除浏览数据:「⋯」菜单 →「清除浏览数据…」,清掉浏览记录、Cookie 与缓存(网站要重新登录)。
  • 省资源:同时只有一个小柚浏览器在运行(再开一次只是多开窗口);没有独立显卡的电脑(包括虚拟机) 会自动改用 CPU 绘图,内存用得更少。

16. 虚拟机

虚拟机:列表上每台都看得到状态与使用量
虚拟机:列表上每台都看得到状态与使用量

「虚拟机」可以在这台电脑里运行别的操作系统(例如试装别的 Linux、跑一台 Windows),不用重启、不会动到这台电脑的系统。 底层是 Linux 内置的 KVM 与 QEMU,不需要另外的内核模块,也不需要 libvirt。

  • 第一次使用:打开后如果还没有 QEMU,会出现「安装」按钮,点下去打开一个终端窗口安装(要输入你的密码), 只装运行虚拟机需要的部分。 (Ubuntu/Debian 的 qemu-system-x86 默认会连带装 QEMU 自己的 GTK 界面等一大堆东西,这里用 --no-install-recommends 不装。)
  • 硬件虚拟化:x86_64 的虚拟机要用 CPU 的硬件虚拟化(Intel VT-x/AMD-V,Linux 里叫 KVM)才会快。 没开的话上面会有提示,到 BIOS 设置打开就好;如果是「你的账号还不能使用」,点「开启」把你加进 kvm 群组,注销再登录。
  • 新增虚拟机:点「新增虚拟机」,选操作系统的安装光盘(.iso)。程序会从文件名猜是什么系统、什么架构, 自动给建议的内存、处理器核心与硬盘大小;名称也会先帮你填好。硬盘文件一开始很小,用多少才占多少空间。 已经有虚拟硬盘(例如 VirtualBox 的 .vdi、VMware 的 .vmdk、.qcow2)也可以打开「使用现有的虚拟硬盘」直接拿来用。
    • Windows 11 需要 UEFI、安全启动与 TPM 2.0,选 Windows 时已经帮你打开(TPM 第一次用时会请你安装 swtpm); 硬盘用 SATA、网卡用 Intel e1000e,Windows 安装光盘内置就有驱动程序。 启动时如果看到「Press any key to boot from CD or DVD」,要在几秒内按任意键。
    • ARM64:「处理器架构」选 ARM64 可以跑 ARM 版的系统(第一次用会请你安装 qemu-system-arm)。 在 x86 电脑上是用软件模拟的,比较慢(大约慢 5~20 倍),适合装服务器或测试。
  • 启动与画面:在列表双击(或打开设置页点「开机」),画面窗口就会出现。硬盘还没装系统时会自动从光盘启动, 装好之后就从硬盘启动,不用改设置。
画面窗口:上面一排是电源、暂停、光盘、USB、快照、按键、查看
画面窗口:上面一排是电源、暂停、光盘、USB、快照、按键、查看
  • 画面窗口:键盘、鼠标直接操作虚拟机,鼠标不会被「抓住」,移出窗口就回到这台电脑。上面一排按钮:
    • 电源:关机(像按一下电源键,让虚拟机自己关机)、重启、保存状态并关闭、强制关机(像拔掉电源)。
    • 暂停:冻结虚拟机(内存留着),再点一次继续。
    • 光盘:换一张光盘镜像或弹出光盘,不用关机。
    • USB:把插在这台电脑上的 USB 设备(U 盘、外接硬盘、手机、读卡器…)交给虚拟机,再点一次还回来。 外接硬盘会先在这台电脑弹出;第一次交给虚拟机时会要你输入密码(取得那个设备的使用权限)。 键盘、鼠标也能交出去,但交出去后这台电脑就不能用它,程序会先问你。
    • 快照:把现在的样子(连同内存)存起来,之后随时回到这一刻,例如装软件、改设置前先拍一张。
    • 按键:送出这台电脑会拦下来的组合键,例如 Ctrl+Alt+Del、Ctrl+Alt+F1~F7、Windows 键。
    • 查看:全屏(或按 Ctrl+Alt+Enter;全屏时把鼠标移到最上面会出现工具栏)、窗口适应画面大小。 显卡用 VirtIO 时,虚拟机的分辨率会跟着窗口大小改变(Linux 虚拟机大多支持)。
    • 快捷键:Ctrl+Alt+End 送出 Ctrl+Alt+Del。
  • 关掉画面窗口:会问你要关机、取消,还是让虚拟机在后台继续运行。在后台运行的虚拟机,之后在列表双击就能再打开画面。
  • 保存状态:「电源 → 保存状态并关闭」会把整个虚拟机(包括开着的程序)存起来,下次开机直接从原来的地方继续, 就像笔记本合上再打开。
  • 快照管理:在虚拟机的设置页下面,可以给快照改名、回到某个快照或删除。关机时拍的快照只存硬盘。 快照存在硬盘文件里,要 qcow2 格式(新建的虚拟机都是)。
使用量:CPU、内存、磁盘读写、网络收发,最近一分钟的图表
使用量:CPU、内存、磁盘读写、网络收发,最近一分钟的图表
  • 使用量:列表上每台运行中的虚拟机会显示 CPU、内存、磁盘、网络使用量;点进去还有最近一分钟的图表。 内存是 QEMU 实际占用的;NAT 网络只算 TCP 连接,是大概的数字。
  • 设置:关机时才能改(内存、处理器核心、光盘、启动顺序、显卡、声音、网络、加大硬盘、TPM 等),改了就自动保存。
    • 网络:「NAT」最简单,虚拟机跟这台电脑共用网络就能上网;要从这台电脑连进虚拟机,在「转发端口」写 例如 2222:22,之后用 ssh -p 2222 localhost 连(只有这台电脑连得到)。 「桥接」让虚拟机像局域网上的另一台电脑,从路由器拿 IP,别的电脑也连得到;需要一个网桥(例如 br0), 没有的话设置页有「创建网桥」按钮(要用有线网卡,Wi-Fi 没办法桥接;创建时网络会中断几秒), 第一次使用要点「允许使用」。
    • 声音:虚拟机的声音从这台电脑播出。 Ubuntu/Debian 默认的 QEMU 没有 PulseAudio 模块,声音改从画面窗口播出(画面窗口开着才听得到),也没有麦克风; 设置页点「安装」加装 qemu-system-gui 后,声音由 QEMU 直接播放,麦克风也能用(会一起装 GTK3,约 30 MB)。
  • 文件放在哪里:每台虚拟机一个文件夹,在 ~/.local/share/pomelo/vm/(硬盘文件、UEFI 设置、快照都在里面)。 设置页最下面可以在文件管理器打开,或删除整台虚拟机。
  • 还没有的功能:跟虚拟机共用剪贴板、共享文件夹、拖放文件、3D 加速、多屏幕。要交换文件可以用网络(例如 ssh、 网上邻居)或 U 盘。
  • 命令行:pomelo-vm --list(列出虚拟机与状态)、pomelo-vm --start 名称、pomelo-vm --stop 名称 (请它关机)、pomelo-vm --kill 名称(强制关机)。

17. 容器(Docker)

容器:运行中的容器显示使用量与端口,compose 项目的名称在括号里
容器:运行中的容器显示使用量与端口,compose 项目的名称在括号里

「容器」用来管理 Docker:容器、镜像、卷与备份,不用记命令。

  • 安装 Docker:还没有 Docker 的话,打开后点「安装」,会打开一个终端窗口(要输入你的密码)。 安装系统内置的 docker.io(不装推荐软件包),设置开机自动运行,再把你加进 docker 群组。 装好之后要注销再登录,加入群组才会生效。Docker 没在运行、账号没权限时,画面上也会出现对应的按钮。 注意:docker 群组的成员可以通过容器取得整台电脑的管理员权限,只加信任的账号。

  • 容器:分成运行中与已停止;运行中的会显示 CPU、内存、网络、磁盘使用量与端口(本机→容器), 用 docker compose 创建的会在名称后面标出项目。点一下进到容器的页面。CPU 的 100% 等于一个处理器核心(跟 docker stats 一样)。

  • 容器的页面:

    容器的页面:上面是常用的操作,下面是最近一分钟的使用量
    容器的页面:上面是常用的操作,下面是最近一分钟的使用量
    • 进入:打开一个终端窗口进到容器里(有 bash 用 bash,没有就用 sh),跟 docker exec -it 一样。
    • 日志:在终端里看容器的输出(最近 300 行,之后的会一直跟着更新)。
    • 停止、重启、暂停/继续、启动;停止后才能删除(卷会留着)。
    • 信息:镜像、创建与启动时间、IP 地址、端口、挂载的文件夹与卷;环境变量可能有密码,只显示数量。
    • 设置:改名称、开机时要不要自动启动。
  • 新增容器:在「容器」标签页最下面点「新增容器」,填镜像(例如 nginx、mariadb:11)、名称、端口 (本机:容器,例如 8080:80)、文件夹(本机路径或卷名称:容器里的路径,例如 ~/网站:/usr/share/nginx/html)、 环境变量(用分号分开)、自动启动,点「创建并启动」。这台电脑还没有的镜像会先下载。

  • 镜像:输入名称按 Enter 下载;点镜像可以用它创建容器或删除;「清理」可以删掉没有名称、没在用的旧镜像 (通常是更新后留下的)与构建缓存。

  • 卷:看每个卷给哪个容器用;没在用的可以删除。卷里的文件要管理员权限才看得到,要拿出来请用备份。

  • 备份:在容器的页面点「备份」,会把容器的设置、卷与挂载文件夹里的文件存成一个文件夹;打开「连镜像一起备份」 (默认)的话,容器现在的样子(包括在容器里改过的东西)也会存起来,可以复制到别的电脑还原。运行中的容器备份时会暂停一下。 备份放在「备份」标签页设置的位置(默认是主文件夹的 docker-backups),可以改到外接硬盘或网络磁盘。

  • 还原:「备份」标签页点一份备份 →「还原」。会照原本的设置重建容器与卷,再把数据放回去; 名称已经有容器在用时会加上 -restored。原本的端口被别的容器占着时,容器照样还原、只是先不启动,改好再启动。

  • 定时备份:可以用命令 pomelo-docker --backup 容器名称 [文件夹] [--no-image] 放进 cron 或 systemd timer; 还原是 pomelo-docker --restore 备份文件夹。

18. 容器集群(Kubernetes)

「容器集群」是选装的程序(软件中心可以装、移除),给想玩 Kubernetes 但不想研究怎么搭的人:引擎是 k3s(轻量的 Kubernetes, Apache 2.0 许可证,第一次创建时才下载,约 70 MB),我们做的是上面那一层——用点选的方式建好、管好集群。底下就是标准的 Kubernetes: kubectl、Helm chart、别人写的 YAML 都能直接用。

创建集群(四步)

  1. 要几台:「只用这台电脑」一分钟内能用,适合学习、开发;「多台电脑」填每台的 IP 与 SSH 账号密码(账号要能 sudo; 第一次用密码,之后会改用密钥),也可以把这台电脑一起加进去。
  2. 体检与建议:每台 SSH 进去只读取硬件与系统状况(核心数、内存、磁盘是 SSD 还是硬盘、网卡速度、系统版本、时间有没有同步、 端口有没有被占、有没有在跑 Docker 或数据库),然后每台给一个建议的角色与理由:
    • Server:控制平面(API、调度器、集群数据库)。三台以上都够格会建议三台做高可用。
    • Client:真的跑容器的工作节点。台数不多时 Server 也一起跑容器。
    • NFS 保存:磁盘剩最多的那台,装 NFS 服务器当共用磁盘(数据库与上传的文件放这里),集群的默认保存就指到它;共用磁盘只开放给集群里的节点,不是整个网络。
    • 高端:Redis、数据库(PostgreSQL/MariaDB/MongoDB)、镜像库。 建议只是默认,开关都可以自己改;不合理的组合会提醒(例如内存不到 4 GB 却当 Server),真的不能成立的才挡(没有 Server、没有人跑容器、时间没同步)。
  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(<名称>.<Server 的 IP>.nip.io 会自动解析成那个 IP),同一个网络的电脑打开就能用;要自己的域名就改主机名。 已安装的应用列在同一页,Pod 就绪后点「打开」。要移除:在「工作负载」删掉,或终端 kubectl delete namespace app-<名称>。

加节点/移除节点:节点页最下面「加入一台」填 IP 与账号密码,体检没问题就装成 Client 加入;每台节点的「移除」会先把 Pod 搬走 (drain)、从集群删掉,再到那台拆 k3s(要那台的 sudo 密码)。旧版创建的集群没有存 token,第一次加节点会先问 Server 的 sudo 密码把 token 读回来。

运维(仪表板的「运维」格子):

  • 告警与通知:节点没响应、Pod 一直崩溃或拉不到镜像、磁盘卷没接上、连接证书快到期,都会列在这页;有「新的」问题会弹桌面通知,同一个问题不会重复吵你,一次冒出好几个会合并成一则。打开「后台监看」的话,窗口关着也每 5 分钟看一次(用 systemd 用户 timer,不用管理员权限;笔记本换网络连不上集群时不会乱通知)。
  • 连接证书:显示 kubeconfig 客户端证书还有几天到期;不到 90 天时可以点「更新证书」——逐台重启 Server(k3s 启动时会自动换新快到期的证书),等到真的回来,再重新取得 kubeconfig。
  • 升级 k3s:有新的稳定版就能点「升级」:先下载并校验,Server 一台一台升,再升 Client;每一台都等到服务真的重新启动、节点报告新版本且 Ready 才换下一台(三台高可用的集群不会一次掉两台)。跑着的 Pod 不会被打断。
  • 备份与还原:「立即备份」把集群的资源(应用、设置、Secret…,已清掉不能还原的字段,也略过 k3s 自己管的东西)存成 JSON;有 NFS 存储时一并打包共享文件夹(用 cpio,因为数据库正在用的文件 tar 读不到)。「还原」会先建命名空间与磁盘卷,等 NFS 磁盘卷绑定后把旧数据搬进新的文件夹(动态存储的文件夹名称含随机的 PV 名称,集群重建后会不同),最后才应用工作负载,所以数据库不会在空文件夹上初始化。正在写入的数据库备份只是「某一刻的样子」,重要数据请另外用 pg_dump、mysqldump。
  • 升级、更新证书、备份 NFS 需要节点的 sudo 密码(各台要一样,只放在内存,用完就清掉,也不会出现在任何进程的命令行)。
  • 命令行: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。各节点拉取容器镜像需要能联网。

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 会列出每个格式能不能创建、能不能加密, 缺什么、怎么装;窗口里做不到的选项会显示原因,不会默默失败。

加密

  • 创建压缩文件时打开「用密码加密」。ZIP 与 7z 用 AES-256;7z 另有「连文件名一起加密」,没有密码连里面有什么文件都看不到。 ZIP 的文件名一定看得到(格式本身的限制)。tar 系列是整包用 OpenPGP(AES-256)加密成 .gpg,看不到里面的文件名;用 gpg 或这个程序都能解开。
  • 打开加密的压缩文件时会问密码;密码不对可以重新输入。密码只在程序里传递,不会出现在命令行、日志或设置文件里,用完就清掉。
  • 忘记密码就打不开,也没有办法找回。

安全

解压缩是最容易被恶意文件攻击的地方,所以压缩管理器一律先挡再解:

  • 路径里的 ..、绝对路径、指到解压文件夹外面的符号链接与硬链接都不会还原(会告诉你略过了几个);setuid/setgid 权限、设备文件一律去掉。
  • 疑似压缩炸弹(解开后超过 1 GB 而且压缩比超过 100 倍,或项目超过 200 万个)会先警告,确认才继续;磁盘空间不够会先讲。
  • 先解到旁边的暂存文件夹,全部成功才搬过去,失败或取消不会留下半成品;目的地有同名文件时会问你要取代、两个都留、略过还是取消。

选配的程序(没装也能用,只是少几项功能)

软件包 没装的时候 怎么装
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. 软件与更新

  • 软件中心(启动器里的「软件中心」):
    • 「探索」有分类推荐的常用软件。
    • 也可以搜索整个软件源,例如输入 chrome、zoom、python。
    • 「已安装」里可以移除用 apt 装的程序。
  • 系统更新:「系统设置 → 一般 → 软件更新」可以检查并安装所有更新。
    • 想要自动安装安全更新:先 sudo apt install unattended-upgrades,同一页就会出现「自动安装安全更新」的开关。
    • 也可以用命令:sudo apt update && sudo apt upgrade

21. 文件、外置设备与密码

  • 文件管理器(Dock 上的文件夹图标):
    • 常用操作:Ctrl+C/X/V 复制剪切粘贴、F2 重命名、Delete 丢到垃圾桶、Ctrl+F 搜索。
    • 拖放:把文件拖到文件夹、侧边栏的位置、另一个文件管理器窗口。同一个磁盘上是移动,到别的磁盘(例如U盘)是复制, 按住 Ctrl 一律复制;拖到「垃圾桶」就是丢掉。拖着停在文件夹上一秒会打开它,停在列表上下边缘会自动滚动,按 Esc 取消。
    • 拖到看图、绘图、文本编辑器、PDF 阅读器、影音播放器的窗口就用它打开;拖到终端会打上文件的路径; 也可以拖到浏览器上传。别的程序拖来的文件也收(放在文件夹上就进那个文件夹)。
    • 压缩与解压缩:在文件上按右键选「压缩…」,在压缩文件上按右键选「解压缩到这里」,双击压缩文件会用压缩管理器打开(见第 19 节)。
  • 外置设备:插上U盘会自动挂载并通知。菜单栏会出现 ⏏ 图标,退出前请先点它。
  • 保存空间(「系统设置 → 一般 → 保存空间」):
    • 看磁盘用量与硬盘健康。
    • 一键清理:垃圾桶、缩略图缓存、软件包缓存、不再需要的软件包、系统日志。
  • 钥匙圈:帮 Chrome、VS Code 等程序保管密码,用你的登录密码加密。

防火墙管理器:用好用的界面管理 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)

  • 「硬件虚拟化没有启用」:到 BIOS 设置把 Intel VT-x(Virtualization Technology)或 AMD-V(SVM)打开。
  • 「你的账号还不能使用」:点「启用」,注销再登录。
  • Pomelo 本身装在虚拟机里(例如 VirtualBox、VMware)时,要在那边打开「嵌套虚拟化」才有 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 时也一样要重新登录一次)。

找出问题原因

  • 用 Pomelo 登录界面登录时,Pomelo 的消息写在 ~/.xsession-errors。
  • 用其他登录界面时,看 ~/.xsession-errors 或 journalctl --user -b。
  • journalctl -b 可以看这次开机的系统纪录。

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. 已知限制

  • Pomelo 的程序还没有全部改成原生 Wayland:0.40 起设置程序、控制中心、通知、启动器、锁定画面、菜单栏、Dock、壁纸、小柚、登录画面已经是原生的, 文件管理器、终端与其他程序还通过 XWayland 显示,之后的版本会逐步改过去;旧式的 XEmbed 系统匣图标(把程序自己的小窗口嵌进菜单栏) 在 Wayland 会话不会显示,新式的 SNI/AppIndicator 图标照常; GTK、Firefox 这些程序在 0.40 起已经直接用 Wayland。不同的屏幕还不能各用不同的缩放比例(例如笔电 150%、外置屏幕 100%), 只能调整整体的文本大小。走 XWayland 的程序彼此之间没有隔离(X11 的设计:同一个 X 服务器上的程序看得到彼此的窗口与按键), 原生 Wayland 的程序则互相隔离,这也是要把剩下的程序改成原生的原因之一。
  • Chromium、VS Code 这类 Electron 程序仍走 XWayland(它们原生 Wayland 模式用的输入法协定还没支持)。
  • 分享屏幕(浏览器的视频会议)一次分享整个屏幕,还不能只分享一个窗口。
  • 虚拟机还不能:跟虚拟机共用剪贴板、共用文件夹、拖放文件;3D 加速、多屏幕。ARM64 在 x86 电脑上是软件仿真, 比较慢。桥接网络只能用有线网络卡。USB 穿透与桥接网络还没有在实体电脑上完整测试过,遇到问题请反馈。
  • 容器只管理这台电脑上的 Docker(不能连到别台电脑的 Docker);docker compose 的项目只标示名称,启动、更新整个项目 还是要用 docker compose;还原备份时,原本接的自订网络如果这台电脑没有,会改接到默认的 bridge 网络。
  • 小柚浏览器没有扩充功能、书签同步,也不能播放需要 DRM 的流视频(例如 Netflix);遇到不兼容的网站可以改用 Firefox。
  • 终端的 emoji 一个字一个字画:国旗、家庭这类用好几个字组成的 emoji 会拆开显示。
  • 绘图没有图层:文本、形状放上去之后就是图的一部分,不能再改字或移动(放错了按 Ctrl+Z 复原)。不能打印,也还不能存成 GIF、WebP。
  • PDF 阅读器还不能:运行表单里的 JavaScript(自动计算、检查格式不会动作);XFA 动态表单(少数政府表单用)不支持。 修改文本是一行一行改,不会自动换行,字变多会盖到右边的东西 (例如表格的隔壁格);直书的字、包在表单对象里的字还不能改。浮水印如果跟正文是同一张图(例如扫描的文件)就拿不掉。 验证签章时不检查凭证是否被撤销;时间戳记服务器只支持 http:// 的网址(大部分都是)。读卡机签章是用仿真的卡片测试的, 还没有在实体的自然人凭证上试过,遇到问题请反馈。 台湾政府机关的根凭证不在系统的信任列表里,政府或自然人凭证签的文件会显示「发证机构不在信任列表里」。 用注解的「文本」工具或页码加上去的字不能选取、搜索(「编辑内容」的「加入文本」可以)。直书的标点符号不会换成直式的写法。
  • 文字处理器还不支持:旧版二进制 .doc 格式(Word 97-2003,只支持 .docx 跟 .odt);拼字检查;页眉、注脚、追踪修订; 真正的齐行(撑开字距);图片只能自己占一整行、不能跟文本同一段混排,而且只认得 PNG/JPEG(文件里其他格式的图片或图表 会被跳过,文本部分照常能编辑,但另存新文件会遗失那些图片,请用「另存为」存成别的文件名,保留原始文件);页码只能整份文件 开关,不能自订格式或位置;打开文件的浏览窗口只列出文件夹跟 .docx/.odt 文件,看不到其他文件;打印预览只是缩略图, 不能在里面编辑。
  • 试算表还不支持:栏宽/列高只能用默认值,不能拖动调整;保存格编辑是单行输入;插入或删除列/栏时, 其他保存格公式里参照的地址不会跟着自动调整;剪贴板跨应用程序粘贴不会保留格式(公式会因为文本本身就是 "=..." 而保留);寻找只在目前工作表内找;冻结窗格、保存格合并、枢纽分析表、图表、条件式格式、打印。

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, 也可以写信索取。

下面这些在你第一次使用对应功能时才会下载,不包含在安装包里:

  • 小助手的 AI 模型:Qwen3-VL,Apache 2.0 许可证。
  • 用说的(语音识别):运行程序 sherpa-onnx,Apache 2.0 许可证;模型 SenseVoice-Small(阿里巴巴 FunASR), 依 FunASR 模型许可证可以自由使用、修改、分享,须标明来源。
  • 运行环境:llama.cpp,MIT 许可证。
  • 离线语音:
    • 语音合成程序 Piper 是 MIT 许可证。
    • 中文声音 huayan 的数据集许可证标示为「未知」。若要用在商业用途,请先自行确认。
  • 虚拟机:QEMU(GPL-2.0)、UEFI 固件 OVMF/EDK II(BSD-2-Clause-Patent)、TPM 模拟器 swtpm(BSD-3-Clause), 从系统的软件源安装。
  • 容器:Docker Engine(Apache 2.0),从系统的软件源安装(Rocky 9 从 Docker 官方的软件源)。
  • 输入法的 Rime 词典(拼音、仓颉、速成、粤拼):Rime 项目的方案与词典(LGPL-3.0);粤拼的词典由 CanCLID 维护, 主体是 CC BY 4.0,jyut6ping3.maps 是 ODbL 1.0。下载到 ~/.local/share/pomelo/rime-data/。

界面使用的其他组件:

  • 压缩管理器:读写压缩文件用系统的 libarchive(BSD-2-Clause 为主);选配的外部程序 gnupg(GPL-3.0-or-later)、squashfs-tools(GPL-2.0-or-later)、 7-Zip(LGPL-2.1-or-later 与 BSD-3-Clause,Ubuntu 24.04/26.04、Debian 13 的软件包另含受 unRAR 限制的 RAR 码,所以只列为建议、不自动安装)都是另外运行,不链接进程式。不支持 RAR(见第 19 节)。
  • 图标:Yaru(CC-BY-SA 4.0)/Adwaita。
  • 字体:Noto CJK(SIL Open Font License)。
  • 输入法:注音用新酷音引擎 libchewing(LGPL-2.1);其他语言用系统的 librime(BSD-3-Clause)、Anthy(LGPL-2.1 与 GPL-2)、 libhangul(LGPL-2.1),在设置里启用时才安装。pomelo-input 附了 librime 的 API 标头文件(BSD-3-Clause,授权全文附在软件包里)。
  • 小助手的简转繁与读音表(内置在程序里):取自 OpenCC(Apache 2.0)与 Unicode 的 Unihan 数据库(Unicode License v3), 授权全文附在软件包里。
  • SVG(图标、看图、绘图):nanosvg(Mikko Mononen,zlib 授权,原代码内嵌在 libpomelo,授权全文附在软件包里)。
  • PDF 阅读器:PDF 核心是 Pomelo 自己写的;字形名称对照表取自 Adobe Glyph List(BSD-3-Clause,授权全文附在软件包里), 中日韩的预先定义 CMap 读取系统上的 poppler-data(只用数据)。