CompressO 安装教程与常见问题
这份 CompressO 安装教程覆盖从下载到第一次压缩的全过程,以及三个平台上最容易被卡住的地方——系统拦截提示。文末的 CompressO 常见问题一节,答案均取自项目 README 与更新日志。
安装前先确认系统版本
CompressO 当前稳定版为 4.2.0(2026 年 11 月 14 日发布)。官方站点列出的系统要求如下,低于该版本的系统不在支持范围内。安装包的文件名与体积列在下载中心,可先对照确认下载的是对应平台的包。
- macOS
- macOS 13 或更新版本;提供 Apple Silicon 与 Intel 两种安装包
- Windows
- Windows 10、Windows 11,64 位
- Linux
- 64 位;AppImage 适用于各发行版,deb 面向 Debian 与 Ubuntu 系
安装包体积:Windows 安装程序约 45 MB,macOS 磁盘映像约 49 MB(Apple Silicon)与 56 MB(Intel),Linux deb 约 55 MB,AppImage 约 192 MB。数值取自 4.2.0 版本的发布资源。
Windows 安装
下载 CompressO_4.2.0_x64.exe 后双击运行,按提示完成安装。安装程序会把 compresso 命令行工具一并装入并加入 PATH,因此安装后需要重新打开一个终端窗口才能识别该命令。
遇到 SmartScreen 拦截
首次运行安装程序时,Windows 可能弹出「Microsoft Defender SmartScreen 已阻止无法识别的应用」。这是系统对来源不明的安装程序的常规提醒,在窗口中点击「更多信息」,再选择「仍要运行」即可继续。
macOS 安装
先确认芯片类型:Apple Silicon(M 系列)下载 CompressO_4.2.0_aarch64.dmg,Intel 机型下载 CompressO_4.2.0_x64.dmg。打开磁盘映像后把应用拖入「应用程序」文件夹。
方式一:Homebrew(推荐)
若已安装 Homebrew,可以直接用 cask 安装,这样能避开下面的 Gatekeeper 提示:
brew install --cask codeforreal1/tap/compresso
项目 README 说明,Homebrew 的安装脚本会自动移除 com.apple.quarantine 属性,因此安装后可直接打开。
方式二:手动安装后的拦截提示
CompressO 未经过 Apple 公证(notarization)。手动安装后首次打开,系统可能给出下面两类提示。两种提示本质相同,处理方式也一样。
- 「CompressO」已损坏,无法打开。
- 「CompressO」无法打开,因为无法验证开发者。
打开「终端」,执行以下命令清除隔离属性,然后重新打开应用:
xattr -cr /Applications/CompressO.app
说明:项目 README 明确解释了这一提示的成因——应用未向 Apple 支付年费做公证,因此被 Gatekeeper 拦截;文件本身并未损坏。若你不愿执行该命令,也可以右键点击应用图标选择「打开」来绕过提示。
Linux 安装
两种包按发行版选择:
- deb 包(
CompressO_4.2.0_amd64.deb)适用于 Debian、Ubuntu 等衍生发行版,用系统包管理器安装即可,安装后会同时提供compresso命令行。 - AppImage(
CompressO_4.2.0_amd64.AppImage)为通用包,适用于各发行版,赋予可执行权限后直接运行。
AppImage 启动崩溃或白屏
部分环境下会因渲染后端问题启动失败或显示空白。可尝试设置以下任一环境变量后重新启动:
WEBKIT_DISABLE_DMABUF_RENDERER=1 ./CompressO_4.2.0_amd64.AppImage
若无效,可把变量换成 WEBKIT_DISABLE_COMPOSITING_MODE=1 再试一次。这两种设置来自项目 README 的故障排查建议。
第一次压缩
首次启动时,应用会解包内置的压缩工具,界面会显示进度。这一步只需做一次,之后所有压缩都在本地完成,不需要联网。
- 拖入文件。把视频、图片或音频拖进窗口;也可以拖到 macOS 菜单栏或 Windows 系统托盘的投放区,让它在后台压完。
- 设定目标。在「Target Size」里填入目标体积(例如 10 MB),或改用画质模式并调整编码、分辨率、帧率等参数。
- 选择保存方式。可设为每次询问、固定保存到某文件夹、保存到原文件旁,或替换原文件。
- 对比后保存。压缩完成可对比原件与结果,确认后再写入磁盘。若不满意,视频的多轮尝试结果里可以换一个。
快捷键:Cmd/Ctrl + Shift + Enter 开始或取消压缩,Cmd/Ctrl + Shift + R 重新配置,Cmd/Ctrl + , 打开设置。这些组合来自 4.0.0 的更新日志。
参数怎么调、每种媒体的编码与画质选项有什么区别,在功能与使用场景一页里有逐项说明。
命令行与 MCP
CompressO 附带 compresso 命令,可以用预设与输出设置压缩单个文件、多个文件或整个文件夹。命令的安装位置因平台而异:
- macOS
- 「设置 → CLI → 安装」,或直接运行
/Applications/CompressO.app/Contents/MacOS/compressO并附带参数 - Windows
- 安装程序自动加入 PATH,需重新打开终端
- Linux
- deb 包安装时一并提供;AppImage 版在「设置 → CLI」中安装,或以
CompressO.AppImage --cli方式调用
配合 MCP 使用时,支持 MCP 的 AI 客户端可以通过标准输入输出调用三个工具:compress、list_presets、cancel_compression。配置片段如下:
{ "mcpServers": { "compresso": { "command": "compresso", "args": ["mcp"] } } }
以上命令、工具名与安装路径均来自项目 README 的「CLI & AI agents」一节。
常见问题
CompressO 常见问题
下列 CompressO 常见问题的答案均能在项目 README 或更新日志中找到依据,未确认的内容不作推断。每条都可以单独展开,也可以直接用浏览器的页内查找定位。
macOS 提示「CompressO 已损坏,无法打开」怎么办?
这是 macOS Gatekeeper 对未公证应用的提示,并不代表文件真的损坏。打开「终端」,执行下面的命令清除隔离属性,然后重新打开应用:
xattr -cr /Applications/CompressO.app
通过 Homebrew 安装不会出现该提示,因为安装脚本会自动移除 com.apple.quarantine 属性。
macOS 提示「无法打开,因为无法验证开发者」怎么办?
与上一条本质相同,都是 Gatekeeper 对未公证开发者的提醒。同样执行 xattr -cr /Applications/CompressO.app;也可以右键点击应用图标选择「打开」来绕过该提示。
Windows 提示「SmartScreen 已阻止无法识别的应用」怎么办?
这是 Windows 对来源不明安装程序的常规提醒。在提示窗口中点击「更多信息」,再选择「仍要运行」即可继续安装。
Linux 上 AppImage 启动崩溃或显示白屏怎么办?
尝试在启动时设置环境变量 WEBKIT_DISABLE_DMABUF_RENDERER=1 或 WEBKIT_DISABLE_COMPOSITING_MODE=1。4.1.0 的更新日志还提到修复了新版发行版(如 Ubuntu 26.04、Fedora 44)上因「Could not create default EGL display」导致的启动退出问题,因此也建议先确认所用版本是否为最新。
CompressO 会把我的文件上传到服务器吗?
不会。压缩由内置的第三方工具在本机完成,项目 README 说明应用不发起网络请求,仅在检查内置更新时联网。断网状态下同样可以正常压缩。
CompressO 收费吗?有付费版或功能限制吗?
不收费。项目以 AGPL-3.0 许可证发布,没有需要付费解锁的功能,也没有订阅或试用期限制。官方站点将其描述为「free forever」。
为什么目标体积对某些格式不可用?
GIF 等部分格式的编码方式无法按目标体积精确控制。界面会说明原因,并要求先切换到其他格式或改用画质模式,之后才会开始压缩。
压缩后发现原文件不见了,能恢复吗?
如果启用了「替换原文件」,原文件会被移入系统回收站,可从回收站取回。界面在替换后不再提供重新配置,因此在开启替换前建议先确认压缩效果。
怎么升级到新版本?
到项目发布页下载最新安装包覆盖安装即可。用 Homebrew 安装的 macOS 用户可执行:
brew upgrade --cask codeforreal1/tap/compresso
若提示 It seems the App source '/Applications/CompressO.app' is not there.,先卸载再重新安装:
brew uninstall --cask --force compresso
brew install --cask codeforreal1/tap/compresso
命令行命令怎么安装?
macOS 与 Linux 的 AppImage 版在「设置 → CLI」中点击安装;Windows 安装程序与 Linux 的 deb 包会自动加入 PATH,Windows 需重新打开终端后生效。