5分钟部署Traefik Log Dashboard：Docker Compose快速开始完整指南，从零到实时仪表盘

5分钟部署Traefik Log DashboardDocker Compose快速开始完整指南从零到实时仪表盘【免费下载链接】traefik-log-dashboardA real-time dashboard for analyzing Traefik logs in UI with IP geolocation, status code analysis, and service metrics. Built with React (Shadcn UI) and Node.js.项目地址: https://gitcode.com/gh_mirrors/tr/traefik-log-dashboard用 Docker Compose 5分钟部署 Traefik Log Dashboard这个开源实时仪表盘基于 ReactShadcn UI与 Node.js 构建能把 Traefik 访问日志秒变可视化大屏IP 地理位置地图、状态码分析、服务响应指标全部开箱即用。无论你是运维新手还是自建站玩家照着本指南从零开始也能快速拥有自己的 Traefik 日志实时分析面板。为什么需要 Traefik 日志实时仪表盘Traefik 作为轻量级反向代理非常流行但默认的访问日志只是一串滚动文本排查问题时体验很差。Traefik Log Dashboard 解决的就是这个问题能力说明 IP 地理位置可视化自动 GeoIP 解析在地图上直观看到访问来源分布 状态码分析一键查看 2xx / 4xx / 5xx 比例快速定位异常⚡ 服务指标响应时间、流量趋势、Top 路由 / IP / 服务排行 告警通知支持 Discord / Telegram Webhook、定时报表与阈值告警 多 Agent 架构一个仪表盘同时管理多台 Traefik 实例项目由三个组件组成核心是两个容器Agent轻量级 Go 服务负责解析 Traefik 日志并通过 REST API 暴露指标源码见 agent/DashboardVite React 构建的 Web UI实时渲染图表与地理可视化源码见 dashboard/src/CLI可选终端仪表盘源码见 cli/部署前准备一键创建目录结构1分钟只需 Docker 和 Docker Compose v2无需安装任何额外依赖。仓库自带了一份可直接参考的 docker-compose.yml官方部署文档见 docs/content/docs/deployment/docker.mdx。先创建工作目录mkdir -p traefik-dashboard/data/{logs,positions,dashboard} cd traefik-dashboard三个子目录各有用途logs/存放 Traefik 的访问日志access.log与错误日志traefik.logpositions/Agent 缓存 IP 地理位置数据dashboard/仪表盘本地数据告警规则等编写 docker-compose.yml最快配置方法2分钟在项目目录新建docker-compose.yml完整示例可对照仓库根目录的 docker-compose.yml。最小可用配置如下只需关注标 ⭐ 的三处修改services: traefik-agent: image: hhftechnology/traefik-log-dashboard-agent:latest restart: unless-stopped ports: - 5000:5000 volumes: - ./data/logs:/logs:ro - ./data/positions:/data environment: - TRAEFIK_LOG_DASHBOARD_ACCESS_PATH/logs/access.log - TRAEFIK_LOG_DASHBOARD_ERROR_PATH/logs/traefik.log - TRAEFIK_LOG_DASHBOARD_AUTH_TOKENyour-secret-token # ⭐ 换成你的令牌 - TRAEFIK_LOG_DASHBOARD_LOG_FORMATjson healthcheck: test: [CMD, wget, --no-verbose, --tries1, --spider, http://localhost:5000/api/logs/status] interval: 2m timeout: 10s retries: 3 start_period: 30s traefik-dashboard: image: hhftechnology/traefik-log-dashboard:latest restart: unless-stopped ports: - 3000:3000 environment: - AGENT_1_NAMEPrimary Agent - AGENT_1_URLhttp://traefik-agent:5000 - AGENT_1_TOKENyour-secret-token # ⭐ 与 Agent 保持一致 - DASHBOARD_AGENTS_ENV_ONLYtrue depends_on: traefik-agent: condition: service_healthy volumes: dashboard-data:安全提示先运行openssl rand -hex 32生成随机令牌替换两处your-secret-token。Agent 会校验该令牌防止日志接口被未授权访问。启动服务从零到实时仪表盘1分钟两条命令完成部署docker compose up -d等待约 30 秒Agent 健康检查通过后浏览器打开http://localhost:3000实时仪表盘即开即用 ✅如果 Traefik 部署在独立网络中可先执行docker network create traefik-network并在两个服务里加networks: [traefik-network]external: true详见 docs/content/docs/deployment/docker.mdx。接入 Traefik JSON 日志让数据真正流动起来仪表盘能看到什么取决于日志。在 Traefik 配置中开启 JSON 访问日志accessLog: filePath: /logs/access.log format: json bufferingSize: 100然后把 Traefik 的日志文件挂载或拷贝到data/logs/目录即可被 Agent 实时追踪解析。若你的日志不是 JSON 格式把 Agent 的TRAEFIK_LOG_DASHBOARD_LOG_FORMAT改为common即可。更多环境变量说明见 docs/content/docs/configuration/environment-variables.mdx。进阶多 Agent 与告警配置 管理多台 Traefik在每台 Traefik 旁边各部署一个 Agent然后在 Dashboard 中追加环境变量即可AGENT_2_*、AGENT_3_*…一个页面切换查看所有实例。 配置告警与历史数据进入 设置 → Alerts 页面添加 Discord / Telegram Webhook可配置每小时流量摘要、错误率阈值告警与日报完整步骤见 QUICK_START_GUIDE.md。☸️ Kubernetes 部署项目内置 Helm Chart 与 K8s 清单分别位于 charts/traefik-log-dashboard/ 与 k8s/适合生产环境。常见问题排查FAQQ1页面打开是空白或提示连接 Agent 失败检查两个容器是否健康docker compose ps。确认AGENT_1_URL与AGENT_1_TOKEN一致且 Agent 的TRAEFIK_LOG_DASHBOARD_AUTH_TOKEN与 Dashboard 令牌完全相同。Q2仪表盘没有数据确认data/logs/access.log确实有内容且 Traefik 日志格式为 JSONAgent 路径变量TRAEFIK_LOG_DASHBOARD_ACCESS_PATH必须指向容器内路径如/logs/access.log而非宿主机路径。Q3端口被占用修改 compose 中ports的宿主机端口如8080:3000访问地址相应改为http://localhost:8080。下一步快速上手清单✅ 按本指南完成 Docker Compose 部署✅ 配置 Traefik JSON 访问日志并挂载到 Agent✅ 阅读快速入门 docs/content/docs/quickstart.mdx✅ 在 设置 页面配置告警 Webhook 与过滤器从一条命令docker compose up -d开始5分钟后你就能在浏览器里看到实时滚动的请求地图与流量图表。Traefik Log Dashboard 让日志排查从翻文本进化为看大屏值得每个 Traefik 用户装上一个 【免费下载链接】traefik-log-dashboardA real-time dashboard for analyzing Traefik logs in UI with IP geolocation, status code analysis, and service metrics. Built with React (Shadcn UI) and Node.js.项目地址: https://gitcode.com/gh_mirrors/tr/traefik-log-dashboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考