Icecast状态页未显示服务器/流名称与描述，求排查方案

我通过PHP调用FFmpeg，将playlist.txt中列出的MP3文件推流至Icecast，推流命令如下：

$ffmpeg_command = "ffmpeg -re -f concat -safe 0 -stream_loop -1 -i /var/www/html/media/radio/playlist.txt -c:a libmp3lame -b:a 128k -f mp3 -ice_name \"My Name\" -ice_description \"My Description\" -metadata title=\"My Title\" -metadata artist=\"My Artist\" -metadata genre=\"My Genre\" -headers \"Icy-MetaData: 1\" icecast://source:Password@99.99.99.99:8000/stream > /dev/null 2>&1 &";

流可正常播放，但Icecast的管理及公共状态页中，Server Name、Server Description、Stream Name、Stream Description均显示为“Unspecified”。

已检查Icecast XML配置文件，相关配置如下：

<icecast>     
<server-name>My Server Name</server-name>
<server-description>My Server Description</server-description>
...
<metadata-update-interval>10</metadata-update-interval>
...
<limits>
    ...
    <metadata>1</metadata>
</limits>
...
<mount>
   <mount-name>/stream</mount-name>
   <name>My Name</name>
   <description>My Description</description>
   <genre>My Genre</genre>    
   ...
   <public>1</public>
</mount>
...
<fileserve>1</fileserve>
...
</icecast>

配置文件中的genre标签可正常同步至状态页，但全局<icecast>标签下的server-name和server-description未生效；FFmpeg命令中添加的-ice_name、-ice_description及-metadata参数也未同步到状态页，虽已配置-headers "Icy-MetaData: 1"。XML文件中已包含metadata-update-interval和metadata相关配置，请问问题出在哪里？

1. 全局server-name/server-description不生效的原因 #

Icecast的全局server-name和server-description仅在无挂载点（mount）专属配置时生效。当你为/stream挂载点单独配置了<name>、<description>后，全局配置会被挂载点配置覆盖。但你这里挂载点的配置没生效，要么是FFmpeg推流参数覆盖了配置，要么是配置加载存在问题。

2. FFmpeg参数未同步的核心问题 #

• -ice_name/-ice_description参数格式或传递问题：FFmpeg推流到Icecast时，部分版本需用-icy_name/-icy_description而非-ice_name/-ice_description；且用-f mp3推流时，FFmpeg可能无法正确传递Icecast专属的ICY头，建议尝试-f ogg格式，或确认FFmpeg版本支持ICY头传递。
• -metadata参数的作用范围：-metadata title等是嵌入音频流的元数据，供播放器显示，不会直接同步到Icecast状态页。状态页的流信息需通过推流时的ICY头或挂载点配置设置。
• -headers "Icy-MetaData: 1"的作用局限：这个参数仅告知Icecast要发送元数据，而非设置流的基本信息，无法替代-icy_*类参数。

3. 挂载点配置未生效的原因 #

如果FFmpeg推流时发送了ICY头信息，Icecast会优先使用推流参数，忽略挂载点配置；若推流参数未正确发送，就会显示“Unspecified”。另外，你提供的配置中<limits>下的<metadata>1</metadata存在语法错误（缺少闭合>），这会导致部分配置无法加载。

具体修复步骤 #

1. 修正FFmpeg推流命令：
   调整ICY参数格式，移除无效的-metadata（用于状态页的部分），示例如下：

   $ffmpeg_command = "ffmpeg -re -f concat -safe 0 -stream_loop -1 -i /var/www/html/media/radio/playlist.txt -c:a libmp3lame -b:a 128k -f mp3 -icy_name \"My Name\" -icy_description \"My Description\" -icy_genre \"My Genre\" -icy_url \"https://your-radio-url.com\" -headers \"Icy-MetaData: 1\" icecast://source:Password@99.99.99.99:8000/stream > /dev/null 2>&1 &";
   

   若你的FFmpeg版本仅支持-ice_name，则换回原参数名即可。

2. 修复Icecast配置语法错误：
   将<metadata>1</metadata修正为<metadata>1</metadata>，保存后重启Icecast服务，确保新配置加载。

3. 验证配置生效：
   查看Icecast日志（通常在/var/log/icecast/目录），检查是否有元数据相关的错误提示；也可通过curl测试推流时的ICY头是否正确发送。

内容的提问来源于stack exchange，提问作者Daniel Torridon