hermsi/alpine-teamspeak

TeamSpeak3 容器化镜像

本镜像基于Alpine系统构建，用于运行TeamSpeak3服务器，支持连接外部数据库。请注意：该镜像已归档，建议优先使用官方TeamSpeak镜像（https://hub.docker.com/_/teamspeak%EF%BC%89%E3%80%82

核心功能

• 轻量级Alpine基础镜像，体积小且资源占用低
• 支持持久化存储，确保服务器数据不丢失
• 可集成外部MariaDB数据库，提升数据可靠性
• 提供多场景部署方案（测试、生产、Docker Compose集成）

使用场景

• 快速验证TeamSpeak3服务器功能的测试环境
• 生产环境中稳定运行的语音通讯服务
• 需要与外部数据库集成的企业级部署场景

配置说明

快速测试（无持久化存储）

仅适用于临时测试，容器重启后数据将丢失：

bash
docker run -d --name teamspeak -p 9987:9987/udp -p 30033:30033 -p 10011:10011 docker.xuanyuan.run/hermsi/teamspeak

持久化部署（无外部数据库）

1. 创建存储目录并设置权限：

   bash
   export TS_VOLUME="/var/storage/docker/volumes/teamspeak" \
   && mkdir -p "${TS_VOLUME}" \
   && chown -R 503:503 "${TS_VOLUME}"
   

2. 启动持久化容器：

   bash
   docker run -d --restart=always --name teamspeak \
     -p 9987:9987/udp -p 30033:30033 -p 10011:10011 \
     -v ${TS_VOLUME}:/teamspeak \
     docker.xuanyuan.run/hermsi/teamspeak
   

持久化部署（外部MariaDB）

1. 创建存储目录：

   bash
   export TS_VOLUME="/var/storage/docker/volumes/teamspeak" \
   && mkdir -p "${TS_VOLUME}/teamspeak" \
   && mkdir -p "${TS_VOLUME}/mysql"
   

2. 创建专属网络：

   bash
   docker network create my_teamspeak
   

3. 启动MariaDB容器：

   bash
   docker run -d --restart=always --name teamspeak_database --net my_teamspeak \
     -v ${TS_VOLUME}/mysql:/var/lib/mysql \
     -e MYSQL_ROOT_PASSWORD=CHANGEME \
     -e MYSQL_DATABASE=teamspeak \
     -e MYSQL_USER=teamspeak \
     -e MYSQL_PASSWORD=CHANGEME \
     docker.xuanyuan.run/mariadb
   

4. 启动TeamSpeak容器：

   bash
   docker run -d --restart=always --name teamspeak --net my_teamspeak \
     -p 9987:9987/udp -p 30033:30033 -p 10011:10011 \
     -v ${TS_VOLUME}/teamspeak:/teamspeak \
     -e TS3_MARIADB_DB=teamspeak \
     -e TS3_MARIADB_USER=teamspeak \
     -e TS3_MARIADB_PASS=CHANGEME \
     -e TS3_MARIADB_HOST=teamspeak_database \
     -e TS3_MARIADB_PORT=3306 \
     docker.xuanyuan.run/hermsi/teamspeak
   

Docker Compose部署（local-persist驱动）

1. 安装local-persist驱动：

   bash
   curl -fsSL https://raw.githubusercontent.com/CWSpear/local-persist/master/scripts/install.sh | sudo bash
   

2. 创建docker-compose.yml文件：

   yml
   version: '3'
   
   volumes:
     teamspeak-data:
        driver: local-persist
        driver_opts:
          mountpoint: ${CONTAINERVOLUME}/teamspeak
     teamspeak-db-data:
        driver: local-persist
        driver_opts:
          mountpoint: ${CONTAINERVOLUME}/var/lib/mysql
   
   services:
     database:
       image: docker.xuanyuan.run/mariadb
       volumes:
         - teamspeak-db-data:/var/lib/mysql
       environment:
         - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
         - MYSQL_DATABASE=${MYSQL_DATABASE}
         - MYSQL_USER=${MYSQL_USER}
         - MYSQL_PASSWORD=${MYSQL_PASSWORD}
   
     application:
       image: docker.xuanyuan.run/hermsi/teamspeak
       depends_on:
         - database
       environment:
         - TS3_MARIADB_DB=${MYSQL_DATABASE}
         - TS3_MARIADB_USER=${MYSQL_USER}
         - TS3_MARIADB_PASS=${MYSQL_PASSWORD}
         - TS3_MARIADB_HOST=database
         - TS3_MARIADB_PORT=3306
       volumes:
         - teamspeak-data:/teamspeak     
       ports:
         - 9987:9987/udp 
         - 30033:30033 
         - 10011:10011
   

3. 创建.env配置文件：

   bash
   # Docker-Compose配置
   COMPOSE_PROJECT_NAME=My_Teamspeak
   CONTAINERVOLUME=/var/storage/docker/volumes/teamspeak
   
   # 数据库配置
   MYSQL_USER=teamspeak
   MYSQL_ROOT_PASSWORD=CHANGEME_HARD
   MYSQL_DATABASE=teamspeak
   MYSQL_PASSWORD=CHANGEME
   

4. 启动服务：

   bash
   docker-compose up -d