Asciinema - 录制与回放终端会话

Asciinema 记录终端中的文本输出和时间信息,生成轻量的 .cast 文件。它可以在终端中回放,也可以选择上传或嵌入网页。与 script 相比,它更适合制作可分享的命令行演示。

安装

优先使用操作系统的软件包管理器,并参考官方安装说明确认当前命令:

# Debian、Ubuntu
sudo apt install asciinema

录制

# 开始录制到本地文件
asciinema rec demo.cast

输入 exit 或按 Ctrl+D 结束录制。

也可以只录制一个指定命令:

asciinema rec -c htop demo.cast

本地回放

# 正常速度回放
asciinema play demo.cast
 
# 两倍速度
asciinema play --speed 2 demo.cast
 
# 将较长的空闲间隔限制为 2 秒
asciinema play --idle-time-limit 2 demo.cast

上传与分享

上传是可选操作。本地审查确认无敏感内容后,才执行:

asciinema upload demo.cast

上传后返回的观看链接应先按未公开信息处理,只分享给预期接收者。不要把授权连接地址、安装标识或未审查的录制链接写入公开笔记。

安全检查

  • 录制可能包含输入过的命令、终端输出、用户名、主机名、路径、内部地址和访问令牌。
  • 录制期间不要展示密码、密钥文件、环境变量全集或生产系统敏感数据。
  • 上传前先在本地完整回放,必要时重新录制;不要依赖“链接不公开”代替内容脱敏。
  • 实时直播会立即向观看者传输终端内容,风险高于本地录制,应单独确认访问范围。

参考资料