Configurar o cache Redis do Nextcloud no Ubuntu 24.04

O Nextcloud 34.0.2 introduziu um backend compatível com Redis integrado KeyValueCache, permitindo que a versão atual do Nextcloud utilize o Redis sem a necessidade de instalar a extensão Redis do PHP. Em um único servidor Ubuntu 24.04, utilize o APCu para o cache local rápido e o Redis para cache distribuído e bloqueio transacional de arquivos, conectados por meio de um socket Unix. Isso mantém o Redis fora da rede e fornece ao Nextcloud um cache compartilhado que funciona em todas as requisições PHP.

Escolha primeiro o backend Redis correto.

O Manual de Administração do Nextcloud 35 atual documenta dois caminhos para o Redis. Para o Nextcloud 34.0.2 ou posterior, o recomendado KeyValueCacheutiliza o Predis, que vem incluído no Nextcloud; você instala o servidor Redis e configura o arquivo `.redis` memcache.kvstore, mas não precisa configurar o arquivo php-redis`.redis`. Versões mais antigas do Nextcloud usam a extensão PhpRedis e um config.phpbloco de configuração diferente. Verifique sua versão com `nextcloud -v` sudo -u www-data php /var/www/nextcloud/occ status, substituindo o caminho caso sua instalação esteja em outro local.

Este guia pressupõe que o Nextcloud e o Redis estejam sendo executados no mesmo host Ubuntu, que o servidor web esteja rodando como ` www-data/var/www/html` e que você gerencie o PHP e o Redis diretamente. Se você instalou o Nextcloud via Snap, AIO, Docker ou outro dispositivo, siga as convenções de serviço e sistema de arquivos desse pacote em vez de aplicar comandos de nível de host indiscriminadamente. O APCu é mais rápido para cache local do que o Redis, enquanto o Redis é adequado para cache distribuído e bloqueio de arquivos. Consulte a documentação de cache de memória do Nextcloud .

Instale o Redis e o APCu.

Atualize o índice de pacotes do Ubuntu, instale o servidor Redis e o módulo PHP APCu e habilite o Redis na inicialização:

sudo apt update
sudo apt install redis-server php-apcu
sudo systemctl enable --now redis-server

No Ubuntu 24.04, a versão padrão do PHP é 8.3, e ` php-apcuapcu` é o nome do pacote de distribuição. O Redis é um serviço separado; o APCu é carregado pelo PHP. Reinicie o manipulador PHP após instalar o APCu para que o processo PHP voltado para a web carregue o módulo. Se você usa PHP-FPM, geralmente é ` php8.3-fpmphp -f apache2...

Torne o Redis local no servidor.

Para esta configuração de host único, use um socket Unix e desative o listener TCP do Redis. Edite o arquivo /etc/redis/redis.conf. Atualize as diretivas ativas existentes em vez de deixar várias cópias conflitantes e, em seguida, defina:

port 0
unixsocket /run/redis/redis-server.sock
unixsocketperm 770

port 0Desativa a porta TCP; o Redis passa a escutar pelo caminho do socket. O modo de permissão 770permite que o proprietário e o grupo do Redis acessem o socket, negando o acesso a outros usuários locais. Adicione a conta do servidor web ao grupo do Redis:

sudo usermod -aG redis www-data
sudo systemctl restart redis-server

Reinicie o serviço PHP-FPM ou o Apache após alterar a associação de grupos, pois os processos em execução mantêm a lista de grupos anterior. Use o serviço que executa o PHP do Nextcloud. A documentação do Redis recomenda restringir o acesso a clientes confiáveis; um socket local evita expor uma porta de cache em uma interface voltada para a internet. Consulte as diretrizes de segurança do Redis .

Aponte o Nextcloud para o socket.

Faça um backup config/config.phpe adicione essas entradas dentro do array de configuração PHP existente. Não substitua o restante do arquivo. Use o caminho onde sua instalação do Nextcloud está localizada.

'memcache.local' => '\OC\Memcache\APCu',
'memcache.distributed' => '\OC\Memcache\KeyValueCache',
'memcache.locking' => '\OC\Memcache\KeyValueCache',
'memcache.kvstore' => [
    'server' => [
        'host' => '/run/redis/redis-server.sock',
    ],
],

A barra inicial no caminho do host indica ao KeyValueCache do Nextcloud para usar um socket Unix, portanto, nenhuma configuração de porta ou protocolo TCP é necessária. O Redis fornece ambos memcache.distributedos protocolos memcache.locking; este último move os bloqueios de arquivos transacionais para fora do banco de dados. Mantenha o APCu ativado para acesso ao cache local com menor latência. As entradas exatas e as opções de socket estão nas instruções do KeyValueCache e do socket Unixmemcache.local do Nextcloud e em seu guia de bloqueio de arquivos transacionais .

Verifique a conexão e solucione problemas de permissões.

Primeiro, confirme se o serviço Redis está ativo e se o socket está respondendo:

sudo systemctl status redis-server
redis-cli -s /run/redis/redis-server.sock ping

A resposta esperada para o segundo comando é PONG. Em seguida, faça login no Nextcloud e abra a visão geral das configurações de administração. Confirme se o aviso de cache local desapareceu e verifique o log do Nextcloud para ver se ainda há avisos relacionados ao Redis ou ao cache. Você também pode executar sudo -u www-data php /var/www/nextcloud/occ statuspara confirmar se a instância ainda carrega; este comando verifica a disponibilidade do Nextcloud, não o cache em si.

Se o Redis reportar "Permissão negada" ou o Nextcloud não conseguir conectar, verifique se o socket existe, se www-datapertence ao redisgrupo e se o grupo e o modo do socket permitem acesso. Reinicie o Redis e o manipulador PHP após alterar a associação ao grupo. Se o Redis não conseguir criar o socket, verifique se há algum erro de digitação no caminho configurado e inspecione o arquivo de configuração sudo journalctl -u redis-server -n 50. Não resolva um problema de permissão de socket expondo o Redis à rede pública.

Nextcloud antigo: use PhpRedis em vez disso.

Se a sua versão do Nextcloud for anterior à 34.0.2, instale a extensão PHP Redis que corresponda à versão do PHP que serve o Nextcloud. Em uma configuração padrão do Ubuntu 24.04 com PHP 8.3, o pacote é php-redis`php.extensions.php`; o Ubuntu o lista como a extensão Redis do PHP 8.3. Reinicie o processo PHP ativo após a instalação. Em `php.extensions.php` config.php, use as classes Redis legadas e o bloco de conexão em vez das entradas `KeyValueCache` acima:

'memcache.local' => '\OC\Memcache\APCu',
'memcache.distributed' => '\OC\Memcache\Redis',
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
    'host' => '/run/redis/redis-server.sock',
    'port' => 0,
],

A lista de pacotes do Noble php-redis no Ubuntu confirma o mapeamento de pacotes. Não configure ambos os backends simultaneamente. Após salvar a configuração correspondente, repita o teste de ping no socket e a verificação da visão geral do painel de administração do Nextcloud.