Cap 开源录屏完整指南：从安装到分享链接-港品优选

Cap 开源录屏完整指南：从安装到分享链接

【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap

Cap 是一款开源录屏工具，定位是 Loom 的开源替代品：录制屏幕、摄像头和麦克风后，可以一键生成分享链接，也可以留在本地做精细编辑再导出。它提供 Instant（边录边传、停止即得链接）和 Studio（本地录制、事后编辑）两种模式，还支持连接自己的 S3 存储或整套自托管。适合需要频繁做产品演示、Bug 反馈、教程录制，且不想把录屏数据锁在封闭服务里的个人和团队。

两个场景，先看看 Cap 干什么

给同事反馈一个偶发 Bug：切到 Instant 模式，选一个窗口开录，复现问题后停止。Cap 在录制过程中就已完成上传，停止的瞬间拿到一条可分享的链接，贴进工单即可，不用等导出。
录制一段对外产品演示：切到 Studio 模式，录完先打开本地编辑器，处理掉口误（裁剪）、加背景、调整摄像头画中画位置、生成字幕，确认无误后再导出文件或发布分享链接。

两种模式共用同一套目标选择逻辑：选屏幕、窗口、区域或仅摄像头，再决定摄像头、麦克风、系统音频录不录。

安装 Cap 并完成首次启动

两种方式任选：普通用户直接装桌面应用，想从源码跑起来或贡献代码的开发者再走第二条路。

方式一：安装桌面应用（推荐）

平台	安装包
macOS	Apple Silicon / Intel 两个版本的`.dmg`，拖入 Applications 即可
Windows	64 位`.exe`安装包
Linux	x86_64 的`.deb`包（Debian 系发行版）

在官方下载页 cap.so/download 按系统选择安装包。首次打开时操作系统会按需索要权限：macOS 在「系统设置 > 隐私与安全性」中授予屏幕与系统音频录制、麦克风、摄像头；Windows 在「设置 > 隐私」中确认桌面应用可访问摄像头和麦克风。权限是"用到才要"，只授予你要用的设备。

装好后登录账号，先随便录一段 10 秒的测试片段，停止后确认能正常播放，安装就算验证通过。详细步骤可看安装文档。

方式二：从源码构建（开发者）

环境要求：Node.js 20+、pnpm 10.5.2、Rust 1.88+、Docker（本地 MySQL、MinIO 等服务依赖 Docker）。

git clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap pnpm install pnpm env-setup pnpm cap-setup pnpm dev:desktop

pnpm dev会同时拉起 web 端和桌面端的完整本地开发栈，只需要桌面端就用pnpm dev:desktop。构建桌面正式版用pnpm tauri:build。

首次录制三步走

选模式：主窗口右上角切换 Instant（闪电）或 Studio（摄像机）模式，另有一键截图入口。
选目标：Capture 区域选 Display（整屏）、Window（单个应用窗口）、Area（自定义区域）或 Camera Only（仅摄像头）；下方依次开启摄像头、麦克风、系统音频，不需要的项目保持 Off 即可。
点 Start Recording：倒计时结束后开始。

录制期间用浮动控制栏操作：查看已录时长、暂停/继续、重新开始、停止。注意 Cap 默认不设置全局快捷键，如果习惯用键盘控制，先到设置 > Shortcuts 里自己配置，配置方法见快捷键文档。

Instant 模式：停止即得分享链接

Instant 模式在录制过程中分段上传，停止录制后 Cap 做最后的处理并生成分享页面，链接就绪后复制出去即可。公开链接无需账号即可在浏览器播放；私有链接需要授权访问，也可以给链接加密码。

Chrome 用户还可以装 Cap 的浏览器扩展，直接在页面上选择录整个屏幕、当前窗口还是当前标签页，操作与桌面端一致，适合"就录网页里这一块"的场景。扩展入口和页面见 apps/chrome-extension/。

Studio 模式：本地编辑后再导出

Studio 模式把.cap工程保存在本地（macOS 默认在~/Library/Application Support/so.cap.desktop），录完自动打开编辑器，可做的事包括：

裁剪：剪掉开头口误和结尾冗余
背景：更换演示背景，避免暴露无关桌面内容
缩放/光标强调：放大关键区域
字幕：为讲解内容生成字幕
导出：导出为本地视频文件，或转成分享链接发布

需要发布链接时走的是和本地文件相同的上传流程，录屏数据默认在本地，发布时机完全由你决定。

数据放哪：云、自己的 S3、还是自托管

这是 Cap 相比闭源录屏工具的关键差异，四种存储方式按需选：

方式	适用场景
Cap Cloud	开箱即用，最快
连接自己的 S3 兼容存储（AWS S3、R2、B2、MinIO 等）	数据留在自己账号下，分享页仍走托管
仅本地	Studio 模式 + 本地导出，录屏完全不离开设备
全套自托管	用`docker compose up -d`在本机或 VPS 拉起 Web 端、API、数据库和媒体服务，访问`http://localhost:3000`，未配置邮件时登录链接打印在`docker compose logs cap-web`里

自托管后在桌面端设置 > Cap Server URL 填入你的地址即可。S3 配置细节见 s3-config 文档。已有 Loom 存量视频的话，Cap 支持整体迁移，见迁移指南。

进阶：用命令行驱动录制

Cap 桌面端内置了capCLI，与桌面端共享同一二进制，在设置 > Command Line 中安装。所有命令加--json输出机器可读结果，适合脚本和 AI 编码助手调用：

cap doctor --json # 检查权限和采集环境 cap targets --json # 列出可用的屏幕/窗口/摄像头/麦克风 cap record start --screen <id> --detach --json cap record stop --id <recordingId> --json cap export <path.cap> --output out.mp4 --json cap upload out.mp4 --json # 复用桌面端登录态，返回分享链接

完整命令说明在 apps/cli/README.md，cap guide --json可随时拉取完整能力清单。

排错速查 🔍

现象	原因	解决
点了录制没反应 / 画面拿不到	系统录屏权限未授予	macOS 到「系统设置 > 隐私与安全性」开启 Cap 对应权限，Windows 检查「设置 > 隐私」，改完重启 Cap
录出来没有系统声音	系统音频支持依赖系统版本和采集路径	保持 Cap 与操作系统为较新版本；仍不可用时改用麦克风拾音
设备列表里没有麦克风/摄像头	对应设备隐私开关未开	在系统隐私设置中为桌面应用开放麦克风/摄像头
按快捷键无法开始/停止	Cap 出厂不带任何默认快捷键	到设置 > Shortcuts 自行绑定后再使用
Instant 停止后链接没立刻出现	链接需等上传后处理完成	等处理结束再复制链接，见 Instant 模式文档

下一步

到这里你已经能完成"安装 → 录一段 → 拿到链接或导出文件"的完整闭环。接下来建议：

用 Studio 模式把同一内容录一遍，体验裁剪和背景替换对成片质量的影响；
团队使用的话读一遍团队文档，配置空间、评论和查看者分析。

【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析