gibby/sdr-trunk

gibby/sdr-trunk 镜像文档

镜像概述

gibby/sdr-trunk是一个整合了trunk-recorder和trunk-player的Docker镜像，通过链接postgres容器提供完整的无线电中继信号处理解决方案。该镜像优化了大小，仅包含必要的构建产物和动态链接库，并提供数据库初始化、Web界面及流服务功能。

核心功能与特性

trunk-recorder 功能

• 完整功能支持：包括编码及上传至broadcastify和icecast
• 文件管理：.wav文件转换为.mp3后自动删除；容器重启后不保留.mp3和.json文件
• 流处理优化：通过liquidsoap从icecast抓取流并推送至broadcastify，解决时钟同步问题

trunk-player 功能

• 工作功能：
  • 初始化postgres数据库
  • 设置django超级用户
  • 在8000端口暴露Web网站
  • 启动redis-server、daphne、add_transmission_worker(x2)和runworker(x2)
  • 提供本地音频文件服务
  • 支持用户注册等邮件发送
  • 从与recorder相同的csv文件自动导入通话组
• 待实现功能：
  • 社交登录
  • S3音频文件服务（计划添加）

镜像优化

• 通过多阶段构建减小体积：在独立容器构建trunk-recorder，仅复制构建产物
• 仅安装动态链接所需的额外库（计划实现静态链接进一步减小体积）

待办事项

• 考虑将SDR容器拆分为两个独立容器：一个用于recorder，一个用于player

使用场景

• 无线电爱好者进行中继信号录制与播放
• 构建本地或网络无线电监控系统
• 需要Web界面管理和访问无线电录音的应用场景

使用方法与配置说明

前期准备

1. 镜像包含/app/config目录，内有config.json和talk_groups.csv示例（talk_groups.csv可从radioreference复制）
2. talk_groups.csv需添加额外列：
   • Priority(0-100)：优先级
   • Streams List：流名称列表（管道分隔），以"player"开头的流将发送至trunk-player（需在trunk-player中定义system_id，如"player0"对应系统0），其他流名称将发送至liquidsoap

Docker Compose配置

1. 复制docker-compose.template.yml为docker-compose.yml
2. 配置示例（包含postgres数据库，也可注释使用外部数据库）：

yaml
version: '3'
services:
  postgres:
    image: postgres:latest
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=your_user
      - POSTGRES_PASSWORD=your_password
      - POSTGRES_DB=trunkplayer
    restart: always

  icecast:
    image: karlrees/icecast
    environment:
      - ICECAST_ADMIN_USERNAME=admin
      - ICECAST_ADMIN_PASSWORD=adminpass
      - ICECAST_SOURCE_PASSWORD=sourcepass
      - ICECAST_RELAY_PASSWORD=relaypass
      - ICECAST_HOSTNAME=localhost
      - ICECAST_PORT=8000
      - ICECAST_MAX_SOURCES=10
    ports:
      - "8000:8000"
    restart: always

  trunk-recorder:
    image: gibby/sdr-trunk
    volumes:
      - ./config:/app/config
      - ./liquidsoap:/app/liquidsoap
      - /dev/bus/usb:/dev/bus/usb
    environment:
      - ENCODING_LOGGING_LEVEL=INFO
      - POSTGRES_HOST=postgres
      - POSTGRES_PORT=5432
      - POSTGRES_USER=your_user
      - POSTGRES_PASSWORD=your_password
      - POSTGRES_DB=trunkplayer
    depends_on:
      - postgres
      - icecast
    restart: always

  trunk-player:
    image: gibby/sdr-trunk
    volumes:
      - ./audio_files:/app/audio_files
    environment:
      - START_TRUNK_PLAYER="true"
      - LOCAL_AUDIO_FILES="true"
      - AUDIO_URL_BASE=http://localhost:8000/audio
      - ALLOWED_HOSTS=localhost,127.0.0.1
      - DJANGO_ADMIN=admin
      - DJANGO_PASS=adminpass
      - DJANGO_EMAIL=admin@example.com
      - SECRET_KEY="your_django_secret_key"
      - SITE_TITLE="My Trunk Player"
      - SITE_EMAIL=site@example.com
      - DEFAULT_FROM_EMAIL=site@example.com
      - TZ=America/New_York
      - ALLOW_GOOGLE_SIGNIN="false"
      - DEBUG="false"
      - EMAIL_HOST=smtp.example.com
      - EMAIL_PORT=587
      - EMAIL_HOST_USER=user@example.com
      - EMAIL_HOST_PASSWORD=emailpass
      - EMAIL_USE_TLS="true"
    ports:
      - "8000:8000"
    depends_on:
      - postgres
    restart: always

volumes:
  postgres_data:

环境变量说明

全局变量

• POSTGRES_USER：postgres数据库用户名
• POSTGRES_PASSWORD：postgres数据库密码
• POSTGRES_DB：postgres数据库名称
• POSTGRES_HOST：数据库主机名（使用docker-compose中的db服务时填"postgres"）
• POSTGRES_PORT：数据库连接端口

icecast 变量

• ICECAST_ADMIN_USERNAME：icecast Web管理用户名
• ICECAST_ADMIN_PASSWORD：icecast管理密码
• ICECAST_SOURCE_PASSWORD：源密码（用于.liq文件）
• ICECAST_RELAY_PASSWORD：中继密码（当前未使用）
• ICECAST_HOSTNAME：icecast配置中的主机名
• ICECAST_PORT：icecast监听端口
• ICECAST_MAX_SOURCES：最大源数量

trunk-recorder 变量

• ENCODING_LOGGING_LEVEL：encode_upload.py日志级别（INFO或DEBUG）

trunk-player 变量

• START_TRUNK_PLAYER：是否启用trunk_player（需双引号包裹）
• LOCAL_AUDIO_FILES：是否使用本地音频文件（需双引号包裹）
• AUDIO_URL_BASE：音频文件访问地址
• ALLOWED_HOSTS：Django允许的主机
• DJANGO_ADMIN：初始管理员账号
• DJANGO_PASS：初始管理员密码
• DJANGO_EMAIL：初始管理员***
• SECRET_KEY：Django密钥（从Django密钥生成器获取，需双引号包裹）
• SITE_TITLE：网站标题
• SITE_EMAIL：网站***地址
• DEFAULT_FROM_EMAIL：默认发件人地址
• TZ：时区
• ALLOW_GOOGLE_SIGNIN：是否允许Google登录（当前未实现）
• DEBUG：是否启用Django调试模式（公共网站请勿设为True）
• EMAIL_HOST：邮件发送服务器
• EMAIL_PORT：邮件服务器端口
• EMAIL_HOST_USER：邮件服务器用户名（未测试***或无用户/密码情况）
• EMAIL_HOST_PASSWORD：邮件服务器密码
• EMAIL_USE_TLS：是否使用TLS/SSL连接邮件服务器

卷挂载说明

• postgres：postgres_data卷用于存储数据库文件
• trunk-recorder：
  • config：存放config.json和talk_groups.csv
  • liquidsoap：存放流名称配置
  • /dev/bus/usb:/dev/bus/usb：保持默认，用于USB设备访问
• trunk-player：audio_files卷用于存放本地音频文件

致谢

• trunk-recorder：https://github.com/robotastic/trunk-recorder
• trunk-player：https://github.com/ScanOC/trunk-player