moul/icecast

Icecast Docker镜像

镜像概述和主要用途

该镜像提供了Icecast2流媒体服务器的Docker化部署方案，旨在简化音频流媒体服务的搭建过程。Icecast2是一款开源的流媒体服务器，主要用于传输音频内容（如网络广播、音乐流等），本镜像通过容器化方式使其部署更加便捷、配置更加灵活。

核心功能和特性

• 快速启动：默认配置下可直接运行，无需复杂设置
• 密码自定义：支持通过环境变量设置源密码、管理员密码、用户密码和中继密码
• 配置灵活：可挂载本地配置文件或目录，实现高级自定义配置
• 可扩展性：支持通过扩展Dockerfile添加自定义配置
• 容器编排支持：提供Docker Compose配置示例，便于集成到多容器项目中

使用场景和适用范围

• 个人或小型网络广播服务搭建
• 音频流媒体服务器的快速部署与测试
• 需要灵活配置的音频内容分发场景
• 开发环境中流媒体服务的快速搭建

使用方法和配置说明

基本运行（默认配置）

使用默认密码启动服务，暴露8000端口：

bash
docker run -p 8000:8000 docker.xuanyuan.run/moul/icecast

启动后可通过浏览器访问 localhost:8000 进入管理界面。

自定义密码

通过环境变量设置各类密码及主机名：

bash
docker run -p 8000:8000 \
  -e ICECAST_SOURCE_PASSWORD=aaaa \
  -e ICECAST_ADMIN_PASSWORD=bbbb \
  -e ICECAST_PASSWORD=cccc \
  -e ICECAST_RELAY_PASSWORD=dddd \
  -e ICECAST_HOSTNAME=noise.example.com \
  docker.xuanyuan.run/moul/icecast

环境变量说明：

• ICECAST_SOURCE_PASSWORD：源客户端连接密码（用于音频源推流）
• ICECAST_ADMIN_PASSWORD：管理员界面访问密码
• ICECAST_PASSWORD：普通用户访问密码
• ICECAST_RELAY_PASSWORD：中继服务器连接密码
• ICECAST_HOSTNAME：服务器主机名（用于标识服务）

自定义配置文件

挂载本地配置文件或目录实现高级配置：

bash
# 挂载整个配置目录
docker run -p 8000:8000 -v /local/path/to/icecast/config:/etc/icecast2 docker.xuanyuan.run/moul/icecast

# 挂载单个配置文件
docker run -p 8000:8000 -v /local/path/to/icecast.xml:/etc/icecast2/icecast.xml docker.xuanyuan.run/moul/icecast

扩展Dockerfile

通过自定义Dockerfile添加配置：

Dockerfile
FROM docker.xuanyuan.run/moul/icecast
ADD ./icecast.xml /etc/icecast2

Docker Compose配置

yaml
icecast:
  image: docker.xuanyuan.run/moul/icecast
  volumes:
    - logs:/var/log/icecast2
    - /etc/localtime:/etc/localtime:ro
  environment:
    - ICECAST_SOURCE_PASSWORD=aaa
    - ICECAST_ADMIN_PASSWORD=bbb
    - ICECAST_PASSWORD=ccc
    - ICECAST_RELAY_PASSWORD=ddd
    - ICECAST_HOSTNAME=noise.example.com
  ports:
    - 8000:8000

示例

• https://github.com/ultreme/scc-radio/

许可证

https://github.com/moul/docker-icecast/blob/master/LICENSE.md