zipkin docker部署需配置持久化存储（mysql/es）、java应用显式设spring.zipkin.base-url和grpc上报，并确保feign透传x-b3头，否则链路中断。

Java 应用通过 Docker 部署 Zipkin 是主流且高效的方式，关键在于服务端启动方式、存储配置和客户端上报三者的协同。单纯拉镜像跑起来只是第一步，真正能用于 Java 微服务链路采集，必须打通从应用埋点到 Zipkin 存储再到 UI 展示的完整通路。

Zipkin 服务端 Docker 部署要点

官方镜像 openzipkin/zipkin 默认使用内存存储，适合本地验证，但重启即丢数据，无法满足测试或预发环境需求。

• 生产级部署务必指定持久化存储：MySQL 或 Elasticsearch（推荐 ES 7.x+，且需关闭安全认证 xpack.security.enabled=false）
• MySQL 方式需提前建库建表：创建 zipkin 数据库，并执行官方初始化 SQL（含 zipkin_spans、zipkin_annotations、zipkin_dependencies 三张表），字符集设为 utf8mb4
• Docker 启动时通过环境变量传参，例如：
  -e STORAGE_TYPE=mysql -e MYSQL_HOST=192.168.0.8 -e MYSQL_PORT=3306 -e MYSQL_USER=root -e MYSQL_PASS=xxx -e MYSQL_DB=zipkin
• 网络模式建议用 --network host 或显式 --link 连接数据库容器，避免桥接网络下 DNS 解析失败

Java 应用接入 Zipkin 的核心配置

Spring Boot 项目不能只加依赖就完事，必须显式控制上报行为，否则 trace 数据大概率静默丢失。

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• 依赖选择：Spring Cloud Sleuth 3.x + spring-cloud-starter-zipkin（或直接用 OpenTelemetry SDK + Zipkin Exporter 更灵活）
• 必须配置上报地址：spring.zipkin.base-url=http://host.docker.internal:9411（Mac/Windows）或 http://宿主机IP:9411（Linux Docker），不能写 localhost
• 推荐使用 gRPC 上报：spring.zipkin.sender.type=grpc，需额外引入 zipkin-sender-grpc，比 HTTP 更稳定、低延迟
• 采样率按场景调整：spring.sleuth.sampler.probability=0.1 适合高流量线上环境；调试期可设为 1.0

跨服务链路不中断的关键细节

Feign 调用常见断链，本质是 trace 上下文未正确透传。

• 调用方 Feign Client 接口方法上不要用 @RequestHeader 覆盖默认头，确保 X-B3-TraceId、X-B3-SpanId 等 header 自动携带
• 被调用方若非 Spring Cloud 项目（如传统 Spring MVC 或 Dubbo），需手动解析 B3 头并重建 Span 上下文，否则 Sleuth 无法关联
• 混合架构（如 Feign + Dubbo）中，Dubbo Filter 可能拦截 trace 传播，需在 Dubbo 消费端显式注入 Tracing Bean

验证与排障提示

启动后别急着看 UI，先确认基础连通性：

• 访问 http://localhost:9411/health，返回 {"status":"UP"} 表示服务正常
• 检查 Java 应用日志，搜索 BraveTracer 或 ZipkinSpanHandler，确认有 span flush 日志
• Zipkin UI 中查不到数据？先 curl 测试上报：curl -X POST http://localhost:9411/api/v2/spans -H 'Content-Type: application/json' -d '[{"traceId":"abc","id":"123","name":"test"}]'
• Docker 内访问宿主机服务失败，多数因网络隔离，改用 host.docker.internal（Mac/Win）或宿主机真实 IP（Linux）

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南