anapsix/webdis

anapsix/webdis Docker镜像文档

!Docker Pulls !Docker Image Size (tag) !linux/amd64 !linux/arm64

镜像概述

Webdis（由Nicolas Favre-Félix开发）是一个简单的HTTP服务器，可将HTTP请求转发至Redis并以指定格式返回响应。通过访问Webdis的/COMMAND/arg0/arg1/.../argN[.ext]路径，可直接执行Redis命令并获取结果，可选扩展名（如.json、.txt）用于指定响应格式。本镜像基于AlpineLinux构建，体积仅8MB，支持linux/amd64和linux/arm64平台。

核心功能与特性

• HTTP接口访问Redis：通过HTTP路径直接执行Redis命令，简化Redis操作
• 多响应格式支持：通过URL扩展名指定响应格式（.json、.txt等）
• ACL访问控制：支持基于IP/CIDR、HTTP Auth的访问控制，可限制客户端允许/禁止使用的命令
• 轻量级设计：基于AlpineLinux，镜像体积仅8MB，资源占用低
• 多平台支持：兼容linux/amd64和linux/arm64架构

使用场景

• 需要通过HTTP协议访问Redis的应用场景
• 简化Redis命令调用，无需直接操作Redis客户端
• 需要对Redis访问进行权限控制的场景（如限制特定IP或用户可执行的命令）
• 轻量级环境下的Redis HTTP代理需求

使用方法

启动方式

1. 一体化启动（包含Redis）

自动启动内置Redis，适用于快速测试或单机环境：

bash
docker run -d -p 7379:7379 -e LOCAL_REDIS=true anapsix/webdis

2. 链接外部Redis容器

手动链接独立的Redis容器：

bash
# 启动Redis容器
docker run -d --name r4w redis

# 链接Redis容器并启动Webdis
docker run -d -p 7379:7379 --link r4w:redis anapsix/webdis

3. 连接外部Redis服务器

指定外部Redis服务器地址：

bash
docker run -d -p 7379:7379 -e REDIS_HOST=redis-server-host anapsix/webdis

4. 使用Docker Compose

通过docker-compose.yml启动（需确保当前目录存在该文件）：

bash
docker-compose up

访问示例

使用curl测试Webdis功能：

直接访问Webdis

bash
# 设置键值对
curl http://127.0.0.1:7379/SET/hello/world

# 获取键值
curl http://127.0.0.1:7379/GET/hello

通过HAProxy访问（如配置了负载均衡）

bash
# 设置键值对
curl http://127.0.0.1:8080/SET/hello/world

# 获取键值
curl http://127.0.0.1:8080/GET/hello

已知问题

详见Webdis官方issue跟踪：https://github.com/nicolasff/webdis/issues

官方文档

完整文档请参考Webdis作者网站：[***]