TestHubo是一款开源免费的测试管理工具，提供一站式测试解决方案，涵盖功能测试、接口测试、性能测试以及 Web 和 App 测试等多个维度。TestHubo 整合了全面的测试能力，使团队可以在一个平台内完成所有测试需求。本文将介绍如何快速安装配置及入门使用。
1、安装
下面介绍TestHubo私有部署应该如何安装。TestHubo 私有部署版本更适合有严格数据安全要求的企业，支持在本地或专属服务器上运行，以实现对数据和系统的完全控制。该版本兼容 Windows、macOS、Linux 和 Docker 等环境，确保多平台部署的灵活性与稳定性。
1.1 Linux 安装
➢ 服务端安装
- 下载，服务端安装包含Agent安装，Linux 安装包下载地址：TestHubo下载，点击Linux下载，下载的安装包名如tiklab-testhubo-x.x.x.rpm。
- 安装，将安装包上传到服务器，使用 rpm 命令安装，默认安装目录在/opt下。
rpm -ivh --nodeps tiklab-testhubo-x.x.x-1.x86_64.rpm
- 启动，进入安装目录/opt/testhubo-ee/bin目录下，执行sh startup.sh即可启动成功。
sh startup.sh
➢ Agent 安装
- 下载，单独安装Agent，Linux 安装包下载地址：TestHubo Agent下载，点击Linux下载，下载安装包如tiklab-testhubo-agent-x.x.x.rpm。
- 安装，将安装包上传到服务器，使用 rpm 命令安装，默认安装目录在/opt下。
rpm -ivh --nodeps tiklab-testhubo-agent-x.x.x-1.x86_64.rpm
- 启动，进入安装目录/opt/testhubo-ee/bin目录下，执行sh startup.sh即可启动成功。
sh startup.sh
1.2 Docker 安装
➢ 服务端安装
- 下载，Docker安装包下载地址：TestHubo下载，下载Docker安装包。下载完成后，得到 tiklab-testhubo-x.x.x.tar.gz 的文件。
- 安装，在执行以下命令加载镜像。
docker load -i tiklab-testhubo-x.x.x.tar.gz
- 启动，加载完成后，执行以下镜像启动即可。
docker run -itd -p 8300:8300 tiklab-testhubo-x.x.x
➢ Agent 安装
- 下载，Docker安装包下载地址：TestHubo Agent下载，下载Docker安装包。下载完成后，得到 testhubo-agent-x.x.x.tar.gz 的文件。
- 安装，在执行以下命令加载镜像。
docker load -i testhubo-agent-x.x.x.tar.gz
- 启动，加载完成后，执行以下镜像启动即可。
docker run -itd -p 8300:8300 testhubo-agent-x.x.x
1.3 Windows 安装
➢ 服务端安装
- 下载，Windows安装包下载地址：TestHubo下载，下载Windows安装包。下载完成后，获取名为 tiklab-testhubo-.x.x.x.exe 的可执行文件。
- 安装，双击运行可执行文件，选择安装位置并点击安装。
- 启动，点击桌面快捷方式启动 TestHubo 服务。
启动服务
➢ Agent 安装
- 下载，Windows安装包下载地址：TestHubo Agent下载，下载Windows安装包。下载完成后，获取名为 tiklab-testhubo-agent-.x.x.x.exe 的可执行文件。
- 安装，双击运行可执行文件，选择安装位置并点击安装。
- 启动，点击桌面快捷方式启动 TestHubo 服务。
1.4 macOS 安装
➢ 服务端安装
- 下载，Mac安装包下载地址：TestHubo下载，下载Mac安装包，下载完成后，获取名为 tiklab-testhubo-.x.x.x.dmg 的可执行文件。
- 安装，双击打开 .dmg 文件，将 TestHubo 拖入 应用程序 文件夹。
- 启动，点击 应用程序 文件夹中的 TestHubo 快捷方式启动服务。
➢ Agent 安装
- 下载，Mac安装包下载地址：TestHubo Agent下载，下载Mac安装包，下载完成后，获取名为 tiklab-testhubo-agent-.x.x.x.dmg 的可执行文件。
- 安装，双击打开 .dmg 文件，将 TestHubo 拖入 应用程序 文件夹。
- 启动，点击 应用程序 文件夹中的 TestHubo 快捷方式启动服务。
2、登录
启动后，默认可以通过 http://ip:8300 访问，默认用户名/密码为admin/123456。
默认支持通过账号密码登录，满足基础登录需求。若需要使用企业微信、钉钉或 LDAP 等高级登录方式，可参阅TesHubo文档获取相关配置说明。
登录页
首页
3、配置
允许自定义端口、数据存放目录、数据库连接、数据库备份策略和统一登录设置，以满足特定个性化需求。配置文件yaml文件默认位置：
| 系统 | 默认位置 |
| Windows | 默认在安装目录 --> conf目录下application.yaml文件 |
| Mac | 默认在app下的Contents --> conf 目录下application.yaml文件 |
| Linux | 默认在/opt/postin-ee/conf 目录下application.yaml文件 |
| Docker | 默认在镜像文件内/usr/local/postin-ee/conf 目录下application.yaml文件 |
3.1 自定义端口
允许用户自定义应用的启动端口，以便在特定网络环境下避免端口冲突或满足其他配置需求。
端口配置
| 属性 | 值 |
| serer.port | 系统启动的端口号（可更改）。 |
3.2 自定义数据库
支持自定义数据库连接方式，用户可以选择使用内嵌数据库或指定外部数据库地址。根据需求配置数据库连接。
数据库配置
| 属性 | 说明 |
| postgresql.embbed.enable | 是否使用内嵌数据库，true:使用 false:不使用。如果配置为false，需要把该文件中jdbc下的数据库连接信息更改为自己的数据库地址，用户名以及密码。 |
| postgresql.database | 是否使用内嵌数据库默认连接的数据库，默认为tiklab_testhubo如果更改次默认值需要把jdbc下的数据库连接信息更改为新的数据地址。 |
| postgresql.db.port | 使用内嵌数据库的启动端口，默认为8301，如果更改需要同时把jdbc.url中的数据库连接地址端口更改。 |
| postgresql.db.username | 使用内嵌数据库的用户名，默认为postgres，如果更改需要同时把jdbc.username中的数据库连接地址用户名更改。 |
| postgresql.db.password | 使用内嵌数据库的密码，默认为darth2020，如果更改需要同时把jdbc.password中的数据库连接地址密码更改。 |
| postgresql.db.address | 使用内嵌数据库的数据库文件保存位置，默认为${DATA_HOME}/postgresql，即默认的应用数据目录下的postgresql目录。注：如果更改该目录，该路径目录必须为空目录，否则会导致数据库无法启动。 |
| jdbc.url | 默认是：jdbc:postgresql://localhost:9301/tiklab_testhubo?stringtype=unspecified 其中 9301 为端口号，postin_db为数据库名字，这两个可更改 但是端口号必须与postgresql.db.port 保持一致 数据库名字必须与postgresql.database 保持一致 |
| jdbc.username | 数据库登录名，必须与postgresql.db.username一致 |
| jdbc.password | 数据库登录密码，必须与postgresql.db.password一致 |
3.3 自定义数据目录
支持用户自定义数据存放目录的位置，帮助用户根据需要选择存储路径。
数据目录
| 属性 | 值 |
| DATA_HOME | 数据文件存放地址。 |
4、快速入门
TestHubo安装结束后，登录系统进入TestHubo首页。首页显示常用项目和TestHubo用例状态统计。
4.1 创建项目
TestHubo根据项目对测试资源进行管理，项目是 TestHubo 中最高级别的项目管理单元，用于帮助团队高效地组织和管理测试资源。它作为一个独立的容器，可以容纳项目的所有测试用例、测试计划、测试报告等资源。
4.1.1 创建项目
点击项目→添加项目，可添加公共或者私密的项目，其中公共项目所有用户可浏览，私密项目仅选择的用户可浏览。
添加项目
| 属性 | 是否必填 | 描述 |
| 项目名称 | 必填 | 为项目设置一个简洁明了的名称，便于识别和管理。 |
| 可见范围 | 必填 | 设定项目的可见性，如“私密”或“公共”，以控制项目的访问权限，选择“私密”可限制特定成员进入项目。
|
| 成员选取 | 选填 | 可见范围选择“私密”才展示成员选取选择框，从系统用户中添项目成员，并为成员分配适当的角色和权限，确保协作效率。 |
| 描述 | 选填 | 提供简短的描述，说明项目的目标或关键内容,帮助团队成员快速了解项目背景。 |
项目创建完成之后，在项目页面“所有项目”，或者“我创建的”找到创建的项目。点击项目名称，进入项目详情。
4.1.2 添加成员
项目创建成功之后，根据项目的属性（可见范围）对访问项目的成员进行管理。
想要添加项目成员，需要添加系统用户，依次点击系统设置->用户与权限->用户，在用户页面对系统用户进行管理。
用户列表
系统用户添加完成之后，可以对项目成员进行添加，在项目详情→设置→项目，进入项目成员编辑页面。
成员列表
如果用户在创建项目未选成员，那么项目默认有创建人和admin两个成员。点击添加用户，添加的成员列表从系统用户列表获取。点击添加用户，勾选添加用户，点击确定即可成功添加项目成员。
4.1.3 分配权限
添加项目成员后，可以对成员分配权限、修改角色，点击项目详情→设置→权限，可浏览到内置角色。
角色列表
| 内置角色 | 属性 |
| 项目超级管理员 | 权限最大，不可指定普通成员，成员有且只有admin。 |
| 项目管理员 | 项目管理员，可对项目基本信息进行编辑，可添加多名成员。 |
| 项目普通角色 | 普通项目成员，权限最低，可添加多名成员。 |
在项目详情→设置→成员，点击“角色修改”，对成员角色进行修改。成员角色可多选。
4.2 添加测试用例
测试用例的目录采用树型目录方式，可以在相应模块添加用例。可以添加功能用例、接口单元用例、接口场景用例、接口性能用例、WEB用例、APP用例。
4.2.1 功能用例
TestHubo的用例结构采用比较经典的用例格式，包含用例名称、用例模块、操作步骤、优先级、类型、预期结果等字段。点击测试用例→添加用例→添加功能用例。
添加功能用例
| 属性 | 是否必填 | 描述 |
| 名称 | 必填 | 功能用例名称，简单描述该功能用例目的，方便查询、管理。 |
| 模块 | 选填 | 功能用例所属模块，方便快速查询。 |
成功新增功能用例之后，点击功能用例名称，可浏览/编辑功能用例详细信息。点击测试步骤，显示每一步测试步骤的描述和期望结果，可以对测试步骤进行添加、编辑、删除、排序。
测试步骤
功能测试用例可以关联Kanass系统的缺陷，关联方便快速定位缺陷。
4.2.2 接口用例
- 添加接口单元用例
提供简单易用的接口测试工具，支持对API进行全面的测试。点击测试用例→添加用例→添加接口单元用例。
添加接口单元用例
| 属性 | 是否必填 | 描述 |
| 名称 | 必填 | 测试用例名称，简单描述该用例目的，方便查询、管理。 |
| 类型 | 必填 | HTTP请求类型（GET、POST）。 |
| 地址 | 必填 | 接口请求地址。 |
| 模块 | 选填 | 测试用例所属模块，方便快速查询。 |
成功新增接口单元用例之后，点击功能用例名称，编辑功能用例详细信息。
接口单元用例
填写接口单元用例请求、响应信息后，选择环境，点击测试，可以对接口单元测试用例进行测试。TestHubo接口单元还支持前置脚本、后置脚本、断言等操作。
- 从PostIn复制
从PostIn复制接口生成接口单元用例，TestHubo支持集成PostIn系统，可以直接将PostIn系统保存的接口保存为TestHubo的接口单元用例。点击测试用例→添加用例→从PostIn复制。
从PostIn复制
选择PostIn的接口，点击提交，测试用例成功新增以接口名称为用例名称的接口单元用例。
- 添加接口场景用例
支持构建复杂的接口测试场景，模拟真实业务流程。点击测试用例→添加用例→添加接口场景用例。
成功新增接口场景用例之后，点击用例名称，编辑用例详细信息。
接口场景用例
接口场景用例支持配置环境变量，在配置接口步骤时可使用环境变量，在接口场景用例，点击环境变量→添加变量。
添加变量
| 属性 | 是否必填 | 描述 |
| 名称 | 必填 | 变量的名称，用来临时存储数据，在接口场景用例测试步骤可以使用 {{变量名称}} 的方法调用变量。 |
| 值 | 必填 | 变量的值，在接口场景用例测试步骤可以使用 {{变量名称}} 那么系统会填入变量的值。 |
| 描述 | 选填 | 为变量提供简单描述，说明变量的用途，可以让团队成员快速了解变量。 |
接口场景用例测试步骤添加接口单元用例，在接口场景用例，点击测试步骤→添加步骤→关联用例。
关联接口单元用例
测试步骤添加if判断，在接口场景用例，点击测试步骤→添加步骤→if判断。
if条件判断
选择环境，点击测试，可以对接口场景测试用例进行测试。
测试结果
点击历史，点击执行序号，显示接口场景用例测试历史。
4.2.3 性能用例
集成接口性能测试工具，支持对API进行高并发和负载测试。点击测试用例→添加用例→添加接口性能用例。成功新增接口性能用例之后，点击用例名称，编辑用例详细信息。
接口性能用例可以关联接口单元用例，对一个或者多个接口单元用例执行并发操作。在接口性能用例，点击测试步骤→关联用例，选择用例点击确定。
关联接口单元用例
点击测试步骤右侧的“压力配置”，配置接口单元的性能测试计划。
压力配置
压力配置结束后，选择环境点击测试，提供性能分析和报告，方便团队优化接口性能。
性能测试报告
点击历史，点击执行序号，也可以查看历史接口性能报告。
4.2.4 UI用例
- 添加WEB用例
提供强大的Web测试功能。支持UI自动化测试，确保Web应用程序的稳定性。点击测试用例→添加用例→添加WEB用例。成功新增WEB用例之后，点击用例名称，编辑用例详细信息。
WEB用例可以添加操作步骤，在WEB用例，点击测试步骤→添加步骤→添加步骤。
添加操作步骤
| 属性 | 描述 |
| 名称 | 操作步骤名称，简单描述该步骤目的。 |
| 操作方法 | 选择WEB操作方法，例如打开网址、点击确定、输入信息等操作。 |
| 定位器 | 选择在哪里执行操作方法，支持根据元素定位。 |
添加完成测试步骤之后，点击测试进行WEB用例测试。展开测试结果。
测试结果
点击历史，点击执行序号，也可以查看历史接口性能报告。
- 添加APP用例
集成App测试工具，支持对移动应用进行自动化测试。支持Android和iOS平台，覆盖广泛。点击测试用例→添加用例→添加APP用例。成功新增APP用例之后，点击用例名称，编辑用例详细信息。
APP用例可以添加操作步骤，在APP用例，点击测试步骤→添加步骤→添加步骤。
添加操作步骤
执行APP用例之前需要配置APP环境，在项目详情点击设置→环境→APP环境→添加环境。
APP环境
| 属性 | 描述 |
| 环境名称 | 环境名称，方便查询、管理。 |
| appiumServer | 安装appium的服务地址。 |
| platformName | 系统类型（iOS/Android）。 |
| deviceName | 设备ID（adb devices获取）。 |
| appPackage | 应用包名。 |
| appActivity | 启动页的Activity名。 |
添加环境后，选择环境，点击测试对APP用例进行测试。
4.3 添加测试计划
项目进入测试阶段后，测试团队可以进入测试计划页面，创建新的测试计划，安排项目的测试工作。在项目详情点击测试计划→添加计划。
添加测试计划
| 属性 | 是否必填 | 描述 |
| 名称 | 必填 | 测试计划名称，简单描述该测试计划目的，方便查询、管理。 |
| 类型 | 必填 | 测试计划类型，包含功能、自动化，功能测试计划只能绑定功能用例，自动化测试用例可以包含接口单元用例、接口场景用例、接口性能用例、WEB用例、APP用例。 |
| 日期范围 | 必填 | 测试计划执行日期范围. |
在测试计划列表可以查看本项目所有测试计划，包含功能测试计划和自动化测试计划。
4.3.1 功能测试计划
添加功能测试计划后，点击测试计划名称，进入测试计划详细，点击关联用例，可以将用例库中的功能用例，批量的添加到测试计划中。
关联用例
关联用例之后，可以在测试计划的用例列表里直接修改用例的测试状态。
执行功能用例
也可以点击功能用例名称，进入测试步骤，分步骤执行测试用例。测试步骤全部成功则用例判断执行成功，测试步骤只要有一步失败则用例判断执行失败。
执行功能用例之后，还可以查看功能用例的测试报告。
测试报告
4.3.2 自动化测试计划
添加自动化测试计划后，点击测试计划名称，进入测试计划详细，点击关联用例，可以将用例库中的接口用例（接口单元、接口场景、接口性能）、UI用例（WEB用例、APP用例），批量的添加到测试计划中。
关联用例
关联用例之后，在测试计划点击测试，选择环境，执行测试计划所有用例，并弹窗显示测试结果。测试结果包含总体测试结果、执行用例数量、通过/失败数量、通过率/失败率、耗时、以及每个用例执行情况。在测试历史也可以点击测试的序号来查看测试结果。
测试报告
自动化测试计划还可以通过定时任务的方式执行，分为单次触发、循环触发。
单次触发，测试计划只会执行单次，选择执行日期和执行时间，测试计划按照设置日期执行。
单次触发
循环触发定时任务，需要设置循环触发时间间隔，如下图测试计划会每600分钟执行一次。
循环触发
设置单次触发，任务状态为运行中，单次任务执行完毕之后，任务状态更改为已触发。循环触发，任务状态一直是运行中。
4.4 查看测试报告
TestHubo对每次接口用例（接口单元、接口场景、接口性能）、UI用例（WEB用例、APP用例）、测试计划执行都生成详细的测试报告，包括测试覆盖率、执行结果等。在项目详情，点击测试报告，查看执行历史。
测试报告
点击测试报告名称，可以查看测试报告，报告可视化，方便团队了解测试结果。
测试报告
4.5 添加缺陷
在执行测试用例的过程中，测试执行中发现缺陷，在Kanass中提交缺陷后，在TestHubo绑定这个缺陷。点击测试用例→关联缺陷→关联缺陷。点击缺陷行进行关联。
关联缺陷
成功关联缺陷，在项目详情的缺陷页面，可以查看测试执行中发现的所有缺陷，有助于在缺陷修复后，进行集中的回归测试安排。