makemake1337/blutgang

Blutgang 官方Docker镜像

镜像概述

Blutgang官方Docker镜像是用于部署Blutgang轻量级代理服务的官方容器化解决方案。Blutgang作为一款高效的请求代理工具，主要用于处理和转发网络（如、Polygon等）的数据请求，通过优化请求流程和减轻全节点负载，提升应用端的数据访问效率与稳定性。

核心功能与特性

• 官方认证：由Blutgang项目官方维护，确保镜像的安全性、完整性及版本一致性。
• 轻量级设计：容器化部署资源占用低，支持在多种环境（服务器、边缘设备等）快速启动。
• 高效请求处理：内置请求优化机制，支持缓存、批处理及负载均衡，提升响应速度。
• 多链兼容：支持主流***网络，可通过配置适配不同链的节点接口。
• 灵活配置：支持通过环境变量或挂载配置文件自定义代理参数、上游节点及网络参数。

使用场景与适用范围

• ***应用开发：作为应用与全节点间的中间层，简化开发环境配置，降低对全节点的直接依赖。
• 节点负载均衡：分散高并发请求至多个上游节点，避免单一节点过载，提高系统稳定性。
• 轻量级部署：在资源受限环境（如边缘计算、小型服务器）中提供高效的***数据访问能力。
• 请求优化场景：对重复请求进行缓存，减少网络传输与节点计算资源消耗。

使用方法与配置说明

基本部署

通过以下命令快速启动Blutgang容器（默认配置）：

bash
docker run -d --name blutgang -p 3000:3000 blutgangofficial/blutgang:latest

• -p 3000:3000：映射容器内服务端口（默认3000）至主机，用于接收外部请求。
• --name blutgang：指定容器名称，便于管理。

环境变量配置

通过环境变量自定义服务参数，常用变量如下：

示例（自定义上游节点与端口）：

bash
docker run -d --name blutgang \
  -p 4000:4000 \
  -e BLUTGANG_PORT=4000 \
  -e UPSTREAM_URL="https://mainnet.infura.io/v3/your-api-key" \
  -e NETWORK="ethereum" \
  blutgangofficial/blutgang:latest

Docker Compose配置

创建docker-compose.yml文件，配置更复杂的部署环境：

yaml
version: '3'
services:
  blutgang:
    image: blutgangofficial/blutgang:latest
    container_name: blutgang
    ports:
      - "3000:3000"
    environment:
      - BLUTGANG_PORT=3000
      - UPSTREAM_URL="https://polygon-mainnet.infura.io/v3/your-api-key"
      - NETWORK="polygon"
      - CACHE_TTL=120
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

启动服务：

bash
docker-compose up -d

注意事项

• 确保上游节点URL（UPSTREAM_URL）可访问，否则代理服务将无法正常转发请求。
• 生产环境建议通过-v参数挂载配置文件（如/etc/blutgang/config.toml）实现更精细的配置。
• 通过docker logs blutgang查看服务运行日志，排查异常问题。