lkrequest Hub

A community registry for lkrequest browser fingerprint presets, with versioned JSON, verification records, search, comparison, and downloads.

lkrequest 指纹预设社区。用户自行采集、通过 Pull Request 贡献 JSON；GitHub Pages 提供项目介绍、搜索、对比和下载。线上不需要 Python 服务、数据库或登录系统。

功能

• 首页介绍 Rust、Python、Go 客户端。
• 按采集客户端、版本、系统、架构、支持协议及来源筛选指纹。
• 保留不可变修订、字段顺序和差异说明；下载前校验 SHA-256。
• 通过 PR、固定规则检查和维护者复核收录社区配置。
• 支持深色、浅色和系统主题，适配桌面与手机。

已收录 lkrequest v0.2.3 的 13 个官方预设，另有 3 个明确标注的配置示例。“官方”表示来源可追溯，各协议分别保留上游验证状态，不等于 Hub L1-L4 认证。查看导入范围与来源。

本地运行

需要 Python 3.12+（推荐 3.13）、Node.js 24、npm 和 Git。从项目根目录执行：

Windows PowerShell：

python -m venv .venv
.\.venv\Scripts\python -m pip install -r requirements.registry.txt
npm --prefix web ci
npm --prefix web run dev

Linux / macOS：

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.registry.txt
npm --prefix web ci
npm --prefix web run dev

打开 http://localhost:5173/。首页介绍请求库，指纹目录位于 #/presets，提交说明位于 #/how-to-submit。旧 #/libraries 和带筛选参数的旧首页链接会自动跳转。

dev/build 会先校验 registry/ 并生成公开目录。Windows 可用 scripts/start-registry.ps1 启动后台预览，端口占用时选择下一端口；scripts/stop-registry.ps1 停止该脚本启动的实例。

可选地将 web/.env.example 复制为 web/.env.local，设置公开仓库地址 VITE_REGISTRY_REPOSITORY。未配置时“提交 PR”禁用；GitHub Actions 会注入实际仓库地址。VITE_* 会写入浏览器产物，不能存放秘密。

贡献

参考 CONTRIBUTING.md，新增 registry/presets/<id>/<revision>.json。可在 GitHub 网页编辑并提出 PR，或在本地分支提交；无写权限时 GitHub 会引导创建 Fork。配置模板见 registry-contribution.json。

普通收录使用 requested_level: none、evidence: null。申请 L1 时必须附可重算的脱敏证据并由非作者复核。公开 PR 在合并前已公开，请提前移除凭据、个人数据和原始流量。配置导出不承诺被任意客户端直接加载。

构建与部署

npm --prefix web run build

部署目录为 web/dist/。推荐按 GitHub Pages 部署说明 开启 Actions 发布；仓库变量 PAGES_ENABLED=true 仅允许默认分支部署。也可用 docker compose -f compose.registry.yaml up --build -d 运行静态容器。

本地测试、部署配置准备和实际公网部署是三个独立状态。 本项目尚未记录远程 CI 或公网部署成功。首次公开前按 开源发布检查 配置维护者、安全报告渠道及分支保护。

开发检查

.\.venv\Scripts\python -m pip install -r requirements.lock
.\.venv\Scripts\python -m pip install --no-build-isolation --no-deps -e .
.\.venv\Scripts\python -m scripts.check_public_tree
.\.venv\Scripts\python -m ruff check hub tests scripts
.\.venv\Scripts\python -m pytest --basetemp .local/pytest-tmp -q
npm --prefix web exec -- playwright install chromium
npm --prefix web run test:registry
npm --prefix web run test:pages

Linux/macOS 将解释器替换为 .venv/bin/python。Playwright 可通过 HUB_BROWSER_EXECUTABLE 使用已有测试浏览器。CI 同时检查保留工作台；真实公网采集测试需显式启用，不是默认测试。

项目结构

路径	内容
web/	React / TypeScript 网站和浏览器测试
registry/	版本化 preset、复核、官方来源与撤销记录
hub/registry.py	CLI 校验、摘要与静态数据构建
schemas/、examples/	公开数据契约和贡献模板
scripts/、tools/	开发检查、预览与官方预设导入工具
docs/、deploy/	部署说明、运行文档与容器配置

web/public/registry/ 和 web/dist/ 是生成目录，不提交 Git；.local/ 存放仅本机使用的数据、证据、密钥和测试结果。请保留锁文件和已审核的 registry/ 源数据。

文档与许可

• 注册表、审核与不可变版本
• GitHub Pages · 开源发布检查
• 安全与数据处理 · 验收记录
• 可选采集工作台：含 API、数据库和采集器，默认静态站点不运行这些服务。
• Apache-2.0 · 第三方声明