常规部署
常规部署，也就是将 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 - 密码：
Pas5*w0rd
# 先以数据库管理员身份连接数据库
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 'Pas5*w0rd';
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会进入初始化界面； - 安装成功后，会自动创建一个软链接(
/opt/tacport)到安装目录，方便日常管理； - 如8所示，安装成功了！🎉🎉🎉
安装完成后，您就可以访问 http://您的TacPort服务器IP:52100 来访问 TacPort 服务了。如果您修改了默认的 api 服务端口，请注意替换。
初始化
如果您是首次部署，TacPort 服务会展示初始化页面（http://您的TacPort服务器IP:52100），以便进行初始化操作。
提醒
如果数据库尚未创建或初始化，而 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