1. 下载服务器文件#

请访问 TeamSpeak 官方下载页面 获取最新的 64 位 Linux 服务器链接。

1
# 注意：请将下面的链接替换为你在官网找到的最新版本
2
wget https://files.teamspeak-services.com/releases/server/3.13.7/teamspeak3-server_linux_amd64-3.13.7.tar.bz2

2. 解压到 ts3 的主目录#

将文件直接解压到刚创建的 /home/ts3 目录中。

1
sudo tar -xf teamspeak3-server_linux_amd64-*.tar.bz2 -C /home/ts3

3. 整理文件并接受许可#

解压会生成一个 teamspeak3-server_linux_amd64 目录，需要将里面的文件都移出来。

1
# 将文件全移出来
2
sudo mv /home/ts3/teamspeak3-server_linux_amd64/* /home/ts3/
3

4
# 删掉空目录和安装包
5
sudo rmdir /home/ts3/teamspeak3-server_linux_amd64
6
sudo rm teamspeak3-server_linux_amd64-*.tar.bz2
7

8
# 必须创建此文件以表示同意许可协议
9
sudo touch /home/ts3/.ts3server_license_accepted

4. 修复文件所有权#

由于之前是以 root 身份操作的，所有文件现在都归 root 所有。必须将它们的所有权交还给 ts3 用户。

WARNING

警告：如果跳过这一步，服务器在后续步骤中极有可能启动失败，并导致 Segmentation fault (段错误) 崩溃。

1
sudo chown -R ts3:ts3 /home/ts3

1. 临时切换到 ts3 用户#

使用此命令，即使用户被禁止登录，也可以临时获取一个 shell：

1
sudo su -s /bin/bash ts3

2. 启动服务器#

此时的提示符应该是 ts3@…。

1
cd /home/ts3  # 确保在 /home/ts3 目录里
2
./ts3server_startscript.sh start

3. 获取 Token#

服务器启动后，Token 会保存在日志中。运行：

1
# 从最新的日志里抓取 token
2
grep "token=" logs/*_1.log | tail -n 1

你会看到类似 token=XXXXXXXXXXXXXXXXXXXXXXXXXX 的输出。请立即复制并保存好这个 Token！这是首次登录所需的管理员密钥。

4. 停止服务器并退出#

获取 Token 后，先停止服务器，以便稍后使用 systemd 服务来管理它。

1
./ts3server_startscript.sh stop
2
exit

(输入 exit 后，将退回到 root 用户提示符)

1. 创建服务文件#

1
sudo nano /etc/systemd/system/teamspeak.service

2. 粘贴以下内容#

将下面的所有文本复制粘贴到 nano 编辑器中。

1
[Unit]
2
Description=TeamSpeak 3 Server
3
After=network.target
4

5
[Service]
6
WorkingDirectory=/home/ts3/
7
User=ts3
8
Group=ts3
9
Type=forking
10
ExecStart=/home/ts3/ts3server_startscript.sh start
11
ExecStop=/home/ts3/ts3server_startscript.sh stop
12
PIDFile=/home/ts3/ts3server.pid
13
Restart=always
14
RestartSec=5
15

16
[Install]
17
WantedBy=multi-user.target

(按 Ctrl + X，然后按 Y，最后按 Enter 保存退出)

3. 启动并启用服务#

1
sudo systemctl daemon-reload          # 重新加载配置
2
sudo systemctl enable teamspeak.service # 设置开机自启
3
sudo systemctl start teamspeak.service  # 立即启动

4. 检查服务状态#

1
sudo systemctl status teamspeak.service

如果一切正常，你应该会看到 Active: active (running)。

故障一：服务起不来，systemctl status 显示 (auto-restart) 或 (code=killed, signal=SEGV)#

问题： 服务器崩溃并无限重启，日志中出现 Segmentation fault (段错误)。

原因： 几乎 100% 是因为你在步骤三的第 4 步 (chown) 之前，曾不小心以 root 身份启动了服务器。root 用户创建的临时锁文件（通常在 /dev/shm 中）与 ts3 用户冲突，导致崩溃。

解决方案 (最简单)： 重启服务器。重启会清除所有临时的共享内存和锁文件。

1
# 1. 先停止服务，防止它继续尝试重启
2
sudo systemctl stop teamspeak.service
3

4
# 2. 重启你的整台服务器
5
sudo reboot
6

7
# 3. 等待服务器重启后，重新登录，服务应该会自动启动。
8
sudo systemctl status teamspeak.service

此时服务应该会显示 active (running)。

故障二：数据迁移或重装客户端后，丢失了管理员权限#

问题： 你从 Windows 迁移了数据（ts3server.sqlitedb），或者你重装了 TS3 客户端，导致连接服务器时不再是管理员。

原因： TS3 的管理员权限是绑定在你客户端的一个”身份 (Identity)“本地文件上的，而不是绑定在你的 myTeamSpeak 登录账号上。重装客户端会生成”新身份”，服务器（加载了旧数据库）无法识别这个新身份。

解决方案： 你需要登录服务器后端 (ServerQuery)，手动创建一个新 Token，并授权给你当前的”新身份”。请严格按以下步骤操作：

1
sudo systemctl stop teamspeak.service

1
sudo su -s /bin/bash ts3  # 切换到 ts3 用户
2
cd /home/ts3
3
./ts3server serveradmin_password=XXXXXXXXXXXXXX

1
sudo apt install telnet -y

1
telnet localhost 10011

1
# 登录 (使用刚设置的密码)
2
login serveradmin XXXXXXXXXXXXXX
3
# 选择服务器
4
use 1
5
# 创建新 Token
6
tokenadd tokentype=0 tokenid1=6 tokenid2=0

1
sudo systemctl start teamspeak.service