5 分钟上手:找到脚本、配置参数、安全执行
这篇用一个已上线的只读脚本 system-info,把“找脚本 → 调参数 → 下载校验 → 执行”的流程完整走一遍。给第一次使用本站的人,命令可以直接复制。
第一步:找到脚本
从 脚本库 按分类浏览,system-info 在“系统初始化 → 系统信息”下;也可以直接打开 脚本详情页。先看详情页上的几项元数据:兼容矩阵(发行版、版本与架构)、危险等级(这里是只读)、是否幂等、是否支持 --dry-run,以及当前版本的 sha256。
第二步:选预设,或改参数
生成器把参数做成了表单。system-info 有两个参数:输出格式 format(text 或 json),以及是否包含详细网络信息 detail。页面同时提供三个预设:文本报告、JSON 报告、文本加详细网络。
| 方式 | 参数来源 | 标识 | 适合 |
|---|---|---|---|
| 预设 | 构建期生成并验证 | 🟢 已验证 | 常见场景,直接下载使用 |
| 自定义 | 浏览器即时渲染 | 🟡 未验证 | 需要非默认参数组合 |
选预设就是使用一组经过 CI 完整验证的参数;手动改任一参数,得到的自定义组合标 🟡,表示这组参数未经验证。渲染是即时的:参数一变,页面上的完整脚本立刻更新,可以复制或下载。脚本顶部是 banner,打印脚本 ID、版本、构建标识、生成参数和文档地址;下面是参数变量区,正文只引用变量,不会把参数拼进命令。
需要换格式或加详细网络信息时,回详情页重新生成,不要手工改下载文件里的参数区——改完它就和构建标识、sha256 不对应了。
第三步:使用固定地址
每个脚本只有一条固定地址,版本升级也不会变:
https://linuxmirror.cn/s/system-info.sh:固定地址,永远指向当前版本(默认参数)。- 参数内置为默认值,需要修改时在命令后覆盖:
bash <(curl -sSL "URL") --format json --detail。 - 页面上的「复制调用命令」按钮会直接给出可粘贴的命令。
该地址只支持命令行调用:请用 bash <(curl -sSL "URL") 执行;浏览器直接打开或 wget 下载会被拒绝(HTTP 403)。脚本是静态文件,--help 可看全部参数。
默认值不会写进 URL,所以裸地址就是“默认配置”。脚本 banner 会打印本次实际使用的参数、版本与构建标识。
第四步:先预演
# 只打印将要做的改动,不落盘bash <(curl -sSL "https://linuxmirror.cn/s/system-info.sh") --dry-run第五步:正式执行
bash <(curl -sSL "https://linuxmirror.cn/s/system-info.sh")它不需要 root,会输出一份系统信息报告。需要 root 的脚本会在元数据里标注 requiresRoot,权限不足时以退出码 4 结束。生产使用建议保留下载到的脚本和版本号,出问题时能对上当时执行的内容。
换成会修改系统的脚本时,顺序是:
sudo bash xxx.sh --dry-runsudo bash xxx.sh不要跳过 --dry-run,也不要在生产上直接管道执行。
常见误用
- 用
sudo bash <(curl ...)跳过预演:预演输出就是变更清单,不看等于闭眼改配置。 - 在生产上跳过 dry-run:预演输出就是变更清单,不看等于闭眼改配置。
- URL 和 sha256 用了不同参数:哈希是按参数渲染结果算的,参数不一致必然对不上。
- 无脑加 sudo:只读脚本不需要 root,权限越小越好。
- 把 🟡 当 🟢:自定义参数组合没有经过完整验证,先在测试机上确认。