server/controllers/api/config.ts

   1 import express from 'express'
   2 import { remove, writeJSON } from 'fs-extra'
   3 import { snakeCase } from 'lodash'
   4 import validator from 'validator'
   5 import { ServerConfigManager } from '@server/lib/server-config-manager'
   6 import { About, CustomConfig, UserRight } from '@shared/models'
   7 import { auditLoggerFactory, CustomConfigAuditView, getAuditIdFromRes } from '../../helpers/audit-logger'
   8 import { objectConverter } from '../../helpers/core-utils'
   9 import { CONFIG, reloadConfig } from '../../initializers/config'
  10 import { ClientHtml } from '../../lib/client-html'
  11 import { asyncMiddleware, authenticate, ensureUserHasRight, openapiOperationDoc } from '../../middlewares'
  12 import { customConfigUpdateValidator, ensureConfigIsEditable } from '../../middlewares/validators/config'
  13
  14 const configRouter = express.Router()
  15
  16 const auditLogger = auditLoggerFactory('config')
  17
  18 configRouter.get('/',
  19   openapiOperationDoc({ operationId: 'getConfig' }),
  20   asyncMiddleware(getConfig)
  21 )
  22
  23 configRouter.get('/about',
  24   openapiOperationDoc({ operationId: 'getAbout' }),
  25   getAbout
  26 )
  27
  28 configRouter.get('/custom',
  29   openapiOperationDoc({ operationId: 'getCustomConfig' }),
  30   authenticate,
  31   ensureUserHasRight(UserRight.MANAGE_CONFIGURATION),
  32   getCustomConfig
  33 )
  34
  35 configRouter.put('/custom',
  36   openapiOperationDoc({ operationId: 'putCustomConfig' }),
  37   authenticate,
  38   ensureUserHasRight(UserRight.MANAGE_CONFIGURATION),
  39   ensureConfigIsEditable,
  40   customConfigUpdateValidator,
  41   asyncMiddleware(updateCustomConfig)
  42 )
  43
  44 configRouter.delete('/custom',
  45   openapiOperationDoc({ operationId: 'delCustomConfig' }),
  46   authenticate,
  47   ensureUserHasRight(UserRight.MANAGE_CONFIGURATION),
  48   ensureConfigIsEditable,
  49   asyncMiddleware(deleteCustomConfig)
  50 )
  51
  52 async function getConfig (req: express.Request, res: express.Response) {
  53   const json = await ServerConfigManager.Instance.getServerConfig(req.ip)
  54
  55   return res.json(json)
  56 }
  57
  58 function getAbout (req: express.Request, res: express.Response) {
  59   const about: About = {
  60     instance: {
  61       name: CONFIG.INSTANCE.NAME,
  62       shortDescription: CONFIG.INSTANCE.SHORT_DESCRIPTION,
  63       description: CONFIG.INSTANCE.DESCRIPTION,
  64       terms: CONFIG.INSTANCE.TERMS,
  65       codeOfConduct: CONFIG.INSTANCE.CODE_OF_CONDUCT,
  66
  67       hardwareInformation: CONFIG.INSTANCE.HARDWARE_INFORMATION,
  68
  69       creationReason: CONFIG.INSTANCE.CREATION_REASON,
  70       moderationInformation: CONFIG.INSTANCE.MODERATION_INFORMATION,
  71       administrator: CONFIG.INSTANCE.ADMINISTRATOR,
  72       maintenanceLifetime: CONFIG.INSTANCE.MAINTENANCE_LIFETIME,
  73       businessModel: CONFIG.INSTANCE.BUSINESS_MODEL,
  74
  75       languages: CONFIG.INSTANCE.LANGUAGES,
  76       categories: CONFIG.INSTANCE.CATEGORIES
  77     }
  78   }
  79
  80   return res.json(about)
  81 }
  82
  83 function getCustomConfig (req: express.Request, res: express.Response) {
  84   const data = customConfig()
  85
  86   return res.json(data)
  87 }
  88
  89 async function deleteCustomConfig (req: express.Request, res: express.Response) {
  90   await remove(CONFIG.CUSTOM_FILE)
  91
  92   auditLogger.delete(getAuditIdFromRes(res), new CustomConfigAuditView(customConfig()))
  93
  94   reloadConfig()
  95   ClientHtml.invalidCache()
  96
  97   const data = customConfig()
  98
  99   return res.json(data)
 100 }
 101
 102 async function updateCustomConfig (req: express.Request, res: express.Response) {
 103   const oldCustomConfigAuditKeys = new CustomConfigAuditView(customConfig())
 104
 105   // camelCase to snake_case key + Force number conversion
 106   const toUpdateJSON = convertCustomConfigBody(req.body)
 107
 108   await writeJSON(CONFIG.CUSTOM_FILE, toUpdateJSON, { spaces: 2 })
 109
 110   reloadConfig()
 111   ClientHtml.invalidCache()
 112
 113   const data = customConfig()
 114
 115   auditLogger.update(
 116     getAuditIdFromRes(res),
 117     new CustomConfigAuditView(data),
 118     oldCustomConfigAuditKeys
 119   )
 120
 121   return res.json(data)
 122 }
 123
 124 // ---------------------------------------------------------------------------
 125
 126 export {
 127   configRouter
 128 }
 129
 130 // ---------------------------------------------------------------------------
 131
 132 function customConfig (): CustomConfig {
 133   return {
 134     instance: {
 135       name: CONFIG.INSTANCE.NAME,
 136       shortDescription: CONFIG.INSTANCE.SHORT_DESCRIPTION,
 137       description: CONFIG.INSTANCE.DESCRIPTION,
 138       terms: CONFIG.INSTANCE.TERMS,
 139       codeOfConduct: CONFIG.INSTANCE.CODE_OF_CONDUCT,
 140
 141       creationReason: CONFIG.INSTANCE.CREATION_REASON,
 142       moderationInformation: CONFIG.INSTANCE.MODERATION_INFORMATION,
 143       administrator: CONFIG.INSTANCE.ADMINISTRATOR,
 144       maintenanceLifetime: CONFIG.INSTANCE.MAINTENANCE_LIFETIME,
 145       businessModel: CONFIG.INSTANCE.BUSINESS_MODEL,
 146       hardwareInformation: CONFIG.INSTANCE.HARDWARE_INFORMATION,
 147
 148       languages: CONFIG.INSTANCE.LANGUAGES,
 149       categories: CONFIG.INSTANCE.CATEGORIES,
 150
 151       isNSFW: CONFIG.INSTANCE.IS_NSFW,
 152       defaultNSFWPolicy: CONFIG.INSTANCE.DEFAULT_NSFW_POLICY,
 153
 154       defaultClientRoute: CONFIG.INSTANCE.DEFAULT_CLIENT_ROUTE,
 155
 156       customizations: {
 157         css: CONFIG.INSTANCE.CUSTOMIZATIONS.CSS,
 158         javascript: CONFIG.INSTANCE.CUSTOMIZATIONS.JAVASCRIPT
 159       }
 160     },
 161     theme: {
 162       default: CONFIG.THEME.DEFAULT
 163     },
 164     services: {
 165       twitter: {
 166         username: CONFIG.SERVICES.TWITTER.USERNAME,
 167         whitelisted: CONFIG.SERVICES.TWITTER.WHITELISTED
 168       }
 169     },
 170     client: {
 171       videos: {
 172         miniature: {
 173           preferAuthorDisplayName: CONFIG.CLIENT.VIDEOS.MINIATURE.PREFER_AUTHOR_DISPLAY_NAME
 174         }
 175       },
 176       menu: {
 177         login: {
 178           redirectOnSingleExternalAuth: CONFIG.CLIENT.MENU.LOGIN.REDIRECT_ON_SINGLE_EXTERNAL_AUTH
 179         }
 180       }
 181     },
 182     cache: {
 183       previews: {
 184         size: CONFIG.CACHE.PREVIEWS.SIZE
 185       },
 186       captions: {
 187         size: CONFIG.CACHE.VIDEO_CAPTIONS.SIZE
 188       },
 189       torrents: {
 190         size: CONFIG.CACHE.TORRENTS.SIZE
 191       }
 192     },
 193     signup: {
 194       enabled: CONFIG.SIGNUP.ENABLED,
 195       limit: CONFIG.SIGNUP.LIMIT,
 196       requiresApproval: CONFIG.SIGNUP.REQUIRES_APPROVAL,
 197       requiresEmailVerification: CONFIG.SIGNUP.REQUIRES_EMAIL_VERIFICATION,
 198       minimumAge: CONFIG.SIGNUP.MINIMUM_AGE
 199     },
 200     admin: {
 201       email: CONFIG.ADMIN.EMAIL
 202     },
 203     contactForm: {
 204       enabled: CONFIG.CONTACT_FORM.ENABLED
 205     },
 206     user: {
 207       history: {
 208         videos: {
 209           enabled: CONFIG.USER.HISTORY.VIDEOS.ENABLED
 210         }
 211       },
 212       videoQuota: CONFIG.USER.VIDEO_QUOTA,
 213       videoQuotaDaily: CONFIG.USER.VIDEO_QUOTA_DAILY
 214     },
 215     videoChannels: {
 216       maxPerUser: CONFIG.VIDEO_CHANNELS.MAX_PER_USER
 217     },
 218     transcoding: {
 219       enabled: CONFIG.TRANSCODING.ENABLED,
 220       remoteRunners: {
 221         enabled: CONFIG.TRANSCODING.REMOTE_RUNNERS.ENABLED
 222       },
 223       allowAdditionalExtensions: CONFIG.TRANSCODING.ALLOW_ADDITIONAL_EXTENSIONS,
 224       allowAudioFiles: CONFIG.TRANSCODING.ALLOW_AUDIO_FILES,
 225       threads: CONFIG.TRANSCODING.THREADS,
 226       concurrency: CONFIG.TRANSCODING.CONCURRENCY,
 227       profile: CONFIG.TRANSCODING.PROFILE,
 228       resolutions: {
 229         '0p': CONFIG.TRANSCODING.RESOLUTIONS['0p'],
 230         '144p': CONFIG.TRANSCODING.RESOLUTIONS['144p'],
 231         '240p': CONFIG.TRANSCODING.RESOLUTIONS['240p'],
 232         '360p': CONFIG.TRANSCODING.RESOLUTIONS['360p'],
 233         '480p': CONFIG.TRANSCODING.RESOLUTIONS['480p'],
 234         '720p': CONFIG.TRANSCODING.RESOLUTIONS['720p'],
 235         '1080p': CONFIG.TRANSCODING.RESOLUTIONS['1080p'],
 236         '1440p': CONFIG.TRANSCODING.RESOLUTIONS['1440p'],
 237         '2160p': CONFIG.TRANSCODING.RESOLUTIONS['2160p']
 238       },
 239       alwaysTranscodeOriginalResolution: CONFIG.TRANSCODING.ALWAYS_TRANSCODE_ORIGINAL_RESOLUTION,
 240       webtorrent: {
 241         enabled: CONFIG.TRANSCODING.WEBTORRENT.ENABLED
 242       },
 243       hls: {
 244         enabled: CONFIG.TRANSCODING.HLS.ENABLED
 245       }
 246     },
 247     live: {
 248       enabled: CONFIG.LIVE.ENABLED,
 249       allowReplay: CONFIG.LIVE.ALLOW_REPLAY,
 250       latencySetting: {
 251         enabled: CONFIG.LIVE.LATENCY_SETTING.ENABLED
 252       },
 253       maxDuration: CONFIG.LIVE.MAX_DURATION,
 254       maxInstanceLives: CONFIG.LIVE.MAX_INSTANCE_LIVES,
 255       maxUserLives: CONFIG.LIVE.MAX_USER_LIVES,
 256       transcoding: {
 257         enabled: CONFIG.LIVE.TRANSCODING.ENABLED,
 258         remoteRunners: {
 259           enabled: CONFIG.LIVE.TRANSCODING.REMOTE_RUNNERS.ENABLED
 260         },
 261         threads: CONFIG.LIVE.TRANSCODING.THREADS,
 262         profile: CONFIG.LIVE.TRANSCODING.PROFILE,
 263         resolutions: {
 264           '144p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['144p'],
 265           '240p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['240p'],
 266           '360p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['360p'],
 267           '480p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['480p'],
 268           '720p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['720p'],
 269           '1080p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['1080p'],
 270           '1440p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['1440p'],
 271           '2160p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['2160p']
 272         },
 273         alwaysTranscodeOriginalResolution: CONFIG.LIVE.TRANSCODING.ALWAYS_TRANSCODE_ORIGINAL_RESOLUTION
 274       }
 275     },
 276     videoStudio: {
 277       enabled: CONFIG.VIDEO_STUDIO.ENABLED
 278     },
 279     import: {
 280       videos: {
 281         concurrency: CONFIG.IMPORT.VIDEOS.CONCURRENCY,
 282         http: {
 283           enabled: CONFIG.IMPORT.VIDEOS.HTTP.ENABLED
 284         },
 285         torrent: {
 286           enabled: CONFIG.IMPORT.VIDEOS.TORRENT.ENABLED
 287         }
 288       },
 289       videoChannelSynchronization: {
 290         enabled: CONFIG.IMPORT.VIDEO_CHANNEL_SYNCHRONIZATION.ENABLED,
 291         maxPerUser: CONFIG.IMPORT.VIDEO_CHANNEL_SYNCHRONIZATION.MAX_PER_USER
 292       }
 293     },
 294     trending: {
 295       videos: {
 296         algorithms: {
 297           enabled: CONFIG.TRENDING.VIDEOS.ALGORITHMS.ENABLED,
 298           default: CONFIG.TRENDING.VIDEOS.ALGORITHMS.DEFAULT
 299         }
 300       }
 301     },
 302     autoBlacklist: {
 303       videos: {
 304         ofUsers: {
 305           enabled: CONFIG.AUTO_BLACKLIST.VIDEOS.OF_USERS.ENABLED
 306         }
 307       }
 308     },
 309     followers: {
 310       instance: {
 311         enabled: CONFIG.FOLLOWERS.INSTANCE.ENABLED,
 312         manualApproval: CONFIG.FOLLOWERS.INSTANCE.MANUAL_APPROVAL
 313       }
 314     },
 315     followings: {
 316       instance: {
 317         autoFollowBack: {
 318           enabled: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_BACK.ENABLED
 319         },
 320
 321         autoFollowIndex: {
 322           enabled: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_INDEX.ENABLED,
 323           indexUrl: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_INDEX.INDEX_URL
 324         }
 325       }
 326     },
 327     broadcastMessage: {
 328       enabled: CONFIG.BROADCAST_MESSAGE.ENABLED,
 329       message: CONFIG.BROADCAST_MESSAGE.MESSAGE,
 330       level: CONFIG.BROADCAST_MESSAGE.LEVEL,
 331       dismissable: CONFIG.BROADCAST_MESSAGE.DISMISSABLE
 332     },
 333     search: {
 334       remoteUri: {
 335         users: CONFIG.SEARCH.REMOTE_URI.USERS,
 336         anonymous: CONFIG.SEARCH.REMOTE_URI.ANONYMOUS
 337       },
 338       searchIndex: {
 339         enabled: CONFIG.SEARCH.SEARCH_INDEX.ENABLED,
 340         url: CONFIG.SEARCH.SEARCH_INDEX.URL,
 341         disableLocalSearch: CONFIG.SEARCH.SEARCH_INDEX.DISABLE_LOCAL_SEARCH,
 342         isDefaultSearch: CONFIG.SEARCH.SEARCH_INDEX.IS_DEFAULT_SEARCH
 343       }
 344     }
 345   }
 346 }
 347
 348 function convertCustomConfigBody (body: CustomConfig) {
 349   function keyConverter (k: string) {
 350     // Transcoding resolutions exception
 351     if (/^\d{3,4}p$/.exec(k)) return k
 352     if (k === '0p') return k
 353
 354     return snakeCase(k)
 355   }
 356
 357   function valueConverter (v: any) {
 358     if (validator.isNumeric(v + '')) return parseInt('' + v, 10)
 359
 360     return v
 361   }
 362
 363   return objectConverter(body, keyConverter, valueConverter)
 364 }