jwater7/darkice

docker-darkice镜像说明

镜像概述

本镜像包含DarkIce实时音频流工具的Docker容器化版本，DarkIce是一款轻量工具，可将音频源编码并流式传输到IceCast2等服务器，适用于实时音频直播场景。

核心功能

• 支持MP3、Ogg Vorbis等音频格式编码
• 可配置采样率（***/22050/44100Hz）、比特率模式（VBR/ABR）、通道数（单/立体声）
• 支持连接IceCast2服务器，配置挂载点、流名称、描述等参数
• 提供内部缓冲设置，确保流传输稳定

使用场景

• 个人/小型广播的实时音频直播（如麦克风、声卡输入）
• 本地音频源的网络流式分发（供远程听众访问）
• 搭建轻量级音频直播服务

配置说明

需准备darkice.cfg配置文件，挂载到容器内/etc/darkice.cfg路径（只读模式）。配置文件包含以下关键部分：

1. general：设置流持续时间（0表示无限）、缓冲时间
2. input：配置音频输入设备、采样率、比特率、通道数
3. icecast2-x：配置IceCast2服务器连接信息（地址、端口、密码等）

示例darkice.cfg配置

# DarkIce配置文件示例（使用前需修改）
[general]
duration        = 0         # 编码持续时间（秒），0=无限
bufferSecs      = 4         # 内部缓冲大小（秒）

[input]
device          = hw:0,0    # 音频输入设备（OSS DSP）
sampleRate      = 44100     # 采样率（Hz）
bitsPerSample   = 16        # 采样比特数
channel         = 2         # 通道数：1=单声道，2=立体声

[icecast2-0]
bitrateMode     = vbr       # 比特率模式：vbr/abr
format          = mp3       # 流格式：mp3/vorbis
quality         = 0.6       # VBR模式下的质量（0.1-1.0）
server          = 172.17.0.1 # IceCast2服务器地址
port            = 8000      # 服务器端口
password        = hackme    # 源密码
mountPoint      = live      # 挂载点
name            = Live      # 流名称
description     = Live stream # 流描述
genre           = live      # 流派
public          = no        # 是否公开

Docker Compose部署示例

yaml
darkice-soundstream:
  image: jwater7/darkice
  container_name: darkice-soundstream
  volumes:
    - "./darkice.cfg:/etc/darkice.cfg:ro"
  privileged: true
  restart: always

icecast-soundstream:
  image: infiniteproject/icecast
  container_name: icecast-soundstream
  ports:
    - "8000:8000"
  environment:
    - "ICECAST_HOSTNAME=localhost"
    - "ICECAST_SOURCE_PASSWORD=hackme"
    - "ICECAST_ADMIN_PASSWORD=hackme"
    - "ICECAST_RELAY_PASSWORD=hackme"
    - "ICECAST_ADMIN_USERNAME=admin"
  restart: always