脚本安全说明:为什么不要直接 curl | bash
本站从设计上就不鼓励 curl | bash:脚本页面把完整内容展示出来,下载地址提供 sha256,参数可以先预演。这篇讲清楚管道执行到底危险在哪、本站做了哪些应对、以及你在执行前应该检查什么。
curl | bash 的六类风险
- 内容可变:URL 通常指向“最新版本”,作者随时可以替换内容,你昨天跑的和今天跑的可能是两份代码,而地址没变。
- 执行不完整:下载从中间中断时,管道前半段可能已经执行、后半段没有执行,系统停在一个中间状态,而且没有报错兜底。
- 无法校验:没有哈希或签名,你无法确认拿到的文件就是作者发布的那一份,也无法发现传输过程中被替换。
- 缺少预演:管道模式下没有机会先看脚本会做什么,命令边下载边执行。
- 以 root 静默执行:
sudo bash <(curl ...)把 root 权限交给一段没有读过的代码,执行记录里也留不下可审计的文件。 - 供应链单点:域名、账号、CI 任一环节被攻破,所有使用者会在同一时间中招;脚本越流行,影响面越大。
这六条不是理论风险,它们共同说明一件事:管道执行省掉的不是步骤,而是你判断的依据。
本站的应对
- sha256 端点:
/s/<slug>.sha256给出固定 URL 静态文件的哈希,脚本 banner 里也会打印版本与构建标识,两者可对照。 - 固定 URL + 命令行参数:每个脚本只有一个静态文件
/s/<slug>.sh,版本升级不换地址;参数内置为默认值,可用--key value覆盖,覆盖后仍执行按类型生成的运行期校验(枚举/布尔/整数/端口/路径/URL/主机名),参数值只以单引号变量注入。需要复现时用 banner 里的版本号与构建标识对齐,并记录 sha256。 - 可预演:支持
--dry-run的脚本只打印将要做的改动;危险等级为destructive的脚本必须支持预演,否则构建不通过。 - 退出码约定:
0成功、1通用失败、2用法错误、3环境不符、4需要 root。包装脚本和 CI 能据此判断结果,不用解析输出文本。 - CI 容器矩阵:预设组合会在多个发行版容器里完整执行,验证过的标 🟢,用户自定义参数组合标 🟡,不混淆两者。
- 不做在线执行:站点不托管执行环境,也不收集你的服务器凭据;脚本只在你的机器上运行。
需要说清楚的是:sha256 只证明文件完整,不证明作者可信。本站通过人工审核、公开完整脚本和版本化发布降低风险,但最终仍建议你自己读一遍脚本,尤其是危险等级不是 read 的。
用户侧最小权限与审计清单
-
只读脚本不用 root。以
system-info为例,requiresRoot为false,普通用户执行即可。 -
站点只支持调用(浏览器/wget 会被拒绝);执行前在脚本页面的生成器里通读一遍完整内容:
Terminal window curl -fsSLo system-info.sh "https://linuxmirror.cn/s/system-info.sh"curl -fsSL "https://linuxmirror.cn/s/system-info.sha256"sha256sum system-info.shbash -n system-info.sh -
用
grep -nE 'rm -rf|eval|curl .*-k|setenforce' system-info.sh定位危险命令,并读它们前后的上下文,不要只看关键词。 -
在测试机或快照上先跑;会修改系统的脚本先加
--dry-run。 -
变更类脚本要确认备份路径
/var/backups/linuxmirror/<脚本 ID>/<时间戳>/可读,并知道回滚命令。 -
生产上记录版本号、构建标识与 sha256,出问题能对上当时执行的文件;版本号与构建标识在脚本 banner 的前几行。
-
会改动系统的脚本,先加
--dry-run预演;确需审计时可用curl -sSL "URL" | less在命令行查看(curl 调用被允许)。
发现问题怎么上报
发邮件到 dakerteam@163.com,标题以「[安全] 脚本 slug」开头,附上版本号、构建标识、sha256、复现步骤与影响判断。如果问题可以被利用,请先不要公开细节;我们会核实并修复对应版本,修复后再更新文档说明。