PostIn零基础学习,安装与配置
今天给大家介绍一款国产开源免费的接口管理工具 - PostIn,PostIn包含项目管理、接口调试、接口文档设计、MOCK、接口用例、性能测试、测试计划等模块,支持免登陆本地接口调试,一键安装零配置,页面设计简洁易用,本文将介绍如何快速安装配置。
1、安装
私有部署版本支持多种操作系统,包括 Linux、Docker、Windows及macOS,方便团队根据自身环境灵活选择下载、安装方式。
1.1 Linux 环境
以Ubuntu为例,CentOS的下载、安装参考官方文档。
- 下载,Ubuntu 安装包下载地址:PostIn下载,或者执行如下命令在线下载安装包。
wget -O tiklab-postin-1.2.6.deb https://install.tiklab.net/app/install/postin/v1.2.6/tiklab-postin-1.2.6.deb
- 安装,将安装包上传到服务器,使用如下命令安装,默认安装目录在/opt下。
dpkg -i tiklab-postin-1.1.4.deb
- 启动,进入安装目录/opt/tiklab-postin/bin目录下,执行./postin start即可启动成功。
1.2 Docker 环境
- 下载,Docker安装包下载地址:PostIn下载,或者执行如下命令在线下载安装包。
wget -O tiklab-postin-1.2.6.tar.gz https://install.tiklab.net/app/install/postin/v1.2.6/tiklab-postin-1.2.6.tar.gz
- 安装,在执行以下命令加载镜像。
docker load -i tiklab-postin-x.x.x.tar.gz
- 启动,执行以下镜像启动即可。
docker run -itd -p 9300:9300 tiklab-postin-x.x.x
1.3 Windows 环境
- 下载,Windows安装包下载地址:PostIn下载,下载Windows安装包。下载完成后,获取名为 tiklab-postin-.x.x.x.exe 的可执行文件。
- 安装,双击运行可执行文件,选择安装位置并点击安装。
- 启动,点击桌面快捷方式启动 PostIn 服务。
1.4 macOS 环境
- 下载,Mac安装包下载地址:PostIn下载,下载Mac安装包,下载完成后,获取名为 tiklab-postin-.x.x.x.dmg 的可执行文件。
- 安装,双击打开 .dmg 文件,将 Postin 拖入 应用程序 文件夹。
- 启动,点击 应用程序 文件夹中的 PostIn 快捷方式启动服务。
2、登录
启动后,默认可以通过 http://ip:9300 访问,默认用户名/密码为admin/123456。
默认支持通过账号密码登录,满足基础登录需求。若需要使用企业微信、钉钉或 LDAP 等高级登录方式,可参阅PostIn文档获取相关配置说明。
PostIn登录页
成功登录系统进入PostIn首页。
PostIn首页
3、配置
允许自定义端口、数据存放目录、数据库连接、统一登录设置等配置,以满足特定个性化需求。配置文件yaml文件默认位置:
| 系统 | 默认位置 |
| Windows | 默认在安装目录 --> conf目录下application.yaml文件 |
| Mac | 默认在app下的Contents --> conf 目录下application.yaml文件 |
| Linux | 默认在/opt/tiklab-postin/conf 目录下application.yaml文件 |
| Docker | 默认在镜像文件内/usr/local/tiklab-postin/conf 目录下application.yaml文件 |
3.1 自定义端口
允许用户自定义应用的启动端口,以便在特定网络环境下避免端口冲突或满足其他配置需求。
端口配置
| 属性 | 说明 |
| server.port | 系统启动的端口号(可更改)。 |
3.2 自定义数据库
支持自定义数据库连接方式,用户可以选择使用内嵌数据库或指定外部数据库地址。根据需求配置数据库连接。
数据库配置
| 属性 | 说明 |
| postgresql.embbed.enable | 是否使用内嵌数据库,true:使用 false:不使用。如果配置为false,需要把该文件中jdbc下的数据库连接信息更改为自己的数据库地址,用户名以及密码。 |
| postgresql.database | 是否使用内嵌数据库默认连接的数据库,默认为tiklab_postin如果更改次默认值需要把jdbc下的数据库连接信息更改为新的数据地址。 |
| postgresql.db.port | 使用内嵌数据库的启动端口,默认为9301,如果更改需要同时把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_postin?stringtype=unspecified 其中 9301 为端口号,postin_db为数据库名字,这两个可更改。 |
| jdbc.username | 数据库登录名。 |
| jdbc.password | 数据库登录密码。 |
3.3 自定义数据目录
支持用户自定义数据存放目录的位置,帮助用户根据需要选择存储路径。
数据目录配置
| 属性 | 说明 |
| DATA_HOME | 数据文件存放地址。 |
有兴趣的开发者朋友可以去Tiklab官网体验、下载安装使用。
