企业官网建设流程全解析

Cap 开源录屏工具完整上手指南：从本地运行到自建服务器

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

Cap 是一个开源的录屏工具，定位类似 Loom：录制屏幕、摄像头和麦克风，然后生成可分享的链接、导出视频，或者把文件留在本地。它提供即时模式（边录边上传，停止即得链接）和工作室模式（本地录制、进编辑器精修后再导出），并支持把整套服务自托管到自己的服务器上。本文按"先跑起来，再录视频，最后自建环境"的顺序，带你走通开发者和普通用户都能复现的完整路径。

一、在本地跑起 Cap：最短路径是四条命令

这一节解决"如何从零把 Cap 桌面应用跑起来"的问题。Cap 是一个 Turborepo 单仓项目，包含 Rust、TypeScript 和 Tauri 桌面应用，所以环境比一般项目多两样：Rust 工具链和 Docker（用于本地数据库和对象存储）。

环境要求如下：

安装步骤：

1. 克隆代码：git clone https://gitcode.com/GitHub_Trending/cap1/Cap
2. 进入目录并安装前端依赖：cd Cap && pnpm install
3. 生成本地环境配置：pnpm env-setup
4. 安装 FFmpeg 等原生依赖：pnpm cap-setup

pnpm env-setup是一个交互式向导，会询问你要运行哪些应用（桌面端或 Web 端）、是否用 Docker 跑 MySQL 和 MinIO，并在target/env-profiles/下生成对应配置。注意它不是复制.env.example，不要手动建.env文件。

安装完依赖后，只跑桌面应用用pnpm dev:desktop，桌面和 Web 一起跑用pnpm dev（会自动先起 Docker 服务）。桌面应用首次启动会要求授予屏幕录制和麦克风权限，这是系统层面的必要步骤。

二、录制第一条视频：先分清即时模式和工作室模式

这一节解决"开始录制前该选哪个模式"的问题。Cap 的两种模式对应两种完全不同的诉求，选错模式会浪费后面所有步骤。

• 即时模式（Instant Mode）：边录边上传，停止的瞬间就能拿到分享链接。适合 bug 反馈、异步站会、快速演示。
• 工作室模式（Studio Mode）：先在本地完整录制，然后打开内置编辑器，可以调背景、加缩放、裁剪片段、加字幕，最后导出或分享。适合产品演示、教程和交付给客户的内容。

录制开始后，主窗口会自动隐藏，取而代之的是一个悬浮控制条：上面有实时计时器、暂停/继续、重新开始、删除和麦克风指示器。控制条不会出现在画面里，也不需要你切换窗口去操作，这正是它设计为"非激活面板"的原因。

录制引擎本身是 Rust 实现的，屏幕捕获、音频采集、编码和封装分别由 crates/recording/ 下的独立 crate 承担，这也是它能做到低延迟边录边上传的原因。对你来说只需记住一点：工作室模式的产物是一个可编辑的工程，即时模式的产物是一个立刻可用的链接。

三、选对录制目标：显示器、窗口和摄像头叠加

这一节解决"录什么画面、如何把自己也录进去"的问题。Cap 支持四类目标：整个显示器、单个窗口、矩形区域、以及纯摄像头。多显示器环境下，每个屏幕都会出现一个独立的透明选择浮层，光标走到哪个屏幕就在哪个屏幕上点选，选中的窗口可以点一下固定住。

摄像头部分是独立于录制的一个悬浮预览窗：选中摄像头后预览气泡立即弹出，不用等开始录制。预览窗支持圆形、方形、全屏三种形状，可以拖动和缩放，还能开启实时背景虚化。需要注意的是，虚化不会烧录进视频，而是写进工程配置，之后在编辑器里仍然可以调整或关闭，画面始终是原始素材。

如果摄像头只枚举出来但打不开（常见于蓝牙设备切换或系统连续性设备），Cap 会降级为不带麦克风的录制，而不是让录制直接失败，这个行为符合"宁可少一条轨也不要整段作废"的思路。

四、视频存哪里：本地目录、编辑器和浏览器扩展

这一节解决"录完之后的文件在哪、怎么二次处理"的问题。开发模式下，macOS 的录制文件位于~/Library/Application Support/so.cap.desktop.dev/recordings，Windows 位于%programfiles%/so.cap.desktop.dev/recordings。正式发布的安装包使用不带.dev的对应目录。每条录制是一个文件夹，内含recording-meta.json和按片段切分的媒体文件，编辑器直接读这个工程来播放和剪辑。

工作室模式的录制动画完成后会自动进入编辑器：时间线支持裁剪、移动、拆分、删除和撤销，右侧配置栏分六个标签页，颜色、缩放、裁剪等参数都会防抖写回工程文件，关掉再打开不丢状态。

如果你的场景集中在浏览器里，apps/chrome-extension/ 下是一个 Chrome 扩展版本：可以只录当前标签页、整个浏览器窗口、全屏或纯摄像头。扩展走的就是即时模式的逻辑，停止即上传，链接直达你的 Cap 空间。

团队侧的能力都在 Web 端：评论、点赞、观看统计、字幕转写、密码保护分享，以及自动生成的标题、摘要和章节。这些功能对自建实例同样可用，只是 AI 相关项需要配置对应的服务商密钥。

五、自建一套 Cap：Docker Compose 三条命令

这一节解决"数据不想放官方云端怎么办"的问题。Cap 支持四种存储方式：官方托管、接入任意 S3 兼容服务（AWS、R2、MinIO、Wasabi 等）、纯本地存储，以及完整自托管。完整自托管是最彻底的一档，官方给的就是 Docker Compose 一条路：

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

服务起来后在http://localhost:3000可以访问 Web 端。一个容易踩的坑是登录方式：没有配置邮件服务时，登录链接不会发到邮箱，而是打印在服务日志里，用docker compose logs cap-web查看并打开即可。

桌面端指向自建实例只需要一步：打开设置，在Cap Server URL里填入你的服务器地址。生产部署前记得配置公网地址并替换默认密钥，相关环境变量包括CAP_URL和S3_PUBLIC_URL。

六、新手最常卡住的三个问题

这一节集中回答跑起来之后最容易被卡住的几件事，每个都给出验证方式。

macOS 权限给了错误的进程。从终端运行pnpm dev:desktop时，屏幕录制和麦克风权限要授予终端应用（比如 Terminal），而不是 Cap 应用本身。验证方式：开始录制时若画面黑屏或无声，先去系统设置的隐私与安全性里确认权限归属。

首次构建很慢、占空间很大。前端依赖走 pnpm，Rust 侧首次编译需要拉取大量 crate，桌面应用的target/目录可能达到数 GB，首编十几分钟属于正常现象，之后的增量编译很快。如果卡死不动，检查网络而不是强行杀进程。

依赖安装失败。最常见的解法是删掉node_modules后重新pnpm install；Rust 侧编译报错则先执行rustup update对齐工具链版本。Windows 还需要提前装好 llvm、clang 和 VCPKG，macOS 需要 cmake，pnpm cap-setup不会替你装这些。

跑通桌面应用只是起点。下一步建议录一条三十秒的工作室模式视频，走完"进编辑器加一个缩放、导出、拿分享链接给同事看"的完整闭环，把编辑器、导出和分享三条链路都摸一遍。

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