RailWise KB已发布

视频教程：TSM服务端部署

RAILWISE-TSM服务端部署视频教程配套文档，涵盖服务器准备、环境配置、服务安装、数据库初始化及验证。

复核 2026-07-09入门公开可引用RailWise 技术团队

learning-path

视频教程：TSM服务端部署

视频概述

项目	内容
视频标题	RAILWISE-TSM 服务端部署指南
视频时长	约25分钟
难度等级	⭐⭐⭐ 高级
目标观众	运维工程师、IT管理员
配套版本	TSM v3.0+

完成本视频学习后，您将能够：

准备TSM服务器环境
安装和配置TSM服务端
初始化数据库和系统参数
验证部署结果并排查常见问题

前置知识

前置知识	掌握程度	说明
Linux基础	掌握	了解Linux命令、文件系统、服务管理
Docker基础	了解	了解Docker容器基本概念
数据库基础	了解	了解PostgreSQL基本操作
网络基础	了解	了解IP、端口、防火墙等概念

步骤详解

步骤1：服务器准备（约4分钟）

操作内容：

确认服务器配置：

配置项	最低要求	推荐配置
CPU	4核	8核+
内存	8GB	16GB+
磁盘	100GB SSD	500GB SSD+
网络	10Mbps	100Mbps+
操作系统	Ubuntu 20.04	Ubuntu 22.04 LTS

更新系统：

sudo apt update && sudo apt upgrade -y

安装基础工具：

sudo apt install -y curl wget git vim htop

[截图占位符：服务器配置信息及系统更新]

步骤2：安装Docker（约3分钟）

操作内容：

安装Docker：

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

安装Docker Compose：

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

验证安装：

docker --version
docker-compose --version

[截图占位符：Docker版本验证输出]

步骤3：下载TSM部署包（约3分钟）

操作内容：

mkdir -p /opt/railwise-tsm
cd /opt/railwise-tsm

下载部署包：

wget https://www.railwise.cn/downloads/tsm/tsm-server-3.0.0.tar.gz
tar -xzf tsm-server-3.0.0.tar.gz

查看部署文件：

ls -la
# 预期输出: docker-compose.yml config/ scripts/

[截图占位符：部署包解压后的文件结构]

步骤4：配置环境（约5分钟）

操作内容：

编辑环境配置文件：

vim .env

配置关键参数：

# 数据库配置
DB_HOST=postgres
DB_PORT=5432
DB_NAME=tsm_db
DB_USER=tsm_user
DB_PASSWORD=your_secure_password

# 服务配置
SERVER_PORT=8080
SERVER_HOST=0.0.0.0

# 存储配置
DATA_PATH=/opt/railwise-tsm/data
LOG_PATH=/opt/railwise-tsm/logs

# 安全配置
JWT_SECRET=your_jwt_secret_key
API_KEY=your_api_key

配置Nginx反向代理（可选）：

sudo cp config/nginx-tsm.conf /etc/nginx/sites-available/
sudo ln -s /etc/nginx/sites-available/nginx-tsm.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

[截图占位符：环境配置文件内容]

务必修改默认密码和密钥
使用强密码策略
限制数据库访问权限
配置防火墙规则

步骤5：启动服务（约4分钟）

操作内容：

启动TSM服务：

docker-compose up -d

查看服务状态：

docker-compose ps

查看日志：

docker-compose logs -f tsm-server

[截图占位符：服务启动状态及日志输出]

步骤6：初始化数据库（约3分钟）

操作内容：

执行数据库初始化：

docker-compose exec tsm-server npm run db:migrate
docker-compose exec tsm-server npm run db:seed

创建管理员账户：

docker-compose exec tsm-server npm run create:admin -- --username admin --password your_password

验证初始化：

docker-compose exec postgres psql -U tsm_user -d tsm_db -c "\dt"

[截图占位符：数据库表列表]

步骤7：验证部署（约3分钟）

操作内容：

访问TSM Web界面：

http://your-server-ip:8080

登录管理员账户
检查系统状态页面
验证API接口：

curl http://your-server-ip:8080/api/v1/health

[截图占位符：TSM Web界面及系统状态]

关键操作要点

要点	说明	重要性
服务器配置	确保满足最低配置要求	⭐⭐⭐
安全配置	修改默认密码，配置防火墙	⭐⭐⭐
数据备份	配置自动备份策略	⭐⭐⭐
日志监控	配置日志收集和监控	⭐⭐
SSL证书	生产环境配置HTTPS	⭐⭐

常见问题

Q1: 服务启动失败

原因：端口冲突或配置错误

解决：

# 检查端口占用
sudo lsof -i :8080

# 查看详细日志
docker-compose logs tsm-server

Q2: 数据库连接失败

原因：数据库配置错误或网络问题

解决：

# 检查数据库容器状态
docker-compose ps postgres

# 测试数据库连接
docker-compose exec tsm-server npx pg-ping --host postgres --port 5432

Q3: 无法访问Web界面

原因：防火墙或网络配置问题

解决：

# 检查防火墙
sudo ufw status
sudo ufw allow 8080

# 检查服务监听
sudo ss -tlnp | grep 8080

课后练习

练习1：服务管理

练习启动、停止、重启TSM服务，熟悉docker-compose命令。

练习2：日志查看

查看各服务日志，了解日志格式和常见信息。

练习3：备份恢复

执行数据库备份，然后模拟恢复过程。

练习4：监控配置

配置基础监控（CPU、内存、磁盘），设置告警阈值。

视频教程：TSM服务端部署

视频教程：TSM服务端部署

视频概述

前置知识

步骤详解

步骤1：服务器准备（约4分钟）

步骤2：安装Docker（约3分钟）

步骤3：下载TSM部署包（约3分钟）

步骤4：配置环境（约5分钟）

步骤5：启动服务（约4分钟）

步骤6：初始化数据库（约3分钟）

步骤7：验证部署（约3分钟）

关键操作要点

常见问题

Q1: 服务启动失败

Q2: 数据库连接失败

Q3: 无法访问Web界面

课后练习

练习1：服务管理

练习2：日志查看

练习3：备份恢复

练习4：监控配置

相关文档