SRT: Support default_mode config for short streamid format. v7.0.131 (#4598)

Author: ossrs-ai

trunk/3rdparty/srs-docs/doc/getting-started-cdk.md

@@ -0,0 +1,13 @@
+---
+title: CDK
+sidebar_label: CDK
+hide_title: false
+hide_table_of_contents: false
+---
+
+# CDK
+
+Please use [srs-cdk](https://github.com/ossrs/srs-cdk) to deploy SRS on AWS.
+
+![](https://ossrs.io/gif/v1/sls.gif?site=ossrs.io&path=/lts/doc/en/v7/getting-started-cdk)
+

trunk/3rdparty/srs-docs/doc/getting-started-k8s.md

@@ -7,14 +7,16 @@ hide_table_of_contents: false
 
 # K8s
 
-We recommend using the HELM method to deploy SRS, see [srs-helm](https://github.com/ossrs/srs-helm). Of course, 
+> **Note:** SRS K8s is deprecated. Please use [CDK](./getting-started-cdk.md) instead.
+
+We recommend using the HELM method to deploy SRS, see [srs-helm](https://github.com/ossrs/srs-helm). Of course,
 SRS also supports direct deployment with K8s, refer to [SRS K8s](./k8s.md).
 
-Actually, HELM is based on K8s and deploys K8s pods, which can be managed with kubectl. However, HELM offers a 
+Actually, HELM is based on K8s and deploys K8s pods, which can be managed with kubectl. However, HELM offers a
 more convenient way to manage and install applications, so SRS will mainly support HELM in the future.
 
-Compared to Docker, HELM and K8s are mainly for medium to large scale deployments. If your business is not that 
-big, we recommend using Docker or Oryx directly. Generally, if you have less than a thousand streams, please 
+Compared to Docker, HELM and K8s are mainly for medium to large scale deployments. If your business is not that
+big, we recommend using Docker or Oryx directly. Generally, if you have less than a thousand streams, please
 do not use HELM or K8s.
 
 ![](https://ossrs.io/gif/v1/sls.gif?site=ossrs.io&path=/lts/doc/en/v7/getting-started-k8s)

trunk/3rdparty/srs-docs/doc/k8s.md

@@ -7,6 +7,8 @@ hide_table_of_contents: false
 
 # K8S
 
+> **Note:** SRS K8s is deprecated. Please use [CDK](./getting-started-cdk.md) instead.
+
 > Cloud+Docker+K8S enable everyone to build live video streaming cluster and service.
 
 Why should you use [k8s](https://docs.kubernetes.io/docs/concepts/overview/what-is-kubernetes) to build your SRS cluster?

trunk/3rdparty/srs-docs/doc/srt.md

@@ -58,12 +58,13 @@ srt_server {
     # Overwrite by env SRS_SRT_SERVER_ENABLED
     # default: off
     enabled on;
-    # The UDP listen port for SRT.
+    # The UDP listen endpoints for SRT, each with format as <[ip:]port>. The ip can be either ipv4 or ipv6,
+    # or both. For example:
+    #       listen 10080 [::]:10080 192.168.1.100:10080 10.10.10.100:10080;
     # Overwrite by env SRS_SRT_SERVER_LISTEN
     listen 10080;
     # For detail parameters, please read wiki:
-    # @see https://ossrs.net/lts/zh-cn/docs/v5/doc/srt-params
-    # @see https://ossrs.io/lts/en-us/docs/v5/doc/srt-params
+    # @see https://ossrs.io/lts/en-us/docs/v7/doc/srt#config
     # The maxbw is the max bandwidth of the sender side.
     # 	-1: Means the biggest bandwidth is infinity.
     # 	 0: Means the bandwidth is determined by SRTO_INPUTBW.
@@ -77,12 +78,12 @@ srt_server {
     # Overwrite by env SRS_SRT_SERVER_MSS
     # default: 1500
     mss 1500;
-    # The timeout time of the SRT connection on the sender side in ms. When SRT connects to a peer costs time 
+    # The timeout time of the SRT connection on the sender side in ms. When SRT connects to a peer costs time
     # more than this config, it will be close.
     # Overwrite by env SRS_SRT_SERVER_CONNECT_TIMEOUT
     # default: 3000
     connect_timeout 4000;
-	# The timeout time of SRT connection on the receiver side in ms. When the SRT connection is idle 
+    # The timeout time of SRT connection on the receiver side in ms. When the SRT connection is idle
     # more than this config, it will be close.
     # Overwrite by env SRS_SRT_SERVER_PEER_IDLE_TIMEOUT
     # default: 10000
@@ -91,36 +92,52 @@ srt_server {
     # Overwrite by env SRS_SRT_SERVER_DEFAULT_APP
     # default: live
     default_app live;
-	# The peerlatency is set by the sender side and will notify the receiver side.
+    # Default mode for short streamid format (without #!:: prefix).
+    # When client uses short streamid like "live/stream" or "stream", this config
+    # determines whether it's a publisher or player by default.
+    # Options: publish, request
+    #   - publish: short streamid is treated as publisher
+    #   - request: short streamid is treated as player (default)
+    # Example: with default_mode=publish, "srt://host:port?streamid=live/stream" publishes.
+    # Overwrite by env SRS_SRT_SERVER_DEFAULT_MODE
+    # default: request
+    default_mode request;
+    # Default streamid when client doesn't provide one.
+    # This is used when SRT client connects without setting SRTO_STREAMID socket option.
+    # The streamid format follows SRT standard: #!::r=app/stream,m=publish|request
+    # Overwrite by env SRS_SRT_SERVER_DEFAULT_STREAMID
+    # default: #!::r=live/livestream,m=request
+    default_streamid "#!::r=live/livestream,m=request";
+    # The peerlatency is set by the sender side and will notify the receiver side.
     # Overwrite by env SRS_SRT_SERVER_PEERLATENCY
     # default: 0
     peerlatency 0;
-	# The recvlatency means latency from sender to receiver.
+    # The recvlatency means latency from sender to receiver.
     # Overwrite by env SRS_SRT_SERVER_RECVLATENCY
     # default: 120
     recvlatency 0;
-	# This latency configuration configures both recvlatency and peerlatency to the same value.
+    # This latency configuration configures both recvlatency and peerlatency to the same value.
     # Overwrite by env SRS_SRT_SERVER_LATENCY
     # default: 120
     latency 0;
-	# The tsbpd mode means timestamp based packet delivery.
-	# SRT sender side will pack timestamp in each packet. If this config is true,
-	# the receiver will read the packet according to the timestamp in the head of the packet.
+    # The tsbpd mode means timestamp based packet delivery.
+    # SRT sender side will pack timestamp in each packet. If this config is true,
+    # the receiver will read the packet according to the timestamp in the head of the packet.
     # Overwrite by env SRS_SRT_SERVER_TSBPDMODE
     # default: on
     tsbpdmode off;
-	# The tlpkdrop means too-late Packet Drop
-	# SRT sender side will pack timestamp in each packet, When the network is congested,
-	# the packet will drop if latency is bigger than the configuration in both sender side and receiver side.
-	# And on the sender side, it also will be dropped because latency is bigger than configuration.
+    # The tlpkdrop means too-late Packet Drop
+    # SRT sender side will pack timestamp in each packet, When the network is congested,
+    # the packet will drop if latency is bigger than the configuration in both sender side and receiver side.
+    # And on the sender side, it also will be dropped because latency is bigger than configuration.
     # Overwrite by env SRS_SRT_SERVER_TLPKTDROP
     # default: on
     tlpktdrop off;
-	# The send buffer size of SRT.
+    # The send buffer size of SRT.
     # Overwrite by env SRS_SRT_SERVER_SENDBUF
     # default:  8192 * (1500-28)
     sendbuf 2000000;
-	# The recv buffer size of SRT.
+    # The recv buffer size of SRT.
     # Overwrite by env SRS_SRT_SERVER_RECVBUF
     # default:  8192 * (1500-28)
     recvbuf 2000000;
@@ -336,6 +353,64 @@ In other words, the following two addresses are equivalent:
 * `srt://127.0.0.1:10080`
 * `srt://127.0.0.1:10080?streamid=#!::r=live/livestream,m=publish`
 
+## SRT URL with short streamid
+
+SRS supports a short streamid format without the `#!::` prefix for simpler URLs. When using short streamid format like `live/livestream` or just `livestream`, SRS uses the `default_mode` configuration to determine whether it's a publish or play request.
+
+The `default_mode` configuration accepts two values:
+* `publish`: Short streamid will be treated as publish/push mode.
+* `request`: Short streamid will be treated as request/play/pull mode (this is the default).
+
+For publisher-friendly setup where clients can push with simple URLs, configure `default_mode` to `publish`:
+
+```bash
+srt_server {
+    enabled on;
+    listen 10080;
+    # Short streamid format will be treated as publisher
+    default_mode publish;
+}
+```
+
+With this configuration, you can publish with a simple URL:
+
+```bash
+# Publish with short streamid (uses default_mode=publish)
+ffmpeg -re -i source.flv -c copy -pes_payload_size 0 -f mpegts \
+  'srt://127.0.0.1:10080?streamid=live/livestream'
+
+# Play with explicit mode (must specify m=request)
+ffplay 'srt://127.0.0.1:10080?streamid=#!::r=live/livestream,m=request'
+```
+
+For player-friendly setup where clients can play with simple URLs, use the default `default_mode=request`:
+
+```bash
+srt_server {
+    enabled on;
+    listen 10080;
+    # Short streamid format will be treated as player (default)
+    default_mode request;
+}
+```
+
+With this configuration, you can play with a simple URL:
+
+```bash
+# Publish with explicit mode (must specify m=publish)
+ffmpeg -re -i source.flv -c copy -pes_payload_size 0 -f mpegts \
+  'srt://127.0.0.1:10080?streamid=#!::r=live/livestream,m=publish'
+
+# Play with short streamid (uses default_mode=request)
+ffplay 'srt://127.0.0.1:10080?streamid=live/livestream'
+```
+
+SRS provides two ready-to-use configuration files:
+* `conf/srt.shortstreamid.publish.conf`: For publisher-friendly setup with `default_mode publish`.
+* `conf/srt.shortstreamid.play.conf`: For player-friendly setup with `default_mode request`.
+
+Note that explicit mode specification with the full `#!::` prefix always takes precedence over `default_mode`. This allows clients that support full streamid format to override the default behavior.
+
 ## Authentication
 
 For the definition of SRT URLs, please refer to [SRT URL Schema](#srt-url).

trunk/conf/full.conf

@@ -689,6 +689,16 @@ srt_server {
     # Overwrite by env SRS_SRT_SERVER_DEFAULT_APP
     # default: live
     default_app live;
+    # Default mode for short streamid format (without #!:: prefix).
+    # When client uses short streamid like "live/stream" or "stream", this config
+    # determines whether it's a publisher or player by default.
+    # Options: publish, request
+    #   - publish: short streamid is treated as publisher
+    #   - request: short streamid is treated as player (default)
+    # Example: with default_mode=publish, "srt://host:port?streamid=live/stream" publishes.
+    # Overwrite by env SRS_SRT_SERVER_DEFAULT_MODE
+    # default: request
+    default_mode request;
     # Default streamid when client doesn't provide one.
     # This is used when SRT client connects without setting SRTO_STREAMID socket option.
     # The streamid format follows SRT standard: #!::r=app/stream,m=publish|request

trunk/conf/srt.shortstreamid.play.conf

@@ -0,0 +1,51 @@
+# SRT with short streamid format and default_mode=request (play/pull)
+# For publishing: ffmpeg -re -i source.flv -c copy -pes_payload_size 0 -f mpegts 'srt://127.0.0.1:10080?streamid=#!::r=live/livestream,m=publish'
+# For playing: ffprobe 'srt://127.0.0.1:10080?streamid=live/livestream'
+# For playing HTTP-FLV: ffprobe 'http://127.0.0.1:8080/live/livestream.flv'
+
+listen              1935;
+max_connections     1000;
+daemon              off;
+srs_log_tank        console;
+
+http_api {
+    enabled         on;
+    listen          1985;
+}
+
+http_server {
+    enabled         on;
+    listen          8080;
+    dir             ./objs/nginx/html;
+}
+
+srt_server {
+    enabled on;
+    listen 10080;
+    maxbw 1000000000;
+    connect_timeout 4000;
+    peerlatency 0;
+    recvlatency 0;
+    latency 0;
+    tsbpdmode off;
+    tlpktdrop off;
+    sendbuf 2000000;
+    recvbuf 2000000;
+    payloadsize 1316;
+    # Short streamid format (without #!::) will be treated as player/puller by default.
+    # This allows: srt://host:port?streamid=live/stream to play directly.
+    default_mode request;
+}
+
+vhost __defaultVhost__ {
+    srt {
+        enabled     on;
+        srt_to_rtmp on;
+    }
+
+    http_remux {
+        enabled     on;
+        mount       [vhost]/[app]/[stream].flv;
+    }
+}
+

trunk/conf/srt.shortstreamid.publish.conf

@@ -0,0 +1,51 @@
+# SRT with short streamid format and default_mode=publish
+# For publishing: ffmpeg -re -i source.flv -c copy -pes_payload_size 0 -f mpegts 'srt://127.0.0.1:10080?streamid=live/livestream'
+# For playing: ffprobe 'srt://127.0.0.1:10080?streamid=#!::r=live/livestream,m=request'
+# For playing HTTP-FLV: ffprobe 'http://127.0.0.1:8080/live/livestream.flv'
+
+listen              1935;
+max_connections     1000;
+daemon              off;
+srs_log_tank        console;
+
+http_api {
+    enabled         on;
+    listen          1985;
+}
+
+http_server {
+    enabled         on;
+    listen          8080;
+    dir             ./objs/nginx/html;
+}
+
+srt_server {
+    enabled on;
+    listen 10080;
+    maxbw 1000000000;
+    connect_timeout 4000;
+    peerlatency 0;
+    recvlatency 0;
+    latency 0;
+    tsbpdmode off;
+    tlpktdrop off;
+    sendbuf 2000000;
+    recvbuf 2000000;
+    payloadsize 1316;
+    # Short streamid format (without #!::) will be treated as publisher by default.
+    # This allows: srt://host:port?streamid=live/stream to publish directly.
+    default_mode publish;
+}
+
+vhost __defaultVhost__ {
+    srt {
+        enabled     on;
+        srt_to_rtmp on;
+    }
+
+    http_remux {
+        enabled     on;
+        mount       [vhost]/[app]/[stream].flv;
+    }
+}
+

trunk/doc/CHANGELOG.md

@@ -7,6 +7,7 @@ The changelog for SRS.
 <a name="v7-changes"></a>
 
 ## SRS 7.0 Changelog
+* v7.0, 2025-11-30, SRT: Support default_mode config for short streamid format. v7.0.131
 * v7.0, 2025-11-28, SRT: Fix player not exiting when publisher disconnects. v7.0.130 (#4591)
 * v7.0, 2025-11-27, Merge [#4588](https://github.com/ossrs/srs/pull/4588): RTMP: Ignore FMLE start packet after flash publish. v7.0.129 (#4588)
 * v7.0, 2025-11-18, AI: API: Change pagination default count to 10, minimum 1. v7.0.128

trunk/src/app/srs_app_config.cpp

@@ -1935,7 +1935,7 @@ srs_error_t SrsConfig::check_normal_config()
         SrsConfDirective *conf = root_->get("srt_server");
         for (int i = 0; conf && i < (int)conf->directives_.size(); i++) {
             string n = conf->at(i)->name_;
-            if (n != "enabled" && n != "listen" && n != "maxbw" && n != "mss" && n != "latency" && n != "recvlatency" && n != "peerlatency" && n != "connect_timeout" && n != "peer_idle_timeout" && n != "sendbuf" && n != "recvbuf" && n != "payloadsize" && n != "default_app" && n != "sei_filter" && n != "mix_correct" && n != "tlpktdrop" && n != "tsbpdmode" && n != "passphrase" && n != "pbkeylen" && n != "default_streamid") {
+            if (n != "enabled" && n != "listen" && n != "maxbw" && n != "mss" && n != "latency" && n != "recvlatency" && n != "peerlatency" && n != "connect_timeout" && n != "peer_idle_timeout" && n != "sendbuf" && n != "recvbuf" && n != "payloadsize" && n != "default_app" && n != "sei_filter" && n != "mix_correct" && n != "tlpktdrop" && n != "tsbpdmode" && n != "passphrase" && n != "pbkeylen" && n != "default_streamid" && n != "default_mode") {
                 return srs_error_new(ERROR_SYSTEM_CONFIG_INVALID, "illegal srt_server.%s", n.c_str());
             }
         }
@@ -7687,6 +7687,23 @@ string SrsConfig::get_srt_default_streamid()
     return conf->arg0();
 }
 
+string SrsConfig::get_srt_default_mode()
+{
+    SRS_OVERWRITE_BY_ENV_STRING("srs.srt_server.default_mode"); // SRS_SRT_SERVER_DEFAULT_MODE
+
+    static string DEFAULT = "request";
+    SrsConfDirective *conf = root_->get("srt_server");
+    if (!conf) {
+        return DEFAULT;
+    }
+
+    conf = conf->get("default_mode");
+    if (!conf || conf->arg0().empty()) {
+        return DEFAULT;
+    }
+    return conf->arg0();
+}
+
 SrsConfDirective *SrsConfig::get_srt(std::string vhost)
 {
     SrsConfDirective *conf = get_vhost(vhost);

trunk/src/app/srs_app_config.hpp

@@ -488,6 +488,7 @@ class ISrsAppConfig : public ISrsConfig
     virtual bool get_srt_enabled() = 0;
     virtual bool get_srt_enabled(std::string vhost) = 0;
     virtual std::string get_srt_default_streamid() = 0;
+    virtual std::string get_srt_default_mode() = 0;
     virtual bool get_srt_to_rtmp(std::string vhost) = 0;
     virtual bool get_rtc_to_rtmp(std::string vhost) = 0;
     virtual srs_utime_t get_rtc_stun_timeout(std::string vhost) = 0;
@@ -1078,6 +1079,9 @@ class SrsConfig : public ISrsAppConfig
     virtual std::string get_default_app_name();
     // Get the default streamid when client doesn't provide one.
     virtual std::string get_srt_default_streamid();
+    // Get the default mode for short streamid format.
+    // @return "publish" or "request", default is "request".
+    virtual std::string get_srt_default_mode();
 
 // clang-format off
 SRS_DECLARE_PRIVATE: // clang-format on