landoop/kafka-topics-ui

Kafka Topics UI

这是Landoop kafka-topics-ui的Docker镜像，用于通过kafka-rest查看Kafka主题的配置和数据。镜像默认从8000端口提供服务，无状态，仅需配置Kafka REST Proxy URL即可使用。你可访问在线演示体验功能。

核心功能

• 可视化展示Kafka主题的配置信息
• 查看Kafka主题中的数据内容
• 支持代理解决CORS问题或防火墙穿透
• 通过环境变量灵活配置UI行为和代理规则

使用场景

• Kafka主题日常管理与监控
• 开发调试时快速查看主题数据
• 团队共享Kafka主题视图（通过代理设置）

部署示例

基本运行

bash
docker run --rm -it -p 8000:8000 \
           -e "KAFKA_REST_PROXY_URL=http://your-kafka-rest-proxy-url" \
           landoop/kafka-topics-ui

访问http://localhost:8000即可进入UI界面。

带代理运行（解决CORS或防火墙问题）

bash
docker run --rm -it -p 8000:8000 \
           -e "KAFKA_REST_PROXY_URL=http://your-kafka-rest-proxy-ip:port" \
           -e "PROXY=true" \
           landoop/kafka-topics-ui

注意：代理时，KAFKA_REST_PROXY_URL需使用IP地址或可解析域名，不可用localhost（容器与主机网络独立）。若REST Proxy用自签名SSL证书，可添加-e "PROXY_SKIP_VERIFY=true"跳过验证。

配置说明

Kafka Topics UI环境变量

• KAFKA_REST_PROXY_URL：必填，Kafka REST Proxy的URL
• MAX_BYTES：默认50000，返回数据的最大字节数
• RECORD_POLL_TIMEOUT：默认2000，记录轮询超时时间（毫秒）
• DEBUG_LOGS_ENABLED：默认true，是否启用调试日志

Docker选项

• PROXY=[true|false]：是否通过内部Caddy服务器代理REST Proxy流量
• PROXY_SKIP_VERIFY=[true|false]：代理HTTPS REST Proxy时是否跳过证书验证
• PORT=[PORT]：UI服务端口，默认8000（适用于--net=host模式）
• CADDY_OPTIONS=[OPTIONS]：Caddy服务器配置选项，如设置基础认证：

  bash
  -e "CADDY_OPTIONS=basicauth / your-username your-password"
  

Kafka REST Proxy配置建议

• 3.2.x版本需设置consumer.request.timeout.ms=30000，避免大主题返回失败
• 不使用代理时需配置CORS：access.control.allow.methods=GET,POST,PUT,DELETE,OPTIONS和access.control.allow.origin=*

日志

容器启动信息输出到stderr，web服务器日志输出到stdout，可将stdout日志发送至日志管理系统。