Como configurar Redis como cache de objeto em VPS Linux

Cache de objeto em memória é uma das otimizações com melhor custo-benefício pra qualquer aplicação web que faz queries repetidas, renderiza fragmentos custosos ou serializa sessões. Redis virou o padrão de fato — single-threaded, latência sub-milissegundo, suporte nativo em quase todo framework PHP, Node.js, Python ou Ruby.

Este tutorial mostra como instalar Redis 7.x numa VPS Ubuntu 24.04 LTS, aplicar hardening básico (autenticação, bind local, limites de memória) e integrar com aplicações PHP e Node.js. O foco é uso como cache de objeto — não como banco persistente nem como broker de fila, embora a configuração base sirva como ponto de partida.

Tempo estimado de execução: 20 a 30 minutos, incluindo testes. Você sai com Redis rodando, autenticado, com política de descarte configurada e exemplo de integração funcional.

Pré-requisitos

Se você nunca trabalhou com Redis antes, vale conhecer os tipos primários: strings, hashes, listas, sets e sorted sets. Pra cache de objeto, 90% do uso é string (valor serializado em JSON ou formato nativo do cliente). O resto aparece em casos específicos como leaderboards, filas leves e contadores.

Instalação do Redis

Esta seção cobre a instalação via repositório oficial do Ubuntu. A versão empacotada (7.x) atende cache de objeto sem ressalvas — você só precisa do repositório upstream se quiser features de versão muito recente como Redis Functions ou módulos específicos.

sudo apt update
sudo apt install -y redis-server

sudo systemctl status redis-server
redis-cli ping

sudo systemctl enable redis-server

Configuração de segurança e limites

O Redis instalado direto do apt vem com defaults razoáveis pra desenvolvimento mas inseguros pra produção: sem senha, persistência ligada, sem limite de memória. Vamos ajustar isso.

sudo nano /etc/redis/redis.conf

bind 127.0.0.1 ::1
protected-mode yes
port 6379
requirepass SuaSenhaForteAleatoria32Chars
maxmemory 256mb
maxmemory-policy allkeys-lru

# save 3600 1 300 100 60 10000
save ""

sudo systemctl restart redis-server
redis-cli -a SuaSenhaForteAleatoria32Chars ping

Integração com PHP

PHP usa a extensão phpredis (nativa em C, mais performática) ou a biblioteca predis/predis via Composer (pure PHP, mais portável). Pra cache de objeto em produção, phpredis ganha por margem expressiva.

sudo apt install -y php-redis
sudo systemctl restart php8.3-fpm

<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$redis->auth('SuaSenhaForteAleatoria32Chars');

$key = 'user:42:profile';
$cached = $redis->get($key);

if ($cached === false) {
    $data = ['id' => 42, 'name' => 'Joao', 'plan' => 'pro'];
    $redis->setex($key, 3600, json_encode($data));
    echo "Cache MISS — populated\n";
} else {
    echo "Cache HIT: " . $cached . "\n";
}

Integração com Node.js

Em Node.js o cliente recomendado é o oficial redis (v4+) — assíncrono, mantido pelo Redis Inc., compatível com TypeScript. Aplicações antigas com ioredis continuam suportadas, mas pra projeto novo use o oficial.

npm install redis

import { createClient } from 'redis';

const client = createClient({
  url: 'redis://:[email protected]:6379'
});

client.on('error', (err) => console.error('Redis error:', err));
await client.connect();

const key = 'session:abc123';
const cached = await client.get(key);

if (!cached) {
  await client.setEx(key, 1800, JSON.stringify({ userId: 42 }));
  console.log('MISS — populated');
} else {
  console.log('HIT:', cached);
}

Verificação e monitoramento

Após configurar e integrar, vale validar que o cache está sendo usado de fato — métricas internas do Redis ajudam a detectar hit ratio baixo ou pressão de memória.

redis-cli -a SuaSenhaForteAleatoria32Chars
> INFO stats
> INFO memory
> DBSIZE

Resolução de problemas

Erro “MISCONF Redis is configured to save RDB snapshots”

Aparece quando a persistência RDB está ligada mas o disco está cheio ou sem permissão de escrita. Se você desativou persistência no Passo 05, isso não deve acontecer — confirme que o save "" foi salvo e o serviço reiniciado. Em caso emergencial, CONFIG SET stop-writes-on-bgsave-error no permite escritas continuarem enquanto você resolve o disco.

Conexão recusada de aplicação em outro container Docker

Por padrão configuramos bind 127.0.0.1 — isso bloqueia conexões vindas de outros containers. Soluções: usar host network no container da aplicação, ou rodar o Redis também em container compartilhando network, ou expandir o bind pra incluir a interface do bridge (bind 127.0.0.1 172.17.0.1) com firewall fechando porta na interface externa.

Latência alta intermitente

Geralmente é I/O do snapshot RDB durante bgsave. Verifique com INFO persistence se rdb_last_bgsave_status está OK e quanto tempo levou. Se persistência é necessária mas snapshot causa picos, considere AOF com appendfsync everysec que tem perfil de I/O mais constante.

Próximos passos

Com Redis funcionando como cache de objeto, vale explorar:

• Estratégias de cache em camadas (memória local + Redis + banco) com bibliotecas como symfony/cache no PHP ou cache-manager no Node
• Pub/sub do Redis pra invalidação de cache entre múltiplos servidores de aplicação
• Replicação master-replica pra leitura escalável quando uma instância não dá conta
• Rate limiting com INCR + TTL — substitui implementações caseiras com performance superior

Se você está rodando isso em produção e precisa de instância dedicada com snapshots automáticos da VPS, latência consistente e proteção DDoS na borda, as VPS Hostini entregam isso por padrão — disco NVMe, rede com filtragem de pacotes e backup diário sem custo extra.