Docker中Cassandra容器与Python容器链接失败问题求助

嘿，我来帮你理清楚这个问题——你踩的是Docker容器网络里一个非常常见的新手坑！

问题根源 #

你在Python容器里用Cluster(['localhost'])尝试连接Cassandra，但这里的localhost指的是Python容器自己的本地回环地址，而不是外面的Cassandra容器。虽然你用了--link把两个容器连起来，但这个操作并没有让Python容器的localhost指向Cassandra，而是给你提供了另一种访问方式。

当你执行--link some-cassandra:cassandra时，Docker会自动在python-container的/etc/hosts文件里添加一条映射，把cassandra这个主机名指向some-cassandra容器的实际IP地址。你需要用这个别名来连接，而不是localhost。

快速修复方法 #

直接修改你的Python连接代码，把localhost换成cassandra：

from cassandra import ConsistencyLevel, OperationTimedOut, WriteTimeout
from cassandra.cluster import Cluster
from cassandra.query import SimpleStatement

# 把localhost改成cassandra，也就是你链接时指定的别名
session = Cluster(['cassandra']).connect()

验证链接是否正常（可选） #

如果你想确认一下映射是否生效，可以进入Python容器查看hosts文件：

docker exec -it python-container cat /etc/hosts

你应该能看到类似这样的条目，证明Cassandra的主机名已经被正确映射：

xxx.xxx.xxx.xxx cassandra

更现代的替代方案（推荐） #

其实Docker官方已经不推荐使用--link这种方式了，现在更推荐用自定义Docker网络来实现容器间通信，这种方式更灵活也更稳定：

1. 先创建一个专属网络：

docker network create cassandra-net

2. 启动Cassandra容器时加入这个网络：

docker run -d --name some-cassandra --network cassandra-net \
-p 7000:7000 -p 7001:7001 -p 7199:7199 -p 9042:9042 -p 9160:9160 \
--rm -t cassandra

3. 启动Python容器时也加入同一个网络：

docker run --name python-container \
--volume=$HOME/cassandra/output:/output --rm \
--network cassandra-net \
-d custom-cassandra:latest

这种情况下，你同样可以用cassandra（或者直接用容器名some-cassandra）作为连接地址，因为同一Docker网络内的容器可以通过容器名直接解析IP。

总结 #

核心要点就是：容器里的localhost只指向自己，跨容器通信要用对方的容器别名/容器名（在同一网络下），调整连接地址后你的Python代码就能正常访问Cassandra了。

内容的提问来源于stack exchange，提问作者MemoNick