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用例。
日期范围	必填	测试计划执行日期范围.