patrikx3/p3x-redis-ui

P3X Redis UI Docker镜像文档

镜像概述和主要用途

p3x-redis-ui是一个多功能Redis GUI工具，可作为基于Web的服务器应用或独立桌面应用运行。该Docker镜像提供了便捷的部署方式，支持通过响应式Web界面或桌面应用管理Redis数据库，特别擅长JSON数据管理、二进制数据上传下载，并支持SSH、集群和哨兵配置。

核心功能和特性

• 多界面支持：Triple GUI（Angular + React + Vue），适应不同开发习惯
• 数据管理：集成CodeMirror编辑器（支持GitHub明暗主题），高效管理JSON数据
• 二进制处理：支持二进制数据的上传和下载
• 连接方式：支持SSH隧道、Redis集群和哨兵配置
• 高级功能：AI驱动的查询翻译、实时监控（Pulse/Profiler/PubSub/Analysis）
• Redis特性支持：RediSearch、RedisTimeSeries、ReJSON、RedisBloom、VectorSet、Redis 8.x及ACL
• 多语言支持：54种语言，覆盖88+国家
• 安全性：可选HTTP基本认证

使用场景和适用范围

• Redis数据库日常管理和监控
• 开发环境中的Redis数据调试和操作
• 生产环境中的Redis集群和哨兵配置管理
• 需要多语言支持的国际化团队
• 需通过Web界面远程管理Redis的场景

使用方法和配置说明

系统要求

• Docker引擎
• 至少1GB可用内存
• 网络端口7843可访问

快速启动

bash
# 创建设置目录
mkdir -p ./p3x-redis-ui-settings

# 启动容器
docker run -d \
  --name p3x-redis-ui \
  -p 7843:7843 \
  -v $PWD/p3x-redis-ui-settings:/settings \
  docker.xuanyuan.run/patrikx3/p3x-redis-ui

启动后访问: http://localhost:7843

注意：Kubernetes/Docker环境建议使用latest标签(patrikx3/p3x-redis-ui:latest)并设置imagePullPolicy: Always。版本特定标签可用，但latest是推荐和支持的标签。

Docker Compose配置

yaml
version: '3'
services:
  p3x-redis-ui:
    image: docker.xuanyuan.run/patrikx3/p3x-redis-ui:latest
    container_name: p3x-redis-ui
    restart: always
    ports:
      - "7843:7843"
    volumes:
      - ./p3x-redis-ui-settings:/settings
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:7843/health"]
      interval: 30s
      timeout: 10s
      retries: 3

启动命令:

bash
wget https://raw.githubusercontent.com/patrikx3/redis-ui/master/docker-compose.yml
# 根据需要调整docker-compose.yml中的设置文件夹路径
docker-compose up -d

高级配置选项

环境变量

示例：启用HTTP基本认证

bash
docker run -d \
  --name p3x-redis-ui \
  -p 7843:7843 \
  -v $PWD/p3x-redis-ui-settings:/settings \
  -e HTTP_AUTH_ENABLE=true \
  -e HTTP_AUTH_USERNAME=admin \
  -e HTTP_AUTH_PASSWORD=securepassword \
  docker.xuanyuan.run/patrikx3/p3x-redis-ui

数据持久化

容器使用/settings目录存储配置文件，通过卷挂载可实现数据持久化：

• p3xrs.json：应用配置文件
• .p3xrs-conns.json：连接配置文件

重要提示：不要手动创建配置JSON文件，应通过GUI生成配置，然后部署到Kubernetes等系统。

健康检查

Docker镜像内置HEALTHCHECK，每30秒轮询/health端点。容器编排工具（Docker Compose、Swarm等）会在服务器停止响应时自动将容器标记为不健康。

优雅关闭

服务器能优雅处理SIGTERM和SIGINT信号，关闭Socket.IO连接、断开所有Redis客户端并关闭HTTP服务器后再退出。

支持语言

通过设置可切换54种语言，包括：阿拉伯语、中文（简体/香港/***）、英语、法语、德语、日语、韩语、俄语、西班牙语等（完整列表见项目文档）。

相关资源

• 官方网站：corifeus.com/redis-ui
• GitHub仓库：https://github.com/patrikx3/redis-ui
• Docker Hub：https://hub.docker.com/r/patrikx3/p3x-redis-ui
• 截图：https://github.com/patrikx3/redis-ui/blob/master/artifacts/readme/screenshots.md
• 在线演示：p3x.redis.patrikx3.com