### Docker 部署 Redis 集群外部访问配置 当遇到 `Cluster is ended` 错误时，这通常意味着客户端尝试连接到 Redis 集群中的某个节点失败。为了确保能够成功从外部访问 Docker 中部署的 Redis 集群，需注意以下几个方面： #### 1. 网络模式设置 默认情况下，在创建 Redis 节点容器时应避免使用 `--network host` 参数，因为该参数会使容器共享主机网络命名空间，从而影响端口映射机制。相反，应该定义自定义桥接网络来实现各节点间的通信以及外部访问。 ```bash docker network create my-redis-network ``` 随后启动各个 Redis 实例并加入此网络环境[^4]。 #### 2. 修改 redis.conf 文件 对于每一个参与构成集群的 Redis 成员而言，其对应的配置文件（通常是 `/etc/redis/redis.conf` 或者位于镜像内部路径下），应当调整如下选项以允许远程接入： - **bind**：取消绑定特定 IP 地址或将之设为 `0.0.0.0` 来接受来自任何地方的数据包； - **protected-mode no**：关闭保护模式以便于非本地请求可以被处理； - **requirepass your_password_here**：如果启用了密码验证，则指定一致的安全凭证用于认证过程； 这些更改有助于防止因权限不足而导致无法正常建立会话的情况发生[^2]。 #### 3. 正确暴露端口号 在运行命令中显式声明 `-p` 标志将宿主机上的某些端口转发给目标容器内的对应服务监听地址。例如，假设有一个由六个实例组成的集群，那么可以在每条指令后面附加类似这样的片段： ```bash -p 7001:7001 \ ... -p 7006:7006 \ ``` 这样做之后便可通过 `<host_ip>:<mapped_port>` 的方式直接触达相应组件了。 #### 4. 使用 go-redis 库编写应用程序逻辑 一旦上述准备工作完成，就可以利用支持 Redis Cluster API 的第三方库来进行编程操作。比如采用 Go 编程语言配合官方推荐的 [go-redis](https://github.com/go-redis/redis) 扩展包构建交互接口[^1]。 ```go package main import ( "context" "fmt" "github.com/go-redis/redis/v8" ) func main() { rdb := redis.NewFailoverClient(&redis.FailoverOptions{ MasterName: "mymaster", SentinelAddrs: []string{"localhost:26379"}, }) ctx := context.Background() val, err := rdb.Get(ctx, "key").Result() if err != nil { fmt.Println(err) return } fmt.Println("key:", val) } ``` 以上代码展示了如何基于哨兵(Sentinel)架构下的主服务器名称(`MasterName`)及其监控代理列表(`SentinelAddrs`)初始化一个新的客户端对象，并执行简单的键值读取动作。