Rust / 系统课时

检查依赖与安全

检查依赖与安全

本课建立一套可重复执行的 Rust 依赖检查流程:先看清实际依赖树与重复版本,再用策略文件约束许可证和来源,最后扫描已知安全公告,并把结果转化为可处理的工程任务。

学习目标

  • 使用 cargo tree 定位直接依赖、传递依赖和重复版本
  • 使用 cargo-deny 检查许可证、禁用项、来源与安全公告
  • 区分必须修复、需要评估和可以暂时接受的问题

先看清实际依赖图

检查应以 Cargo.lock 解析出的实际版本为准,而不能只阅读 Cargo.toml。cargo tree 展示依赖图,-d 只显示存在多个版本的 crate,-i 则反向追踪“谁引入了它”。Cargo 官方文档也建议用重复版本视图定位旧依赖链。:contentReference[oaicite:0]{index=0}

在工作区根目录执行:

bash
cargo tree
cargo tree -d
cargo tree -i <CRATE>

预期结果:

text
cargo tree       -> 输出完整依赖树
cargo tree -d    -> 输出重复版本及其反向依赖链;没有重复版本时可能无正文输出
cargo tree -i    -> 输出所有依赖 <CRATE> 的路径

<CRATE> 替换为实际包名。发现重复版本后,不要直接删除 Cargo.lock;应先查看上游 crate 是否可升级、是否能统一版本要求,或是否由不必要的 feature 引入。

配置统一的依赖策略

cargo-deny 可以把许可证白名单、重复版本、禁用依赖、注册表来源和公告检查集中到 deny.toml。许可证检查依据项目配置评估每个 crate 的许可证表达式,bans 检查则可发现多版本和被禁止的 crate。:contentReference[oaicite:1]{index=1}

先安装工具并生成配置:

bash
cargo install cargo-deny --locked
cargo deny init

预期结果:

text
Installed package `cargo-deny v<VERSION>`
Created <PATH>/deny.toml

实际版本和路径可能不同。将生成的配置收敛为团队明确接受的规则,例如:

toml
[advisories]
ignore = []

[licenses]
allow = ["MIT", "Apache-2.0", "BSD-3-Clause", "ISC"]
confidence-threshold = 0.8

[bans]
multiple-versions = "warn"
wildcards = "deny"

[sources]
unknown-registry = "deny"
unknown-git = "deny"
allow-registry = ["https://github.com/rust-lang/crates.io-index"]
allow-git = []

这份配置是起点,不是通用答案。许可证白名单必须与项目发布方式和组织合规要求一致;确需例外时,应限定到具体 crate,并记录原因,而不是扩大整个白名单。

执行许可证与安全检查

运行完整策略检查,再用 cargo-audit 对 Cargo.lock 执行一次独立的 RustSec 扫描。cargo audit 的职责是发现 RustSec Advisory Database 中已登记的依赖风险。:contentReference[oaicite:2]{index=2}

bash
cargo deny check bans licenses advisories sources
cargo install cargo-audit --locked
cargo audit

预期结果:

text
cargo deny check -> 各检查项通过,进程退出码为 0
cargo audit      -> 未发现公告命中时报告扫描完成,进程退出码为 0

若命中公告,优先升级直接依赖并重新生成锁文件;若风险来自传递依赖,用 cargo tree -i <CRATE> 找到上游入口。只有确认受影响代码路径未被使用、暂时没有可升级版本并且已有补偿措施时,才可带原因临时忽略公告。

形成可执行的处理顺序

检查结果按风险处理比“看到告警就全部升级”更可靠:

  1. 已知安全漏洞或来源不可信:阻止合并,立即升级、替换或移除。
  2. 许可证不符合发布要求:停止发布,交由项目负责人或合规人员确认。
  3. 重复版本:评估编译时间、二进制体积和维护成本,再决定统一或记录例外。
  4. 未维护公告:确认是否存在替代 crate,并评估迁移成本和暴露面。

在持续集成中,应固定工具安装方式并提交 deny.toml。检查失败必须保留完整诊断,便于从 crate、版本和引入路径直接定位责任依赖。

本课总结

  • cargo tree -d 与 cargo tree -i 分别回答“哪些版本重复”和“谁引入了它”
  • cargo-deny 负责团队策略,cargo-audit 负责已知安全公告扫描
  • 例外必须限定范围、说明原因并设置后续清理条件

下一课预告

下一课将从实现细节转向命令行工具设计,先明确输入、输出、子命令、退出码和异常边界,再开始编码。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

检查依赖与安全

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通