strukturag/nextcloud-spreed-signaling

Nextcloud-Spreed-Signaling Docker镜像文档

信令服务器

信令服务器镜像可从以下地址获取：

strukturag/nextcloud-spreed-signaling:<version>

将 <version> 替换为您要使用的标签或提交哈希。

配置

运行中的容器可通过以下环境变量进行配置：

• CONFIG：可选的配置文件名。
• HTTP_LISTEN：HTTP监听器地址。
• HTTPS_LISTEN：HTTPS监听器地址。
• HTTPS_CERTIFICATE：HTTPS监听器的证书文件名。
• HTTPS_KEY：HTTPS监听器的私钥文件名。
• HASH_KEY：用于生成会话校验和的密钥值（32或64字节）。
• BLOCK_KEY：用于加密会话数据的密钥（16、24或32字节）。
• INTERNAL_SHARED_SECRET_KEY：内部客户端连接的共享密钥。
• BACKENDS：后端ID的空格分隔列表。
• BACKEND_<ID>_URL：后端<ID>的URL（其中<ID>为大写的后端ID）。
• BACKEND_<ID>_SHARED_SECRET：后端<ID>的共享密钥（其中<ID>为大写的后端ID）。
• BACKEND_<ID>_SESSION_LIMIT：后端<ID>的可选会话限制（其中<ID>为大写的后端ID）。
• BACKEND_<ID>_MAX_STREAM_BITRATE：后端<ID>中音频/视频流的可选最大比特率（其中<ID>为大写的后端ID）。
• BACKEND_<ID>_MAX_SCREEN_BITRATE：后端<ID>中屏幕共享流的可选最大比特率（其中<ID>为大写的后端ID）。
• NATS_URL：NATS服务器的可选URL。
• ETCD_ENDPOINTS：etcd端点的静态列表（如需使用etcd）。
• ETCD_DISCOVERY_SRV：用于etcd端点DNS SRV配置的替代域名（如需使用etcd）。
• ETCD_DISCOVERY_SERVICE：etcd的DNS SRV配置的可选服务名称。
• ETCD_CLIENT_CERTIFICATE：etcd客户端证书文件名。
• ETCD_CLIENT_KEY：etcd客户端私钥文件名。
• ETCD_CLIENT_CA：etcd客户端CA证书文件名。
• USE_JANUS：设为1时使用Janus作为WebRTC后端。
• JANUS_URL：Janus服务器URL（当USE_JANUS设为1时）。
• USE_PROXY：设为1时使用代理服务器作为WebRTC后端。
• PROXY_TOKEN_ID：连接代理服务器时使用的令牌ID。
• PROXY_TOKEN_KEY：配置的令牌ID对应的私钥。
• PROXY_URLS：代理URL的空格分隔列表。
• PROXY_DNS_DISCOVERY：启用对配置的静态URL主机名的DNS发现。
• PROXY_ETCD：设为1时使用etcd配置代理连接。
• PROXY_KEY_PREFIX：代理条目的键前缀。
• MAX_STREAM_BITRATE：音频/视频流的可选全局最大比特率。
• MAX_SCREEN_BITRATE：屏幕共享流的可选全局最大比特率。
• TURN_API_KEY：Janus请求TURN凭证时需发送的API密钥。
• TURN_SECRET：用于生成TURN凭证的共享密钥。
• TURN_SERVERS：TURN服务器的逗号分隔列表。
• GEOIP_LICENSE：下载MaxMind GeoIP数据库时使用的许可证密钥。
• GEOIP_URL：下载MaxMind GeoIP数据库的可选URL。
• GEOIP_OVERRIDES：GeoIP查找的可选覆盖项（空格分隔列表）。
• CONTINENT_OVERRIDES：大陆映射的可选覆盖项（空格分隔列表）。
• STATS_IPS：允许访问统计端点的IP地址（逗号分隔列表）。
• GRPC_LISTEN：GRPC请求监听的IP和端口。
• GRPC_SERVER_CERTIFICATE：GRPC服务器使用的证书。
• GRPC_SERVER_KEY：GRPC服务器使用的私钥。
• GRPC_SERVER_CA：允许颁发GRPC服务器证书的CA证书。
• GRPC_CLIENT_CERTIFICATE：GRPC客户端使用的证书。
• GRPC_CLIENT_KEY：GRPC客户端使用的私钥。
• GRPC_CLIENT_CA：允许颁发GRPC客户端证书的CA证书。
• GRPC_TARGETS：集群模式下连接的GRPC目标（逗号分隔列表）。
• GRPC_DNS_DISCOVERY：启用对配置的GRPC目标主机名的DNS发现。
• GRPC_ETCD：设为1时使用etcd配置GRPC节点。
• GRPC_TARGET_PREFIX：GRPC目标条目的键前缀。
• SKIP_VERIFY：设为true时跳过后端和代理服务器的证书验证。仅应在开发期间启用（如使用自签名证书）。

配置两个后端的示例：

bash
docker run \
  ... \
  -e BACKENDS="foo bar" \
  -e BACKEND_FOO_URL=https://cloud.server1.tld \
  -e BACKEND_FOO_SHARED_SECRET=verysecret \
  -e BACKEND_BAR_URL=https://cloud.server2.tld \
  -e BACKEND_BAR_SHARED_SECRET=moresecret \
  ...

有关更多选项的详细信息，请参见https://github.com/strukturag/nextcloud-spreed-signaling/blob/master/server.conf.in%E3%80%82

信令代理

信令代理镜像可从以下地址获取：

strukturag/nextcloud-spreed-signaling:<version>-proxy

将 <version> 替换为您要使用的标签或提交哈希。

配置

运行中的容器可通过以下环境变量进行配置：

• CONFIG：可选的配置文件名。
• HTTP_LISTEN：HTTP监听器地址。
• COUNTRY：代理所在的可选ISO 3166国家代码。
• JANUS_URL：Janus服务器URL。
• MAX_STREAM_BITRATE：音频/视频流的可选最大比特率。
• MAX_SCREEN_BITRATE：屏幕共享流的可选最大比特率。
• ETCD_ENDPOINTS：etcd端点的静态列表（如需使用etcd）。
• ETCD_DISCOVERY_SRV：用于etcd端点DNS SRV配置的替代域名（如需使用etcd）。
• ETCD_DISCOVERY_SERVICE：etcd的DNS SRV配置的可选服务名称。
• ETCD_CLIENT_CERTIFICATE：etcd客户端证书文件名。
• ETCD_CLIENT_KEY：etcd客户端私钥文件名。
• ETCD_CLIENT_CA：etcd客户端CA证书文件名。
• TOKENS_ETCD：设为1时使用etcd配置令牌。
• TOKEN_KEY_FORMAT：用于检索公钥的密钥名格式，"%s"将替换为令牌ID。
• TOKENS：令牌ID的空格分隔列表。
• TOKEN_<ID>_KEY：令牌<ID>的公钥文件名（其中<ID>为大写的令牌ID）。

配置两个令牌的示例：

bash
docker run \
  ... \
  -e TOKENS="foo signaling.server1.tld" \
  -e TOKEN_FOO_KEY=/path/to/foo.key \
  -e TOKEN_SIGNALING_SERVER1_TLD_KEY=/path/to/signaling.server1.tld.key \
  ...

有关更多选项的详细信息，请参见https://github.com/strukturag/nextcloud-spreed-signaling/blob/master/proxy.conf.in%E3%80%82