CompressO 安装教程与常见问题

这份 CompressO 安装教程覆盖从下载到第一次压缩的全过程,以及三个平台上最容易被卡住的地方——系统拦截提示。文末的 CompressO 常见问题一节,答案均取自项目 README 与更新日志。

最后更新 对应 CompressO 4.2.0,步骤与命令核验自项目仓库

安装前先确认系统版本

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 的故障排查建议。

第一次压缩

首次启动时,应用会解包内置的压缩工具,界面会显示进度。这一步只需做一次,之后所有压缩都在本地完成,不需要联网。

  1. 拖入文件。把视频、图片或音频拖进窗口;也可以拖到 macOS 菜单栏或 Windows 系统托盘的投放区,让它在后台压完。
  2. 设定目标。在「Target Size」里填入目标体积(例如 10 MB),或改用画质模式并调整编码、分辨率、帧率等参数。
  3. 选择保存方式。可设为每次询问、固定保存到某文件夹、保存到原文件旁,或替换原文件。
  4. 对比后保存。压缩完成可对比原件与结果,确认后再写入磁盘。若不满意,视频的多轮尝试结果里可以换一个。

快捷键: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 需重新打开终端后生效。

还没装?先拿安装包

安装包按平台分开展示,版本与 4.2.0 发布资源一致。

安装包来源请以项目 GitHub 发布页为准;本站不提供修改版。

获取 CompressO 安装包

用手机扫描下方任一网盘 App 的二维码获取安装包。两个入口提供的内容一致,任选其一即可。

夸克网盘安装包二维码
夸克网盘App扫码 · 识别
百度网盘安装包二维码
百度网盘App扫码 · 识别

本站不提供直链下载。安装包版本与校验信息请以项目 GitHub 发布页为准;macOS 用户首次打开可能遇到系统拦截提示,处理方法见教程页说明。