在Ubuntu上部署TTorrent-SYD Tracker作为系统服务

本文档记录了在Ubuntu服务器上将TTorrent-SYD Tracker配置为系统服务的完整部署过程。这个指南适用于需要运行持久化BitTorrent tracker服务的场景，特别是在使用修改版的ttorrent-syd源代码情况下。

项目信息

项目名称: ttorrent-syd
项目仓库: https://gitee.com/syd2333/ttorrent-syd.git

环境准备

Ubuntu服务器
Java开发环境
Maven构建工具
已修改的TTorrent-SYD源代码

部署步骤

1. 克隆项目代码

首先克隆ttorrent-syd项目代码：

git clone https://gitee.com/syd2333/ttorrent-syd.git
cd ttorrent-syd

2. 编译TTorrent-SYD项目

编译项目以生成必要的类文件：

mvn clean install

注意：这里修改了源代码，测试一定会失败，但这通常不影响部署过程。测试失败是预期的，特别是修改了HTTP数据流逻辑后。

3. 生成类路径文件

使用Maven生成一个包含所有依赖项的类路径文件，这样可以避免每次启动服务时都需要运行Maven:

cd ~/ttorrent-syd
mvn dependency:build-classpath -Dmdep.outputFile=classpath.txt

4. 创建启动脚本

创建一个启动脚本来运行Tracker:

sudo nano ~/ttorrent-syd/start-tracker.sh

添加以下内容：

#!/bin/bash
cd ~/ttorrent-syd
# 使用预先生成的classpath.txt
CLASSPATH="ttorrent-tracker/build/test-classes:ttorrent-tracker/build/classes:common/build/classes:bencoding/build/classes:test-api/build/classes:$(cat classpath.txt)"
echo "Starting tracker with classpath: $CLASSPATH"
java -cp "$CLASSPATH" com.turn.ttorrent.tracker.TrackerTest

设置脚本为可执行：

sudo chmod +x ~/ttorrent-syd/start-tracker.sh

5. 创建SystemD服务配置

创建一个SystemD服务单元文件：

sudo nano /etc/systemd/system/ttorrent-syd-tracker.service

添加以下内容：

[Unit]
Description=TTorrent SYD Tracker Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/ttorrent-syd
ExecStart=/bin/bash /root/ttorrent-syd/start-tracker.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

注意：根据您的实际路径调整WorkingDirectory。

6. 启动并管理服务

重新加载SystemD配置：

sudo systemctl daemon-reload

启动服务：

sudo systemctl start ttorrent-syd-tracker.service

验证服务状态：

sudo systemctl status ttorrent-syd-tracker.service

设置开机自启动（可选）：

sudo systemctl enable ttorrent-syd-tracker.service

故障排除

查看服务日志

如果服务无法正常启动，可以通过以下命令查看服务日志：

sudo journalctl -u ttorrent-syd-tracker.service

实时查看日志：

sudo journalctl -u ttorrent-syd-tracker.service -f

常见问题

服务启动超时：
- 原因：Maven下载依赖或编译项目时间过长
- 解决方案：使用预先生成的classpath.txt文件，避免每次启动时运行Maven
类路径问题：
- 原因：SystemD服务文件中的$(cat classpath.txt)无法正确展开
- 解决方案：使用启动脚本，在脚本中展开类路径
错误代码返回：
- 原因：Java运行时错误，可能是缺少依赖或类路径错误
- 解决方案：检查日志详情，修正类路径或Java命令

ttorrent-syd部署