libretime/icecast

icecast

镜像概述

本镜像由https://github.com/libretime/icecast-docker%E9%A1%B9%E7%9B%AE%E6%8F%90%E4%BE%9B%EF%BC%8C%E6%98%AFIcecast%E6%B5%81%E5%AA%92%E4%BD%93%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E5%AE%9E%E7%8E%B0%E3%80%82%E5%B0%BD%E7%AE%A1%E9%95%9C%E5%83%8F%E4%BD%8D%E4%BA%8ELibreTime%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4%E4%B8%8B%EF%BC%8C%E4%BD%86%E4%BB%BB%E4%BD%95%E7%94%A8%E6%88%B7%E5%9D%87%E5%8F%AF%E8%87%AA%E7%94%B1%E4%BD%BF%E7%94%A8%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E4%B8%8D%E6%B7%BB%E5%8A%A0LibreTime%E7%89%B9%E5%AE%9A%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%AE%8C%E5%85%A8%E4%BF%9D%E6%8C%81%E4%B8%8E%E4%B8%8A%E6%B8%B8Icecast%E9%A1%B9%E7%9B%AE%E7%9A%84%E4%B8%80%E8%87%B4%E6%80%A7%E3%80%82

主要用途：作为轻量级流媒体服务器，用于音频/视频内容的实时传输与分发。

核心功能与特性

• 多基础镜像支持：提供基于Debian（稳定）和Alpine（轻量级）的两种镜像版本
• 灵活标签策略：通过标签区分基础镜像和版本，满足不同环境需求
• 配置扩展性：支持通过环境变量快速配置或挂载自定义配置文件
• 版本稳定性：专注维护稳定版本，明确标记支持与不支持的标签

支持的标签

当前支持标签

• 2.4.4-debian、2.4.4、debian、latest（基于Debian系统）
• 2.4.4-alpine、alpine（基于Alpine系统）

不再支持标签

• 2.5-beta3-debian、2.5-beta3（自2025/09/17起停止支持）
• 2.5-beta3-alpine（自2025/09/17起停止支持）

使用场景

• 快速部署流媒体服务进行开发测试
• 生产环境中搭建稳定的音频/视频流分发服务器
• 资源受限环境下选择Alpine版本减少系统开销
• 需要自定义流媒体服务配置的场景

使用方法与配置说明

快速启动

通过以下命令可快速启动Icecast容器（默认映射8000端口）：

bash
# Docker Hub 镜像
docker run -d -p 8000:8000 libretime/icecast:2.4.4

# GitHub Container Registry 镜像
docker run -d -p 8000:8000 ghcr.io/libretime/icecast:2.4.4

配置方式

环境变量配置

支持通过以下环境变量自定义服务参数：

• ICECAST_SOURCE_PASSWORD：源连接密码
• ICECAST_RELAY_PASSWORD：中继服务器密码
• ICECAST_ADMIN_PASSWORD：管理员密码
• ICECAST_ADMIN_USERNAME：管理员用户名
• ICECAST_ADMIN_EMAIL：管理员***
• ICECAST_LOCATION：服务器地理位置描述
• ICECAST_HOSTNAME：服务器主机名
• ICECAST_MAX_CLIENTS：最大并发客户端数
• ICECAST_MAX_SOURCES：最大并发源流数

自定义配置文件

如需更复杂的配置，可挂载本地icecast.xml文件覆盖默认配置：

bash
docker run -d \
    -p 8000:8000 \
    -v ./icecast.xml:/etc/icecast.xml \
    libretime/icecast:2.4.4

镜像版本管理

当底层系统包或基础镜像更新时，会自动构建新版本镜像，现有标签将指向更新后的镜像。为避免意外更新，建议通过sha256摘要固定镜像版本，例如：

bash
libretime/icecast:2.4.4@sha256:56e6f265675f07a80c4164f48b2ed6f3d371aed78a334c666dd2eda0d97afc5e

可通过以下命令获取镜像的sha256摘要：

bash
docker inspect --format='{{index .RepoDigests 0}}' ghcr.io/libretime/icecast:2.4.4

注：默认配置文件/etc/icecast.xml已优化日志输出，将错误日志打印至stdout而非文件，便于容器日志收集。