Topics

#audit-tool #bash #devops #health-check #html-report #inspection #linux #monitoring #server-monitoring #shell-script #sysadmin #system-administration

Language breakdown

Shell 100.0%

▸ Files click to expand

README

Linux Auto Inspection

Linux Auto Inspection 是一款面向运维与 SRE 的 Linux 服务器一键巡检工具。脚本采用纯 Bash 编写,无需安装任何依赖,可在 CentOS / RHEL / Ubuntu / Debian / Rocky / AlmaLinux / openEuler / Kylin / Anolis 等 30+ 主流发行版上开箱即用。

>

一条命令即可完成系统信息、硬件资源、性能负载、网络状态、磁盘 I/O、服务进程、安全基线、日志异常等多维度巡检,并自动输出一份结构清晰、可直接交付的工程师风格 HTML 报告,告别手工敲命令、复制粘贴拼报告的繁琐流程。

[]()

历史版本

每个版本的详细中文发布说明都在 Releases 页面每个 tag 下面看到。也在仓库 history/ 目录里归档了 markdown 副本。

| 版本 | 日期 | 亮点 | 详细 | |---|---|---|---| | v2.5 | 2026-05-25 | 跨发行版兼容大改 (30+ 发行版) + 修 CentOS 7 CRLF + Rocky 9 pipefail 两个生产事故 + 4 个 helper + NTP/防火墙多源识别 + podman 兼容 | release notes | | v2.4 | 2026-05-10 | HTML 重构 (Token Insight 风) + 提速 60s→8-15s + 总体建议章节 + 命令行参数 | release notes |

完整变更见 CHANGELOG.md。v2.0/v2.1/v2.2/v2.3 早期版本没有单独的 Release tag, 详情都在 CHANGELOG。

为什么用它

写一份脚本 vs 写 10 份脚本: 主流 Linux 发行版的诡异差异 (systemd vs sysvinit, GNU vs busybox, /etc/os-release vs /etc/redhat-release, dmesg vs journalctl, docker vs podman, iostat 装没装) 都被这一个脚本吃下了。

零依赖: 系统自带 bash 4.0+ 就能跑, 不需要装 Python / PowerCLI / pyvmomi / 任何包
跨发行版: RHEL/CentOS/Rocky/Alma/Oracle/Fedora/Amazon/Anolis/openEuler/TencentOS/AliyunLinux/EulerOS/Ubuntu/Debian/Kali/Mint/Pop!_OS/Raspbian/Deepin/SUSE/openSUSE/Kylin/NeoKylin/UOS/Arch/Manjaro/EndeavourOS/Alpine/Gentoo, 30+ 发行版
不假设环境: 没 systemd? 没 iproute2? 没 sysstat? 没 docker? non-root 跑 dmesg? 全部自动 fallback
工程师风: 不要 emoji 装饰、不要营销腔、不要渐变光晕。表格、徽章、颜色码,够用

报告样张

Linux 巡检报告样张

上图为某 Rocky Linux 实测报告的整页截图,工程师风扁平卡片 + 17 章节侧栏导航 + 进度条 + 徽章。HTML 输出可直接在浏览器打开、邮件转发或打印归档。

兼容性矩阵

| 发行版 | 状态 | 备注 | |---|---|---| | RHEL 7/8/9, CentOS 7/8/9, Rocky 8/9, AlmaLinux 8/9 | ✅ 完整支持, 实战测试 | OS_FAMILY=rhel | | Oracle Linux 7/8/9, Fedora 36+, Amazon Linux 2/2023 | ✅ 完整支持 | | | Anolis, openEuler, TencentOS, Alibaba Cloud Linux, EulerOS, Scientific | ✅ 完整支持 | 走 ID_LIKE=rhel | | Ubuntu 18/20/22/24, Debian 10/11/12 | ✅ 完整支持 | OS_FAMILY=debian | | Kali, Mint, Pop!OS, Raspbian, Elementary, Deepin | ✅ 兼容 | 走 IDLIKE=debian | | SUSE Linux Enterprise 12/15, openSUSE Leap 15/Tumbleweed | ✅ 完整支持 | OS_FAMILY=suse | | Kylin V10, NeoKylin | ✅ 完整支持 | OS_FAMILY=kylin | | UOS, Deepin | ✅ 兼容 | OS_FAMILY=uos | | Arch, Manjaro, EndeavourOS, Garuda | ✅ 兼容, 新增 pacman 支持 | OS_FAMILY=arch | | Alpine Linux | ⚠️ 部分兼容 | apk 已集成; busybox grep/awk 个别章节输出退化 | | Gentoo | ⚠️ 未实测 | OS_FAMILY=gentoo; portage 未集成 | | CentOS 6 / RHEL 6 | ⚠️ 部分兼容 | bash 4.1.2 + sysvinit 双轨 fallback 路径已覆盖 | | CentOS 5 / 老版 | ❌ 不支持 | bash 3.x 不支持关联数组 | | WSL1 / WSL2 / 容器 | ⚠️ 部分兼容 | 无 systemd 走 sysvinit, dmesg 走 journalctl |

