MacOS下PostIn安装配置指南

PostIn是一款开源免费的接口管理工具，下面介绍私有部署版本的MacOS下安装与配置。私有部署版本更适合有严格数据安全要求的企业，实现对数据和系统的完全控制。

1、MacOS服务端安装

Mac安装包下载地址：下载Mac安装包
下载完成后，获取名为 tiklab-postin.x.x.x.dmg 的可执行文件。
双击打开 .dmg 文件，将 Postin 拖入应用程序文件夹。
安装完成后，点击应用程序文件夹中的 Postin 快捷方式启动服务。

2、MacOS桌面端安装

Mac安装包下载地址：下载Mac桌面端
下载完成后，获取名为 tiklab-postin-client.x.x.x.dmg 的可执行文件。
双击打开 .dmg 文件，将 Postin 拖入应用程序文件夹。
安装完成后，点击应用程序文件夹中的 Postin 快捷方式启动桌面端。

3、登录

3.1 默认账号

用户名：admin，密码：123456

首页：

3.2 登录类型

默认本地

默认支持通过账号密码登录，满足基础登录需求。若需要使用企业微信、钉钉或 LDAP 等高级登录方式，可参阅 PostIn 文档获取相关配置说明。

统一登录

支持通过 Soular 门户中心的统一登录，登录方式同上，方便用户在多个应用间无缝切换。统一登录方式需安装 Soular，具体安装步骤可参考Soular 文档。

4、配置

允许自定义端口、数据存放目录、数据库连接、数据库备份策略和统一登录设置，以满足特定个性化需求。

yaml文件默认位置：

系统	默认位置
Windows	默认在安装目录 --> conf目录下
Mac	默认在app下的Contents --> conf 目录下
Linux	默认在/opt/postin/conf 目录下
Docker	默认在镜像文件内/usr/local/postin/conf 目录下

4.1 应用启动端口自定义

允许用户自定义应用的启动端口，以便在特定网络环境下避免端口冲突或满足其他配置需求。

属性	值
server.port	系统启动的端口号（可更改）

4.2 数据存放目录自定义

支持用户自定义数据存放目录的位置，帮助用户根据需要选择存储路径。

属性	值
DATA_HOME	数据文件存放地址

4.3 数据库自定义

支持自定义数据库连接方式，用户可以选择使用内嵌数据库或指定外部数据库地址。根据需求配置数据库连接。

属性	值
postgresql.embbed.enable	是否使用内嵌数据库，true:使用 false:不使用。如果配置为false，需要把该文件中jdbc下的数据库连接信息更改为自己的数据库地址，用户名以及密码。
postgresql.database	是否使用内嵌数据库默认连接的数据库，默认为matflow-ee如果更改次默认值需要把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/postin_db?stringtype=unspecified 其中 9301 为端口号，postin_db为数据库名字，这两个可更改但是端口号必须与postgresql.db.port 保持一致数据库名字必须与postgresql.database 保持一致
jdbc.username	数据库登录名，必须与postgresql.db.username一致
jdbc.password	数据库登录密码，必须与postgresql.db.password一致

4.4 备份数据库自定义

允许用户自定义备份配置，包括设置备份的时间和选择备份文件的存储路径。

属性	值
backups.time	备份时间，corn表达式格式，默认为凌晨两点。
backups.dir	备份地址，默认为${DATA_HOME}/backups，即应用数据目录下的backups文件夹。

4.5 配置统一登录

统一登录，即统一使用Soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。需要安装Soular，具体安装详见Soular文档

属性	说明
soular.embbed.enable	是否为统一登录，true: 本地模式 false：统一模式
soular.address	Soular的应用地址，统一模式必填

5、更新

Postin支持用户使用脚本一键升级，只需要执行应用升级脚本即可。

Postin的升级脚本位置：

系统	默认位置
Windows	进入默认安装目录 --> 进入bin目录 --> 执行update.bat脚本。
Mac	进入app下的Contents --> 进入bin目录 --> 执行update.sh脚本。
Linux	默认在/opt/postin/bin 目录下 --> 执行update.sh脚本。
Docker	默认在镜像文件内/usr/local/postin/bin 目录下 --> 执行update.sh脚本。