Debian下Compton安装步骤

Debian 下 Compton 安装与启用

一 安装方式概览

• 在 Debian 上安装 Compton 常用三种方式：使用 APT 仓库安装、使用 Snap 安装、从 源码编译。APT 最简单；Snap 隔离性好；源码编译可获得更新版本或特定分支（如 compton2d）。下文给出可直接复制的命令与要点。

二 使用 APT 安装

• 更新索引并安装：
  • sudo apt update
  • sudo apt install compton
• 验证安装：
  • compton --version
• 说明：
  • 适用于 Debian 10+ 等稳定版本；安装后即可在 X11 会话中使用。若提示找不到命令，请确认当前会话为 Xorg（而非 Wayland）。

三 使用 Snap 安装

• 安装 Snap（如未安装）：
  • sudo apt update
  • sudo apt install snapd
  • sudo systemctl enable --now snapd.socket
  • sudo ln -s /var/lib/snapd/snap /snap
• 安装 Compton（classic 模式）：
  • sudo snap install compton --classic
• 验证：
  • /snap/bin/compton --version
• 说明：
  • Snap 包路径为 /snap/bin/compton，后续自启与命令行调用请使用该路径。

四 从源码编译安装（可选）

• 安装构建依赖（按需精简/补齐）：
  • sudo apt update
  • sudo apt install -y build-essential cmake git libx11-dev libxext-dev libxrender-dev libxtst-dev libxi-dev libxrandr-dev libxinerama-dev libxcursor-dev libxdamage-dev libgl1-mesa-dev mesa-utils
• 克隆与构建（以 compton2d 为例）：
  • git clone https://github.com/Compton2D/Compton2D.git
  • cd Compton2D
  • mkdir build && cd build
  • cmake -DCMAKE_BUILD_TYPE=Release …
  • make -j$(nproc)
  • sudo make install
• 验证：
  • compton --version
• 说明：
  • 源码方式可获取最新特性或修复；若遇到缺失依赖，按报错补充对应的 -dev 包再编译。

五 启动与开机自启

• 会话内直接启动（X11）：
  • 简单启动：compton
  • 指定配置：compton --config ~/.config/compton.conf
• 使用 systemd 用户服务（推荐，登录即启动）：
  • 创建服务文件：nano ~/.config/systemd/user/compton.service
  • 写入内容（注意 ExecStart 路径与是否使用 snap）：
    • [Unit] Description=Compton Compositor After=graphical-session.target
    • [Service] ExecStart=/usr/bin/compton --config %h/.config/compton.conf Restart=always Environment=XDG_RUNTIME_DIR=/run/user/%U
    • [Install] WantedBy=graphical-session.target
  • 启用并启动：
    • systemctl --user daemon-reload
    • systemctl --user enable --now compton.service
• 使用 systemd 系统服务（全局，适用于多用户/特定场景）：
  • 创建服务文件：sudo nano /etc/systemd/system/compton.service
  • 写入内容（ExecStart 路径按安装方式选择）：
    • [Unit] Description=Compton Compositor After=graphical.target
    • [Service] ExecStart=/usr/bin/compton --config /etc/compton.conf Restart=always
    • [Install] WantedBy=graphical.target
  • 启用并启动：
    • sudo systemctl daemon-reload
    • sudo systemctl enable --now compton.service
• 重启/热重载：
  • 用户服务：systemctl --user restart compton.service
  • 系统服务：sudo systemctl restart compton.service
• 注意：
  • 仅在 Xorg 会话下使用 Compton；Wayland 会话不支持。
  • 若使用 Snap，请将 ExecStart 改为 /snap/bin/compton；必要时在 service 中设置 XDG_RUNTIME_DIR 与权限。

六 配置文件与常见问题

• 配置文件位置与示例：
  • 位置：用户级 ~/.config/compton.conf；系统级 /etc/compton.conf 或 /etc/xdg/compton.conf
  • 最小可用示例（保存后重启 compton）：
    • backend = “glx”
    • vsync = true
    • shadow = true
    • opacity = 0.9
• 常见问题排查：
  • 启动失败先以终端运行查看报错：compton --config ~/.config/compton.conf
  • 黑屏/撕裂：尝试切换 backend（glx/xrender）、开启/关闭 vsync、更新显卡驱动（如 mesa-utils、nvidia-driver）
  • 阴影异常：调整 shadow-exclude 规则
  • 与桌面环境叠加冲突：在 GNOME/KDE/Xfce 中关闭内置合成器后再启用 Compton
• 说明：
  • 不同桌面/驱动/硬件组合的最佳参数不同，建议小步调整并逐项验证。