Linux 安装说明（.deb / .rpm）

桌面支持：完整支持 GNOME 桌面 + X11；GTK、Wayland 为部分支持。

.deb 和 .rpm 均不声明依赖，以避免不同发行版包名 / 版本差异导致「not installable」或依赖冲突。
请先按下方各发行版章节安装所需依赖，再安装 ClipaX。

1. 按发行版安装依赖

在安装 ClipaX 之前，请在对应发行版执行下方命令（每台机器一次即可）。

Ubuntu / Kubuntu 24.04

sudo apt update && sudo apt install -y \
  libwebkit2gtk-4.1-0 \
  libayatana-appindicator3-1 \
  libkeybinder-3.0-0 \
  tesseract-ocr \
  libjsoncpp25 \
  libsqlite3-dev

Fedora 41

sudo dnf install -y \
  libayatana-appindicator-gtk3 \
  keybinder3 \
  tesseract \
  jsoncpp

# Fedora 41 临时兼容方案：对齐 tesseract 的 SONAME
sudo ln -s /lib64/libtesseract.so.5.5 /lib64/libtesseract.so.5.4

2. 安装 ClipaX

.deb（Ubuntu / Kubuntu）

# 先安装依赖（见上方），再安装包
sudo apt install ./clipx_1.1.2_amd64.deb

.rpm（Fedora）

sudo dnf install ./clipx-1.1.2-1.x86_64.rpm

3. 常见问题

如果无法打开 app，可在终端手动执行 /opt/clipx/clipx，查看终端中的日志输出。
若 Wayland 相关功能无法正常使用，可尝试切换至 X11 会话：
- Ubuntu / Kubuntu 24.04
  
  取消注释 /etc/gdm3/custom.conf 中的 WaylandEnable=false，然后重启。
- Fedora
  
  取消注释 /etc/gdm/custom.conf 中的 WaylandEnable=false，然后重启。
如还有其它异常，请执行下方命令获取当前系统信息，并发送邮件至 support@clipax.app，或在 https://github.com/clipax/ClipaX/issues 提交 Issue 以便排查：

# 内核与架构信息
uname -a

# 发行版信息
cat /etc/os-release || cat /usr/lib/os-release || true

# 桌面会话（用于判断 Wayland / X11）
echo "DESKTOP_SESSION=$DESKTOP_SESSION"

Linux 安装说明

On this page