常规部署
常规部署,也就是将 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!
# 先以数据库管理员身份连接数据库
mysql -uroot -p
# 此时提示输入密码,请输入数据库root账号的密码
输入正确的密码后,进入MySQL交互式环境:
-- 进入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 节点服务并不展示初始化页面,而是直接报错退出,请检查配置是否允许进行初始化操作:
# 配置文件中
allow_init: yes
# 环境变量中
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