Compton在Ubuntu如何启用

在 Ubuntu 上启用 Compton 的完整步骤

一 准备与安装

• 确认会话类型：Compton 是 X11 的窗口合成器，Wayland 会话下通常无法使用。可在登录界面齿轮图标中选择 Ubuntu on Xorg。
• 安装 Compton：

  sudo apt update
  sudo apt install compton
  

• 验证安装：

  compton --version
  

以上步骤适用于 Ubuntu 20.04/22.04/24.04 等常见版本。

二 快速启用

• 直接启动（测试用）：

  compton --config ~/.config/compton.conf &
  

  若没有配置文件，可直接运行 compton 使用默认设置。
• 手动重启/热重载：

  pkill compton
  compton -c ~/.config/compton.conf &
  

• 常用参数说明：
  • -b 后台常驻（守护）
  • -c 指定配置文件
  • --backend=glx 使用 GLX 后端（也可尝试 xrender）
  • --vsync 开启垂直同步
  • -f 前台运行（便于调试）
  • --log-level 与 --log-file 输出日志便于排错 以上命令可直接在终端执行，便于快速验证效果。

三 开机自启动

• 会话级自启（推荐，适用于大多数桌面环境）
  • 创建桌面会话文件 ~/.config/autostart/compton.desktop：

    [Desktop Entry]
    Type=Application
    Exec=compton -b --config ~/.config/compton.conf
    Hidden=false
    NoDisplay=false
    X-GNOME-Autostart-enabled=true
    Name=Compton
    Comment=Lightweight X11 compositor
    

  • 若使用 GNOME Tweak Tool，可在“启动应用程序”中新增上述命令。
• Systemd 用户级服务（可选，适用于无会话自启能力的环境）
  • 创建服务文件 ~/.config/systemd/user/compton.service：

    [Unit]
    Description=Compton Window Composer
    After=graphical-session.target
    
    [Service]
    Type=simple
    ExecStart=/usr/bin/compton -b --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
    

• 系统级服务（不推荐，可能与会话生命周期冲突）

  sudo tee /etc/systemd/system/compton.service >/dev/null <<'EOF'
  [Unit]
  Description=Compton Window Composer
  After=display-manager.service
  
  [Service]
  Type=simple
  ExecStart=/usr/bin/compton -b --config /etc/xdg/compton.conf
  Restart=always
  
  [Install]
  WantedBy=multi-user.target
  EOF
  sudo systemctl daemon-reload
  sudo systemctl enable --now compton.service
  

以上自启方式覆盖会话级与系统级两种常见做法，优先使用会话级或用户级服务以减少与桌面会话的冲突。

四 桌面环境集成要点

• GNOME：GNOME Shell 自带合成器，启用 Compton 可能与内置效果冲突。若确需使用，建议关闭 GNOME 动画/透明特效，并通过 autostart 或用户级 systemd 启动 Compton。
• KDE Plasma：KDE 自带 KWin 合成器。一般不建议替换；若坚持尝试，需在系统设置中关闭 KWin 合成器，再按会话级自启方式启动 Compton。
• Xfce：可在“设置 → 窗口管理器”选择使用自定义合成器，或通过会话自启启动 Compton。
• i3 / Openbox 等窗口管理器：Compton 使用广泛，直接会话级自启即可。 以上集成要点可避免与自带合成器的功能冲突，确保桌面稳定。

五 配置与排错

• 配置文件位置与示例：
  • 推荐路径：~/.config/compton.conf（用户级），或 /etc/xdg/compton.conf（系统级）。
  • 最小可用示例：

    backend = "glx"
    vsync = true
    shadow = true
    fade = true
    unredirect-translucent-windows = true
    
    [shadow]
    shadow-radius = 5
    shadow-offset-x = 1
    shadow-offset-y = 1
    shadow-opacity = 0.3
    
    [blur]
    method = gaussian
    size = 10
    deviation = 5.0
    

• 应用与重启：

  pkill compton
  compton -b --config ~/.config/compton.conf &
  

• 日志与常见问题：
  • 启动时添加日志便于排查：

    compton -b --config ~/.config/compton.conf --log-level=debug --log-file=/tmp/compton.log
    

  • 若出现卡顿、撕裂或黑屏，优先尝试切换后端（glx ↔ xrender）、关闭/开启 vsync、关闭 unredirect-translucent-windows，并确认显卡驱动为最新版本。 以上配置与排错方法覆盖了常用参数、热重载与日志定位，便于快速优化体验。