公开记录
软件健康报告模式 0.34.0 · 指标 2.10.0 · 2026-10-10 15:21 UTC

Guard-Core / fastapi-guard

A security library for FastAPI that provides middleware to control IPs, log requests, detect penetration attempts, honeypot setup, behavioural analysis, emergency mode lockdown, block Cloud Provider IPs, country blocking, and much more... It integrates seamlessly with FastAPI to offer robust protection against various security threats.

PythonMIT★ 824 星标⑂ 47 复刻始于 2024年8月在 GitHub 上查看 ↗
类型库网络服务如何判定
#api#security#fastapi#ip#middleware#python#rest

Guard-Core/fastapi-guard 的健康指数为 100 分中的 94 分，处于「卓越」区间。 其得分最高的类别是Engineering Quality（96/100），最低的是Sustainability & Governance（65/100）。 最近一次更新在今天。 近期的大部分工作由 1 位贡献者完成。

94
总分 / 100
卓越

软件健康指数

指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均，再依据公开记录的分布进行校准，使各等级具有百分位含义；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 34（存在风险）的上限。

94
卓越93-100公开记录中的最高层级（约前 5%）；基本满足所有检验标准
优秀80-92各方面均表现强劲；仅有少量不足
良好65-79健康；不足之处有限且可控
中等50-64可接受，但存在明显不足；建议进行审查
薄弱35-49多个领域存在实质性薄弱环节
存在风险20-34存在重大薄弱环节；采用时应保持审慎
危急1-19问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
活力社区与采用可持续性与治理工程质量安全AI 就绪度

评分画像

每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。

加权总体分 80 经校准后在公布的指数量表上为 94（记录校准 2026-08-02）。

所有权

Guard Core组织 · 域名已验证
3 关注者34 个公开仓库始于 2026年6月

该仓库由组织支持——共同承担、可问责的托管责任，可延续于任何单一维护者之后。

软件包生态系统

注册表软件包版本月下载量版本数最近发布标签
PyPIfastapi_guard8.1.062,187620 天前api-securityfastapiip-filteringmiddlewarepenetration-detectionrate-limitingsecuritywaf

按类别列示的指标

活力

项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？

91优秀 · 占总体的 21%

开发活跃度

85优秀
评分方式
36/36推送新近度 — 最近一次推送于 0 天前
20.8/36提交节奏 — 52 周中有 30 周有提交
18/18提交量 — 最近一年 176 次提交
10/10OpenSSF Scorecard：Maintained — 30 commit(s) and 11 issue activity found in the last 90 days -- score normalized to 10
所用输入
commits_last_year176
human_commit_share0.92
days_since_last_push0
active_weeks_last_year30

发布纪律

100卓越
评分方式
27/27有发布版本 — 已发布 64 个发布版本
36/36发布时效 — 最近一次发布版本于 0 天前
27/27发布节奏 — 约每 6.4 天发布一次
0/10OpenSSF Scorecard：Signed-Releases — 无数据
所用输入
releases_count64
latest_release_tagv8.1.0
releases_from_tags否
days_since_latest_release0
mean_days_between_releases6.4
已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。 其余权重已重新归一化。

社区与采用

项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？

78良好 · 占总体的 17%

流行度与采用

64中等
评分方式
47.3/60星标 — 824 个星标
13.9/25复刻 — 47 个复刻
2.7/15关注者 — 4 位关注者
所用输入
forks47
stars824
watchers4
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

社区健康

92优秀
评分方式
22.5/22.5README
22.5/22.5许可证 — 可识别的许可证（MIT）
18/18CONTRIBUTING 指南
13.5/13.5行为准则
0/7.2议题模板
6.3/6.3PR 模板
所用输入
has_readme是
has_license是
readme_badges38
has_contributing是
has_issue_template否
has_code_of_conduct是
readme_badge_servicesbadge.fury.io, github.com, shields.io
has_pull_request_template是

生态采用（下载量）

80优秀
评分方式
63.9/80月度下载量 — pypi 合计每月 62,187 次下载
0/20注册表被依赖数 — 该生态系统不报告此项
所用输入
packagesfastapi_guard
dependents—
ecosystemspypi
total_downloads—
monthly_downloads62,187
unverified_packages_excluded—
已排除计分（无数据或不适用）：注册表被依赖数。 其余权重已重新归一化。

可持续性与治理

项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？

65良好 · 占总体的 23%

维护者韧性（巴士系数）

29存在风险
评分方式
9/54巴士系数 — 1 位贡献者贡献了半数提交
0.8/22.5提交分布 — 头号贡献者编写了 96% 的提交
9.5/13.5贡献者广度 — 7 位贡献者
10/10OpenSSF Scorecard：Contributors — project has 3 contributing companies or organizations -- score normalized to 10
所用输入
bus_factor1
contributors_sampled7
top_contributor_share0.963

