Docker容器暴露端口仅支持外部IP访问，localhost及容器间通信失败

这个问题的核心是zcashd的RPC服务默认配置了IP访问白名单，只有被允许的IP段才能访问RPC端口（8232），而localhost（127.0.0.1）和Docker内部网络的IP不在默认允许列表内，导致返回403 Forbidden错误。

验证依据 #

进入容器查看zcashd的配置文件（通常路径为/srv/zcashd/.zcash/zcash.conf），会发现配置中存在类似rpcallowip=192.168.0.0/24的规则，但缺少127.0.0.1/32（对应localhost）和Docker内部子网（比如你的172.25.0.0/16）的允许条目。

解决方法 #

方法1：直接修改zcash.conf配置 #

1. 进入运行中的容器：

   docker exec -it zcash_zcashd_1 bash
   

2. 编辑配置文件：

   nano /srv/zcashd/.zcash/zcash.conf
   

3. 添加以下IP允许规则（根据你的实际网络调整）：

   rpcallowip=127.0.0.1/32
   rpcallowip=172.25.0.0/16  # 对应你的Docker内部子网
   rpcallowip=192.168.0.0/24 # 保留原局域网允许规则
   

4. 重启容器使配置生效：

   docker restart zcash_zcashd_1
   

方法2：通过docker-compose.yml传递环境变量 #

部分zcashd镜像支持通过环境变量设置rpcallowip，修改docker-compose.yml添加环境变量配置：

version: '3.1'
services:
  zcashd:
    image: electriccoinco/zcashd
    restart: unless-stopped
    environment:
      - RPCALLOWIP=127.0.0.1/32,172.25.0.0/16,192.168.0.0/24
    ports:
    - 8232:8232 # RPC (security sensitive)
    - 8233:8233 # Zcash network (public)
    volumes:
    - data:/srv/zcashd/.zcash
    - params:/srv/zcashd/.zcash-params

然后重新部署容器：

docker-compose down && docker-compose up -d

修复验证 #

1. 测试localhost访问：

   curl --user zecwallet -d '{"jsonrpc":"1.0","id":1,"method":"getblockchaininfo","params":[]}' -H 'Content-Type:text/plain' http://localhost:8232
   

2. 测试Docker内部容器通信：添加其他服务到docker-compose.yml后，使用zcashd主机名访问8232端口，应返回200 OK的正常响应。

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