Skip to content

常规部署

常规部署,也就是将 TacPort 直接安装到主机系统中,这里的主机是指运行 Linux 系统的任意主机,包括物理主机、虚拟机、云主机等,甚至可以是 WSL 这样的虚拟化环境。

准备工作

操作系统

TacPort 服务需要由 systemd 来进行管理。一般常用的 Linux 发行版均可支持[1]。可以通过执行 systemctl --version来检查您的操作系统是否支持 systemd。

TacPort 服务支持 amd64 及 arm64 架构[2]

目前已经部署验证过的系统有:

  • amd64
    • Ubuntu 18.04 LTS / 24.04 LTS
    • Rocky 9.4
  • arm64/aarch64
    • Kylin 银河麒麟 V10 SP3

注意

如果您发现有无法部署的操作系统,请与我们联系改进。

初始化数据库

提示

如果您有数据库管理员账号及密码,可以跳过初始化数据库的步骤,在部署后由 TacPort 来为您创建并初始化数据库。

下面以 MySQL 8.x 为例说明如何为 TacPort 创建库及用户,并授予相应的访问权限。示例中的信息如下:

  • 库名:tacport
  • 用户:tacport
  • 密码:Pas5word!
shell
# 先以数据库管理员身份连接数据库
mysql -uroot -p
# 此时提示输入密码,请输入数据库root账号的密码

输入正确的密码后,进入MySQL交互式环境:

sql
-- 进入MySQL交互式环境后,执行以下SQL语句:
CREATE DATABASE tacport DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
CREATE USER `tacport`@`localhost` IDENTIFIED BY 'Pas5word!';
GRANT ALL PRIVILEGES ON tacport.* TO `tacport`@`localhost`;
FLUSH PRIVILEGES;

-- 最后执行quit退出MySQL交互式环境
quit;

安装部署

安装

将下载的 TacPort 服务端安装包解压缩后,执行其中的 install.sh 脚本,即进入安装过程,如下图所示:

安装步骤
安装步骤
  • 1所示,将安装包解压缩得到同名的安装包目录;
  • 2所示,安装包目录中有 install.sh 安装脚本;
  • 3所示,执行 install.sh 脚本;
  • 4所示,需要设置安装目录,默认为 /opt/tacport-X.Y.Z,其中 x.y.z 为版本号,您可以直接回车来使用此默认安装目录;
  • 5所示,安装会在几秒中内完成,并自动启动节点服务;
  • 启动服务后,会检查并显示出节点服务的状态,如6所示;
  • ⚠️注意⚠️,如7所示,首次部署后,需要访问 http://TP_HOST_IP:52100/init 进行初始化;
  • 安装成功后,会自动创建一个软链接(/opt/tacport)到安装目录,方便日常管理;
  • 8所示,安装成功了!🎉🎉🎉

安装完成后,您就可以访问 http://您的TacPort服务器IP:52100 来访问 TacPort 服务了。如果您修改了默认的 api 服务端口,请注意替换。

初始化

如果您是首次部署,TacPort 服务会展示初始化页面(http://您的TacPort服务器IP:52100/init),以便进行初始化操作,如下图所示:

提醒

如果数据库尚未创建或初始化,而 TacPort 节点服务并不展示初始化页面,而是直接报错退出,请检查配置是否允许进行初始化操作:

yaml
# 配置文件中
allow_init: yes
shell
# 环境变量中
TP_ALLOW_INIT=yes
初始化
初始化
  • 1所示,请仔细检查数据库配置是否正确;
  • 如果数据库尚未创建,您可以选择:
    • 在这里提供数据库管理员账号及密码,初始化程序会自动为您创建所需库表及数据库用户,如2所示;
    • 或者要求 DBA (数据库管理员) 为您创建库表及数据库用户,就如前面 准备工作-初始化数据库 一节所描述,一旦库表及数据库用户创建好,可以刷新本页面来重新加载配置并进行检查;
  • 初始化页面同时会检查 Redis 服务是否能正常访问,如3所示;
  • 您需要为 TacPort 系统配置管理员及密码,如4所示;
  • 一切准备就绪后,点击“开始初始化”按钮。

初始化成功后会自动跳转到 TacPort 服务入口页面:

跳转到服务入口
跳转到服务入口

至此,您就可以正常使用 TacPort 的服务了!

卸载

如同安装一样,执行 ./install.sh 脚本,然后按提示操作,如下图所示:

卸载
卸载
  • 1所示,执行 ./install.sh 脚本;
  • 检测到已安装的版本,如2所示,按提示输入 u 并回车(不区分大小写)开始卸载;
  • 脚本会停止服务并从 systemd 自动启动列表中移除,如3所示;
  • 出于对用户数据的保护,脚本不会删除您的文件,包括配置文件、远程会话录像等数据,如果您确定要彻底卸载 TacPort,请按提示手动删除如4所示的目录和文件。

常用信息

默认安装信息

  • 安装路径:/opt/tacport-X.Y.Z,可以使用软链接/opt/tacport来访问
  • 配置文件:/opt/tacport/data/etc/config.yaml
  • 日志文件:/opt/tacport/data/log
  • 录像文件:/opt/tacport/data/record

服务日常管理

  • 查看状态:systemctl status tpnode
  • 启动服务:systemctl start tpnode
  • 停止服务:systemctl stop tpnode
  • 重启服务:systemctl restart tpnode

  1. 已在 Ubuntu 18.04 LTS / 24.04 LTS、Rocky 9.4 等发行版上测试验证。 ↩︎

  2. 对 arm64 架构的支持已在 Kylin(银河麒麟) V10 SP3 上测试验证。 ↩︎