Cap开源录屏工具：5分钟从安装到第一条分享链接
【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap
Cap是一个可自托管的开源录屏工具：支持显示器、窗口、区域三种捕获目标，可叠加摄像头画面，内置完整的时间线编辑器，并提供Instant与Studio两种模式。Instant边录边传，停录后直接得到分享链接；Studio项目保存在本地，可先编辑再分享。本文按使用场景带你走完从安装到首次录屏的完整路径。
适配判断：Cap录屏适合谁、不适合谁
适合
- 想要一个Loom开源替代，录制产品演示、教学、Bug反馈、异步站会的人
- 需要控制数据归属的人：可以只存本地、接入自己的S3兼容存储，或完整自托管
- macOS（Apple Silicon/Intel）、64位Windows、Debian系Linux（x86_64 .deb包）用户
不适合
- 只用手机工作的人：录制以桌面端为主要入口
- 使用非Debian系Linux发行版的人：官方发布目前只提供x86_64 .deb包
- 期望开箱即用全局录制快捷键的人：Cap默认不设置任何录制热键，需自行在 Settings > Shortcuts 中配置
四步完成安装与首次Cap录屏
以下是最短路径，走完即可产出第一条录屏。
- 安装客户端。macOS下载对应芯片的.dmg，把Cap拖入Applications；Windows运行64位.exe安装器；Linux用系统包管理器安装.deb包。
- 授予权限。首次使用时系统会分别请求屏幕录制、麦克风、摄像头权限。macOS可在 系统设置 > 隐私与安全性 中逐项确认。
- 完成第一次录制。选择捕获目标（显示器/窗口/区域）→ 选择摄像头与麦克风，说话确认电平表有反应 → 点击Record，倒计时结束后开始录制，可暂停、恢复或停止 → 停止后Instant产出分享链接，Studio打开本地编辑器。
- （可选）自托管数据。如果需要把完整平台部署到自己的服务器，用Docker Compose启动：
git clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap docker compose up -d启动后Web端运行在 http://localhost:3000 ，未配置邮件时登录链接会打印在服务日志里；桌面端在 Settings > Cap Server URL 指向该地址即可接入。
分场景实操：四类常见录屏任务
Bug反馈与快速沟通：Instant模式
适用情形：只需要一条能立即发出的链接，不需要编辑。
操作步骤：
- 选择Instant模式
- 选目标与麦克风，点击Record
- 停录后Cap继续上传并处理，处理完成后复制链接
- 公开链接在浏览器打开即可观看，无需账号
推荐参数：Bug反馈用720p足够（免费计划下Instant上限为720p）；开启麦克风、关闭摄像头可减小体积。
教学与产品演示：Studio模式
适用情形：需要剪辑、字幕、隐私打码，或导出文件而不是链接。
操作步骤：
- 选择Studio模式录制，停录后自动进入编辑器
- 时间线操作：修剪首尾、拆分、删除、重排；单段可调0.25x至8x速度
- Zoom轨道：1x至4.5x放大，可基于录制的点击数据自动生成缩放段
- Mask轨道：对隐私区域做模糊或马赛克；Highlight类型则压暗全屏、突出所选区域
- Captions：本地转写生成字幕，可烧录进视频或导出SRT/VTT
- 导出MP4（720p/1080p/4K，15/30/60FPS）或生成分享链接
推荐参数：对外演示用1080p/30FPS，存档用4K/60FPS。注意：Studio模式下录制和编辑都不会上传，项目保持本地，直到你主动选择“分享链接”导出。
会议与视频通话记录：摄像头加系统音频
适用情形：需要同时保留双方声音和屏幕内容的通话、评审。
操作步骤：
- 打开摄像头开关：画面以圆形浮窗叠加在屏幕上方，可拖到任意角落、调节大小
- 同时打开麦克风与系统音频，覆盖通话双方声音
- 用显示器或窗口捕获目标，点击Record
推荐参数：外接USB麦克风明显优于内置麦克风；嘴距麦克风15至30厘米；开始前试说一句话，确认电平表响应。
隐私敏感内容：本地加自托管
适用情形：内部资料、不允许进入第三方云端的录制。
关键点：
- Studio模式默认不上传，项目留在本机，先打码再导出
- 存储三选一：保留本地、接入自己的S3兼容存储（R2、B2、MinIO、Wasabi等）、完整自托管
- 自托管对外暴露前，先配置CAP_URL与S3_PUBLIC_URL并替换默认密钥；桌面端通过 Settings > Cap Server URL 指向自托管实例
进阶调优：输出参数、快捷键与开发构建
- 画布与输出：输出比例可选16:9、9:16、1:1、4:3、3:4；背景支持纯色、渐变、图片，可加窗口边框或浏览器外框，源录屏不被修改
- 场景轨道：同一视频内可在屏幕加摄像头、仅摄像头、隐藏摄像头、分屏、悬浮卡片五种布局间切换，各自带进出场时长
- 光标：可显隐、缩放，或渲染为圆形光标，并平滑录制的原始移动轨迹
- 快捷键：默认无录制热键，全局控制需在 Settings > Shortcuts 中自行注册
- 开发构建：仓库是Turborepo monorepo，需要Node.js 20+、pnpm 10.5.2、Rust 1.88+、Docker，本地全栈启动：
pnpm install pnpm env-setup pnpm cap-setup pnpm dev:desktop排障自查：黑屏、无声、摄像头未识别
点录制无反应、无法开始
- macOS确认已开启“屏幕与系统音频录制”权限
- 完全退出并重启Cap
- 确认目标选择中至少存在一个可选的显示器、窗口或区域
录出来是黑屏
- 检查同一项屏幕录制权限与macOS版本，保持Cap与系统为最新
- Windows下更新显卡驱动
- Linux确认PipeWire可用、桌面会话受支持
没有声音
- 说话时观察应用内电平表是否有反应
- 确认麦克风下拉框选择了正确设备
- 检查系统输入未静音、音量合适
- 用另一个应用测试同一麦克风，判断是设备问题还是Cap配置问题
摄像头未识别
- 检查USB连接，换一个端口
- 确认系统摄像头权限已授予
- 关闭其他正在占用摄像头的程序
- 重启Cap刷新设备列表
录成的视频里没有摄像头画面
- 确认摄像头开关处于开启状态
- 确认预览中能看到摄像头画面
- 若摄像头是启动后才接入的，重启Cap
常用命令速查
| 需求 | 命令 |
|---|---|
| 启动完整本地开发栈 | pnpm dev |
| 只启动桌面端 | pnpm dev:desktop |
| 构建桌面端发布包 | pnpm tauri:build |
| 构建整个workspace | pnpm build |
| 运行测试 | pnpm test |
Cap把录屏拆成两种明确的路径：Instant负责最快拿到链接，Studio负责本地编辑后再分享，自托管与自有S3覆盖了对数据归属的要求。下一步建议先用Instant录一条真实Bug反馈，再用Studio做一条带字幕和打码的教程，熟悉后再尝试Docker Compose自托管。
资源链接：
- 快速上手：quickstart.mdx
- 安装与系统权限：installation.mdx
- Instant模式：instant-mode.mdx
- Studio模式：studio-mode.mdx
- 摄像头与麦克风：camera-and-mic.mdx
- 自托管指南：self-hosting.mdx
- 桌面端源码：apps/desktop/，录屏核心Rust模块在 crates/
【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
` 深度解析：Chrome 与 Firefox 默认启动参数是如何组装的)
