sound4/impact

SOUND4 IMPACT.CL 镜像说明

镜像概述

本镜像为SOUND4 IMPACT.CL 音频处理工具的Docker化版本，需使用SOUND4官方许可证才能正常运行。支持通过RTP协议收发音频，并内置Web服务器用于配置处理参数。

核心功能

1. RTP音频传输：接收RTP格式的音频输入，处理后通过RTP输出；
2. Web配置界面：提供网页界面用于设置音频处理参数；
3. 状态与预设存储：需挂载存储卷保存处理状态和预设配置；
4. Kubernetes Leader Election：在K8s集群中支持主实例选举，确保仅一个实例运行处理任务；
5. 用户认证：支持创建setup或admin用户，用于Web界面访问控制。

使用场景

• 广播电台的音频信号处理；
• 专业音频流的优化与增强；
• 基于K8s集群的高可用音频处理部署。

配置说明

环境变量

必填变量

• S4_AWS_ACCESS_KEY_ID：SOUND4许可证AccessKeyID；
• S4_AWS_SECRET_ACCESS_KEY：SOUND4许可证AccessKeySecret；
• RADIO_NAME：SOUND4许可证对应的电台名称；
• S4LOGINKEY：SOUND4许可证LoginKey。

可选变量

• RTP相关：RTP_SRC_PORT（默认5004）、RTP_DEST_IP（默认0，返回发送方）、RTP_DEST_PORT（默认5004）、RTP_SAMPLE_FORMAT（默认S16_BE）、RTP_PAYLOAD、RTP_FRAMES（默认0）；
• 用户认证：SETUP_USER/SETUP_SECRET（创建setup用户）、ADMIN_USER/ADMIN_SECRET（创建admin用户，未提供则随机生成密码并打印到日志）；
• K8s Leader Election：LEADERELECTION_LEASENAME、LEADERELECTION_NAMESPACE（需同时设置生效），可选LEADERELECTION_IFACE_IP、LEADERELECTION_WAITFORCREATE等参数。

存储挂载

需将存储卷挂载到/usr/share/sound4proc路径，用于保存状态和预设。

Docker Compose示例

yaml
version: '3.4'
services:
  process:
    image: sound4/impact:${IMAGE_VERSION:-latest}
    restart: unless-stopped
    ports:
     - "${RTP_SRC_PORT:-5004}:${RTP_SRC_PORT:-5004}/udp"
     - "${HTTP_PORT:-80}:80"
    volumes:
     - state:/usr/share/sound4proc
    command: [
        "/usr/local/bin/sound4.impact.cl-proc"
        # 可通过 -h 参数查看完整命令行选项
        , "-a", "KANTAR_OfflineLicense=0"
        , "-a", "Metadata_provided_path=/usr/local/share/sound4/SOUND4 Stream.CL Metaparsers"
        , "-a", "Metadata_no_ui=0"
    ]
    environment:
      # SOUND4许可证信息
      - S4LOGINKEY=${S4LOGINKEY}
      - RADIO_NAME=${RADIO_NAME}
      - S4_AWS_ACCESS_KEY_ID=${S4_AWS_ACCESS_KEY_ID}
      - S4_AWS_SECRET_ACCESS_KEY=${S4_AWS_SECRET_ACCESS_KEY}
      # RTP配置
      - RTP_SRC_IP=${RTP_SRC_IP:-0}
      - RTP_SRC_PORT=${RTP_SRC_PORT:-5004}
      - RTP_DEST_IP=${RTP_DEST_IP}
      - RTP_DEST_PORT=${RTP_DEST_PORT:-5004}
      - PROC_VERB=${PROC_VERB:--vv}
      - RTP_SAMPLE_FORMAT=${RTP_SAMPLE_FORMAT:-S16_BE}
      - RTP_PAYLOAD=${RTP_PAYLOAD:-97}
      - RTP_FRAMES=${RTP_FRAMES}
      # Web界面用户认证
      - SETUP_USER=${SETUP_USER:-}
      - SETUP_SECRET=${SETUP_SECRET:-}
      - ADMIN_USER=${ADMIN_USER:-}
      - ADMIN_SECRET=${ADMIN_SECRET:-}
volumes:
  state: