注意：这是teamspeak官方镜像的amd64架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“除amd64之外的架构？”以及官方镜像FAQ中的“Git中镜像的源已更改，现在该怎么办？”。

快速参考

• 维护者：
  TeamSpeak开发者 nwerensteijn 和 muenchow

• 获取帮助的地方：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及相应的 Dockerfile 链接

警告：此镜像在 amd64 架构上不受支持

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  无支持的架构

• 镜像 artifact 详情：
  repo-info 仓库的 repos/teamspeak/ 目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/teamspeak 标签
  official-images 仓库的 library/teamspeak 文件（历史记录）

• 本描述的来源：
  docs 仓库的 teamspeak/ 目录（历史记录）

什么是 TeamSpeak？

TeamSpeak 提供理想的语音通信解决方案，适用于在线游戏、教育与培训、企业内部沟通以及与朋友和家人保持联系。我们的主要关注点是提供易用、高安全标准、优质语音质量且低系统和带宽占用的解决方案。

teamspeak.com

!logo

如何使用此镜像

查看许可协议

$ docker run -e TS3SERVER_LICENSE=view amd64/teamspeak

启动 TeamSpeak 服务器

接受许可协议并将端口映射到主机：

$ docker run -p 9987:9987/udp -p 10011:10011 -p 30033:30033 -e TS3SERVER_LICENSE=accept amd64/teamspeak

然后你可以在 TeamSpeak 客户端中连接到 localhost。请记录生成的服务器查询密码和服务器管理员权限密钥，这些是管理 TeamSpeak 服务器所必需的。

容器 shell 访问

docker exec 命令允许你在 Docker 容器内运行命令。以下命令将为你的 teamspeak 容器提供一个 shell：

$ docker exec -it some-teamspeak sh

TeamSpeak 服务器日志可通过 Docker 的容器日志查看：

$ docker logs some-teamspeak

使用 docker compose

teamspeak 的 compose.yaml 示例：

services:
  teamspeak:
    image: teamspeak
    restart: always
    ports:
      - 9987:9987/udp
      - 10011:10011
      - 30033:30033
    environment:
      TS3SERVER_DB_PLUGIN: ts3db_mariadb
      TS3SERVER_DB_SQLCREATEPATH: create_mariadb
      TS3SERVER_DB_HOST: db
      TS3SERVER_DB_USER: root
      TS3SERVER_DB_PASSWORD: example
      TS3SERVER_DB_NAME: teamspeak
      TS3SERVER_DB_WAITUNTILREADY: 30
      TS3SERVER_LICENSE: accept
  db:
    image: mariadb
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: teamspeak

运行 docker compose up，等待其完全初始化后，使用 TeamSpeak 客户端连接 localhost:9987 或 主机IP:9987（视情况而定）。

环境变量

启动 teamspeak 镜像时，可通过在 docker run 命令行中传递一个或多个环境变量来调整 TeamSpeak 服务器实例的配置。

• TS3SERVER_LICENSEPATH：设置 TeamSpeak 服务器查找 licensekey.dat 的路径。此变量是 licensekey.dat 应所在的目录路径。默认为 /var/ts3server/。

• TS3SERVER_DB_PLUGIN：控制 TeamSpeak 服务器使用的数据库类型。

• TS3SERVER_DB_PLUGINPARAMETER：此变量的内容将作为 parameter 发送给数据库插件。

• TS3SERVER_DB_SQLPATH：控制 TeamSpeak 服务器查找 SQL 文件的位置。默认为 /opt/ts3server/sql/。

• TS3SERVER_DB_SQLCREATEPATH：用于初始化数据库的 SQL 脚本路径。该路径相对于 TS3SERVER_DB_SQLPATH。

• TS3SERVER_DB_CONNECTIONS：控制数据库的并发连接数。必须至少为 2 且最多为 100。默认为 10。

• TS3SERVER_DB_CLIENTKEEPDAYS：TeamSpeak 服务器保留未使用用户身份的天数。已添加到组的用户不会被清理，但访客会被清理。

