10分钟上手pity接口测试平台:超详细安装部署指南(含Docker一键启动)
pity是一款专注于API自动化测试的开源接口测试平台,采用Python+FastApi+React开发,支持HTTP测试、测试集合、定时任务、全局变量、自定义脚本等核心功能,帮助中小型企业快速搭建专业的接口测试体系。本文将为你提供超详细的pity安装部署教程,即使是新手也能在10分钟内完成平台搭建。
🍔 为什么选择pity接口测试平台?
pity接口测试平台具有以下核心优势:
- 全功能覆盖:支持HTTP测试、测试集合、定时任务、全局变量、自定义脚本等接口测试全流程需求
- 简单易用:提供直观的Web界面,无需复杂配置即可快速创建和执行测试用例
- 灵活扩展:支持自定义脚本、参数提取和断言,满足复杂场景测试需求
- 丰富的通知机制:内置精美的邮件/钉钉通知模板,及时反馈测试结果
- 一键部署:提供Docker-compose配置,无需手动安装依赖,快速启动整个服务栈
🚀 准备工作:环境要求
在开始安装pity之前,请确保你的环境满足以下要求:
- Docker Engine (20.10.0+)
- Docker Compose (v2.0+)
- 至少2GB内存
- 网络连接(用于拉取Docker镜像)
⚡ Docker一键启动(推荐新手)
pity提供了Docker-compose配置文件,可以一键启动包含MySQL、Redis和pity服务的完整环境,无需手动安装和配置数据库。
步骤1:克隆代码仓库
打开终端,执行以下命令克隆pity代码仓库:
git clone https://gitcode.com/gh_mirrors/pi/pity
cd pity
步骤2:启动Docker容器
进入项目目录后,执行以下命令启动服务:
docker-compose -f ./ops/docker-compose.yaml up
步骤3:访问pity平台
等待所有容器启动完成(首次启动可能需要几分钟拉取镜像),打开浏览器访问:
http://localhost:7777
🔧 手动安装部署(适合开发人员)
如果你需要进行二次开发或自定义配置,可以选择手动安装部署方式。
步骤1:克隆代码仓库
git clone https://gitcode.com/gh_mirrors/pi/pity
cd pity
步骤2:安装依赖
使用pip安装Python依赖:
pip install -r requirements.txt
步骤3:配置数据库和Redis
- 安装并启动MySQL和Redis服务
- 修改配置文件
conf/dev.env,更新数据库和Redis连接信息:
# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=yourpassword
DB_DATABASE=pity
# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=yourpassword
步骤4:启动服务
python pity.py
✨ 首次使用指南
注册管理员账号
打开浏览器访问http://localhost:7777,点击注册按钮,第一个注册的用户将自动成为超级管理员,拥有所有权限。
开始使用pity
登录后,你可以:
- 创建项目和测试用例
- 配置全局变量和数据库连接
- 编写测试集合和定时任务
- 查看测试报告和执行结果
详细使用文档可参考项目中的docs/目录,里面包含了更详细的功能说明和操作指南。
📌 常见问题解决
1. Docker启动后无法访问服务?
- 检查容器是否正常运行:
docker-compose -f ./ops/docker-compose.yaml ps - 查看服务日志:
docker-compose -f ./ops/docker-compose.yaml logs pity
2. 手动启动时报数据库连接错误?
- 确认MySQL服务是否正常运行
- 检查
conf/dev.env中的数据库连接信息是否正确 - 确保数据库已创建:
CREATE DATABASE pity CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
3. 忘记管理员密码?
可以通过修改数据库user表重置密码,或删除数据库重新初始化(会清除所有数据)。
🎉 总结
通过本文的指南,你已经成功安装并启动了pity接口测试平台。无论是使用Docker一键启动还是手动部署,pity都能快速帮助你搭建专业的接口测试体系。现在,你可以开始探索pity的强大功能,创建你的第一个API测试用例了!
如果你在使用过程中遇到任何问题,欢迎查阅项目文档或提交issue反馈。祝你的接口测试工作更加高效!
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考




