SRS配置文件详解：100+配置项的功能说明与最佳实践

2026-02-06 04:56:58作者：柏廷章Berta

SRS（Simple RTMP Server）是一个开源的流媒体服务器，支持RTMP、WebRTC、HLS、HTTP-FLV等多种流媒体协议。通过深入解析SRS的配置文件，您可以快速掌握100+配置项的功能说明与最佳实践，构建高性能的流媒体服务。

📋 SRS配置文件结构与基础配置

SRS配置文件采用类Nginx的配置语法，主要分为全局配置和虚拟主机（vhost）配置两部分。全局配置定义服务器级别的参数，而虚拟主机配置则针对不同的应用和流进行个性化设置。

核心监听端口配置

SRS支持多种协议的监听端口，这是构建流媒体服务的基础：

listen              1935;        # RTMP协议默认端口
max_connections     1000;        # 最大连接数限制

http_api {
    enabled         on;
    listen          1985;        # HTTP API管理端口
}

http_server {
    enabled         on;
    listen          8080;        # HTTP流媒体服务端口
    dir             ./objs/nginx/html;
}

rtc_server {
    enabled on;
    listen 8000;                 # WebRTC UDP端口
    candidate $CANDIDATE;
}

🚀 虚拟主机配置详解

虚拟主机是SRS配置的核心，允许您为不同的应用创建独立的配置环境。

HLS流媒体配置

HLS（HTTP Live Streaming）是苹果公司开发的流媒体协议，适合跨平台播放：

vhost __defaultVhost__ {
    hls {
        enabled         on;
        hls_path        ./objs/nginx/html;
        hls_fragment    10;
        hls_window      60;
        hls_cleanup     on;
        hls_nb_notify   5;
    }
}

HTTP-FLV低延迟配置

HTTP-FLV提供比HLS更低的延迟，适合直播场景：

http_remux {
    enabled     on;
    mount       [vhost]/[app]/[stream].flv;
    hstrs       on;
}

WebRTC实时通信配置

WebRTC配置支持超低延迟的实时音视频通信：

rtc {
    enabled     on;
    rtmp_to_rtc on;
    rtc_to_rtmp on;
    # 转码配置
    transcode {
        enabled on;
        ffmpeg      ./objs/ffmpeg/bin/ffmpeg;
        engine ff {
            enabled         on;
            vcodec          h264;
            vparams {
                preset      ultrafast;
                tune        zerolatency;
            }
            acodec          aac;
            aparams {
                ab          128k;
            }
            output          rtmp://127.0.0.1:[port]/[app]?vhost=[vhost]/[stream]_[engine];
        }
    }
}

🔧 高级功能配置

DVR录制功能

DVR（Digital Video Recording）允许录制直播流为MP4文件：

dvr {
    enabled         on;
    dvr_path        ./objs/nginx/html/[app]/[stream].[timestamp].mp4;
    dvr_plan        session;
    dvr_duration    30;
    dvr_wait_keyframe on;
}

安全与权限控制

增强服务器安全性配置：

# IP访问控制
security {
    enabled         on;
    allow           publish 127.0.0.1;
    deny            publish all;
}

# Token鉴权
http_hooks {
    enabled         on;
    on_connect      http://127.0.0.1:8085/api/v1/clients;
    on_close        http://127.0.0.1:8085/api/v1/clients;
    on_publish      http://127.0.0.1:8085/api/v1/streams;
    on_unpublish    http://127.0.0.1:8085/api/v1/streams;
    on_play         http://127.0.0.1:8085/api/v1/sessions;
    on_stop         http://127.0.0.1:8085/api/v1/sessions;
}

集群与边缘配置

支持大规模部署的集群配置：

# 源站服务器配置
cluster {
    mode            local;
    origin_cluster  on;
    coworkers       127.0.0.1:1935 127.0.0.1:1936;
}

# 边缘服务器配置
vhost edge.example.com {
    cluster {
        mode            remote;
        origin          127.0.0.1:1935;
    }
}

🎯 性能优化最佳实践

内存与连接优化

# 工作进程配置
worker_processes    1;          # CPU核心数
worker_rlimit_nofile 10240;     # 每个进程最大文件描述符

# 连接超时配置
timeout             30s;        # 连接超时时间
keepalive_timeout   60s;        # 保持连接时间

# 缓冲区配置
chunk_size          60000;
in_ack_size         0;
out_ack_size        0;

日志与监控配置

# 日志配置
srs_log_tank        file;
srs_log_file        ./objs/srs.log;
srs_log_level       trace;

# 性能监控
stats {
    network         0;
    disk           0;
}
http_api {
    enabled         on;
    listen          1985;
    raw_api {
        enabled     on;
        allow_cors  on;
    }
}