OSV(Open Source Vulnerabilities)
OSV 是一種開放的漏洞資安公告資料格式,也是一個免費資料庫 OSV.dev,以此格式收集來自 GitHub、PyPI、RustSec、Go、Linux 發行版等來源的開源套件資安公告。
最後更新:2026年11月13日
OSV 是 Open Source Vulnerabilities 的縮寫。這個名稱涵蓋兩件事:OSV schema,一種以受影響套件與版本來描述漏洞的開放 JSON 格式;以及 OSV.dev,一個以該格式收集多方來源資安公告的免費資料庫與 API。CVE 紀錄為漏洞命名,而 OSV 紀錄回答的則是開發者真正會問的問題:我使用的這個套件版本是否受影響?
由誰營運 OSV
Google 於 2021 年 2 月推出 OSV,最初收錄的是其 OSS-Fuzz 模糊測試服務發現的漏洞。這個 schema 如今在 Open Source Security Foundation 的 osv-schema 儲存庫中維護,名為 OpenSSF vulnerability format;資料庫及其基礎架構則以開源形式放在 google/osv.dev。
OSV.dev 的大部分資安公告並非自行撰寫。它彙整以 OSV 格式發布的資料庫,例如 GitHub Advisory Database、PyPI 與 Python Software Foundation 的資料庫、Go Vulnerability Database、RustSec、OpenSSF Malicious Packages、Ubuntu、Red Hat、Chainguard 與 Android。對於 Debian、Alpine,以及 NVD 中關於開源軟體的 CVE,則由 OSV.dev 團隊自行轉換來源資料(資料來源)。
OSV ID 前綴
每筆 OSV 紀錄的 ID 格式為 <DB>-<ENTRYID>,前綴代表發布該紀錄的資料庫。以下是 schema 中定義的部分前綴:
| 前綴 | 資料庫 | 範例 ID |
|---|---|---|
| GHSA | GitHub Advisory Database | GHSA-jfh8-c2jp-5v3q |
| PYSEC | PyPI Vulnerability Database | PYSEC-2021-123 |
| RUSTSEC | RustSec Advisory Database(crates.io) | RUSTSEC-2021-0001 |
| GO | Go Vulnerability Database | GO-2022-0236 |
| MAL | OpenSSF Malicious Packages | MAL-2025-1234 |
| CVE | 由 OSV.dev 轉換的 NVD 紀錄 | CVE-2021-44228 |
| OSV | 由 OSV.dev 分配,目前僅用於 OSS-Fuzz | OSV-2020-111 |
同一個漏洞通常有多筆紀錄,每個來源各一筆。aliases 欄位將它們連結起來:Log4Shell 的 GitHub 資安公告 GHSA-jfh8-c2jp-5v3q 將 CVE-2021-44228 列為別名,讓工具只計算一次。MAL- 紀錄的性質不同:它們描述的是惡意套件,沒有修正版本。
OSV 紀錄長什麼樣子
紀錄的核心是 affected 清單:針對每個套件,列出其生態系、名稱與有漏洞的版本範圍,並以事件標示範圍在何處 introduced(引入)、在何處 fixed(修正)。以下是 GHSA-jfh8-c2jp-5v3q,精簡為其中一個範圍:
{
"schema_version": "1.9.0",
"id": "GHSA-jfh8-c2jp-5v3q",
"aliases": ["CVE-2021-44228"],
"summary": "Remote code injection in Log4j",
"published": "2021-12-10T00:40:56Z",
"affected": [{
"package": {
"ecosystem": "Maven",
"name": "org.apache.logging.log4j:log4j-core",
"purl": "pkg:maven/org.apache.logging.log4j/log4j-core"
},
"ranges": [{
"type": "ECOSYSTEM",
"events": [{ "introduced": "2.13.0" }, { "fixed": "2.15.0" }]
}]
}]
}
範圍可以是 SEMVER、ECOSYSTEM(生態系自身的版本排序方式,例如 PyPI 或 Debian)或 GIT(以提交雜湊值表示)。Git 範圍讓 OSV.dev 能將漏洞對應到完全沒有套件管理工具的 C 與 C++ 程式碼中的提交。
OSV 與 NVD、CVE 的比較
| 問題 | CVE 紀錄 | NVD | OSV |
|---|---|---|---|
| 是什麼 | ID 與簡短紀錄 | 為 CVE 補充資訊的 NIST 資料庫 | 格式加上彙整資料庫 |
| 以什麼識別軟體 | 廠商與產品文字 | CPE 名稱 | 生態系與套件名稱,或 Git 儲存庫 |
| 受影響版本 | 依 CNA 撰寫的內容 | CPE 版本範圍 | 以各生態系自身版本規則表示的機器可讀範圍 |
| 涵蓋沒有 CVE 的資安公告 | 否 | 否 | 是,例如許多 RUSTSEC、PYSEC 與 MAL 紀錄 |
| 最適合 | 為單一漏洞命名 | 商業與閉源產品 | 開源相依套件 |
由於 OSV 以生態系與套件為鍵,它能直接對應鎖定檔,或 SBOM 中元件的套件 URL,不需要費心猜測如何把套件對應到 CPE。它對閉源產品與設備較弱,這些產品沒有套件生態系,而是在 NVD 中描述。
OSV API 與 osv-scanner
位於 https://api.osv.dev 的 API 是免費的,其文件未載明任何使用限制。依套件與版本查詢:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch 可在單一請求中檢查多個套件,/v1/vulns/{id} 則回傳單筆紀錄。整個資料庫也可依生態系下載。
於 2022 年 12 月發表的 OSV-Scanner 是 Google 為該資料庫提供的命令列前端。它可掃描鎖定檔、SBOM、目錄與容器映像檔,並回報相符的 OSV 紀錄。
與 CRACI 的關係
CRACI 會針對每次建置中記錄的元件,顯示每個套件的資安公告,包括其 CVE、GHSA 與其他 ID,以及嚴重程度。關於 SBOM 在任何資料庫能比對之前必須包含哪些內容,請參閱建置時 SBOM。