议题与 PR 响应能力

81优秀
评分方式
39.2/42议题解决 — 93% 的议题已关闭
27.6/30PR 接受 — 已裁定的 PR 中 114/124 已合并
13/13Newcomer PR acceptance — 30 天内首次贡献者的 PR 已合并 1/1
1.5/15OpenSSF Scorecard：Code-Review — Found 2/19 approved changesets -- score normalized to 1
所用输入
merged_prs114
open_issues2
closed_issues28
prs_merged_7d5
prs_decided_7d5
prs_merged_30d13
prs_decided_30d14
issue_closed_ratio0.933
closed_unmerged_prs10
first_time_authors_30d1
first_time_prs_merged_30d1
first_time_prs_decided_30d1

所有权与托管责任

66良好
评分方式
30/30所有权背书 — 组织持有
20/20已验证域名
4.3/25所有者影响力 — Guard-Core 有 3 位关注者
11.8/25既往记录 — 34 个公开仓库，账户约 0 年
所用输入
followers3
owner_typeOrganization
is_verified是
owner_loginGuard-Core
public_repos34
account_age_days110

软件包维护

100卓越
评分方式
25/25已发布且可解析 — pypi 上有 1 个软件包
35/35发布时效 — 最近一次发布于 0 天前
20/20版本历史 — 62 个已发布版本
20/20未被弃用 — 活跃，未被弃用或撤回
所用输入
packagesfastapi_guard
ecosystemspypi
any_deprecated否
min_days_since_publish0

工程质量

基础的工程与文档实践是否到位？

96卓越 · 占总体的 19%

工程实践

94卓越
评分方式
24/24CI 工作流 — 15 个工作流
24/24存在测试
16/16Linter 配置 — pyproject.toml ([tool.ruff])
9.6/9.6Pre-commit 钩子
0/6.4.editorconfig
20/20OpenSSF Scorecard：CI-Tests — 12 out of 12 merged PRs checked by a CI test -- score normalized to 10
所用输入
has_ci是
has_tests是
has_editorconfig否
has_linter_config是
has_precommit_config是

文档

100卓越
评分方式
30/30README
25/25文档目录
15/15文档 / 主页站点 — https://guard-core.com/
10/10仓库描述
10/10主题标签 — 7 个主题标签
10/10Wiki
所用输入
topicsapi, security, fastapi, ip, middleware, python, rest
has_wiki是
homepagehttps://guard-core.com/
docs_sitehttps://guard-core.com/
has_readme是
has_docs_dir是
has_description是

安全

可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？

71良好 · 占总体的 16%

安全态势

71良好
评分方式
7.5/7.5Binary-Artifacts — no binaries found in the repo
6.8/7.5Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5CI-Tests — 12 out of 12 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0.8/7.5Code-Review — Found 2/19 approved changesets -- score normalized to 1
2.5/2.5Contributors — project has 3 contributing companies or organizations -- score normalized to 10
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5许可证 — license file detected
7.5/7.5Maintained — 30 commit(s) and 11 issue activity found in the last 90 days -- score normalized to 10
5/5Packaging — packaging workflow detected
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
4.5/5SAST — SAST tool detected but not run on all commits
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — 无数据
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
所用输入
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate7.1
已排除计分（无数据或不适用）：Signed-Releases。 其余权重已重新归一化。

AI 就绪度

该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？权重刻意设小（4%）：代理工具链是一项真实的维护信号，但完全不具备的仓库仍可达到 100/100。

80优秀 · 占总体的 4%

AI 代理上下文与指引

100卓越
评分方式
45/45代理指令 — AGENTS.md, CLAUDE.md
15/15机器可读文档（llms.txt） — 存在 llms.txt
40/40可读的提交历史 — 92 次人类提交中有 84 次说明了意图（结构化标题或解释性正文）
所用输入
has_llms_txt是
llms_txt_url—
legible_history_share0.913
agent_instruction_filesAGENTS.md, CLAUDE.md
agent_instruction_max_bytes12,766

验证循环（构建 / 测试 / 类型检查）

80优秀
评分方式
18/18一条命令的引导启动 — Makefile
22/22自动化测试
11/11Lint / 格式化配置 — pyproject.toml ([tool.ruff])
11/11静态类型检查 — guard/py.typed
10/10可复现环境 — Dockerfile
0/10已体现的代理实践 — 最近 100 次提交中没有代理编写的提交
8/8自动化维护 — 最近 100 次提交中有 8 次为自动依赖更新
0/10OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
所用输入
has_nix否
has_tests是
lockfiles—
has_dockerfile是
typed_language否
bootstrap_filesMakefile
has_devcontainer否
has_linter_config是
typecheck_configsguard/py.typed
agent_commit_share0
toolchain_manifests—
dependency_bot_commit_share0.08

