标签 asciinema 下的文章

用这个开源的终端会话记录器 Asciinema 来展示终端会话。

title=

支持电话是很重要的，而且最后往往是令人满意的，但明确的沟通行为对每个参与的人来说都是艰巨的。如果你曾经参加过支持电话，你可能会花好几分钟拼出了最短的命令，并详细解释了空格和回车的位置。虽然直接拿过来用户电脑的控制权往往更容易，但这并不是真正的教育的最佳方式。你可以尝试向用户发送一个屏幕记录，而他们可以复制命令并粘贴到自己的终端。

Asciinema 是一个开源的终端会话记录器。与 script 和 scriptreplay 命令类似，Asciinema 准确记录了你的终端显示。它将你的“电影”记录保存到一个文本文件中，然后根据需要进行回放。你可以把你的电影上传到 Asciinema.org，就像你在互联网上分享任何其他视频一样，你甚至可以把你的电影嵌入到网页中。

安装 Asciinema

在 Linux 上，你可以使用你的包管理器安装 Asciinema。

在 Fedora、CentOS、Mageia 或类似系统上：

$ sudo dnf install asciinema

在 Debian、Linux Mint 或类似系统上：

$ sudo apt install asciinema

在 macOS 上，你可以用 Homebrew 安装：

$ sudo brew install asciinema

在 BSD 和任何其它平台上使用 Pkgsrc：

$ cd /usr/pkgsrc/misc/py-asciinema
$ sudo bmake install clean

从文本中制作电影

要用 Asciinema 开始录制，你可以使用 rec 子命令：

$ asciinema rec mymovie.cast
asciinema: recording asciicast to mymovie.cast
asciinema: press <ctrl-d> or type "exit" when you're done

一些友好的输出信息提醒你，你正在录制，并告诉你如何停止：按 Ctrl+D 或直接输入 exit。

当 Asciinema 处于活动状态时，你在终端所做的一切都会被记录下来。这包括输入、输出、错误、尴尬的停顿、错误或成功。如果在录制时，在你的终端中查看它，它就会被剪断。

当你演示完终端如何工作时，按 Ctrl+D 或输入 exit 来停止记录。

在这个例子中，产生的文件 mymovie.cast 是一个时间戳和动作的集合，它用作回放所使用的脚本（像电影脚本一样）。

