devopsfaith/krakend

KrakenD Docker官方镜像文档

镜像概述与主要用途

KrakenD是一款Docker官方认证的API网关镜像，自2025年3月底起正式成为Docker官方镜像。原维护仓库已停止更新，建议使用Docker Hub官方镜像以获取最新功能与安全支持。该镜像核心用途是提供高性能API请求处理能力，支持中间件扩展，适用于各类API路由、聚合与流量管理场景。

核心功能与特性

• 超高性能：针对高并发场景优化，具备卓越的吞吐量和低延迟特性
• 中间件支持：可灵活集成认证、日志、限流等各类中间件，扩展功能边界
• 市场领先速度：被公认为市场上性能最快的API网关解决方案之一
• 轻量设计：容器化部署模式，资源占用低，易于集成至现有架构

使用场景与适用范围

• 微服务架构：作为微服务集群的统一API入口，实现服务路由与请求聚合
• 高流量业务：适用于电商平台、支付系统等需要处理大量并发API请求的场景
• API生命周期管理：支持API版本控制、灰度发布与后端服务平滑切换
• 多源数据整合：聚合来自多个后端服务的数据，减少客户端请求次数，优化用户体验

使用方法与配置说明

获取官方镜像

直接从Docker Hub拉取最新官方镜像：

bash
docker pull krakend

基本运行命令

运行KrakenD容器需挂载配置文件，典型启动命令：

bash
docker run -d \
  -p 8080:8080 \
  -v $(pwd)/krakend.json:/etc/krakend/krakend.json \
  --name krakend-gateway \
  krakend

参数说明：

• -p 8080:8080：映射容器8080端口至主机，用于API访问
• -v $(pwd)/krakend.json:/etc/krakend/krakend.json：挂载本地配置文件至容器默认配置路径
• --name krakend-gateway：指定容器名称，便于管理

配置文件示例

KrakenD通过JSON配置文件定义核心功能，基础配置示例（krakend.json）：

json
{
  "version": 3,
  "endpoints": [
    {
      "endpoint": "/api/combined",
      "method": "GET",
      "backend": [
        {
          "url_pattern": "/users",
          "host": ["http://user-service:8081"]
        },
        {
          "url_pattern": "/orders",
          "host": ["http://order-service:8082"]
        }
      ]
    }
  ]
}

访问官方资源

• 官方Docker镜像页面：https://hub.docker.com/_/krakend
• 完整配置文档：KrakenD官方文档

注意事项

• 仓库迁移提示：原非官方KrakenD Docker仓库已停止维护，必须使用官方镜像（krakend） 以确保兼容性
• 配置文件必填：容器启动需挂载有效的KrakenD配置文件，否则无法正常运行
• 端口映射：根据实际需求调整端口映射规则，避免与主机现有服务冲突