快速开始

下载方式见最新版本 / 下载。下面是脚本跑起来后的标准输出。

控制台输出示例

==============================================
  Linux Inspection v2.5
  Host: prod-app-01
  Time: 2026-05-25 14:13:10
  Format: html  |  Verbose: off
  Steps: 19
==============================================
[ 1/19] (  5%) 采集基本信息(主机/CPU/内存/网络/虚拟化)...
[ 2/19] ( 10%) 检查 CPU 使用率与负载...
[ 3/19] ( 15%) 检查内存与 Swap...
[ 4/19] ( 21%) 检查磁盘使用率与 Inode...
[ 5/19] ( 26%) 检查磁盘 I/O 性能...
[ 6/19] ( 31%) 扫描大文件 (>+100M / 最近7天>+50M)...
[ 7/19] ( 36%) 检查文件描述符使用...
[ 8/19] ( 42%) 检查网络状态 (网卡/TCP/路由)...
[ 9/19] ( 47%) 检查进程状态 (僵尸/D状态/长运行)...
[10/19] ( 52%) 执行安全检查 (SSH/账户/SUID/登录)...
[11/19] ( 57%) 检查定时任务 (crontab/cron.d)...
[12/19] ( 63%) 检查关键服务状态 (systemctl/service/chkconfig 自适应)...
[13/19] ( 68%) 检查 Docker / Podman 容器...
[14/19] ( 73%) 检查内核参数 (sysctl)...
[15/19] ( 78%) 检查系统更新状态 (包管理器)...
[16/19] ( 84%) 检查系统日志 (异常/OOM/认证)...
[17/19] ( 89%) 检查 NTP 时间同步...
[18/19] ( 94%) 检查 SSL 证书过期...
[19/19] (100%) 生成报告 (html)...
==============================================
  Linux Inspection v2.5 - 巡检完成
  Host: prod-app-01      Steps: 19/19
  Warnings: 2    Critical: 0    Elapsed: 0m12s
  Report: /tmp/inspectreport/inspectprod-app-0120260525141322.html
==============================================

命令行参数

用法: ./linux_inspect.sh [选项]

选项: -o, --output FILE 指定输出文件路径 (默认 /tmp/inspect_report/...) -f, --format FORMAT 输出格式: html (默认) | json -v, --verbose 显示详细 debug 日志 -q, --quiet 静默模式, 只输出报告路径 --no-large-file-scan 跳过大文件扫描 (大磁盘环境提速) --skip-update-check 跳过包管理器更新检查 (内网无外网时用) --skip-ssl-check 跳过 SSL 证书过期检查 --fast 快速模式 (= 上面三个 skip 全开) -h, --help 显示帮助

17 大类检查维度

| # | 维度 | 涉及命令 | |---|---|---| | 1 | 主机基本信息 | hostname / uname / nproc / /proc/cpuinfo / dmidecode | | 2 | CPU 使用率与负载 | /proc/stat / /proc/loadavg | | 3 | 内存与 Swap | /proc/meminfo / free | | 4 | 磁盘使用率 + Inode | df -h / df -i | | 5 | 磁盘 I/O 性能 | iostat (fallback /proc/diskstats) | | 6 | 大文件 TOP N | find + du | | 7 | 文件描述符 | /proc/sys/fs/file-nr | | 8 | 网络 (网卡/TCP/路由) | ip addr / ifconfig / ss / netstat | | 9 | 进程状态 (僵尸/D状态/长运行) | ps | | 10 | 安全检查 (SSH/账户/SUID/登录) | sshd_config / /etc/shadow / find | | 11 | 定时任务 (crontab/cron.d) | crontab / /etc/cron.d/* | | 12 | 关键服务 | systemctl + service + chkconfig 三轨 | | 13 | Docker / Podman 容器 | docker / podman ps / images | | 14 | 内核参数 (sysctl) | sysctl -a | | 15 | 系统更新 (yum/dnf/apt/zypper/pacman/apk) | 多包管理器分发 | | 16 | 系统日志 (异常/OOM/认证) | dmesg / journalctl -k / /var/log/* | | 17 | NTP 时间同步 | chronyc / ntpq / ntpstat / timedatectl / ntpctl | | (+) | SSL 证书过期 | openssl x509 |

