这是一个适用于 Linux AMD64 的 TeamTalk 5 Server Docker 镜像。
linux/amd64镜像内部使用 Ubuntu 24.04 提供 TeamTalk 所需的 glibc，因此可以运行在 Ubuntu、Debian、Fedora、Rocky Linux、Arch Linux 和 OpenWrt x86_64 等安装了 Docker 的 Linux 系统上。
容器内的持久化目录是：
/data
下面的示例将它映射到宿主机的 /opt/tt5srv/data：
| 内容 | 宿主机路径 | 容器内路径 |
|---|---|---|
| 配置文件 | /opt/tt5srv/data/tt5srv.xml | /data/tt5srv.xml |
| 日志文件 | /opt/tt5srv/data/tt5srv.log | /data/tt5srv.log |
宿主机目录可以自行修改，但容器内路径应保持为 /data。在 OpenWrt 上应将
宿主机目录放在持久化存储中。
先创建数据目录：
mkdir -p /opt/tt5srv/data
首次启动前运行 TeamTalk 配置向导：
docker run --rm -it \
--network host \
-v /opt/tt5srv/data:/data \
fltx2004/tt5srv:latest \
-wizard -wd /data
向导询问文件存储目录时，最好在/data 里提前创建共享文件夹，就可以填写：
/data/files
向导生成的 tt5srv.xml 会保存在宿主机的 /opt/tt5srv/data 中。
完成配置后启动服务器：
docker run -d \
--name tt5srv \
--restart unless-stopped \
--network host \
-v /opt/tt5srv/data:/data \
fltx2004/tt5srv:latest \
-nd -wd /data -l /data/tt5srv.log -verbose
以上命令以前台模式运行服务，并读取 /data/tt5srv.xml。
如果不希望使用 host 网络，可以将 --network host 替换为端口映射：
-p 10333:10333/tcp -p 10333:10333/udp
如果向导中修改了端口，需要同步修改映射端口。
创建 /opt/tt5srv/compose.yaml：
services:
tt5srv:
image: fltx2004/tt5srv:latest
container_name: tt5srv
network_mode: host
restart: unless-stopped
volumes:
- /opt/tt5srv/data:/data
command:
- -nd
- -wd
- /data
- -l
- /data/tt5srv.log
- -verbose
如果尚未运行配置向导：
docker compose -f /opt/tt5srv/compose.yaml run --rm \
tt5srv -wizard -wd /data
启动服务器：
docker compose -f /opt/tt5srv/compose.yaml up -d
如果已经通过 docker run 创建了同名容器，第一次切换到 Compose 前需要先
删除旧容器：
docker rm -f tt5srv
绑定目录中的配置和上传文件不会被删除。
旧版 Compose 使用 docker-compose 命令，其余参数相同。
查看运行状态：
docker ps --filter name=tt5srv
查看实时日志：
docker logs -f tt5srv
重启、停止或启动服务器：
docker restart tt5srv
docker stop tt5srv
docker start tt5srv
查看镜像中的 TeamTalk 完整版本：
docker run --rm fltx2004/tt5srv:latest --version
升级前建议备份数据目录：
tar -C /opt/tt5srv -czf \
/opt/tt5srv-backup-$(date +%Y%m%d-%H%M%S).tar.gz data
docker compose -f /opt/tt5srv/compose.yaml up -d --pull always
旧版 Compose 可以使用：
docker-compose -f /opt/tt5srv/compose.yaml pull && \
docker-compose -f /opt/tt5srv/compose.yaml up -d
先拉取新镜像：
docker pull fltx2004/tt5srv:latest
删除旧容器并使用相同的数据目录重新创建：
docker rm -f tt5srv
docker run -d \
--name tt5srv \
--restart unless-stopped \
--network host \
-v /opt/tt5srv/data:/data \
fltx2004/tt5srv:latest \
-nd -wd /data -l /data/tt5srv.log -verbose
生产环境可以使用固定版本标签：
fltx2004/tt5srv:5.22
Compose 中相应修改为：
image: fltx2004/tt5srv:5.22
修改版本后重新创建容器：
docker compose -f /opt/tt5srv/compose.yaml up -d --pull always
如果新版本出现问题，将镜像标签改回之前的版本并再次执行上述命令即可回滚。
自动切换到新镜像，仍然需要重新创建容器。
Fedora、Rocky Linux、RHEL 等启用 SELinux 的系统如果遇到目录权限错误，
可以给绑定目录添加 :Z：
volumes:
- /opt/tt5srv/data:/data:Z
对应的 docker run 参数为：
-v /opt/tt5srv/data:/data:Z
Content type
Image
Digest
sha256:1fdef9da0…
Size
32.9 MB
Last updated
3 days ago
docker pull fltx2004/tt5srv