Linux中國

如何在 Linux 中使用 Asciinema 進行錄製和回放終端會話

簡介

Asciinema 是一個輕量並且非常高效的終端會話錄製器。使用它可以錄製、回放和分享 JSON 格式的終端會話記錄。與一些桌面錄製器,比如 Recordmydesktop、Simplescreenrecorder、Vokoscreen 或 Kazam 相比,Asciinema 最主要的優點是,它能夠以通過 ASCII 文本以及 ANSI 轉義碼編碼來錄製所有的標準終端輸入、輸出和錯誤信息。

事實上,即使是很長的終端會話,錄製出的 JSON 格式文件也非常小。另外,JSON 格式使得用戶可以利用簡單的文件轉化器,將輸出的 JSON 格式文件嵌入到 HTML 代碼中,然後分享到公共網站或者使用 asciinema 賬戶分享到 Asciinema.org 。最後,如果你的終端會話中有一些錯誤,並且你還懂一些 ASCI 轉義碼語法,那麼你可以使用任何編輯器來修改你的已錄製終端會話。

難易程度:

很簡單!

標準終端:

  • # - 給定命令需要以 root 用戶許可權運行或者使用 sudo 命令
  • $ - 給定命令以常規許可權用戶運行

從軟體庫安裝

通常, asciinema 可以使用你的發行版的軟體庫進行安裝。但是,如果不可以使用系統的軟體庫進行安裝或者你想安裝最新的版本,那麼,你可以像下面的「從源代碼安裝」部分所描述的那樣,使用 Linuxbrew 包管理器來執行 Asciinema 安裝。

在 Arch Linux 上安裝:

# pacman -S asciinema

在 Debian 上安裝:

# apt install asciinema

在 Ubuntu 上安裝:

$ sudo apt install asciinema

在 Fedora 上安裝:

$ sudo dnf install asciinema

從源代碼安裝

最簡單並且值得推薦的方式是使用 Linuxbrew 包管理器,從源代碼安裝最新版本的 Asciinema 。

前提條件

下面列出的前提條件是安裝 Linuxbrew 和 Asciinema 需要滿足的依賴關係:

  • git
  • gcc
  • make
  • ruby

在安裝 Linuxbrew 之前,請確保上面的這些包都已經安裝在了你的 Linux 系統中。

在 Arch Linux 上安裝 ruby:

# pacman -S git gcc make ruby

在 Debian 上安裝 ruby:

# apt install git gcc make ruby

在 Ubuntu 上安裝 ruby:

$ sudo apt install git gcc make ruby

在 Fedora 上安裝 ruby:

$ sudo dnf install git gcc make ruby

在 CentOS 上安裝 ruby:

# yum install git gcc make ruby

安裝 Linuxbrew

Linuxbrew 包管理器是蘋果的 MacOS 操作系統很受歡迎的 Homebrew 包管理器的一個復刻版本。還沒發布多久,Homebrew 就以容易使用而著稱。如果你想使用 Linuxbrew 來安裝 Asciinema,那麼,請運行下面命令在你的 Linux 版本上安裝 Linuxbrew:

$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Linuxbrew/install/master/install)"

現在,Linuxbrew 已經安裝到了目錄 $HOME/.linuxbrew/ 下。剩下需要做的就是使它成為可執行 PATH 環境變數的一部分。

$ echo 'export PATH="$HOME/.linuxbrew/bin:$PATH"' >>~/.bash_profile
$ . ~/.bash_profile

為了確認 Linuxbrew 是否已經安裝好,你可以使用 brew 命令來查看它的版本:

$ brew --version
Homebrew 1.1.7
Homebrew/homebrew-core (git revision 5229; last commit 2017-02-02)

安裝 Asciinema

安裝好 Linuxbrew 以後,安裝 Asciinema 就變得無比容易了:

$ brew install asciinema

檢查 Asciinema 是否安裝正確:

$ asciinema --version
asciinema 1.3.0

錄製終端會話

經過一番辛苦的安裝工作以後,是時候來干一些有趣的事情了。Asciinema 是一個非常容易使用的軟體。事實上,目前的 1.3 版本只有很少的幾個可用命令行選項,其中一個是 --help

我們首先使用 rec 選項來錄製終端會話。下面的命令將會開始錄製終端會話,之後,你將會有一個選項來丟棄已錄製記錄或者把它上傳到 asciinema.org 網站以便將來參考。

$ asciinema rec

運行上面的命令以後,你會注意到, Asciinema 已經開始錄製終端會話了,你可以按下 CTRL+D 快捷鍵或執行 exit 命令來停止錄製。如果你使用的是 Debian/Ubuntu/Mint Linux 系統,你可以像下面這樣嘗試進行第一次 asciinema 錄製:

$ su
Password:
# apt install sl
# exit
$ sl

一旦輸入最後一個 exit 命令以後,將會詢問你:

$ exit
~ Asciicast recording finished.
~ Press <Enter> to upload, <Ctrl-C> to cancel.

https://asciinema.org/a/7lw94ys68gsgr1yzdtzwijxm4

如果你不想上傳你的私密命令行技巧到 asciinema.org 網站,那麼有一個選項可以把 Asciinema 記錄以 JSON 格式保存為本地文件。比如,下面的 asciinema 記錄將被存為 /tmp/my_rec.json

$ asciinema rec /tmp/my_rec.json

另一個非常有用的 asciinema 特性是時間微調。如果你的鍵盤輸入速度很慢,或者你在進行多任務,輸入命令和執行命令之間的時間會比較長。Asciinema 會記錄你的實時按鍵時間,這意味著每一個停頓都將反映在最終視頻的長度上。可以使用 -w 選項來縮短按鍵的時間間隔。比如,下面的命令將按鍵的時間間隔縮短為 0.2 秒:

$ asciinema rec -w 0.2

回放已錄製終端會話

有兩種方式可以來回放已錄製會話。第一種方式是直接從 asciinema.org 網站上播放終端會話。這意味著,你之前已經把錄製會話上傳到了 asciinema.org 網站,並且需要提供有效鏈接:

$ asciinema play https://asciinema.org/a/7lw94ys68gsgr1yzdtzwijxm4

另外,你也可以使用本地存儲的 JSON 文件:

$ asciinema play /tmp/my_rec.json

如果要使用 wget 命令來下載之前的上傳記錄,只需在鏈接的後面加上 .json

$ wget -q -O steam_locomotive.json https://asciinema.org/a/7lw94ys68gsgr1yzdtzwijxm4.json
$ asciinema play steam_locomotive.json

將視頻嵌入 HTML

最後,asciinema 還帶有一個獨立的 JavaScript 播放器。這意味者你可以很容易的在你的網站上分享終端會話記錄。下面,使用一段簡單的 index.html 代碼來說明這個方法。首先,下載所有必要的東西:

$ cd /tmp/
$ mkdir steam_locomotive
$ cd steam_locomotive/
$ wget -q -O steam_locomotive.json https://asciinema.org/a/7lw94ys68gsgr1yzdtzwijxm4.json
$ wget -q https://github.com/asciinema/asciinema-player/releases/download/v2.4.0/asciinema-player.css
$ wget -q https://github.com/asciinema/asciinema-player/releases/download/v2.4.0/asciinema-player.js

之後,創建一個新的包含下面這些內容的 /tmp/steam_locomotive/index.html 文件:

<html>
<head>
  <link rel="stylesheet" type="text/css" href="./asciinema-player.css" />
</head>
<body>
  <asciinema-player src="./steam_locomotive.json" cols="80" rows="24"></asciinema-player>
  <script src="./asciinema-player.js"></script>
</body>
</html>

完成以後,打開你的網頁瀏覽器,按下 CTRL+O 來打開新創建的 /tmp/steam_locomotive/index.html 文件。

結論

正如前面所說的,使用 asciinema 錄製器來錄製終端會話最主要的優點是它的輸出文件非常小,這使得你的視頻很容易分享出去。上面的例子產生了一個包含 58472 個字元的文件,它是一個只有 58 KB 大 小的 22 秒終端會話視頻。如果我們查看輸出的 JSON 文件,會發現甚至這個數字已經非常大了,這主要是因為一個 「蒸汽機車」 已經跑過了終端。這個長度的正常終端會話一般會產生一個更小的輸出文件。

下次,當你想要在一個論壇上詢問關於 Linux 配置的問題,並且很難描述你的問題的時候,只需運行下面的命令:

$ asciinema rec

然後把最後的鏈接貼到論壇的帖子里。

故障排除

在 UTF-8 環境下運行 asciinema

錯誤信息:

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

解決方法: 生成並導出 UTF-8 語言環境。例如:

$ localedef -c -f UTF-8 -i en_US en_US.UTF-8
$ export LC_ALL=en_US.UTF-8

via: https://linuxconfig.org/record-and-replay-terminal-session-with-asciinema-on-linux

作者:Lubos Rendek 譯者:ucasFL 校對:wxy

本文由 LCTT 原創編譯,Linux中國 榮譽推出


本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive

對這篇文章感覺如何?

太棒了
0
不錯
0
愛死了
0
不太好
0
感覺很糟
0
雨落清風。心向陽

    You may also like

    Leave a reply

    您的電子郵箱地址不會被公開。 必填項已用 * 標註

    此站點使用Akismet來減少垃圾評論。了解我們如何處理您的評論數據

    More in:Linux中國