系统管理员手册

系统管理员手册 v2.0.0 — 一套面向系统管理员的全面系统运维工具包。从命令行记录、追踪和管理系统管理的各个方面。所有操作均带时间戳，并在本地完整日志化，确保全程可审计。

为何选择系统管理员手册？

• 完全离线运行 — 您的数据永不离开您的机器
• 简洁的命令行接口，无需图形界面（GUI）
• 每次操作均自动添加时间戳并记录日志
• 随时导出为 JSON、CSV 或纯文本格式
• 自动记录历史操作与活动轨迹
• 支持跨所有操作类型进行关键词检索

快速开始

# 查看所有可用命令
sysadmin-handbook help

# 检查当前健康状态
sysadmin-handbook status

# 查看汇总统计信息
sysadmin-handbook stats

命令列表

操作类命令

每个命令均支持两种模式：不带参数运行时查看最近的若干条记录；传入参数时则记录一条新条目。

工具类命令

数据存储

所有数据均本地存储于 ~/.local/share/sysadmin-handbook/ 目录下。目录结构如下：

• scan.log、monitor.log、report.log 等 — 每个命令对应一个独立日志文件，采用管道符分隔（timestamp|value）
• history.log — 所有命令统一汇聚的活动日志
• export.json / export.csv / export.txt — 导出生成的文件

每条日志记录格式为 YYYY-MM-DD HH:MM|。您可随时使用 export 命令备份全部数据。

运行要求

• Bash 4+（使用 set -euo pipefail）
• 标准 Unix 工具（date、wc、du、tail、grep、sed、cat）
• 无需任何外部依赖，亦无需联网

适用场景

1. 事件响应追踪 — 在活跃事件处理期间记录扫描结果、告警及修复动作，为事后复盘提供完整时间线
2. 日常运维日志化 — 在执行系统管理员例行任务过程中，同步记录监控观测、健康检查与清理任务
3. 备份与恢复审计 — 对每次备份与恢复操作打上时间戳并记录，以满足合规性要求或辅助故障诊断
4. 性能基准测试 — 长期保存基准测试结果，并利用 compare 命令跟踪各次部署间的性能退化或改进趋势
5. 团队交接文档化 — 在当班期间详尽记录所有操作，使接班管理员可通过 recent 或 search 快速掌握当前系统状态

使用示例

# 记录一次网络扫描结果
sysadmin-handbook scan "192.168.1.0/24 — 14 hosts up, 3 with open SSH"

# 记录一条监控观测
sysadmin-handbook monitor "web-prod-01 CPU at 92% for 15 minutes"

# 记录一项已实施的修复
sysadmin-handbook fix "Increased nginx worker_connections from 1024 to 4096"

# 追踪一次备份操作
sysadmin-handbook backup "Full backup of /data completed — 48GB, 23 min"

# 将全部数据导出为 JSON 归档
sysadmin-handbook export json

# 在全部日志中搜索关键词
sysadmin-handbook search "nginx"

# 查看所有命令的最近活动记录
sysadmin-handbook recent

输出说明

所有命令均输出至标准输出（stdout）。如需保存到文件，请使用重定向：

sysadmin-handbook stats > report.txt
sysadmin-handbook export csv

配置方式

设置环境变量 SYSADMIN_HANDBOOK_DIR 可覆盖默认数据目录（~/.local/share/sysadmin-handbook/）。

由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com