lzocateli/redis-gui repository overview

⁠P3X Redis UI

Interface web P3X Redis UI para administrar Valkey e outros servidores compatíveis com o protocolo Redis. A imagem derivada fixa a versão upstream e executa o processo sem root.

⁠Referência da imagem

⁠Conteúdo e finalidade

⁠Incluído

• P3X Redis UI 2026.4.3014.
• Diretório /settings preparado para UID 10001.
• Health check HTTP em /health.

⁠Não incluído

• Servidor Valkey/Redis.
• Proxy reverso, TLS, autenticação HTTP ou conexão pré-configurada.

⁠Início rápido

mkdir -p settings/redis-gui
sudo chown 10001:0 settings/redis-gui
docker run --name redis-gui \
  --detach \
  --publish 127.0.0.1:7843:7843 \
  --mount type=bind,src="$(pwd)/settings/redis-gui",dst=/settings \
  lzocateli/redis-gui:2026.4.3014-r1

Acesse http://127.0.0.1:7843. Com Podman, prepare a propriedade com podman unshare chown 10001:0 settings/redis-gui e use --volume "$(pwd)/settings/redis-gui:/settings:Z" em hosts com SELinux.

⁠Docker Compose

O Compose integrado está em redis/compose.yaml e inicia a GUI junto ao Valkey:

mkdir -p data/valkey settings/redis-gui
sudo chown 999:999 data/valkey
sudo chown 10001:0 settings/redis-gui
docker compose -f redis/compose.yaml up -d

Cadastre a conexão com host valkey e porta 6379. Informe usuário e secret quando a ACL de produção estiver ativa.

⁠Configuração

⁠Variáveis de ambiente

⁠Portas

⁠Persistência e mounts

O bind mount deve permitir escrita por 10001:0. Não monte /tmp nem /data; esses caminhos pertenciam ao contrato antigo do RedisInsight.

⁠Secrets

Credenciais dos servidores gerenciados podem ser persistidas em /settings. Proteja e faça backup desse diretório como dado sensível, restrinja suas permissões no host e não o inclua no Git ou no contexto Docker.

⁠Inicialização e ciclo de vida

O entrypoint upstream inicia p3x-redis como UID 10001. O health check consulta http://localhost:7843/health e espera HTTP 200. SIGTERM encerra o processo Node.js.

⁠Segurança

• Publique a porta somente em localhost ou atrás de proxy com TLS e autenticação.
• Não exponha a GUI diretamente à internet.
• Execute sem --privileged e preserve o usuário 10001:0.
• Trate /settings como secret, pois pode conter credenciais de conexão.

⁠Build local

docker build --pull --tag lzocateli/redis-gui:2026.4.3014-r1 redis/gui

⁠Tags e compatibilidade

Esta versão substitui RedisInsight 2.54 por P3X Redis UI. A mudança é incompatível quanto à aplicação, porta, persistência e formato das configurações. RedisInsight usa SSPLv1; P3X Redis UI usa MIT, compatível com a política deste repositório. Recrie as conexões manualmente e não reutilize o diretório /data antigo.

⁠Validação

Antes da publicação, confirme BuildKit, build linux/amd64, HTTP 200 em /health, UID 10001, escrita e persistência em /settings, encerramento normal, labels OCI, scan de vulnerabilidades, SBOM e proveniência.

⁠Publicação

Use Actions > Publicar imagem de container > Run workflow com:

• context_path: redis/gui;
• image_name: redis-gui;
• image_tag: 2026.4.3014-r1;
• dockerfile: Dockerfile;
• platforms: linux/amd64.

⁠Operação

Faça backup protegido de /settings. Para atualizar, use nova tag imutável, preserve o backup e valide as conexões. Para rollback, restaure o diretório compatível com a versão anterior. Consulte logs com docker logs redis-gui.

⁠Troubleshooting

⁠Limitações conhecidas

• Somente linux/amd64 está declarado e validado neste repositório.
• A imagem não inclui autenticação para a interface web.
• Configurações do RedisInsight não são migradas automaticamente.

⁠Licenças e fontes

O badge MIT descreve somente o conteúdo original deste repositório. O código do P3X Redis UI é MIT, mas a imagem base também distribui sistema operacional, runtime e dependências sujeitos às respectivas licenças e aos avisos upstream. Consulte a política de licenciamento⁠.

⁠Histórico de alterações

• 2026.4.3014-r1: mantém P3X Redis UI 2026.4.3014 e aplica patch de segurança npm 11.18.0 (tar 7.5.19) para mitigar o CVE-2026-59873.
• 2026.4.3014: substitui RedisInsight por P3X Redis UI, muda a porta para 7843, persiste configuração em /settings e executa como UID 10001.