Linux 终端回放神器:如何优雅的使用 Asciinema

系统 Linux
asciinema 是一款开源免费的终端录制工具,它可以将命令行输入输出的任何内容加上时间保存在文件中,同时还提供方法在终端或者web浏览器中进行回放。

 如何实现类似于Jumpserver koko一样的终端录制回放功能呢?本文介绍一个神器。

[[282420]]

asciinema 是一款开源免费的终端录制工具,它可以将命令行输入输出的任何内容加上时间保存在文件中,同时还提供方法在终端或者web浏览器中进行回放。

asciinema的录制和播放都是基于文本的,相比传统的video有很多好处,例如录制文件体积小,在播放的过程中可以暂停复制其中的文本内容等等。同时 asciinema 还提供了一个网站,你如果愿意还可以将录制的内容上传至 asciinema.org 进行展示,也可以在这里找到很多有趣的终端录像。asciinema 由以下三个子项目构成:

  1. asciinema:基于命令行的终端会话记录器
  2. asciinema.org:提供API供上传录像和展示的网站
  3. javascript player:用于在web上播放录像的js播放器

asciinema 的安装和使用都非常简单,一起来看看吧

安装

asciinema 为 python 开发,可以直接通过apt-get、yum或者pip进行安装

  1. # apt-get install asciinema 

安装完成后查看版本

  1. # asciinema --version 
  2. asciinema 2.0.2 

asciinema 有v1和v2两个版本,差异较大,咖啡君使用了v2,以下所有内容也基于v2演示。

asciinema 有5个参数,分别为录制:rec,播放:play,以文件形式查看录制内容:cat,上传文件到 asciinema.org 网站:upload、asciinema.org 账号认证:auth,本文主要说明rec和play的使用。

录制

  1. # asciinema rec ops-coffee.cast 

有几个参数可以使用:

--stdin表示启用标准输入录制,意思是通常情况下linux输入密码类的信息都不会显示,如果开启了这个选项,可以记录键盘输出的密码,但这个功能官方似乎还没有支持,加了后看不到效果。

--append 添加录制到已存在的文件中。

--raw 保存原始STDOUT输出,无需定时信息等。

--overwrite 如果文件已存在,则覆盖。

-c 要记录的命令,默认为$SHELL。

-e 要捕获的环境变量列表,默认为SHELL,TERM。

-t 后跟数字,指定录像的title。

-i 后跟数字,设置录制时记录的最大空闲时间。

-y 所有提示都输入yes

-q 静默模式,加了此参数在进入录制或者退出录制时都没有提示。

输入exit或按ctrl+D组合键退出录制。

播放

  1. # asciinema play ops-coffee.cast 

有两个参数可以使用:

-s 后边跟数字,表示用几倍的速度来播放录像

-i 后边跟数字,表示在播放录像时空闲时间的最大秒数

在播放的过程中你可以通过空格来控制暂停或播放,也可以通过ctrl+c组合键来退出播放,当你按空格键暂停时,可以通过.号来逐帧显示接下来要播放的内容。

文件

asciinema 推荐的文件后缀是.cast,当然linux是不关心文件后缀的,你用什么都可以,推荐按规范使用.cast,文件内容大概如下

  1. # cat ops-coffee.cast 
  2. {"version": 2, "width": 237, "height": 55, "timestamp": 1572646909, "env": {"SHELL""/bin/bash""TERM""linux"}, "title""ops-coffee"
  3. [0.010014, "o""root@onlinegame:~# "
  4. [1.296458, "o""exit"
  5. [1.976439, "o""\r\n"
  6. [1.976532, "o""exit\r\n"

cast 文件主要有两部分组成,位于第一行的一个字典,这里叫 header

  1.     "version": 2, 
  2.     "width": 237, 
  3.     "height": 55, 
  4.     "timestamp": 1572646909, 
  5.     "env": { 
  6.         "SHELL""/bin/bash"
  7.         "TERM""linux" 
  8.     }, 
  9.     "title""ops-coffee" 

header很简单,字段的意思分别为:version版本,width和height分别表示录制窗口的宽高,timestamp录制开始的时间戳,env录制时指定的-e参数设置,title录制时指定的-t参数设置。

接下来的都是固定格式的内容,实际上就是IO流信息

  1. [0.010014, "o""root@onlinegame:~# "

每一行都是由三部分组成的一个列表

  • 第一部分为一个浮点数,表示输入输出这一行内容所花的时间
  • 第二部分似乎是一个固定的字符串,没有找到说明做什么用的
  • 第三部分就是具体的输入输出的内容

这个文件格式设计还是非常优雅的,开头 header 声明,后边具体内容,如果中途因为任何意外导致录像终止,也不会丢失整个录像,而且还可以 append 增加录像,这在需要长时间暂停录制时非常有用,更重要的是可以流式读取,几乎很少占用内存,不需要把整个录像文件都放在内存中,对长时间的录制播放更友好。

自动录制审计日志

如果你有经历过严格的IT审计,或者有用到堡垒机,就会知道操作过程是需要记录并加入审计的,如果你有因为不知道是谁操作了什么导致了数据被删而背锅的经历,就会知道对操作过程的记录有多么的重要,接下来以一个简单的案例来介绍asciinema有什么样的实用价值。

非常简单,只需要在 devuser 用户的家目录下添加.bash_profile文件即可,内容如下:

  1. $ cat ~/.bash_profile 
  2. export LC_ALL=en_US.UTF-8 
  3. /usr/local/bin/asciinema rec /tmp/$USER-$(date +%Y%m%d%H%M%S).log -q 

添加export LC_ALL=en_US.UTF-8的原因是有可能系统会报错:

  1. asciinema needs a UTF-8 native locale to run. Check the output of locale command. 

rec命令进行录制时添加了-q 参数,这样在进入或者退出时都不会有任何关于 asciinema 的提示,使用简单方便。

这样 devuser 用户每次登陆就会自动开启一个录像,如果需要审计或检查操作,只需要回放录像就可以了。

你可能会说history命令一样可以记录用户操作,asciinema 有什么优势呢?asciinema 不仅可以记录用户的输入,还可以记录系统的输出,也就是说history只能记录执行的命令,而 asciinema 还可以记录执行的结果,怎么样,是不是很方便,赶紧试试吧。

责任编辑:武晓燕 来源: 运维咖啡吧
相关推荐

2017-05-19 13:19:16

LinuxAsciinema终端会话

2022-07-27 11:46:35

Asciinema日志工具

2022-01-27 15:37:34

Asciinema终端会话记录器开源

2014-05-12 10:57:41

TermRecord终端会话

2015-11-26 10:53:45

LinuxWindowsMac OS

2017-07-26 11:32:50

NETRabbitMQ系统集成

2021-06-02 11:41:54

LinuxTmux命令

2022-06-19 14:23:56

Linux

2023-06-16 09:08:39

ReactContextRFC

2022-04-29 09:10:25

MobaXterm软件Linux

2022-09-01 13:12:53

LinuxTC网络限流

2022-10-08 06:43:15

Linux系统终端

2021-03-28 09:17:18

JVM场景钩子函数

2022-09-14 08:16:48

装饰器模式对象

2018-04-19 09:23:07

Linux网速测试命令行工具

2022-06-02 10:02:47

Kubectl更新应用Linux

2023-06-28 08:25:14

事务SQL语句

2022-10-27 11:23:26

GoFrame共享变量

2014-04-18 13:28:55

Windows终端Linux

2019-09-08 10:24:48

Linux颜色主题终端主题
点赞
收藏

51CTO技术栈公众号