• TS3SERVER_IP_WHITELIST：控制白名单的位置。该文件包含豁免洪水保护系统的 IP 地址列表。警告：不要添加任何你不信任的 IP 地址，因为这将允许它们 Flood 服务器。

• TS3SERVER_IP_BLACKLIST：控制黑名单的位置。该文件包含无论如何都无法连接到服务器查询接口的 IP 地址列表，即使在服务器重启后也是如此。

• TS3SERVER_LOG_PATH：控制服务器存储日志文件的文件夹。默认为 /var/ts3server/logs/。

• TS3SERVER_LOG_QUERY_COMMANDS：如果此变量设置为 1，发送到服务器的每个查询命令都将被记录。
  
  警告：虽然这在遇到服务器问题时可能有帮助，但请注意这可能导致日志文件变得极大。除非确实需要记录所有命令，否则建议将此变量设置为 0。

• TS3SERVER_LOG_APPEND：如果此变量设置为 1，所有新日志条目将写入每个虚拟服务器的单个文件中。建议将此变量设置为 0，以便更轻松地查看日志。

• TS3SERVER_QUERY_PROTOCOLS：可用于连接到 ServerQuery 的协议的逗号分隔列表。可能的值为 raw 和 ssh。如果指定 raw，则在 10011/tcp 上打开原始或“经典”ServerQuery。如果指定 ssh，则在 10022/tcp 上打开使用 SSH 的加密 ServerQuery。可在此参数中指定上述值的任意组合，包括留空（这将完全禁用 ServerQuery）。

• TS3SERVER_QUERY_TIMEOUT：查询连接因不活动而断开连接前的秒数。如果值设置为 0 或负数，将禁用超时。默认为 300 秒超时。

• TS3SERVER_QUERY_SSH_RSA_HOST_KEY：查询使用的 ssh_host_rsa_key 的路径。如果不存在，将在服务器启动时创建。

注意事项

插入许可文件

TeamSpeak 服务器在使用超过 1 个 32 插槽的虚拟服务器时需要许可文件。为此，必须使 licensekey.dat 对服务器可用。一种方法是将 licensekey.dat 挂载到 /var/ts3server。

$ docker run --name some-teamspeak -v /location/to/licensekey.dat:/var/ts3server/licensekey.dat amd64/teamspeak:tag

当整个数据目录（/var/ts3server/）已挂载到某个位置时，可将 licensekey.dat 复制到该目录中，TeamSpeak 服务器下次重启后将加载它。

数据存储位置

重要提示：有多种方法可存储 Docker 容器中运行的应用程序所使用的数据。我们建议 teamspeak 镜像的用户熟悉可用选项，包括：

• 让 Docker 通过使用其自己的内部卷管理将数据库文件写入主机系统的磁盘来管理数据库数据存储（详情）。这是默认选项，对用户来说简单且相当透明。缺点是对于直接在主机系统（即容器外部）运行的工具和应用程序，可能难以定位这些文件。

• 在主机系统上（容器外部）创建数据目录，并将其挂载到容器内可见的目录。这将数据库文件放在主机系统上的已知位置，并使主机系统上的工具和应用程序易于访问这些文件。缺点是用户需要确保目录存在，并且主机系统上的目录权限和其他安全机制设置正确。

Docker 文档是了解不同存储选项和变体的良好起点，有多个博客和论坛帖子讨论并提供了这方面的建议。以下仅展示上述后一种选项的基本步骤：

1. 在主机系统的合适卷上创建数据目录，例如 /my/own/datadir。
2. 像这样启动 teamspeak 容器：

$ docker run --name some-teamspeak -v /my/own/datadir:/var/ts3server/ -d amd64/teamspeak:tag

命令中的 -v /my/own/datadir:/var/ts3server/ 部分将主机系统的 /my/own/datadir 目录挂载为容器内的 /var/ts3server，TeamSpeak 默认会在此处写入其数据文件。

许可

查看此镜像中包含的软件的许可信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他受其他许可约束的软件（例如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可信息可能位于 repo-info 仓库的 teamspeak/ 目录中。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用都符合其中包含的所有软件的相关许可。