TestHubo安装及入门指南

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绑定这个缺陷。点击测试用例→关联缺陷→关联缺陷。点击缺陷行进行关联。

关联缺陷 

成功关联缺陷，在项目详情的缺陷页面，可以查看测试执行中发现的所有缺陷，有助于在缺陷修复后，进行集中的回归测试安排。