面向模型的代码可读性

82优秀
评分方式
27/45可类型检查的代码 — Python，已配置类型检查（guard/py.typed）
54.5/55可控的文件大小 — 采样的 110 个源文件中有 1 个超过 60KB
所用输入
primary_languagePython
largest_source_bytes86,579
source_files_sampled110
oversized_source_files1

机器可读接口

40薄弱
评分方式
0/40API 模式（OpenAPI/GraphQL/proto）
0/20MCP 服务器
40/40可运行示例 — examples
所用输入
example_dirsexamples
has_mcp_signal否
api_schema_files—
interfaces_expected_ofnetwork-service

关键数据

824GitHub 星标
7贡献者
176最近 12 个月提交数
0距最近推送天数
64发布版本数
1巴士系数（bus factor）
2开放议题
PyPI软件包生态系统数

数据采集警告

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • deps.dev does not index pypi:fastapi_guard@8.1.0; advisories assessed against the repository dependency graph instead
  • No resolved dependencies carried a version and a supported ecosystem

更多细节

Star 与 Fork 历史 0 ★ / 47 ⇿
0Star
47Fork
55发布

每颗 star 和每个 fork 的添加时间，来自 GitHub 并按天汇总。累计增长位于其构成来源——每日新增——的正上方，二者可相互对照：稳定的自然增长与短暂的突增形态截然不同。当这一差别可被衡量时，它会作为增长真实性予以报告。

010203040504642025-022025-122026-09
主版本 7次版本 20修订 28

每个点涵盖 2 天。

OpenSSF Scorecard 7.1 / 10
7.1综合

来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。Scorecard v5.5.0 · 2026-10-10 15:20 UTC

10Binary-Artifactsno binaries found in the repo
9Branch-Protectionbranch protection is not maximal on development and all release branches
10CI-Tests12 out of 12 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
1Code-ReviewFound 2/19 approved changesets -- score normalized to 1
10Contributorsproject has 3 contributing companies or organizations -- score normalized to 10
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 11 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
9SASTSAST tool detected but not run on all commits
10Security-Policysecurity policy file detected
不适用Signed-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
10Vulnerabilities0 existing vulnerabilities detected
直接依赖 4
注册表软件包版本约束清单文件
PyPIfastapi>=0.109.0pyproject.toml
PyPIguard-core>=4.1.0pyproject.toml
PyPIstarlette>=0.35.0pyproject.toml
PyPIuvicorn—pyproject.toml
全部依赖 8

来自 GitHub 依赖图的完整解析依赖集合：4 个直接依赖与 4 个间接（传递）软件包。仓库提交锁文件时，传递闭包才是完整的。

注册表软件包版本关系
PyPIfastapi—直接
PyPIguard-core—直接
PyPIstarlette—直接
PyPIuvicorn—直接
PyPIfastapi-guard—间接
PyPIgunicorn—间接
PyPIredis—间接
PyPIrequests—间接
依赖安全公告 未评估

本报告未能完成公告比对：No resolved dependencies carried a version and a supported ecosystem

原始 JSON 报告 机器可读

反馈

发现这份报告有不准确之处，或有想法要分享？错误的测量、未识别的工具、建议、疑问——都欢迎提出。每条消息都会被阅读并得到回复。

登录过程中消息不会丢失。

相关记录

与 Guard-Core/fastapi-guard 共享目录标签或生态系统的已检测仓库。 并排阅读 →

99IBM/mcp-context-forgeAn AI Gateway, registry, and proxy that sits in front of any MCP, A2A, or REST/gRPC APIs, exposing a unified endpoint with centralized discovery, guardrails and management. Optimizes Agent & Tool calling, and supports plugins.卓越98strawberry-graphql/strawberryA GraphQL library for Python that leverages type annotations 🍓卓越99litestar-org/litestarLight, flexible and extensible ASGI framework | Built to scale卓越98polarsource/polarPolar — A billing platform for the intelligence era卓越99pydantic/logfireAI observability platform for production LLM and agent systems.卓越99prowler-cloud/prowlerProwler is the world’s most widely used open-source cloud security platform that automates security and compliance across any cloud environment.卓越

评分是信号，而非担保。 评分反映的是 GitHub 上公开可见的实践——不是代码审计，也不是安全保证。

缺失数据将被剔除并重新归一化权重，绝不按零分计。方法论已版本化并公开：指标 v2.10.0、模式 v0.34.0—— 完整方法论 · 指标知识库.

单项结果在整体记录中的位置： 汇总统计 — PyPI.