erev0s/vampi

VAmPI Docker镜像文档

概述

VAmPI（Vulnerable API）是一个故意设计包含OWASP Top 10安全漏洞的REST API应用，旨在为安全测试人员、开发人员和安全学习者提供一个真实的漏洞环境，用于实践识别、利用和修复常见的Web API安全漏洞。

核心功能与特性

• 覆盖OWASP Top 10漏洞：包含注入***、身份认证失效、敏感数据暴露、XML外部实体（XXE）、访问控制失效、安全配置错误、跨站脚本（XSS）、不安全的反序列化、使用已知漏洞组件、日志与监控不足等典型漏洞。
• 模拟真实API场景：提供用户管理（注册、登录、权限控制）、资源CRUD操作（如文章、评论管理）等贴近实际业务的API端点。
• 漏洞文档化：每个漏洞均配有详细说明，包括风险等级、利用条件、修复建议及示例请求。
• 轻量级部署：基于Python/Flask构建，Docker化部署便捷，无需复杂依赖配置。
• 支持多种测试方式：兼容手动渗透测试、自动化扫描工具（如OWASP ZAP、Burp Suite）及安全测试框架集成。

使用场景

• 安全测试人员练习漏洞检测与利用技能
• 开发人员学习安全编码规范，理解漏洞产生原因
• 安全培训课程中的实践环境搭建
• 自动化安全扫描工具（如SAST/DAST）的功能验证与测试

使用方法

Docker快速部署

1. 拉取镜像（假设镜像已发布至Docker Hub，实际使用时需确认镜像名称）：

   bash
   docker pull docker.xuanyuan.run/erev0s/vampi
   

2. 运行容器：

   bash
   docker run -d -p 5000:5000 --name vampi_container docker.xuanyuan.run/erev0s/vampi
   

   • -p 5000:5000：将容器内5000端口映射到主机5000端口（默认端口，可修改）
   • --name vampi_container：指定容器名称，便于管理

3. 访问API： 容器启动后，通过http://localhost:5000访问API服务，通过http://localhost:5000/docs查看API文档（Swagger UI），获取端点详情及漏洞说明。

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  vampi:
    image: docker.xuanyuan.run/erev0s/vampi
    ports:
      - "5000:5000"
    container_name: vampi
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

可通过环境变量自定义服务配置（具体变量以项目文档为准）：

• VAMPI_PORT：修改服务端口，如-e VAMPI_PORT=8080
• VAMPI_DEBUG：开启调试模式，-e VAMPI_DEBUG=True（默认False）
• VAMPI_DB_PATH：指定数据库文件路径（默认使用内存数据库，重启后数据重置）

示例（自定义端口）：

bash
docker run -d -p 8080:8080 -e VAMPI_PORT=8080 --name vampi_debug docker.xuanyuan.run/erev0s/vampi

漏洞列表与利用示例

API文档（/docs）中详细列出了各端点存在的漏洞类型及利用示例，例如：

• 注入***：用户登录接口支持SQL注入，可通过构造***用户名/密码获取数据库信息
• 身份认证失效：密码重置功能存在逻辑缺陷，无需验证即可修改任意用户密码
• 敏感数据暴露：API响应中包含未加密的用户密码、***信息等敏感数据

注意事项

• VAmPI为故意设计的易受*应用**，严禁部署在生产环境或公网可访问的服务器上
• 默认配置包含测试数据，如需重置环境，可重启容器
• 详细漏洞说明及修复建议请参考项目GitHub仓库文档（https://github.com/erev0s/VAmPI%EF%BC%89