ragingtnv/konga

Konga (PostgreSQL 12支持版) 镜像文档

镜像概述

本镜像为Pantsel/Konga的私有分支版本，在原版Konga基础上增加了对PostgreSQL 12数据库的支持。Konga是一款针对Kong API网关的开源可视化管理工具，提供直观的Web界面用于管理Kong的API、插件、消费者、服务等核心资源。

核心功能与特性

• PostgreSQL 12支持：专门适配PostgreSQL 12数据库，解决原版Konga可能存在的数据库兼容性问题
• Kong管理功能：全面支持Kong API网关的资源管理，包括服务、路由、插件、消费者等
• 用户认证与授权：提供多用户管理及权限控制功能
• 数据可视化：通过仪表盘展示API流量、响应时间等关键指标
• 配置导入/导出：支持Kong配置的备份与恢复

使用场景

• 需要使用PostgreSQL 12作为数据库后端的Kong API网关管理场景
• 对Kong网关进行可视化配置与监控的企业级应用
• 需要集中管理多个Kong节点的分布式API架构环境

使用方法

前提条件

• 已部署PostgreSQL 12数据库实例
• 已部署Kong API网关实例

基本部署命令

bash
docker run -d \
  --name konga-postgres12 \
  -p 1337:1337 \
  -e DB_ADAPTER=postgres \
  -e DB_HOST=postgres-host \
  -e DB_PORT=5432 \
  -e DB_USER=konga_user \
  -e DB_PASSWORD=konga_password \
  -e DB_DATABASE=konga_db \
  -e KONGA_HOOK_TIMEOUT=120000 \
  -e NODE_ENV=production \
  your-registry/konga-postgres12:latest

环境变量配置

Docker Compose示例

yaml
version: '3'

services:
  konga:
    image: your-registry/konga-postgres12:latest
    container_name: konga
    ports:
      - "1337:1337"
    environment:
      - DB_ADAPTER=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=konga_user
      - DB_PASSWORD=secure_password
      - DB_DATABASE=konga
      - NODE_ENV=production
    depends_on:
      - postgres
      - kong

  postgres:
    image: postgres:12
    container_name: postgres
    environment:
      - POSTGRES_USER=konga_user
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=konga
    volumes:
      - postgres_data:/var/lib/postgresql/data

  kong:
    image: kong:latest
    container_name: kong
    ports:
      - "8000:8000"
      - "8001:8001"
    environment:
      - KONG_DATABASE=postgres
      - KONG_PG_HOST=postgres
      - KONG_PG_USER=konga_user
      - KONG_PG_PASSWORD=secure_password
      - KONG_PG_DATABASE=kong
      - KONG_PROXY_ACCESS_LOG=/dev/stdout
      - KONG_ADMIN_ACCESS_LOG=/dev/stdout
      - KONG_PROXY_ERROR_LOG=/dev/stderr
      - KONG_ADMIN_ERROR_LOG=/dev/stderr
      - KONG_ADMIN_LISTEN=0.0.0.0:8001

volumes:
  postgres_data:

初始化数据库

首次启动容器时，需执行数据库迁移命令：

bash
docker exec -it konga-postgres12 npm run db:migrate

访问方式

容器启动后，通过 http://<host>:1337 访问Konga管理界面，使用默认管理员账户（首次登录需创建）进行配置。