phpRedisAdmin Docker 镜像文档

镜像概述和主要用途

phpRedisAdmin 是一个简单的 Redis 数据库 Web 管理界面，采用 Creative Commons Attribution 3.0 许可证 发布。该项目由 Erik Dubbelboer 开发和维护。

主要用途是通过直观的 Web 界面管理 Redis 数据库，提供键值浏览、编辑、删除等基本操作，以及服务器信息查看等功能。

核心功能和特性

• 直观的 Web 界面管理 Redis 数据库
• 支持多 Redis 服务器配置
• 键值对的增删改查操作
• 服务器信息监控
• 支持通过环境变量配置

使用场景和适用范围

• 开发环境中快速查看和调试 Redis 数据
• 生产环境中安全地管理 Redis 数据库
• 需要通过 Web 界面进行 Redis 管理的场景
• 适合个人开发者、小型团队和企业环境使用

安装与部署

Docker 快速启动

bash
docker run --rm -it -e REDIS_1_HOST=myredis.host -e REDIS_1_NAME=MyRedis -p 80:80 erikdubbelboer/phpredisadmin

Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  phpredisadmin:
    image: erikdubbelboer/phpredisadmin
    ports:
      - "80:80"
    environment:
      - REDIS_1_HOST=redis-server
      - REDIS_1_NAME=MyRedis
      - REDIS_1_PORT=6379
    depends_on:
      - redis-server

  redis-server:
    image: redis
    ports:
      - "6379:6379"

启动服务：

bash
docker-compose up -d

访问 http://localhost 即可打开 phpRedisAdmin 界面。

配置说明

环境变量配置

phpRedisAdmin Docker 镜像使用 includes/config.environment.inc.php 作为配置文件，支持通过以下环境变量进行配置：

Redis 服务器配置

• REDIS_1_HOST: Redis 服务器主机地址（必填）
• REDIS_1_NAME: Redis 服务器名称（显示在界面上）
• REDIS_1_PORT: Redis 服务器端口（默认：6379）
• REDIS_1_AUTH: Redis 服务器认证密码（如需要）

支持配置多个 Redis 服务器，只需增加数字索引，例如： REDIS_2_HOST, REDIS_2_NAME, REDIS_2_PORT, REDIS_2_AUTH 等。

访问控制配置

• ADMIN_USER: 基本认证用户名
• ADMIN_PASS: 基本认证密码

自定义配置文件

如需更复杂的配置，可以通过挂载自定义配置文件实现：

bash
docker run --rm -it -v /path/to/your/config.inc.php:/var/www/html/includes/config.inc.php -p 80:80 erikdubbelboer/phpredisadmin

使用示例

连接到本地 Redis 服务器

bash
docker run --rm -it -e REDIS_1_HOST=host.docker.internal -e REDIS_1_NAME=LocalRedis -p 8080:80 erikdubbelboer/phpredisadmin

连接到带密码认证的 Redis 服务器

bash
docker run --rm -it \
  -e REDIS_1_HOST=myredis.host \
  -e REDIS_1_NAME=SecureRedis \
  -e REDIS_1_PORT=6379 \
  -e REDIS_1_AUTH=strongpassword \
  -e ADMIN_USER=admin \
  -e ADMIN_PASS=admin123 \
  -p 80:80 erikdubbelboer/phpredisadmin

配置多个 Redis 服务器

bash
docker run --rm -it \
  -e REDIS_1_HOST=redis1.example.com \
  -e REDIS_1_NAME=Production \
  -e REDIS_1_PORT=6379 \
  -e REDIS_2_HOST=redis2.example.com \
  -e REDIS_2_NAME=Staging \
  -e REDIS_2_PORT=6379 \
  -p 80:80 erikdubbelboer/phpredisadmin