Asciinema:你的所有操作都将被录制
如何实现类似于Jumpserver koko一样的终端录制回放功能呢?本文介绍一个神器
asciinema是一款开源免费的终端录制工具,它可以将命令行输入输出的任何内容加上时间保存在文件中,同时还提供方法在终端或者web浏览器中进行回放
asciinema的录制和播放都是基于文本的,相比传统的video有很多好处,例如录制文件体积小,在播放的过程中可以暂停复制其中的文本内容等等
同时asciinema还提供了一个网站,你如果愿意还可以将录制的内容上传至asciinema.org进行展示,也可以在这里找到很多有趣的终端录像
asciinema由以下三个子项目构成:
-
asciinema:基于命令行的终端会话记录器
-
asciinema.org:提供API供上传录像和展示的网站
-
javascript player:用于在web上播放录像的js播放器
asciinema的安装和使用都非常简单,一起来看看吧
安装
asciinema为python开发,可以直接通过 apt-get
、 yum
或者 pip
进行安装
# apt-get install asciinema
安装完成后查看版本
# asciinema --version asciinema 2.0.2
asciinema有v1和v2两个版本,差异较大,咖啡君使用了v2,以下所有内容也基于v2演示
asciinema有5个参数,分别为录制: rec
,播放: play
,以文件形式查看录制内容: cat
,上传文件到asciinema.org网站: upload
、asciinema.org账号认证: auth
,本文主要说明 rec
和 play
的使用
录制
# 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
组合键退出录制
播放
# asciinema play ops-coffee.cast
有两个参数可以使用:
-s
后边跟数字,表示用几倍的速度来播放录像
-i
后边跟数字,表示在播放录像时空闲时间的最大秒数
在播放的过程中你可以通过空格来控制暂停或播放,也可以通过 ctrl+c
组合键来退出播放,当你按空格键暂停时,可以通过 .
号来逐帧显示接下来要播放的内容
文件
asciinema推荐的文件后缀是 .cast
,当然linux是不关心文件后缀的,你用什么都可以,推荐按规范使用 .cast
,文件内容大概如下
# cat ops-coffee.cast {"version": 2, "width": 237, "height": 55, "timestamp": 1572646909, "env": {"SHELL": "/bin/bash", "TERM": "linux"}, "title": "ops-coffee"} [0.010014, "o", "root@onlinegame:~# "] [1.296458, "o", "exit"] [1.976439, "o", "\r\n"] [1.976532, "o", "exit\r\n"]
cast文件主要有两部分组成,位于第一行的一个字典,这里叫header
{ "version": 2, "width": 237, "height": 55, "timestamp": 1572646909, "env": { "SHELL": "/bin/bash", "TERM": "linux" }, "title": "ops-coffee" }
header很简单,字段的意思分别为:version版本,width和height分别表示录制窗口的宽高,timestamp录制开始的时间戳,env录制时指定的 -e
参数设置,title录制时指定的 -t
参数设置
接下来的都是固定格式的内容,实际上就是IO流信息
[0.010014, "o", "root@onlinegame:~# "]
每一行都是由三部分组成的一个列表
第一部分为一个浮点数,表示输入输出这一行内容所花的时间
第二部分似乎是一个固定的字符串,没有找到说明做什么用的
第三部分就是具体的输入输出的内容
这个文件格式设计还是非常优雅的,开头header声明,后边具体内容,如果中途因为任何意外导致录像终止,也不会丢失整个录像,而且还可以append增加录像,这在需要长时间暂停录制时非常有用,更重要的是可以流式读取,几乎很少占用内存,不需要把整个录像文件都放在内存中,对长时间的录制播放更友好
自动录制审计日志
如果你有经历过严格的IT审计,或者有用到堡垒机,就会知道操作过程是需要记录并加入审计的,如果你有因为不知道是谁操作了什么导致了数据被删而背锅的经历,就会知道对操作过程的记录有多么的重要,接下来以一个简单的案例来介绍asciinema有什么样的实用价值
如果希望能够将linux服务器上devuser的所有操作过程都记录下来,以备后续审计使用,该如何实现呢?
非常简单,只需要在devuser用户的家目录下添加 .bash_profile
文件即可,内容如下:
$ cat ~/.bash_profile export LC_ALL=en_US.UTF-8 /usr/local/bin/asciinema rec /tmp/$USER-$(date +%Y%m%d%H%M%S).log -q
添加 export LC_ALL=en_US.UTF-8
的原因是有可能系统会报错 asciinema needs a UTF-8 native locale to run. Check the output of locale command.
rec
命令进行录制时添加了 -q
参数,这样在进入或者退出时都不会有任何关于asciinema的提示,使用简单方便
这样devuser用户每次登陆就会自动开启一个录像,如果需要审计或检查操作,只需要回放录像就可以了
你可能会说 history
命令一样可以记录用户操作,asciinema有什么优势呢?asciinema不仅可以记录用户的输入,还可以记录系统的输出,也就是说history只能记录执行的命令,而asciinema还可以记录执行的结果,怎么样,是不是很方便,赶紧试试吧
