如何在BlockScout中为RPC URL传递含API Key的请求头

核心配置方式：通过环境变量定义请求头 #

BlockScout依赖的以太坊JSON-RPC客户端支持通过ETHEREUM_JSONRPC_HEADERS环境变量传入自定义HTTP请求头，格式为JSON字符串。假设你的RPC要求在请求头X-API-Key中传入密钥，配置方式如下：

• 直接运行BlockScout
  在启动命令前设置环境变量：

  export ETHEREUM_JSONRPC_HEADERS='{"X-API-Key": "your-private-api-key"}'
  export ETHEREUM_JSONRPC_URL="http://your-internal-rpc-address:port"
  # 随后启动BlockScout
  

• Docker Compose部署
  在docker-compose.yml的blockscout服务环境变量中添加配置：

  services:
    blockscout:
      ...
      environment:
        ETHEREUM_JSONRPC_URL: "http://your-internal-rpc-address:port"
        ETHEREUM_JSONRPC_HEADERS: '{"X-API-Key": "your-private-api-key"}'
        # 其他必要配置（如数据库连接等）
      ...
  

注意事项 #

• 确保BlockScout部署环境能访问你的私有RPC：因为RPC不公开，BlockScout必须部署在能直接连接到RPC的内网/VPC/私有网络中，或者通过专用隧道打通网络。
• 验证请求头格式：JSON字符串必须严格符合格式，键值对要正确对应RPC要求的头名称和密钥。
• 排查问题：启动后可通过查看BlockScout日志（如docker logs blockscout）确认是否成功建立RPC连接，若出现权限错误，优先检查API Key的正确性和请求头配置是否有误。

内容的提问来源于stack exchange，提问作者ISURU UDAYANGA BANDARA