import { createClient, RedisClientOptions, RedisModules, RedisScripts } from 'redis' import { exists } from '@server/helpers/custom-validators/misc' import { sha256 } from '@shared/extra-utils' import { logger } from '../helpers/logger' import { generateRandomString } from '../helpers/utils' import { CONFIG } from '../initializers/config' import { AP_CLEANER, CONTACT_FORM_LIFETIME, RESUMABLE_UPLOAD_SESSION_LIFETIME, TRACKER_RATE_LIMITS, USER_EMAIL_VERIFY_LIFETIME, USER_PASSWORD_CREATE_LIFETIME, USER_PASSWORD_RESET_LIFETIME, VIEW_LIFETIME, WEBSERVER } from '../initializers/constants' // Only used for typings // TODO: remove when https://github.com/microsoft/TypeScript/issues/37181 is fixed const redisClientWrapperForType = () => createClient<{}, RedisScripts>() class Redis { private static instance: Redis private initialized = false private connected = false private client: ReturnType private prefix: string private constructor () { } init () { // Already initialized if (this.initialized === true) return this.initialized = true this.client = createClient(Redis.getRedisClientOptions()) logger.info('Connecting to redis...') this.client.connect() .then(() => { logger.info('Connected to redis.') this.connected = true }).catch(err => { logger.error('Cannot connect to redis', { err }) process.exit(-1) }) this.prefix = 'redis-' + WEBSERVER.HOST + '-' } static getRedisClientOptions () { let config: RedisClientOptions = { socket: { connectTimeout: 20000 // Could be slow since node use sync call to compile PeerTube } } if (CONFIG.REDIS.AUTH) { config = { ...config, password: CONFIG.REDIS.AUTH } } if (CONFIG.REDIS.DB) { config = { ...config, database: CONFIG.REDIS.DB } } if (CONFIG.REDIS.HOSTNAME && CONFIG.REDIS.PORT) { config.socket = { ...config.socket, host: CONFIG.REDIS.HOSTNAME, port: CONFIG.REDIS.PORT } } else { config.socket = { ...config.socket, path: CONFIG.REDIS.SOCKET } } return config } getClient () { return this.client } getPrefix () { return this.prefix } isConnected () { return this.connected } /* ************ Forgot password ************ */ async setResetPasswordVerificationString (userId: number) { const generatedString = await generateRandomString(32) await this.setValue(this.generateResetPasswordKey(userId), generatedString, USER_PASSWORD_RESET_LIFETIME) return generatedString } async setCreatePasswordVerificationString (userId: number) { const generatedString = await generateRandomString(32) await this.setValue(this.generateResetPasswordKey(userId), generatedString, USER_PASSWORD_CREATE_LIFETIME) return generatedString } async removePasswordVerificationString (userId: number) { return this.removeValue(this.generateResetPasswordKey(userId)) } async getResetPasswordLink (userId: number) { return this.getValue(this.generateResetPasswordKey(userId)) } /* ************ Email verification ************ */ async setVerifyEmailVerificationString (userId: number) { const generatedString = await generateRandomString(32) await this.setValue(this.generateVerifyEmailKey(userId), generatedString, USER_EMAIL_VERIFY_LIFETIME) return generatedString } async getVerifyEmailLink (userId: number) { return this.getValue(this.generateVerifyEmailKey(userId)) } /* ************ Contact form per IP ************ */ async setContactFormIp (ip: string) { return this.setValue(this.generateContactFormKey(ip), '1', CONTACT_FORM_LIFETIME) } async doesContactFormIpExist (ip: string) { return this.exists(this.generateContactFormKey(ip)) } /* ************ Views per IP ************ */ setIPVideoView (ip: string, videoUUID: string) { return this.setValue(this.generateIPViewKey(ip, videoUUID), '1', VIEW_LIFETIME.VIEW) } async doesVideoIPViewExist (ip: string, videoUUID: string) { return this.exists(this.generateIPViewKey(ip, videoUUID)) } /* ************ Tracker IP block ************ */ setTrackerBlockIP (ip: string) { return this.setValue(this.generateTrackerBlockIPKey(ip), '1', TRACKER_RATE_LIMITS.BLOCK_IP_LIFETIME) } async doesTrackerBlockIPExist (ip: string) { return this.exists(this.generateTrackerBlockIPKey(ip)) } /* ************ Video views stats ************ */ addVideoViewStats (videoId: number) { const { videoKey, setKey } = this.generateVideoViewStatsKeys({ videoId }) return Promise.all([ this.addToSet(setKey, videoId.toString()), this.increment(videoKey) ]) } async getVideoViewsStats (videoId: number, hour: number) { const { videoKey } = this.generateVideoViewStatsKeys({ videoId, hour }) const valueString = await this.getValue(videoKey) const valueInt = parseInt(valueString, 10) if (isNaN(valueInt)) { logger.error('Cannot get videos views stats of video %d in hour %d: views number is NaN (%s).', videoId, hour, valueString) return undefined } return valueInt } async listVideosViewedForStats (hour: number) { const { setKey } = this.generateVideoViewStatsKeys({ hour }) const stringIds = await this.getSet(setKey) return stringIds.map(s => parseInt(s, 10)) } deleteVideoViewsStats (videoId: number, hour: number) { const { setKey, videoKey } = this.generateVideoViewStatsKeys({ videoId, hour }) return Promise.all([ this.deleteFromSet(setKey, videoId.toString()), this.deleteKey(videoKey) ]) } /* ************ Local video views buffer ************ */ addLocalVideoView (videoId: number) { const { videoKey, setKey } = this.generateLocalVideoViewsKeys(videoId) return Promise.all([ this.addToSet(setKey, videoId.toString()), this.increment(videoKey) ]) } async getLocalVideoViews (videoId: number) { const { videoKey } = this.generateLocalVideoViewsKeys(videoId) const valueString = await this.getValue(videoKey) const valueInt = parseInt(valueString, 10) if (isNaN(valueInt)) { logger.error('Cannot get videos views of video %d: views number is NaN (%s).', videoId, valueString) return undefined } return valueInt } async listLocalVideosViewed () { const { setKey } = this.generateLocalVideoViewsKeys() const stringIds = await this.getSet(setKey) return stringIds.map(s => parseInt(s, 10)) } deleteLocalVideoViews (videoId: number) { const { setKey, videoKey } = this.generateLocalVideoViewsKeys(videoId) return Promise.all([ this.deleteFromSet(setKey, videoId.toString()), this.deleteKey(videoKey) ]) } /* ************ Video viewers stats ************ */ getLocalVideoViewer (options: { key?: string // Or ip?: string videoId?: number }) { if (options.key) return this.getObject(options.key) const { viewerKey } = this.generateLocalVideoViewerKeys(options.ip, options.videoId) return this.getObject(viewerKey) } setLocalVideoViewer (ip: string, videoId: number, object: any) { const { setKey, viewerKey } = this.generateLocalVideoViewerKeys(ip, videoId) return Promise.all([ this.addToSet(setKey, viewerKey), this.setObject(viewerKey, object) ]) } listLocalVideoViewerKeys () { const { setKey } = this.generateLocalVideoViewerKeys() return this.getSet(setKey) } deleteLocalVideoViewersKeys (key: string) { const { setKey } = this.generateLocalVideoViewerKeys() return Promise.all([ this.deleteFromSet(setKey, key), this.deleteKey(key) ]) } /* ************ Resumable uploads final responses ************ */ setUploadSession (uploadId: string, response?: { video: { id: number, shortUUID: string, uuid: string } }) { return this.setValue( 'resumable-upload-' + uploadId, response ? JSON.stringify(response) : '', RESUMABLE_UPLOAD_SESSION_LIFETIME ) } doesUploadSessionExist (uploadId: string) { return this.exists('resumable-upload-' + uploadId) } async getUploadSession (uploadId: string) { const value = await this.getValue('resumable-upload-' + uploadId) return value ? JSON.parse(value) : '' } deleteUploadSession (uploadId: string) { return this.deleteKey('resumable-upload-' + uploadId) } /* ************ AP resource unavailability ************ */ async addAPUnavailability (url: string) { const key = this.generateAPUnavailabilityKey(url) const value = await this.increment(key) await this.setExpiration(key, AP_CLEANER.PERIOD * 2) return value } /* ************ Keys generation ************ */ private generateLocalVideoViewsKeys (videoId: number): { setKey: string, videoKey: string } private generateLocalVideoViewsKeys (): { setKey: string } private generateLocalVideoViewsKeys (videoId?: number) { return { setKey: `local-video-views-buffer`, videoKey: `local-video-views-buffer-${videoId}` } } private generateLocalVideoViewerKeys (ip: string, videoId: number): { setKey: string, viewerKey: string } private generateLocalVideoViewerKeys (): { setKey: string } private generateLocalVideoViewerKeys (ip?: string, videoId?: number) { return { setKey: `local-video-viewer-stats-keys`, viewerKey: `local-video-viewer-stats-${ip}-${videoId}` } } private generateVideoViewStatsKeys (options: { videoId?: number, hour?: number }) { const hour = exists(options.hour) ? options.hour : new Date().getHours() return { setKey: `videos-view-h${hour}`, videoKey: `video-view-${options.videoId}-h${hour}` } } private generateResetPasswordKey (userId: number) { return 'reset-password-' + userId } private generateVerifyEmailKey (userId: number) { return 'verify-email-' + userId } private generateIPViewKey (ip: string, videoUUID: string) { return `views-${videoUUID}-${ip}` } private generateTrackerBlockIPKey (ip: string) { return `tracker-block-ip-${ip}` } private generateContactFormKey (ip: string) { return 'contact-form-' + ip } private generateAPUnavailabilityKey (url: string) { return 'ap-unavailability-' + sha256(url) } /* ************ Redis helpers ************ */ private getValue (key: string) { return this.client.get(this.prefix + key) } private getSet (key: string) { return this.client.sMembers(this.prefix + key) } private addToSet (key: string, value: string) { return this.client.sAdd(this.prefix + key, value) } private deleteFromSet (key: string, value: string) { return this.client.sRem(this.prefix + key, value) } private deleteKey (key: string) { return this.client.del(this.prefix + key) } private async getObject (key: string) { const value = await this.getValue(key) if (!value) return null return JSON.parse(value) } private setObject (key: string, value: { [ id: string ]: number | string }) { return this.setValue(key, JSON.stringify(value)) } private async setValue (key: string, value: string, expirationMilliseconds?: number) { const options = expirationMilliseconds ? { PX: expirationMilliseconds } : {} const result = await this.client.set(this.prefix + key, value, options) if (result !== 'OK') throw new Error('Redis set result is not OK.') } private removeValue (key: string) { return this.client.del(this.prefix + key) } private increment (key: string) { return this.client.incr(this.prefix + key) } private async exists (key: string) { const result = await this.client.exists(this.prefix + key) return result !== 0 } private setExpiration (key: string, ms: number) { return this.client.expire(this.prefix + key, ms / 1000) } static get Instance () { return this.instance || (this.instance = new this()) } } // --------------------------------------------------------------------------- export { Redis }