avhost/go-apiproxy

go-apiproxy

镜像概述和主要用途

go-apiproxy是一个用Go语言编写的轻量级API代理工具。它作为中间层接收请求，自动添加认证头（基于提供的令牌），并将请求转发至指定的外部API服务。主要用途是简化服务对需要令牌认证的外部API的访问，同时隔离服务与外部API的直接连接，提升安全性。

核心功能和特性

• 自动认证头添加：自动为转发的请求添加认证头，无需客户端手动处理令牌
• 简单配置：通过环境变量即可完成核心配置，无需复杂的配置文件
• 轻量级设计：基于Go语言开发，容器体积小，运行效率高
• 灵活转发：支持将所有接收到的请求转发至指定的API_URL

使用场景和适用范围

• 服务无法直接处理令牌认证逻辑时，作为中间层处理认证
• 需要隔离内部服务与外部API的直接访问，增强系统安全性
• 简化客户端调用流程，避免客户端直接处理认证令牌
• 适用于需要统一处理API认证的微服务架构或简单应用场景

使用方法和配置说明

环境变量配置

Docker运行示例

bash
# 设置环境变量
export API_TOKEN="your_api_token_here"
export API_URL="https://api.target-service.com"

# 运行容器
docker run -d \
  -e API_TOKEN=$API_TOKEN \
  -e API_URL=$API_URL \
  -p 10777:10777 \
  --name go-apiproxy \
  docker.xuanyuan.run/avhost/go-apiproxy:latest

访问代理服务

容器启动后，可通过 http://localhost:10777 访问代理服务。所有发送到该地址的请求将被自动添加认证头，并转发至 API_URL 指定的外部API。

例如，发送请求到代理服务：

bash
curl http://localhost:10777/api/endpoint

该请求将被转发至 https://api.target-service.com/api/endpoint，并自动添加包含 API_TOKEN 的认证头。

Docker Compose配置示例

yaml
version: '3'
services:
  apiproxy:
    image: avhost/go-apiproxy:latest
    environment:
      - API_TOKEN=your_api_token_here
      - API_URL=[***]
    ports:
      - "***:***"
    restart: unless-stopped