limeyard

一个故意存在漏洞的 Docker 实验环境，具有可路由的 DNS 资产和每个目标对应的机器可读答案密钥，可在本地对扫描器的精确率、召回率和范围进行评分。

快速开始

你需要 Docker（带 compose 插件）和 git。仅此而已。

这会将实验室克隆到 ./limeyard，用新的 API 令牌写入其 .env，构建并启动控制平面，然后询问要运行什么。在启动任何东西之前，它会显示所选内容在参考机器上空闲时测得的成本，并与你机器的可用资源进行对比：

非交互式：curl ... | bash -s -- --light --yes（或 --all、--none、--pick dvwa,juice-shop,estate）。用 LIMEYARD_DIR=/path 将检出目录放到别处。

然后面板位于 http://127.0.0.1:7000，手动执行相同操作：

不使用安装程序，手动操作：

每个清单都带有一个实测的 resources 块（容器、空闲 RAM、镜像磁盘、空闲 CPU）。向导、面板的选择条和每个目标的页面都从中汇总，因此估算在任何地方都一致。

分支

两个，且仅有两个。

• main 是安装程序克隆的分支，也是你不做任何操作时得到的分支。它通过拉取请求推进，绝不通过直接推送。
• dev 是默认分支，也是工作落地的分支。针对它提交拉取请求。

概念

类型：web api bench cve service estate edge control mobile。

布局

控制面板

docker compose up -d 启动两个容器，仅此而已：limeyard_control（limed 守护进程，持有 Docker socket）和 limeyard_ui（SvelteKit 面板）。两者都仅绑定回环。面板位于 http://127.0.0.1:7000，原始 API 位于 http://127.0.0.1:7099。两者都需要 .env，其中的 LIME_TOKEN 是必需的：面板在服务端持有令牌，浏览器永远看不到它。

面板会自我更新：limed 通过 SSE 流式传输状态转换，因此从 CLI 启动的目标无需刷新即可显示。页头从同一流中携带主机的 CPU、RAM 和可用磁盘，仅在值得注意时着色。每个表格都可通过点击列标题排序；再次点击会翻转方向。

在更改面板或守护进程后，重新构建这一对：

要在不重新构建镜像的情况下针对运行中的守护进程开发面板：

API

除 /api/health 外的每个调用都需要 X-Lime-Token。

网络

三个层级，因为单一层级正是最初的问题。

• lime-web 网桥。Web 和 API 目标，发布在 127.0.0.1:70xx。
• lime-lab 网桥，10.66.0.0/16，静态 IP，无主机绑定。扫描器作为容器加入此网络，看到的是具有真实主机和真实端口的真实子网，而不是回环端口列表。
• lime-edge WAF 层级，源站可达但不在 DNS 中。

DNS 是 .test 区域上的权威 BIND（RFC 6761 保留了它）。Docker 网络别名刻意不作为事实来源：它们永远不会出现在区域传输中，并且会使拓扑与答案密钥不一致。

端口

评分

每个目标都附带一个 truth.yml。评分器将发现结果转化为精确度、召回率和 F1，按目标和按类别：

统计三件事，而不是一件。召回率：我们是否找到了存在的东西。精确度：我们是否避免了报告不存在的东西，依据每个答案密钥都携带的 negative 条目来衡量。范围：我们正确地没有尝试什么，记录下来以免每个季度都有人重新争论。

mirage 目标仅为第二项而存在。其中没有任何东西存在漏洞，而其中一切看起来都像是有漏洞的，因此针对它的任何发现从构造上就是误报。

贡献

CONTRIBUTING.md 包含了全部内容：贡献通常是什么、./lime audit 强制执行的不变量，以及为什么在这里修正答案密钥比新增功能更有价值。规则的简短版本如下。所有参与者都受行为准则约束。

添加目标

保持实验室整洁的规则：

• 仅绑定目标端口，绑定到 127.0.0.1。
• 单容器目标仅加入 [lime-web]。不要添加每个项目的网络：网络太多会导致 Docker 地址池耗尽。
• 带数据库的目标加入 [default, lime-web]，并将数据库仅放在 [default] 上。每个目标获得自己的数据库服务和卷。
• 为被发现而非被浏览而存在的目标加入 [lime-lab]，使用静态 IP，不发布任何主机端口。
• upstream 是必需的。 lime doctor 会让没有它的目标失败，管理器拒绝注册这样的目标。见下文。
• limeyard 不内置任何第三方源代码。将 repo: 和 compose: 放入清单，源代码会在运行时获取到 <target>/src。
• 记录它的成本。启动它，让它稳定下来，然后 ./lime measure <slug> 打印出要粘贴的 resources 块。安装程序和面板会将这些加起来，以便在有人启动之前发出警告，所以这里的猜测就是那里的谎言。

信任与隔离

目标是别人的刻意设计为存在漏洞的软件，因此来源是被记录而非假设的，运行时是被约束而非信任的。SECURITY.md 有完整的情况；简短版本：

• 每个镜像都通过摘要固定，而不是浮动标签，固定到在此处拉取和测试的摘要。./lime pin 报告漂移。
• 发布者按镜像记录：Docker 官方镜像、项目组织账户（OWASP、ISC、Traefik、Prometheus），或作者自己的命名空间。两个最薄弱的环节，raesene/bwapp（已归档，最后重建于 2022 年，无许可证）和 delfer/alpine-ftp-server（个人），被如此标明。
• 每个服务都以 no-new-privileges、cap_drop: ALL 加上每个镜像最低限度的 cap_add、pid 上限和内存上限运行。数据库层级位于 internal: true 网络上，没有对外路由。
• limed 持有 Docker socket，即主机上的 root，因此它在每次调用时都需要共享密钥。被攻陷的目标可以访问它但学不到任何东西。
• ./lime audit 会在 privileged、主机网络、目标中的 socket 挂载、非回环绑定、未固定镜像或缺失令牌时失败。

这里没有任何东西能防御内核级容器逃逸。为此，请使用一次性 VM。

归属

这里几乎所有东西都是别人写的，而且有几个目标完全没有声明许可证。因此，署名作者是硬性门槛，而非惯例：

• target.yml 带有一个必需的 upstream 块：作者、仓库、许可证，以及我们最后验证其可构建的日期。当容器化者与作者不同时，packager 记录容器化者。
• 每个仪表板卡片都在目标名称下显示作者，链接到源，旁边是许可证。许可证为 none declared 会渲染为警告，这也是禁止再分发的信号。
• 每个目标的详情视图以署名块开头，位于漏洞列表之上，我们的答案密钥与上游自己的文档清晰分开。
• UI 中的 /credits 和 ./lime credits 列出每个目标、作者和许可证。./lime credits --markdown 重新生成下面的部分。

致谢

limeyard 运行别人的作品。下面的每个目标和场景都是别人构建的，除非它标明 Clickswave。

api

bench

control

cve

edge

mobile

scenario

service

web