server/lib/live/live-manager.ts

   1
   2 import { readdir, readFile } from 'fs-extra'
   3 import { createServer, Server } from 'net'
   4 import { join } from 'path'
   5 import { createServer as createServerTLS, Server as ServerTLS } from 'tls'
   6 import {
   7   computeLowerResolutionsToTranscode,
   8   ffprobePromise,
   9   getLiveSegmentTime,
  10   getVideoStreamBitrate,
  11   getVideoStreamDimensionsInfo,
  12   getVideoStreamFPS
  13 } from '@server/helpers/ffmpeg'
  14 import { logger, loggerTagsFactory } from '@server/helpers/logger'
  15 import { CONFIG, registerConfigChangedHandler } from '@server/initializers/config'
  16 import { P2P_MEDIA_LOADER_PEER_VERSION, VIDEO_LIVE } from '@server/initializers/constants'
  17 import { UserModel } from '@server/models/user/user'
  18 import { VideoModel } from '@server/models/video/video'
  19 import { VideoLiveModel } from '@server/models/video/video-live'
  20 import { VideoLiveSessionModel } from '@server/models/video/video-live-session'
  21 import { VideoStreamingPlaylistModel } from '@server/models/video/video-streaming-playlist'
  22 import { MStreamingPlaylistVideo, MVideo, MVideoLiveSession, MVideoLiveVideo } from '@server/types/models'
  23 import { wait } from '@shared/core-utils'
  24 import { LiveVideoError, VideoState, VideoStreamingPlaylistType } from '@shared/models'
  25 import { federateVideoIfNeeded } from '../activitypub/videos'
  26 import { JobQueue } from '../job-queue'
  27 import { generateHLSMasterPlaylistFilename, generateHlsSha256SegmentsFilename, getLiveReplayBaseDirectory } from '../paths'
  28 import { PeerTubeSocket } from '../peertube-socket'
  29 import { LiveQuotaStore } from './live-quota-store'
  30 import { LiveSegmentShaStore } from './live-segment-sha-store'
  31 import { cleanupLive } from './live-utils'
  32 import { MuxingSession } from './shared'
  33
  34 const NodeRtmpSession = require('node-media-server/src/node_rtmp_session')
  35 const context = require('node-media-server/src/node_core_ctx')
  36 const nodeMediaServerLogger = require('node-media-server/src/node_core_logger')
  37
  38 // Disable node media server logs
  39 nodeMediaServerLogger.setLogType(0)
  40
  41 const config = {
  42   rtmp: {
  43     port: CONFIG.LIVE.RTMP.PORT,
  44     chunk_size: VIDEO_LIVE.RTMP.CHUNK_SIZE,
  45     gop_cache: VIDEO_LIVE.RTMP.GOP_CACHE,
  46     ping: VIDEO_LIVE.RTMP.PING,
  47     ping_timeout: VIDEO_LIVE.RTMP.PING_TIMEOUT
  48   }
  49 }
  50
  51 const lTags = loggerTagsFactory('live')
  52
  53 class LiveManager {
  54
  55   private static instance: LiveManager
  56
  57   private readonly muxingSessions = new Map<string, MuxingSession>()
  58   private readonly videoSessions = new Map<number, string>()
  59
  60   private rtmpServer: Server
  61   private rtmpsServer: ServerTLS
  62
  63   private running = false
  64
  65   private constructor () {
  66   }
  67
  68   init () {
  69     const events = this.getContext().nodeEvent
  70     events.on('postPublish', (sessionId: string, streamPath: string) => {
  71       logger.debug('RTMP received stream', { id: sessionId, streamPath, ...lTags(sessionId) })
  72
  73       const splittedPath = streamPath.split('/')
  74       if (splittedPath.length !== 3 || splittedPath[1] !== VIDEO_LIVE.RTMP.BASE_PATH) {
  75         logger.warn('Live path is incorrect.', { streamPath, ...lTags(sessionId) })
  76         return this.abortSession(sessionId)
  77       }
  78
  79       const session = this.getContext().sessions.get(sessionId)
  80
  81       this.handleSession(sessionId, session.inputOriginUrl + streamPath, splittedPath[2])
  82         .catch(err => logger.error('Cannot handle sessions.', { err, ...lTags(sessionId) }))
  83     })
  84
  85     events.on('donePublish', sessionId => {
  86       logger.info('Live session ended.', { sessionId, ...lTags(sessionId) })
  87     })
  88
  89     registerConfigChangedHandler(() => {
  90       if (!this.running && CONFIG.LIVE.ENABLED === true) {
  91         this.run().catch(err => logger.error('Cannot run live server.', { err }))
  92         return
  93       }
  94
  95       if (this.running && CONFIG.LIVE.ENABLED === false) {
  96         this.stop()
  97       }
  98     })
  99
 100     // Cleanup broken lives, that were terminated by a server restart for example
 101     this.handleBrokenLives()
 102       .catch(err => logger.error('Cannot handle broken lives.', { err, ...lTags() }))
 103   }
 104
 105   async run () {
 106     this.running = true
 107
 108     if (CONFIG.LIVE.RTMP.ENABLED) {
 109       logger.info('Running RTMP server on port %d', CONFIG.LIVE.RTMP.PORT, lTags())
 110
 111       this.rtmpServer = createServer(socket => {
 112         const session = new NodeRtmpSession(config, socket)
 113
 114         session.inputOriginUrl = 'rtmp://127.0.0.1:' + CONFIG.LIVE.RTMP.PORT
 115         session.run()
 116       })
 117
 118       this.rtmpServer.on('error', err => {
 119         logger.error('Cannot run RTMP server.', { err, ...lTags() })
 120       })
 121
 122       this.rtmpServer.listen(CONFIG.LIVE.RTMP.PORT, CONFIG.LIVE.RTMP.HOSTNAME)
 123     }
 124
 125     if (CONFIG.LIVE.RTMPS.ENABLED) {
 126       logger.info('Running RTMPS server on port %d', CONFIG.LIVE.RTMPS.PORT, lTags())
 127
 128       const [ key, cert ] = await Promise.all([
 129         readFile(CONFIG.LIVE.RTMPS.KEY_FILE),
 130         readFile(CONFIG.LIVE.RTMPS.CERT_FILE)
 131       ])
 132       const serverOptions = { key, cert }
 133
 134       this.rtmpsServer = createServerTLS(serverOptions, socket => {
 135         const session = new NodeRtmpSession(config, socket)
 136
 137         session.inputOriginUrl = 'rtmps://127.0.0.1:' + CONFIG.LIVE.RTMPS.PORT
 138         session.run()
 139       })
 140
 141       this.rtmpsServer.on('error', err => {
 142         logger.error('Cannot run RTMPS server.', { err, ...lTags() })
 143       })
 144
 145       this.rtmpsServer.listen(CONFIG.LIVE.RTMPS.PORT, CONFIG.LIVE.RTMPS.HOSTNAME)
 146     }
 147   }
 148
 149   stop () {
 150     this.running = false
 151
 152     if (this.rtmpServer) {
 153       logger.info('Stopping RTMP server.', lTags())
 154
 155       this.rtmpServer.close()
 156       this.rtmpServer = undefined
 157     }
 158
 159     if (this.rtmpsServer) {
 160       logger.info('Stopping RTMPS server.', lTags())
 161
 162       this.rtmpsServer.close()
 163       this.rtmpsServer = undefined
 164     }
 165
 166     // Sessions is an object
 167     this.getContext().sessions.forEach((session: any) => {
 168       if (session instanceof NodeRtmpSession) {
 169         session.stop()
 170       }
 171     })
 172   }
 173
 174   isRunning () {
 175     return !!this.rtmpServer
 176   }
 177
 178   stopSessionOf (videoId: number, error: LiveVideoError | null) {
 179     const sessionId = this.videoSessions.get(videoId)
 180     if (!sessionId) return
 181
 182     this.saveEndingSession(videoId, error)
 183       .catch(err => logger.error('Cannot save ending session.', { err, ...lTags(sessionId) }))
 184
 185     this.videoSessions.delete(videoId)
 186     this.abortSession(sessionId)
 187   }
 188
 189   private getContext () {
 190     return context
 191   }
 192
 193   private abortSession (sessionId: string) {
 194     const session = this.getContext().sessions.get(sessionId)
 195     if (session) {
 196       session.stop()
 197       this.getContext().sessions.delete(sessionId)
 198     }
 199
 200     const muxingSession = this.muxingSessions.get(sessionId)
 201     if (muxingSession) {
 202       // Muxing session will fire and event so we correctly cleanup the session
 203       muxingSession.abort()
 204
 205       this.muxingSessions.delete(sessionId)
 206     }
 207   }
 208
 209   private async handleSession (sessionId: string, inputUrl: string, streamKey: string) {
 210     const videoLive = await VideoLiveModel.loadByStreamKey(streamKey)
 211     if (!videoLive) {
 212       logger.warn('Unknown live video with stream key %s.', streamKey, lTags(sessionId))
 213       return this.abortSession(sessionId)
 214     }
 215
 216     const video = videoLive.Video
 217     if (video.isBlacklisted()) {
 218       logger.warn('Video is blacklisted. Refusing stream %s.', streamKey, lTags(sessionId, video.uuid))
 219       return this.abortSession(sessionId)
 220     }
 221
 222     // Cleanup old potential live files (could happen with a permanent live)
 223     LiveSegmentShaStore.Instance.cleanupShaSegments(video.uuid)
 224
 225     const oldStreamingPlaylist = await VideoStreamingPlaylistModel.loadHLSPlaylistByVideo(video.id)
 226     if (oldStreamingPlaylist) {
 227       await cleanupLive(video, oldStreamingPlaylist)
 228     }
 229
 230     this.videoSessions.set(video.id, sessionId)
 231
 232     const now = Date.now()
 233     const probe = await ffprobePromise(inputUrl)
 234
 235     const [ { resolution, ratio }, fps, bitrate ] = await Promise.all([
 236       getVideoStreamDimensionsInfo(inputUrl, probe),
 237       getVideoStreamFPS(inputUrl, probe),
 238       getVideoStreamBitrate(inputUrl, probe)
 239     ])
 240
 241     logger.info(
 242       '%s probing took %d ms (bitrate: %d, fps: %d, resolution: %d)',
 243       inputUrl, Date.now() - now, bitrate, fps, resolution, lTags(sessionId, video.uuid)
 244     )
 245
 246     const allResolutions = this.buildAllResolutionsToTranscode(resolution)
 247
 248     logger.info(
 249       'Will mux/transcode live video of original resolution %d.', resolution,
 250       { allResolutions, ...lTags(sessionId, video.uuid) }
 251     )
 252
 253     const streamingPlaylist = await this.createLivePlaylist(video, allResolutions)
 254
 255     return this.runMuxingSession({
 256       sessionId,
 257       videoLive,
 258       streamingPlaylist,
 259       inputUrl,
 260       fps,
 261       bitrate,
 262       ratio,
 263       allResolutions
 264     })
 265   }
 266
 267   private async runMuxingSession (options: {
 268     sessionId: string
 269     videoLive: MVideoLiveVideo
 270     streamingPlaylist: MStreamingPlaylistVideo
 271     inputUrl: string
 272     fps: number
 273     bitrate: number
 274     ratio: number
 275     allResolutions: number[]
 276   }) {
 277     const { sessionId, videoLive, streamingPlaylist, allResolutions, fps, bitrate, ratio, inputUrl } = options
 278     const videoUUID = videoLive.Video.uuid
 279     const localLTags = lTags(sessionId, videoUUID)
 280
 281     const liveSession = await this.saveStartingSession(videoLive)
 282
 283     const user = await UserModel.loadByLiveId(videoLive.id)
 284     LiveQuotaStore.Instance.addNewLive(user.id, videoLive.id)
 285
 286     const muxingSession = new MuxingSession({
 287       context: this.getContext(),
 288       user,
 289       sessionId,
 290       videoLive,
 291       streamingPlaylist,
 292       inputUrl,
 293       bitrate,
 294       ratio,
 295       fps,
 296       allResolutions
 297     })
 298
 299     muxingSession.on('master-playlist-created', () => this.publishAndFederateLive(videoLive, localLTags))
 300
 301     muxingSession.on('bad-socket-health', ({ videoId }) => {
 302       logger.error(
 303         'Too much data in client socket stream (ffmpeg is too slow to transcode the video).' +
 304         ' Stopping session of video %s.', videoUUID,
 305         localLTags
 306       )
 307
 308       this.stopSessionOf(videoId, LiveVideoError.BAD_SOCKET_HEALTH)
 309     })
 310
 311     muxingSession.on('duration-exceeded', ({ videoId }) => {
 312       logger.info('Stopping session of %s: max duration exceeded.', videoUUID, localLTags)
 313
 314       this.stopSessionOf(videoId, LiveVideoError.DURATION_EXCEEDED)
 315     })
 316
 317     muxingSession.on('quota-exceeded', ({ videoId }) => {
 318       logger.info('Stopping session of %s: user quota exceeded.', videoUUID, localLTags)
 319
 320       this.stopSessionOf(videoId, LiveVideoError.QUOTA_EXCEEDED)
 321     })
 322
 323     muxingSession.on('ffmpeg-error', ({ videoId }) => {
 324       this.stopSessionOf(videoId, LiveVideoError.FFMPEG_ERROR)
 325     })
 326
 327     muxingSession.on('ffmpeg-end', ({ videoId }) => {
 328       this.onMuxingFFmpegEnd(videoId, sessionId)
 329     })
 330
 331     muxingSession.on('after-cleanup', ({ videoId }) => {
 332       this.muxingSessions.delete(sessionId)
 333
 334       LiveQuotaStore.Instance.removeLive(user.id, videoLive.id)
 335
 336       muxingSession.destroy()
 337
 338       return this.onAfterMuxingCleanup({ videoId, liveSession })
 339         .catch(err => logger.error('Error in end transmuxing.', { err, ...localLTags }))
 340     })
 341
 342     this.muxingSessions.set(sessionId, muxingSession)
 343
 344     muxingSession.runMuxing()
 345       .catch(err => {
 346         logger.error('Cannot run muxing.', { err, ...localLTags })
 347         this.abortSession(sessionId)
 348       })
 349   }
 350
 351   private async publishAndFederateLive (live: MVideoLiveVideo, localLTags: { tags: string[] }) {
 352     const videoId = live.videoId
 353
 354     try {
 355       const video = await VideoModel.loadAndPopulateAccountAndServerAndTags(videoId)
 356
 357       logger.info('Will publish and federate live %s.', video.url, localLTags)
 358
 359       video.state = VideoState.PUBLISHED
 360       video.publishedAt = new Date()
 361       await video.save()
 362
 363       live.Video = video
 364
 365       await wait(getLiveSegmentTime(live.latencyMode) * 1000 * VIDEO_LIVE.EDGE_LIVE_DELAY_SEGMENTS_NOTIFICATION)
 366
 367       try {
 368         await federateVideoIfNeeded(video, false)
 369       } catch (err) {
 370         logger.error('Cannot federate live video %s.', video.url, { err, ...localLTags })
 371       }
 372
 373       PeerTubeSocket.Instance.sendVideoLiveNewState(video)
 374     } catch (err) {
 375       logger.error('Cannot save/federate live video %d.', videoId, { err, ...localLTags })
 376     }
 377   }
 378
 379   private onMuxingFFmpegEnd (videoId: number, sessionId: string) {
 380     this.videoSessions.delete(videoId)
 381
 382     this.saveEndingSession(videoId, null)
 383       .catch(err => logger.error('Cannot save ending session.', { err, ...lTags(sessionId) }))
 384   }
 385
 386   private async onAfterMuxingCleanup (options: {
 387     videoId: number | string
 388     liveSession?: MVideoLiveSession
 389     cleanupNow?: boolean // Default false
 390   }) {
 391     const { videoId, liveSession: liveSessionArg, cleanupNow = false } = options
 392
 393     try {
 394       const fullVideo = await VideoModel.loadAndPopulateAccountAndServerAndTags(videoId)
 395       if (!fullVideo) return
 396
 397       const live = await VideoLiveModel.loadByVideoId(fullVideo.id)
 398
 399       const liveSession = liveSessionArg ?? await VideoLiveSessionModel.findCurrentSessionOf(fullVideo.id)
 400
 401       // On server restart during a live
 402       if (!liveSession.endDate) {
 403         liveSession.endDate = new Date()
 404         await liveSession.save()
 405       }
 406
 407       JobQueue.Instance.createJob({
 408         type: 'video-live-ending',
 409         payload: {
 410           videoId: fullVideo.id,
 411
 412           replayDirectory: live.saveReplay
 413             ? await this.findReplayDirectory(fullVideo)
 414             : undefined,
 415
 416           liveSessionId: liveSession.id,
 417
 418           publishedAt: fullVideo.publishedAt.toISOString()
 419         }
 420       }, { delay: cleanupNow ? 0 : VIDEO_LIVE.CLEANUP_DELAY })
 421
 422       fullVideo.state = live.permanentLive
 423         ? VideoState.WAITING_FOR_LIVE
 424         : VideoState.LIVE_ENDED
 425
 426       await fullVideo.save()
 427
 428       PeerTubeSocket.Instance.sendVideoLiveNewState(fullVideo)
 429
 430       await federateVideoIfNeeded(fullVideo, false)
 431     } catch (err) {
 432       logger.error('Cannot save/federate new video state of live streaming of video %d.', videoId, { err, ...lTags(videoId + '') })
 433     }
 434   }
 435
 436   private async handleBrokenLives () {
 437     const videoUUIDs = await VideoModel.listPublishedLiveUUIDs()
 438
 439     for (const uuid of videoUUIDs) {
 440       await this.onAfterMuxingCleanup({ videoId: uuid, cleanupNow: true })
 441     }
 442   }
 443
 444   private async findReplayDirectory (video: MVideo) {
 445     const directory = getLiveReplayBaseDirectory(video)
 446     const files = await readdir(directory)
 447
 448     if (files.length === 0) return undefined
 449
 450     return join(directory, files.sort().reverse()[0])
 451   }
 452
 453   private buildAllResolutionsToTranscode (originResolution: number) {
 454     const resolutionsEnabled = CONFIG.LIVE.TRANSCODING.ENABLED
 455       ? computeLowerResolutionsToTranscode(originResolution, 'live')
 456       : []
 457
 458     return resolutionsEnabled.concat([ originResolution ])
 459   }
 460
 461   private async createLivePlaylist (video: MVideo, allResolutions: number[]): Promise<MStreamingPlaylistVideo> {
 462     const playlist = await VideoStreamingPlaylistModel.loadOrGenerate(video)
 463
 464     playlist.playlistFilename = generateHLSMasterPlaylistFilename(true)
 465     playlist.segmentsSha256Filename = generateHlsSha256SegmentsFilename(true)
 466
 467     playlist.p2pMediaLoaderPeerVersion = P2P_MEDIA_LOADER_PEER_VERSION
 468     playlist.type = VideoStreamingPlaylistType.HLS
 469
 470     playlist.assignP2PMediaLoaderInfoHashes(video, allResolutions)
 471
 472     return playlist.save()
 473   }
 474
 475   private saveStartingSession (videoLive: MVideoLiveVideo) {
 476     const liveSession = new VideoLiveSessionModel({
 477       startDate: new Date(),
 478       liveVideoId: videoLive.videoId
 479     })
 480
 481     return liveSession.save()
 482   }
 483
 484   private async saveEndingSession (videoId: number, error: LiveVideoError | null) {
 485     const liveSession = await VideoLiveSessionModel.findCurrentSessionOf(videoId)
 486     liveSession.endDate = new Date()
 487     liveSession.error = error
 488
 489     return liveSession.save()
 490   }
 491
 492   static get Instance () {
 493     return this.instance || (this.instance = new this())
 494   }
 495 }
 496
 497 // ---------------------------------------------------------------------------
 498
 499 export {
 500   LiveManager
 501 }