Linux Compton配置如何同步

Linux Compton 配置同步方案

一、同步思路与准备

• 明确同步范围：统一存放一份权威配置（推荐在用户目录的 dotfiles 仓库，如 ~/.dotfiles/compton/compton.conf），各机器以软链接或配置管理工具分发到目标路径 ~/.config/compton.conf。
• 识别差异点：不同机器的 GPU/驱动、刷新率、显示器数量与布局 可能不同，建议将易变的参数抽离为可覆盖的“本地覆盖片段”（如 backend、vsync、shadow-exclude 等），其余保持一致。
• 选择分发方式：手动软链接、Git 子模块/符号链接、或配置管理工具（Ansible/Salt 等）皆可；关键是统一路径与原子化更新。

二、推荐做法 软链接 + 本地覆盖

• 步骤
  1. 在 dotfiles 中维护权威配置：

     mkdir -p ~/.dotfiles/compton
     cp ~/.config/compton.conf ~/.dotfiles/compton/compton.conf
     

  2. 在每台机器上用软链接指向权威配置，并准备本地覆盖片段：

     mkdir -p ~/.config
     ln -sf ~/.dotfiles/compton/compton.conf ~/.config/compton.conf
     mkdir -p ~/.config/compton.d
     # 本地仅放需要差异化的键值，例如：
     cat > ~/.config/compton.d/local.conf <<'EOF'
     backend = "glx"
     vsync = true
     shadow-exclude = [ "name='Conky'" ]
     EOF
     

  3. 在权威配置底部（或在启动命令中）包含本地覆盖，确保“主配置稳定、局部可变”：

     # ~/.dotfiles/compton/compton.conf 末尾追加
     include ~/.config/compton.d/*.conf
     

• 说明
  • 软链接便于“一处维护、处处生效”；本地覆盖避免每台机器都改主配置。
  • 若某台机器没有 X11（如 Wayland 会话），Compton 不会生效，这是预期行为，无需强行同步。

三、按会话与显示管理器的启动同步

• 通用 systemd 用户服务（推荐，用户级、登录即启）
  1. 创建服务文件：~/.config/systemd/user/compton.service

     [Unit]
     Description=Compton Window Compositor
     After=graphical-session.target
     
     [Service]
     Type=simple
     ExecStart=/usr/bin/compton --config %h/.config/compton.conf --log-file /tmp/compton.log
     Restart=on-failure
     Environment=XDG_RUNTIME_DIR=%t
     
     [Install]
     WantedBy=graphical-session.target
     

  2. 启用并立即启动：

     systemctl --user daemon-reload
     systemctl --user enable --now compton.service
     

  3. 如需系统级服务（所有用户），将服务放到 /etc/systemd/system/compton.service，并在 [Unit] 中使用 After=display-manager.service，然后执行：

     sudo systemctl daemon-reload
     sudo systemctl enable --now compton.service
     

• 会话自启动（不使用 systemd 时）
  • 在 ~/.xprofile、~/.xinitrc 或窗口管理器/桌面环境的“启动程序”中添加：

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

• 多显示器提示
  • Compton 本身不负责显示器布局，显示器的连接、扩展/镜像等应由 xrandr 等工具管理；多屏场景下保持各机 xrandr 布局一致，可减少合成器侧的适配工作。

四、批量分发与变更管理

• Git 方式
  • 将 ~/.dotfiles 纳入 Git 管理，各机通过 git pull && ln -sf ... 更新；必要时用 Git 子模块 管理特定机器配置片段。
• 配置管理工具
  • 使用 Ansible/Salt 将主配置分发到 /etc/xdg/compton.conf 或 ~/.config/compton.conf，并在模板中渲染机器差异（如 backend、vsync、shadow-exclude）。
• 原子化与安全更新
  • 先写入临时文件，再 mv 覆盖目标；变更后通过 systemctl --user restart compton 或 killall compton && compton ... & 重启生效。
• 回滚与审计
  • Git 提交历史即回滚路径；为关键机器保留“基线分支/标签”，变更前先在测试机验证。

五、验证与常见问题处理

• 验证运行状态与配置生效

  pgrep -x compton || echo "Compton not running"
  compton --version
  # 查看日志
  tail -n50 /tmp/compton.log
  

• 快速重启与热更新

  # systemd 用户级
  systemctl --user restart compton.service
  # 或手动
  killall compton && compton --config ~/.config/compton.conf &
  

• 常见问题
  • 黑屏/撕裂/卡顿：在本地覆盖中调整 backend（glx/xrender）、vsync（true/false）、shadow/fade 等开关，逐项定位。
  • 多屏异常：确认显示器已由 xrandr 正确设置扩展/主屏；Compton 仅负责合成，不负责布局。
  • 配置不生效：检查是否被其他合成器占用、软链接是否指向正确文件、systemd 服务是否启用并“After=graphical-session.target”。