{"version": 2, "width": 139, "height": 36, "timestamp": 1641457358, "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}}
[0.05351, "o", "\u001b]0;seth:~\u0007"]
[0.05393, "o", "\u001b[1;31m$ \u001b[00m"]
[1.380059, "o", "e"]
[1.443823, "o", "c"]
[1.514674, "o", "h"]
[1.595238, "o", "o"]
[1.789562, "o", " "]
[2.09658, "o", "\""]
[2.19683, "o", "h"]
[2.403994, "o", "e"]
[2.466784, "o", "l"]
[2.711183, "o", "lo"]
[3.120852, "o", "\""]
[3.427886, "o", "
hello
"]
[...]

如果你犯了一个错误，你可以通过删除重现错误的行来去除这个错误。如果你发现自己在录制过程中做了很多命令行修改或冗长的停顿，你可以安装并使用 asciinema-edit 工具，它可以通过你定义的时间戳或消除空闲时间来剪掉这些“镜头”片段。

播放 Asciinema 电影

你可以使用 play 子命令回放你的 Asciinema：

$ asciinema play mymovie.cast

这会接管你的终端会话，并使其成为最接近银幕的形式（除了那次你通过 telnet 观看 ASCII 格式的星球大战）。这个基于文本的电影播放，向你的用户展示了一个复杂的任务是如何完成的。当然，播放的实际命令并不真正执行。这不是一个正在运行的 shell 脚本，所以即使你在电影中创建了一个 hello.txt 文件，在播放后也不会有一个新的 hello.txt。这只是为了展示。

然而，它又不仅仅是一个展示。你可以暂停 Asciinema 电影，选择你在屏幕上看到的文本，并将其粘贴到一个活动终端以运行该命令。Asciinema 是有用的文档。它向用户展示了如何完成一项任务，并允许他们进行复制和粘贴以确保准确性。

上传你的 Asciinema 电影

目前还没有像大片一样的 Asciinema 电影，但你可以把你的电影上传到 Asciinema.org，与全世界分享：

$ asciinema upload mymovie.cast

如果你习惯了 YouTube 上传所花费的时间，你会对 Asciinema 电影的传输速度感到惊喜。一个 .cast 文件通常只有几千字节，最多几兆字节，所以上传几乎是瞬间完成的。你不需要注册账户来分享你的电影，但所有无人认领的电影将在七天后会被删除。为了保存你的杰作，你可以在 Asciinema 上开设一个账户，然后坐等电影学院的电话。

Asciinema 作为文档

Asciinema 是演示最基本概念的好方法。因为它保留了从录制中复制和粘贴代码的能力，提供了按需暂停和播放的能力，并且完全准确地描绘了它的内容，它不仅仅是屏幕录像，它要好得多。无论你是用它来向你的朋友炫耀你的终端技能，还是用它来教育同事和学生，Asciinema 都是一个无价的、社交的、可利用的工具。

via: https://opensource.com/article/22/1/record-terminal-session-asciinema

作者：Seth Kenlon 选题：lujun9972 译者：geekpi 校对：wxy

本文由 LCTT 原创编译，Linux中国荣誉推出

Asciinema：在云端记录并分享你的终端会话

这个众所周知的话题我们早已经写过了足够多的文章。即使这样，我们今天也要去讨论相同的话题。

其他的工具都是在本地运行的，但是 Asciinema 可以以相同的方式在本地和 Web 端运行。我的意思是我们可以在 Web 上分享这个录像。

默认情况下，每个人都更愿意使用 history 命令来回看、调用之前在终端内输入的命令。不过，不行的是，这个命令只展示了我们运行的命令却没有展示这些命令上次运行时的输出。

在 Linux 下有很多的组件来记录终端会话活动。在过去，我们也写了一些组件，不过今天我们依然要讨论这同一类心的工具。

如果你想要使用其他工具来记录你的 Linux 终端会话活动，你可以试试 Script 命令、Terminalizer 工具和 Asciinema 工具。

不过如果你想要找一个 GIF 录制工具，可以试试 Gifine、Kgif 和 Peek。

什么是 Asciinema

asciinema 是一个自由开源的用于录制终端会话并将它们分享到网络上的解决方案。

当你在你的终端内运行 asciinema rec 来启动录像时，你输入命令的时候，终端内的所有输出都会被抓取。

当抓取停止时（通过按下 Ctrl-D 或输出 exit)，抓取的输出将会被上传到 asciinema.org 的网站，并为后续的回放做准备。

Asciinema 项目由多个不同的完整的部分组成，比如 asciinema 命令行工具、asciinema.org API 和 JavaScript 播放器。

Asciinema 的灵感来自于 script 和 scriptreplay 命令。

如何在 Linux 上安装 Asciinema

Asciinema 由 Python 写就，在 Linux 上，推荐使用 pip 安装的方法来安装。

确保你已经在你的系统里安装了 python-pip 包。如果没有，使用下述命令来安装它。

对于 Debian/Ubuntu 用户，使用 Apt 命令或 Apt-Get 命令来安装 pip 包。

$ sudo apt install python-pip

对于 Archlinux 用户，使用 Pacman 命令来安装 pip 包。

$ sudo pacman -S python-pip

对于 Fedora 用户，使用 DNF 命令来安装 pip 包。

$ sudo dnf install python-pip

对于 CentOS/RHEL 用户，使用 YUM 命令来安装 pip 包。

$ sudo yum install python-pip

对于 openSUSE 用户，使用 Zypper 命令来安装 pip 包。

$ sudo zypper install python-pip

最后，运行如下的 pip 命令来在 Linux 上安装 Asciinema 工具。

$ sudo pip3 install asciinema

如何使用 Asciinema 工具来记录你的终端会话

一旦你成功的安装了 Asciinema，只需要运行如下命令来开始录制：

$ asciinema rec 2g-test
asciinema: recording asciicast to 2g-test
asciinema: press "ctrl-d" or type "exit" when you're done

出于测试的目的，运行一些简单的命令，并看一看它是否运行良好。

$ free
              total        used        free      shared  buff/cache   available
Mem:          15867        2783       10537        1264        2546       11510
Swap:         17454           0       17454

$ hostnamectl
   Static hostname: daygeek-Y700
         Icon name: computer-laptop
           Chassis: laptop
        Machine ID: 31bdeb7b833547368d230a2025d475bc
           Boot ID: c84f7e6f39394d1f8fdc4bcaa251aee2
  Operating System: Manjaro Linux
            Kernel: Linux 4.19.8-2-MANJARO
      Architecture: x86-64

$ uname -a
Linux daygeek-Y700 4.19.8-2-MANJARO #1 SMP PREEMPT Sat Dec 8 14:45:36 UTC 2018 x86_64 GNU/Linux

$ lscpu
Architecture:        x86_64
CPU op-mode(s):      32-bit, 64-bit
Byte Order:          Little Endian
Address sizes:       39 bits physical, 48 bits virtual
CPU(s):              8
On-line CPU(s) list: 0-7
Thread(s) per core:  2
Core(s) per socket:  4
Socket(s):           1
NUMA node(s):        1
Vendor ID:           GenuineIntel
CPU family:          6
Model:               94
Model name:          Intel(R) Core(TM) i7-6700HQ CPU @ 2.60GHz
Stepping:            3
CPU MHz:             800.047
CPU max MHz:         3500.0000
CPU min MHz:         800.0000
BogoMIPS:            5186.00
Virtualization:      VT-x
L1d cache:           32K
L1i cache:           32K
L2 cache:            256K
L3 cache:            6144K
NUMA node0 CPU(s):   0-7
Flags:               fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx pdpe1gb rdtscp lm constant_tsc art arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc cpuid aperfmperf tsc_known_freq pni pclmulqdq dtes64 monitor ds_cpl vmx est tm2 ssse3 sdbg fma cx16 xtpr pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand lahf_lm abm 3dnowprefetch cpuid_fault epb invpcid_single pti ssbd ibrs ibpb stibp tpr_shadow vnmi flexpriority ept vpid ept_add fsgsbase tsc_adjust bmi1 hle avx2 smep bmi2 erms invpcid rtm mpx rdseed adx smap clflushopt intel_pt xsaveopt xsavec xgetbv1 xsaves dtherm ida arat pln pts hwp hwp_notify hwp_act_window hwp_epp flush_l1d

当你完成后，简单的按下 CTRL+D 或输入 exit 来退出录制。这个结果将会被保存在同一个目录。

$ exit
exit
asciinema: recording finished
asciinema: asciicast saved to 2g-test

如果你想要保存输出到不同的目录中，就需要提醒 Asciinema 你想要保存文件的目录。

$ asciinema rec /opt/session-record/2g-test1

我们可以使用如下命令来回放录制的会话。

$ asciinema play 2g-test

我们能够以两倍速来回放录制的会话。

$ asciinema play -s 2 2g-test

或者，我们可以以正常速度播放录制的会话，限制空闲时间为 2 秒。

$ asciinema play -i 2 2g-test

如何在网络上分享已经录制的会话

如果你想要分享录制的会话给你的朋友，只要运行下述命令上传你的会话到 asciinema.org，就可以获得一个唯一链接。

它将会在被上传 7 天后被归档。

$ asciinema upload 2g-test
View the recording at:

    https://asciinema.org/a/jdJrxhDLboeyrhzZRHsve0x8i

This installation of asciinema recorder hasn't been linked to any asciinema.org
account. All unclaimed recordings (from unknown installations like this one)
are automatically archived 7 days after upload.

If you want to preserve all recordings made on this machine, connect this
installation with asciinema.org account by opening the following link:

    https://asciinema.org/connect/10cd4f24-45b6-4f64-b737-ae0e5d12baf8

如果你想要分享录制的会话在社交媒体上，只需要点击页面底部的 “Share” 按钮。

如果任何人想要去下载这个录制，只需要点击页面底部的 “Download” 按钮，就可以将其保存在你系统里。

如何管理 asciinema.org 中的录制片段

如果你想要留存所有在这个机器上录制的片段，点击上述显示的链接并使用你在 asciinema.org 的账户登录，然后跟随这个说明继续操作，来将你的机器和该网站连接起来。

https://asciinema.org/connect/10cd4f24-45b6-4f64-b737-ae0e5d12baf8

如果你早已录制了一份，但是你没有在你的 asciinema.org 账户界面看到它，只需要运行 asciinema auth 命令来移动它们。

$ asciinema auth

Open the following URL in a web browser to link your install ID with your asciinema.org user account:

https://asciinema.org/connect/10cd4f24-45b6-4f64-b737-ae0e5d12baf8

This will associate all recordings uploaded from this machine (past and future ones) to your account, and allow you to manage them (change title/theme, delete) at asciinema.org.

如果你想直接上传文件而不是将其保存在本地，直接运行如下命令：

$ asciinema rec
asciinema: recording asciicast to /tmp/tmp6kuh4247-ascii.cast
asciinema: press "ctrl-d" or type "exit" when you're done

出于测试目的，运行下述命令，并看一看它是否运行的很好。

$ free
              total        used        free      shared  buff/cache   available
Mem:          15867        2783       10537        1264        2546       11510
Swap:         17454           0       17454

$ hostnamectl
   Static hostname: daygeek-Y700
         Icon name: computer-laptop
           Chassis: laptop
        Machine ID: 31bdeb7b833547368d230a2025d475bc
           Boot ID: c84f7e6f39394d1f8fdc4bcaa251aee2
  Operating System: Manjaro Linux
            Kernel: Linux 4.19.8-2-MANJARO
      Architecture: x86-64

$ uname -a
Linux daygeek-Y700 4.19.8-2-MANJARO #1 SMP PREEMPT Sat Dec 8 14:45:36 UTC 2018 x86_64 GNU/Linux

如果你完成了，简单的按下 CTRL+D 或输入 exit 来停止录制，然后按下回车来上传文件到 asciinema.org 网站。

这将会花费一些时间来为你的录制生成唯一链接。一旦它完成，你会看到和下面一样的样式：

$ exit
exit
asciinema: recording finished
asciinema: press "enter" to upload to asciinema.org, "ctrl-c" to save locally

View the recording at:

 https://asciinema.org/a/b7bu5OhuCy2vUH7M8RRPjsSxg

via: https://www.2daygeek.com/linux-asciinema-record-your-terminal-sessions-share-them-on-web/

作者：Magesh Maruthamuthu 选题：lujun9972 译者：Bestony 校对：wxy

本文由 LCTT 原创编译，Linux中国荣誉推出