5 分钟跑通 Cap：从零到第一条可分享的屏幕录制-创锋一号

5 分钟跑通 Cap：从零到第一条可分享的屏幕录制

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

Cap 是一款开源的屏幕录制工具，录屏的思路对标 Loom：选一个区域开始录，录完直接得到一个可分享的链接。它的卖点是把录制、编辑、分享放在一条流程里，同时支持完全自托管，适合需要频繁录制操作演示的开发者、产品经理和教学者。

最快跑起来

如果你只是自己用，去官网下载 macOS 或 Windows 桌面端，装完登录就能录，这是最短路径。

如果你想连 Web 端和存储一起自托管，仓库里已经配好了完整的 Docker Compose（含 MySQL、MinIO 对象存储和媒体处理服务）：

git clone https://gitcode.com/GitHub_Trending/cap1/Cap.git cd Cap docker compose up -d

执行后 Cap Web 会在http://localhost:3000启动，数据库和存储自动初始化，不需要手动配环境变量。

未配置邮件时，首次登录链接会打印在服务日志里：

docker compose logs cap-web

方式	适合谁	耗时
Docker Compose	有 VPS 或家用服务器的人	5~10 分钟
Railway	想一键托管、不想管服务器的人	5 分钟左右
Coolify	已有 PaaS、按团队部署的人（用`docker-compose.coolify.yml`）	10 分钟左右

它到底能做什么

录屏、摄像头、麦克风一起录 📷

选择全屏、窗口或框选区域，同时挑一个摄像头和麦克风。Cap 把各轨道并行录制、合成一段视频：屏幕是主体，摄像头画中画挂在角落，声音走音轨。

两种录制模式

Instant Mode：录制过程中后台上传，一停止就生成可分享链接，适合 bug 反馈、快速沟通。
Studio Mode：先存在本地，录完打开本地编辑器精修，再决定分享还是导出，适合正式教程和演示。

本地编辑器

Studio Mode 录完自动进入编辑器。可以换背景、加缩放、剪掉开头结尾、配字幕，最后导出 MP4 或直接生成分享链接。

分享页自带协作功能

分享链接支持公开或私有、加密码、绑定自己的域名。看的人可以带时间戳留评论，你能看到谁看过、看了多久。

数据放哪你说了算

录制内容可以存 Cap 的云端、你自己的 S3 兼容存储，或完全留在本机；整套服务端也可以自托管，桌面端指向它即可。

跟着做一次

任务：录一段 30 秒的操作演示，发给同事。

启动桌面端并登录或注册账号。预期：主界面出现录制面板，含 Screen / Window 切换。
选择录制范围。预期：系统高亮你选中的区域或目标窗口。
打开麦克风（可选摄像头），确认设备名正确。预期：麦克风指示器显示输入音量。
点击Start Recording。预期：短暂倒计时后开始录制，控制条显示计时。
做你的演示操作，控制在 30 秒内；说错了就停止重录。
点击停止。预期：Instant Mode 几秒内出分享链接；Studio Mode 进入本地编辑器，可先剪辑再发布。
在分享页点 Share 复制链接，发给同事。

做完这一步，你会拿到这条 30 秒录屏的链接，同事用浏览器打开就能直接播放，不需要装任何软件。

按你的场景调参数

教学录屏

参数	建议
模式	Studio Mode，可回炉重剪重导
音频	外接麦克风 + 系统声音都开
摄像头	打开，画中画出镜

避坑提示：正式录制前先试录 10 秒，确认麦克风量和画面稳定；长录之后才发现音量的代价，比多录一遍高。

产品 Demo

参数	建议
模式	Instant Mode，录完马上出链接
范围	窗口录制，只录被演示的应用
分享	私有链接或加密码，别默认公开

避坑提示：Instant Mode 边录边传，网络差会拖慢出链接的速度；弱网环境改走 Studio Mode，录完再传。

代码讲解

参数	建议
模式	Studio Mode，事后剪掉试错过程
范围	区域录制，只框住编辑器
字幕	打开，顺带生成文字稿

避坑提示：不要整屏框选终端加编辑器，区域越窄，观众看到的代码字号越大。

进阶与排障

进阶配置

指向自托管服务器：在Settings > Cap Server URL里把桌面端指向你部署的实例，录制、分享、存储全走你自己的服务器（实现见apps/desktop/src/routes/(window-chrome)/settings/general.tsx）。
自定义快捷键：开始/停止录制、截图等全局快捷键都能在Settings > Shortcuts里改，源码在apps/desktop/src/routes/(window-chrome)/settings/hotkeys.tsx。
从源码本地开发：需要 Node.js 20+、pnpm 10.5.2、Rust 1.88+ 和 Docker。

pnpm install pnpm env-setup pnpm cap-setup

常见问题速查

Q：自托管起来之后怎么登录？未配置邮件时，登录链接会打印在服务日志里，执行docker compose logs cap-web复制即可。

Q：录好的文件存在哪？Studio Mode 存在本地，可编辑可导出；Instant Mode 直接传到你配置的存储（云端或你自己的 S3），返回分享链接。

Q：桌面端连不上自托管服务？检查Settings > Cap Server URL是否指向你的实例（如http://你的服务器:3000），以及对应端口是否放行。

下一步

下载安装 Cap 桌面端，登录并熟悉录制面板
用 Instant Mode 试录一段 30 秒屏幕录制，拿到第一条分享链接
用docker compose up -d自托管一次，把桌面端指到本地实例
翻一遍仓库apps/web/content/docs/里的产品文档；遇到问题就整理复现步骤，提交一个 Issue

第一段 30 秒录屏录完、发出去、对方打开能播，你就可以决定这些录制是继续留在本地，还是把整个团队的存储挪到自己的服务器上。

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

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

企业官网建设流程全解析