兼容性设计 (v2.5 核心改进)

四个 helper 函数

| 函数 | 用途 | 降级路径 | |---|---|---| | detectos() | 多源 OS 识别 | os-release → kylin-release → centos-release → redhat-release → SuSE-release → debianversion → alpine-release → arch-release → gentoo-release → system-release → uname | | safeservicestatus() | 服务状态 | systemctl → service → chkconfig → init.d | | safe_dmesg() | 内核日志 | dmesg → journalctl -k | | detect_timezone() | 时区 | timedatectl → /etc/timezone → readlink /etc/localtime → /etc/sysconfig/clock |

NTP 四套时间源全识别

chronyc tracking ─┐
ntpq -pn         ─┤
ntpstat          ─┼→ 任一返回"已同步"即为正常
timedatectl show ─┤
ntpctl -s status ─┘

防火墙五套并查

firewalld / ufw / nftables / iptables / SuSEfirewall2

每个走 safeservicestatus 双轨; 最后兜底 iptables -L 看有无规则推断。

包管理器扩展

| OS_FAMILY | 包管理器 | |---|---| | rhel | dnf → yum | | debian | apt | | suse | zypper | | arch | pacman (走 checkupdates 不需 root) | | alpine | apk | | kylin / uos | dnf → yum → apt |

IP / 路由命令双轨

| 用途 | 优先 | Fallback | |---|---|---| | IP 获取 | hostname -I | ip addr → ifconfig | | 默认网关 | ip route | netstat -rn → route -n | | 路由表 | ip route | netstat -rn → route -n |

已修复的踩坑 (v2.5)

这里列两个真实生产事故,提醒后来者别再踩

踩坑 1: CRLF 行尾让 bash 突然崩 (CentOS 7 / Rocky)

症状:

linux_inspect.sh: line 1278: syntax error near unexpected token '<'

跑到某个 done < <(...) 紧凑语法时 bash 直接挂。

根因: 文件被 Windows 编辑过, 行尾是 CRLF。bash 把 done\r 当一个命令, 后面的 < 当意外 token。前面 16 步能跑是因为简单命令对 \r 容忍度高。

预防:

v2.5 仓库带 .gitattributes, 锁定 *.sh 为 LF 行尾
客户端兜底: sed -i 's/\r$//' linux_inspect.sh

踩坑 2: `set -o pipefail` + `grep -c ... || echo "0"` 算术崩 (Rocky 9 dnf)

症状:

linux_inspect.sh: line 1841: ((: 158 0: syntax error in expression (error token is "0")

根因:

dnf check-update 有可用更新时故意 exit 100 (不是 0)
set -o pipefail 让整个 pipeline 也返回 100
触发 || echo "0", 但 grep 已经输出了 158, echo 又写一遍
变量值变成 "158\n0" 两行字符串, (( VAR > 0 )) 崩

预防: 所有 || echo "0" → || true, 再加 VAR=${VAR//[^0-9]/}; VAR=${VAR:-0} 双重 sanitize

文件结构

LinuxAutoInspection/
├── linux_inspect.sh                # 主脚本 (2200+ 行, 单文件即用)
├── .gitattributes                  # 锁定 *.sh 为 LF 行尾
├── README.md                       # 本文件
├── CHANGELOG.md                    # 完整版本历史 (v2.0 → v2.5)
├── CONTRIBUTING.md                 # 贡献指南
├── LICENSE                         # MIT
├── docs/
│   └── report-preview.png          # 报告样张
└── history/                        # 历史版本发布说明 + 代码审查归档
    ├── RELEASENOTESv2.5.md       # v2.5 发布说明
    ├── RELEASENOTESv2.4.md       # v2.4 发布说明
    └── linuxinspectscript_analysis.md  # v2.0-v2.3 代码缺陷分析档案