liquidsoap Docker镜像文档

镜像概述与主要用途

本仓库提供用于运行liquidsoap的生产就绪Docker镜像。镜像基于最小化的Debian testing系统构建，仅包含liquidsoap及其必要依赖，确保轻量且高效，适用于生产环境中liquidsoap应用的部署与运行。

核心功能与特性

• 生产就绪：专为生产环境设计，确保稳定性与可靠性
• 自动构建：通过CI流程自动构建，保证镜像版本与代码同步更新
• 最小化镜像：基于Debian testing基础镜像，仅安装liquidsoap及必要组件，减少资源占用
• 标签策略：镜像标签与生成该镜像的Git分支对应，便于版本管理与追溯

使用场景与适用范围

适用于需要部署liquidsoap的各类生产环境，包括但不限于：

• 音频流服务（如网络电台、直播音频流）
• 广播自动化系统
• 音频处理与转码服务
• 需要稳定运行liquidsoap脚本的场景

使用方法与配置说明

镜像拉取

镜像标签基于生成该镜像的Git分支命名，拉取特定分支的镜像命令如下：

bash
docker pull <镜像仓库地址>:<git分支名>

（注：需将<镜像仓库地址>替换为实际仓库地址，<git分支名>替换为目标Git分支，如main、stable等）

基本运行命令

运行liquidsoap容器的基本命令示例：

bash
docker run -it --rm <镜像标签> liquidsoap <liquidsoap脚本路径>

• -it：交互式终端，便于调试与查看输出
• --rm：容器退出后自动删除，适合临时任务
• <镜像标签>：已拉取的liquidsoap镜像标签
• <liquidsoap脚本路径>：需执行的liquidsoap脚本路径（若脚本在容器内，使用容器内路径；若需挂载本地脚本，可通过-v参数映射本地目录至容器）

挂载本地脚本示例

若需运行本地liquidsoap脚本，可通过目录挂载实现：

bash
docker run -v /本地脚本目录:/app -it --rm <镜像标签> liquidsoap /app/your_script.liq

• -v /本地脚本目录:/app：将本地脚本目录映射至容器内/app目录
• /app/your_script.liq：容器内的脚本路径（对应本地脚本）

注意事项

• 镜像基于Debian testing系统，确保宿主环境支持该基础镜像的运行
• 如需持久化数据或配置，建议通过Docker卷（Volume）或绑定挂载（Bind Mount）实现
• 镜像标签与Git分支严格对应，部署时需确认目标分支的稳定性