valkey/valkey-extension

Valkey Extension Docker镜像文档

快速参考

• 维护者：
  https://github.com/valkey-io/valkey-extension

• 获取帮助：
  请在https://github.com/valkey-io/valkey-extension/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E8%AF%B4%E6%98%8E%E6%82%A8%E7%9A%84%E7%96%91%E9%97%AE%E3%80%82

支持的标签及对应Dockerfile链接

发布候选版本

• https://github.com/valkey-io/valkey-extension/blob/mainline/8.1/debian/Dockerfile

什么是Valkey Extension？

Valkey Extension是容器化的Valkey版本，增强了常用模块如https://github.com/valkey-io/valkey-json%E3%80%81https://github.com/valkey-io/valkey-bloom%E5%92%8Chttps://github.com/valkey-io/valkey-search%EF%BC%8C%E5%85%81%E8%AE%B8%E6%82%A8%E5%9C%A8%E6%A0%87%E5%87%86Valkey%E5%8A%9F%E8%83%BD%E5%9F%BA%E7%A1%80%E4%B8%8A%E4%BD%BF%E7%94%A8%E9%AB%98%E7%BA%A7%E6%95%B0%E6%8D%AE%E7%BB%93%E6%9E%84%E5%92%8C%E9%A2%9D%E5%A4%96%E6%90%9C%E7%B4%A2%E8%83%BD%E5%8A%9B%E3%80%82

该镜像基于官方Valkey基础镜像构建，简化了包含这些强大模块的Valkey部署。

模块版本

安全性

为便于通过Docker网络从其他容器访问Valkey Extension，默认关闭"保护模式"。这意味着如果通过-p暴露端口，实例将无认证开放。强烈建议在将实例暴露到互联网时设置密码或认证方法。

有关Valkey安全的更多资源：

• https://valkey.io/topics/security/
• https://valkey.io/topics/security/#protected-mode

如何使用此镜像

启动valkey-extension实例

console
$ docker run --name my-valkey-extension -d valkey/valkey-extension

使用持久化存储

console
$ docker run --name my-valkey-extension -d valkey/valkey-extension valkey-server --save 60 1 --loglevel warning

此示例配置每60秒且至少有1次写入时保存快照。数据存储在VOLUME /data。

通过valkey-cli连接

console
$ docker run -it --network some-network --rm valkey/valkey-extension valkey-cli -h my-valkey-extension

通过环境变量传递额外启动参数

可通过环境变量VALKEY_EXTRA_FLAGS配置启动参数：

console
$ docker run --env VALKEY_EXTRA_FLAGS='--save 60 1 --loglevel warning' valkey/valkey-extension

使用自定义valkey.conf

创建自定义配置文件valkey.conf并在容器中使用：

Dockerfile方式：

dockerfile
FROM docker.xuanyuan.run/valkey/valkey-extension:latest
COPY valkey.conf /usr/local/etc/valkey/valkey.conf
CMD [ "valkey-server", "/usr/local/etc/valkey/valkey.conf" ]

Docker run方式：

console
$ docker run -v /myvalkey/conf:/usr/local/etc/valkey --name my-valkey-extension valkey/valkey-extension valkey-server /usr/local/etc/valkey/valkey.conf

镜像变体

valkey/valkey-extension:<version>

这是主要镜像，包含Valkey及预加载的valkey-json、valkey-bloom和valkey-search等常用模块。适用于需要开箱即用这些模块的开发、测试和生产环境。

部分标签可能包含如bookworm的名称，指代https://wiki.debian.org/DebianReleases%EF%BC%8C%E8%A1%A8%E7%A4%BA%E6%89%80%E4%BD%BF%E7%94%A8%E7%9A%84%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E6%9C%89%E5%8A%A9%E4%BA%8E%E7%A1%AE%E4%BF%9D%E5%AE%B9%E5%99%A8%E9%9C%80%E8%A6%81%E9%A2%9D%E5%A4%96%E5%8C%85%E6%97%B6%E7%9A%84%E5%85%BC%E5%AE%B9%E6%80%A7%E3%80%82%E5%BB%BA%E8%AE%AE%E6%98%BE%E5%BC%8F%E6%8C%87%E5%AE%9A%E8%BF%99%E4%BA%9B%E6%A0%87%E7%AD%BE%EF%BC%8C%E4%BB%A5%E9%81%BF%E5%85%8D%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E7%89%88%E6%9C%AC%E6%9B%B4%E6%96%B0%E6%97%B6%E7%9A%84%E6%84%8F%E5%A4%96%E5%8F%98%E6%9B%B4%E3%80%82

如果您需要一个包含内置模块的轻量且功能完善的Valkey容器，此镜像是理想选择。

许可证

查看此镜像中包含软件的https://github.com/valkey-io/valkey-extension/blob/mainline/LICENSE%E3%80%82

此镜像的用户负责确保遵守其中包含的所有软件的许可条款。