PeerTube/server/core/lib/redis.ts

454 lines
13 KiB
TypeScript
Raw Normal View History

import { Redis as IoRedis, RedisOptions } from 'ioredis'
import { exists } from '@server/helpers/custom-validators/misc.js'
import { sha256 } from '@peertube/peertube-node-utils'
import { logger } from '../helpers/logger.js'
import { generateRandomString } from '../helpers/utils.js'
import { CONFIG } from '../initializers/config.js'
2019-01-09 15:14:29 +01:00
import {
2021-12-28 11:36:51 +01:00
AP_CLEANER,
2019-01-09 15:14:29 +01:00
CONTACT_FORM_LIFETIME,
EMAIL_VERIFY_LIFETIME,
2021-12-24 14:49:03 +01:00
RESUMABLE_UPLOAD_SESSION_LIFETIME,
TWO_FACTOR_AUTH_REQUEST_TOKEN_LIFETIME,
USER_PASSWORD_CREATE_LIFETIME,
2021-12-24 14:49:03 +01:00
USER_PASSWORD_RESET_LIFETIME,
2020-11-06 16:42:23 +01:00
VIEW_LIFETIME,
2021-12-24 14:49:03 +01:00
WEBSERVER
} from '../initializers/constants.js'
2018-04-17 14:01:06 +02:00
2018-01-30 13:27:07 +01:00
class Redis {
private static instance: Redis
private initialized = false
2021-12-24 14:49:03 +01:00
private connected = false
private client: IoRedis
2018-01-30 13:27:07 +01:00
private prefix: string
2020-01-31 16:56:52 +01:00
private constructor () {
}
2018-01-30 13:27:07 +01:00
init () {
// Already initialized
if (this.initialized === true) return
this.initialized = true
const redisMode = CONFIG.REDIS.SENTINEL.ENABLED ? 'sentinel' : 'standalone'
logger.info('Connecting to redis ' + redisMode + '...')
2022-01-04 09:16:43 +01:00
this.client = new IoRedis(Redis.getRedisClientOptions('', { enableAutoPipelining: true }))
this.client.on('error', err => logger.error('Redis failed to connect', { err }))
this.client.on('connect', () => {
logger.info('Connected to redis.')
this.connected = true
})
this.client.on('reconnecting', (ms) => {
logger.error(`Reconnecting to redis in ${ms}.`)
})
this.client.on('close', () => {
logger.error('Connection to redis has closed.')
this.connected = false
})
this.client.on('end', () => {
logger.error('Connection to redis has closed and no more reconnects will be done.')
})
2021-12-24 14:49:03 +01:00
2019-04-11 11:33:44 +02:00
this.prefix = 'redis-' + WEBSERVER.HOST + '-'
2018-01-30 13:27:07 +01:00
}
static getRedisClientOptions (name?: string, options: RedisOptions = {}): RedisOptions {
const connectionName = [ 'PeerTube', name ].join('')
const connectTimeout = 20000 // Could be slow since node use sync call to compile PeerTube
if (CONFIG.REDIS.SENTINEL.ENABLED) {
return {
connectionName,
connectTimeout,
enableTLSForSentinelMode: CONFIG.REDIS.SENTINEL.ENABLE_TLS,
sentinelPassword: CONFIG.REDIS.AUTH,
sentinels: CONFIG.REDIS.SENTINEL.SENTINELS,
name: CONFIG.REDIS.SENTINEL.MASTER_NAME,
...options
}
}
return {
connectionName,
connectTimeout,
password: CONFIG.REDIS.AUTH,
db: CONFIG.REDIS.DB,
host: CONFIG.REDIS.HOSTNAME,
port: CONFIG.REDIS.PORT,
path: CONFIG.REDIS.SOCKET,
showFriendlyErrorStack: true,
...options
2022-01-04 09:16:43 +01:00
}
2018-05-14 17:51:15 +02:00
}
getClient () {
return this.client
}
getPrefix () {
return this.prefix
}
2021-12-24 14:49:03 +01:00
isConnected () {
return this.connected
}
2020-01-31 16:56:52 +01:00
/* ************ Forgot password ************ */
2018-10-05 11:15:06 +02:00
2018-01-30 13:27:07 +01:00
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)
2018-01-30 13:27:07 +01:00
return generatedString
}
2020-08-12 09:15:31 +02:00
async removePasswordVerificationString (userId: number) {
return this.removeValue(this.generateResetPasswordKey(userId))
}
async getResetPasswordVerificationString (userId: number) {
2018-01-30 13:27:07 +01:00
return this.getValue(this.generateResetPasswordKey(userId))
}
/* ************ Two factor auth request ************ */
async setTwoFactorRequest (userId: number, otpSecret: string) {
const requestToken = await generateRandomString(32)
await this.setValue(this.generateTwoFactorRequestKey(userId, requestToken), otpSecret, TWO_FACTOR_AUTH_REQUEST_TOKEN_LIFETIME)
return requestToken
}
async getTwoFactorRequestToken (userId: number, requestToken: string) {
return this.getValue(this.generateTwoFactorRequestKey(userId, requestToken))
}
2020-01-31 16:56:52 +01:00
/* ************ Email verification ************ */
2018-10-05 11:15:06 +02:00
2023-01-19 09:27:16 +01:00
async setUserVerifyEmailVerificationString (userId: number) {
const generatedString = await generateRandomString(32)
2023-01-19 09:27:16 +01:00
await this.setValue(this.generateUserVerifyEmailKey(userId), generatedString, EMAIL_VERIFY_LIFETIME)
return generatedString
}
2023-01-19 09:27:16 +01:00
async getUserVerifyEmailLink (userId: number) {
return this.getValue(this.generateUserVerifyEmailKey(userId))
}
async setRegistrationVerifyEmailVerificationString (registrationId: number) {
const generatedString = await generateRandomString(32)
await this.setValue(this.generateRegistrationVerifyEmailKey(registrationId), generatedString, EMAIL_VERIFY_LIFETIME)
return generatedString
}
async getRegistrationVerifyEmailLink (registrationId: number) {
return this.getValue(this.generateRegistrationVerifyEmailKey(registrationId))
}
2020-01-31 16:56:52 +01:00
/* ************ Contact form per IP ************ */
2019-01-09 15:14:29 +01:00
async setContactFormIp (ip: string) {
return this.setValue(this.generateContactFormKey(ip), '1', CONTACT_FORM_LIFETIME)
}
2019-03-19 09:26:50 +01:00
async doesContactFormIpExist (ip: string) {
2019-01-09 15:14:29 +01:00
return this.exists(this.generateContactFormKey(ip))
}
2020-01-31 16:56:52 +01:00
/* ************ Views per IP ************ */
2018-10-05 11:15:06 +02:00
setIPVideoView (ip: string, videoUUID: string) {
return this.setValue(this.generateIPViewKey(ip, videoUUID), '1', VIEW_LIFETIME.VIEW)
}
2020-11-06 16:42:23 +01:00
2019-03-19 09:26:50 +01:00
async doesVideoIPViewExist (ip: string, videoUUID: string) {
return this.exists(this.generateIPViewKey(ip, videoUUID))
}
/* ************ Video views stats ************ */
2018-10-05 11:15:06 +02:00
addVideoViewStats (videoId: number) {
const { videoKey, setKey } = this.generateVideoViewStatsKeys({ videoId })
2018-08-29 16:26:25 +02:00
return Promise.all([
this.addToSet(setKey, videoId.toString()),
this.increment(videoKey)
2018-08-29 16:26:25 +02:00
])
}
async getVideoViewsStats (videoId: number, hour: number) {
const { videoKey } = this.generateVideoViewStatsKeys({ videoId, hour })
2018-08-29 16:26:25 +02:00
const valueString = await this.getValue(videoKey)
2018-12-04 16:02:49 +01:00
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)
2018-12-04 16:02:49 +01:00
return undefined
}
return valueInt
2018-08-29 16:26:25 +02:00
}
async listVideosViewedForStats (hour: number) {
const { setKey } = this.generateVideoViewStatsKeys({ hour })
2018-08-29 16:26:25 +02:00
const stringIds = await this.getSet(setKey)
2018-08-29 16:26:25 +02:00
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)
2018-08-29 16:26:25 +02:00
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)
2018-08-29 16:26:25 +02:00
])
}
/* ************ 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) {
return this.setValue('resumable-upload-' + uploadId, '', RESUMABLE_UPLOAD_SESSION_LIFETIME)
}
doesUploadSessionExist (uploadId: string) {
return this.exists('resumable-upload-' + uploadId)
}
deleteUploadSession (uploadId: string) {
return this.deleteKey('resumable-upload-' + uploadId)
}
/* ************ AP resource unavailability ************ */
2021-12-28 11:36:51 +01:00
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
}
2020-01-31 16:56:52 +01:00
/* ************ Keys generation ************ */
2018-10-05 11:15:06 +02:00
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}` }
2018-08-29 16:26:25 +02:00
}
generateLocalVideoViewerKeys (ip: string, videoId: number): { setKey: string, viewerKey: string }
generateLocalVideoViewerKeys (): { setKey: string }
generateLocalVideoViewerKeys (ip?: string, videoId?: number) {
2024-02-29 10:09:03 +01:00
const anonymousIP = sha256(CONFIG.SECRETS + '-' + ip)
return { setKey: `local-video-viewer-stats-keys`, viewerKey: `local-video-viewer-stats-${anonymousIP}-${videoId}` }
}
private generateVideoViewStatsKeys (options: { videoId?: number, hour?: number }) {
const hour = exists(options.hour)
? options.hour
: new Date().getHours()
2018-08-29 16:26:25 +02:00
return { setKey: `videos-view-h${hour}`, videoKey: `video-view-${options.videoId}-h${hour}` }
2018-08-29 16:26:25 +02:00
}
2018-10-05 11:15:06 +02:00
private generateResetPasswordKey (userId: number) {
return 'reset-password-' + userId
}
private generateTwoFactorRequestKey (userId: number, token: string) {
return 'two-factor-request-' + userId + '-' + token
}
2023-01-19 09:27:16 +01:00
private generateUserVerifyEmailKey (userId: number) {
return 'verify-email-user-' + userId
}
private generateRegistrationVerifyEmailKey (registrationId: number) {
return 'verify-email-registration-' + registrationId
}
generateIPViewKey (ip: string, videoUUID: string) {
2024-02-29 10:09:03 +01:00
return `views-${videoUUID}-${sha256(CONFIG.SECRETS.PEERTUBE + '-' + ip)}`
2019-01-09 15:14:29 +01:00
}
private generateContactFormKey (ip: string) {
2024-02-29 10:09:03 +01:00
return 'contact-form-' + sha256(CONFIG.SECRETS.PEERTUBE + '-' + ip)
}
2021-12-28 11:36:51 +01:00
private generateAPUnavailabilityKey (url: string) {
return 'ap-unavailability-' + sha256(url)
}
2020-01-31 16:56:52 +01:00
/* ************ Redis helpers ************ */
2018-01-30 13:27:07 +01:00
private getValue (key: string) {
2021-12-24 14:49:03 +01:00
return this.client.get(this.prefix + key)
2018-01-30 13:27:07 +01:00
}
2018-08-29 16:26:25 +02:00
private getSet (key: string) {
return this.client.smembers(this.prefix + key)
2018-08-29 16:26:25 +02:00
}
private addToSet (key: string, value: string) {
return this.client.sadd(this.prefix + key, value)
2018-08-29 16:26:25 +02:00
}
private deleteFromSet (key: string, value: string) {
return this.client.srem(this.prefix + key, value)
2018-08-29 16:26:25 +02:00
}
private deleteKey (key: string) {
2021-12-24 14:49:03 +01:00
return this.client.del(this.prefix + key)
2018-10-05 11:15:06 +02:00
}
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 }, expirationMilliseconds?: number) {
return this.setValue(key, JSON.stringify(value), expirationMilliseconds)
}
private async setValue (key: string, value: string, expirationMilliseconds?: number) {
2022-11-14 16:36:17 +01:00
const result = expirationMilliseconds !== undefined
? await this.client.set(this.prefix + key, value, 'PX', expirationMilliseconds)
: await this.client.set(this.prefix + key, value)
2018-01-30 13:27:07 +01:00
2021-12-24 14:49:03 +01:00
if (result !== 'OK') throw new Error('Redis set result is not OK.')
2018-01-30 13:27:07 +01:00
}
2020-08-12 09:15:31 +02:00
private removeValue (key: string) {
2021-12-24 14:49:03 +01:00
return this.client.del(this.prefix + key)
2018-04-17 14:01:06 +02:00
}
2018-08-29 16:26:25 +02:00
private increment (key: string) {
2021-12-24 14:49:03 +01:00
return this.client.incr(this.prefix + key)
2018-08-29 16:26:25 +02:00
}
2022-01-14 14:15:23 +01:00
private async exists (key: string) {
const result = await this.client.exists(this.prefix + key)
return result !== 0
2018-02-23 16:39:51 +01:00
}
2021-12-28 11:36:51 +01:00
private setExpiration (key: string, ms: number) {
return this.client.expire(this.prefix + key, ms / 1000)
}
2018-01-30 13:27:07 +01:00
static get Instance () {
return this.instance || (this.instance = new this())
}
}
// ---------------------------------------------------------------------------
export {
Redis
}