robertcsapo/cisco-meraki-cmx-api-app
robertcsapo
自动构建
这是Cisco Meraki CMX API的演示应用Docker容器，帮助用户快速上手使用CMX位置分析与交互平台，支持配置验证、接收设备位置事件、查询客户端位置等功能，适用于Meraki无线AP环境。
3 次收藏下载次数: 0状态：自动构建维护者：robertcsapo仓库类型：镜像最近更新：8 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Cisco Meraki CMX API演示应用（Docker容器版）
这个应用展示如何开始使用https://meraki.cisco.com/ CMX API。CMX（Connected Mobile Experiences）是Cisco的位置分析与交互平台，集成于Meraki无线产品中。更多信息可参考https://meraki.cisco.com/solutions/cmx%E5%92%8CMeraki%E5%BC%80%E5%8F%91%E8%80%85%E5%B9%B3%E5%8F%B0%E3%80%82%E6%9C%AC%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8Ehttps://github.com/meraki/cmx-api-app%E5%88%86%E5%8F%89%E5%B9%B6%E5%90%88%E5%B9%B6%E4%BA%86%E6%96%87%E6%A1%A3%E3%80%82
免责声明
- 本代码仅作示例用途。生产环境使用前，建议通过nginx等支持TLS的反向代理添加SSL/TLS支持。
- 应测试服务器能否处理网络生成的事件频率。经验法则：服务器应能每分钟处理一次所有网络节点，例如100个节点时，每个请求响应需在600ms内；超过100个节点可能需要多线程Web应用。
核心功能
- 接收Meraki AP推送的设备位置事件（如客户端探针数据）
- 验证Meraki Dashboard与服务器的连接
- 提供客户端位置查询接口（通过MAC地址）
- 支持自定义端口、绑定IP等配置
- 兼容OpenShift和ciscoshipped.io平台
使用场景
- 企业网络中设备位置追踪与分析
- 学习Meraki CMX API的入门实践
- 快速搭建CMX API测试环境
配置说明
网络基础设施要求
- 需使用一个或多个https://meraki.cisco.com/products/wireless
- 每个AP需有效许可证
- 不支持其他品牌AP
Meraki Dashboard设置
假设Docker主机地址为pushapi.myserver.com：
- 进入Meraki Dashboard，在Network-wide > Configure > General中配置CMX API，URL填写
http://pushapi.myserver.com:4567/events - 设置密钥（secret）并记录
- 获取Dashboard提供的验证代码（validator）
- 启动容器时传入密钥和验证代码
Docker容器运行示例
交互式运行（查看输出）
docker-e CMX_SECRET=你的密钥 \ -e CMX_VALIDATOR=你的验证代码 \ robertcsapo/cisco-meraki-cmx-api-app``` #### 自定义端口 ```docker run --rm -it -p 80:80 \ -e CMX_SECRET=你的密钥 \ -e CMX_VALIDATOR=你的验证代码 \ -e CMX_PORT=80 \ robertcsapo/cisco-meraki-cmx-api-app``` #### 绑定特定IP ```docker run --rm -it -p 4567:4567 \ -e CMX_BIND=0.0.0.0 \ -e CMX_SECRET=你的密钥 \ -e CMX_VALIDATOR=你的验证代码 \ --net=host robertcsapo/cisco-meraki-cmx-api-app``` #### 后台运行 ```docker run -d -p 4567:4567 \ -e CMX_SECRET=你的密钥 \ -e CMX_VALIDATOR=你的验证代码 \ robertcsapo/cisco-meraki-cmx-api-app``` #### 进入后台容器 ```docker exec -it <容器ID/名称> /bin/bash``` ### 服务验证 1. 点击Meraki Dashboard的“Validate server”按钮，容器日志会显示类似`[26/Mar/2014 11:52:09] "GET /events HTTP/1.1" 200 6 0.0024`的信息 2. 通过`telnet pushapi.myserver.com 4567`确认端口开放 3. 接收事件后，可通过`http://pushapi.myserver.com:4567/clients/{MAC地址}`查询客户端位置，或访问`http://pushapi.myserver.com:4567/`查看示例前端 ## 版权与许可 代码和文档版权2013-2014 Cisco Systems, Inc. 代码以MIT许可证发布，文档以Creative Commons许可证发布。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 cisco-meraki-cmx-api-app 镜像标签
docker pull docker.xuanyuan.run/robertcsapo/cisco-meraki-cmx-api-app:<标签>
DockerHub 原生拉取命令
docker pull robertcsapo/cisco-meraki-cmx-api-app:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"