面向 Linux 的 CyberPatriot 加固工具:一个 Bash 框架,可在限时回合中执行加固流程中可脚本化的部分。它会记录每一处更改,并在编辑每个文件之前对其进行备份。需要人工判断的决策仍由操作员负责。
由 Andrew Melek 为 Lakeside High School CyberPatriot 团队构建。
CI 会在 Ubuntu 24.04 上运行 ShellCheck 和 27 个 bats 测试,并在 Ubuntu 22.04 和 24.04 上运行 dry-run 检查。
这是在 Ubuntu 24.04 容器中执行 make dry-run 的真实输出(已精简)。该片段也位于 docs/media/cphlf-demo.mp4。
[!warning] 实际运行会清除软件包、重置你审查过的账户密码,并重写 sshd_config、PAM 和防火墙规则。请在竞赛镜像或一次性虚拟机上使用,并从
--dry-run开始。
你需要 Docker 和 make。每个目标都会启动一个一次性的 --rm 容器,并以只读方式挂载仓库,因此脚本绝不会在你的机器上运行。
git clone https://gitlab.com/WhereIsXuezugi/cphlf.git
cd cphlf
make dry-run IMAGE=ubuntu:24.04
[00:00] INFO === harden.sh starting on Ubuntu 24.04 ===
[00:00] INFO DRY-RUN MODE: no changes will be made
[...]
[00:01] INFO DRY-RUN: default deny incoming -- would execute: ufw default deny incoming
[00:01] INFO DRY-RUN: default allow outgoing -- would execute: ufw default allow outgoing
[...]
[00:01] INFO === Hardening run complete ===
[...]
check: harden.sh exit 0, stderr empty
check: files changed in /etc /home /usr /var /root: 1
check: /root/hardening-run/harden.log
check: a config with DRY_RUN=0 still dry-runs
check: passed
检查会在运行前后记录 /etc、/home、/usr、/var 和 /root 下每个文件的 sha256 校验和、权限模式和所有者(跳过 /var/cache 和 /var/log)。如果脚本以非零状态退出、写入 stderr,或更改了 /root/hardening-run 之外的任何内容,则检查失败。第二轮使用设置了 DRY_RUN=0 的配置,并检查该标志是否仍然优先生效。
目标为 Ubuntu 22.04 和 24.04(apt、ufw、PAM)。
cp examples/config.env.example my-machine.env
sudo ./bin/harden.sh --config my-machine.env --dry-run
sudo ./bin/harden.sh --config my-machine.env --auto-approve
首先在你的副本中设置 WANT_* 角色答案和 HARDEN_DEFAULT_PASSWORD。examples/config.env.example 列出了所有变量。
| 标志 | 作用 |
|---|---|
--dry-run | 记录每条命令而不执行。仅写入 /root/hardening-run 下。 |
--auto-approve | 不经询问直接清除已审查的双用途和遗留软件包。 |
--config FILE | 预设角色答案。Root 会将该文件作为 shell 代码加载。 |
命令行上的标志优先于配置文件。以下步骤仍会提示:账户审查、新建账户、每个已审查账户的密码、介质清扫以及重启。在 stdin 关闭(</dev/null)的情况下,每一步都采用其默认值:不审查任何账户、不删除任何介质、不重启。
输出写入 /root/hardening-run:harden.log(每次运行追加)、backups/ 和 baseline/(每次运行覆盖)。设置 HARDEN_STATE_DIR 可更改位置。
flowchart LR
cli["bin/harden.sh<br/>flags, config, role answers"] --> mods["lib/*.sh<br/>10 modules in a fixed order"]
mods -->|commands| run["run()<br/>dry run: log it<br/>real run: execute, WARN on failure"]
mods -->|file edits| guard["DRY_RUN check<br/>backup_file first"]
run --> state["/root/hardening-run<br/>log, backups, baseline"]
guard --> state
命令通过 lib/common.sh 中的 run() 执行。失败的命令会记录为 WARN,然后继续运行。不是单条命令的文件编辑会检查同一个 DRY_RUN 标志,并先备份文件。ensure_line_in_file 和 ensure_block_in_file 会阻止第二次运行添加重复行。已审查的密码会在每次运行时重新设置。
| 模块 | 功能 |
|---|---|
packages.sh | 更新系统,运行 autoremove,并将 apt 设置为每日更新。移除 18 个攻击性工具和 7 个游戏。在清除 12 个双用途工具和 14 个遗留服务前询问,默认保留。 |
firewall.sh | ufw:默认拒绝入站,允许出站,启用。 |
ssh.sh | 将 sshd_config 写入临时文件,用 sshd -t 检查,然后移入。禁止 root 登录,3 次认证尝试,chacha20-poly1305、AES-GCM 和 AES-CTR 加密算法,保留 sftp。 |
services.sh | 按角色为 8 个服务配置防火墙规则。角色关闭时清除 Samba、vsftpd、telnetd、MySQL、Apache 和 BIND。角色开启时安装 Samba 并保留共享供你审查,同时安装并加固 vsftpd、MySQL 和 Apache。邮件和打印仅配置端口规则。 |
users.sh | 审查你指定的账户:删除、管理员权限、密码重置和 90/1/7 天老化。创建新账户。锁定额外 UID 0 账户和空密码账户的密码。 |
kernel.sh | 在一个标记块中设置 24 个 sysctl 键:15 个 IPv4 网络键和 9 个内核与文件系统键。仅在 DISABLE_IPV6=yes 时关闭 IPv6。 |
pam.sh | 密码质量(12 个字符,全部 4 类)、5 次历史记录、在标准 common-auth 布局下 5 次失败后锁定 30 分钟,以及 login.defs 的 90/1/7 天老化。还包含 kernel_login_defs。 |
filesystem.sh | 设置 shadow、passwd、group、主目录和 /root 的权限。仅 root 可用的 cron 和 at、登录横幅、重置现有的 rc.local。可选:关闭 USB、FireWire 和 Thunderbolt 存储,并扫描 /home 下的媒体文件。写入 SUID、全局可写、无属主和 PHP 文件列表。 |
monitoring.sh | 安装 fail2ban、auditd(发行版默认规则)、rkhunter 和 chkrootkit,不安装推荐包。ClamAV 和 rootkit 扫描为可选。 |
forensics.sh | 在运行结束时保存 11 个基线文件:系统信息、用户、组、最后登录、进程、服务、监听端口、已安装和手动安装的包、防火墙状态和 sshd_config。 |
tools/ 有两个辅助脚本:find-port-owner.sh 显示端口上的进程,list-nonstandard-users.sh 列出你未预期的账户。
| 决策 | 默认值 | 原因 |
|---|---|---|
| SSH 密码登录 | 开启(SSH_PASSWORD_AUTH=yes) | 没有 SSH 密钥的团队仍保留进入方式。密钥就位后将其关闭。 |
| 删除账户 | 询问,默认否 | 错误的删除无法撤销。你自己的账户永远不会被删除、降权或重置。 |
| 账户密码 | 重置为 HARDEN_DEFAULT_PASSWORD | 仓库中的值是占位符,使用时会记录警告。请设置你自己的值。 |
| 双用途和遗留包 | 询问,默认保留 | nmap 或 telnet 服务器可能是机器角色的一部分。 |
| 媒体扫描 | 除非 ALLOW_MEDIA_FILES=no 且你输入 DELETE,否则关闭 | 它会删除 /home 下的图像、音频和视频文件。它会先打印数量。 |
| 账户锁定 | 5 次失败,30 分钟 | 队友也可能把自己锁在外面。root 不会被锁定。 |
| ClamAV 和 rootkit 扫描 | 关闭(INSTALL_CLAMAV、RUN_BASELINE_SCAN) | 它们很慢。在轮次允许时运行它们。 |
| IPv6 | 保持开启(DISABLE_IPV6=no) | 仅当你的检查清单要求时才关闭。 |
| GRUB 密码 | 不自动化 | 错误可能导致机器无法启动。 |
入站流量默认拒绝,并为你选择的角色添加允许规则。如果镜像向评分代理报告,请在加固前运行 sudo ss -tulpn,并检查加固后它仍能连接。
.gitlab-ci.yml 运行三个作业,每个作业都在容器中执行:style 级别的 ShellCheck、tests/ 中的 27 个 bats 测试,以及在 Ubuntu 22.04 和 24.04 上的 dry-run 检查。PAM 测试使用 pamtester 登录,以验证正确的密码仍然有效,并验证五次错误密码会锁定账户。其余测试覆盖 run()、重复编辑、备份、配置解析、SSH 允许列表、账户审查、MySQL 清理以及这两个工具。本地运行:
make lint
make test
make dry-run IMAGE=ubuntu:22.04
在容器外,测试会被跳过,dry-run 脚本会以错误退出。如果有任何测试被跳过,CI 就会失败。CONTRIBUTING.md 中列出了变更规则。
模块头部和 docs/security-controls.md 按章节引用了 CIS Ubuntu Linux Benchmark 以及 11 项 NIST SP 800-53 Rev. 5 基础控制项,并说明了每项选择背后的理由。
baseline/ 以供审查。lib/packages.sh 中的某个列表里,或者属于你已关闭的角色。我以 Lakeside High School CyberPatriot 项目主席兼首席研究员的身份构建了这套工具,自 2024 年起担任该职务。这套工具包将我们团队的修复时间缩短了 40%。我带领两支队伍进入半决赛,我们团队在 Linux 组别中从 3,000 多支队伍中跻身前 5。我已培训了 20 多名成员。更多信息见 whereisxuezugi.gitlab.io/amelek。
MIT。见 LICENSE。