magistrala

用 Go 快速搭建可扩展的物联网平台，搞定设备接入与数据管理。

开源 🏷️定价信息待确认 🔧 仅开源项目，无在线服务，需自行部署行业应用 🍴 复刻 693 🐛 待处理 229 👀 关注 100

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2662

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类行业应用

开发团队absmach

官网地址https://www.absmach.eu/products/magistrala

GitHubhttps://github.com/absmach/magistrala

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型coap,distributed-systems,edge,edge-computing,golang,iiot,internet-of-things,iot,iot-cloud,iot-gateway,iot-platform,lora,lorawan,lwm2m,message-broker,messaging,mqtt,opc-ua,telecom,web-socket

GitHub 星标★ 2662

上线时间2015-07-06 00:00:00

代码更新2026-11-09

仓库体积149.8 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-12

浏览次数9

项目介绍

Magistrala 是一个用 Go 语言构建的开源物联网平台框架，原名 Mainflux。它旨在为工业物联网（IIoT）、边缘计算和智能设备提供一套灵活、可扩展的基础设施，解决设备接入、数据管理、消息路由和系统集成等核心问题。其核心能力包括：支持多种通信协议（MQTT、CoAP、HTTP、WebSocket 等），提供设备管理、用户认证、授权、数据持久化、规则引擎和事件日志等功能。平台采用微服务架构，模块化设计，易于定制和扩展，可部署在云端或边缘节点。Magistrala 强调系统解耦，通过消息代理（如 NATS）实现服务间异步通信，支持水平扩展，适合构建从原型到生产级的物联网解决方案。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-12 · 当前星标 ★ 2662

技术标签

distributed-systems edge edge-computing golang iot

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：Docker 7 步

环境要求

Git（用于克隆仓库）
Docker 与 Docker Compose（make run_latest 通过 Docker Compose 拉起全栈）
make 构建工具
Go 环境（执行 make cli 构建 CLI）
可用的终端（bash）

安装与启动步骤

1克隆仓库

从 GitHub 拉取 magistrala 源码到本地，确保网络可访问 github.com。
```
git clone https://github.com/absmach/magistrala.git
```
2进入项目目录

后续所有 make 命令都要在仓库根目录执行。
```
cd magistrala
```
3准备 Atom 令牌

全新克隆不含生成的密钥。make run_latest 会自行生成证书与密钥，但要求 Atom 服务令牌提前存在，所以令牌步骤必须在启动前完成。README 未给出生成命令，请参照官网文档准备。
4启动全栈

通过 Docker Compose 拉起消息、身份认证及全部核心服务，首次会拉取镜像，耗时较长。
```
make run_latest
```
5构建 CLI

编译出 ./build/cli 命令行客户端，用于后续登录和查询。
```
make cli
```
6登录管理员

使用默认本地管理员账号 admin 登录，密码为 12345678（仅本地环境示例）。
```
./build/cli login admin 12345678
```
7验证工作区列表

带上管理员令牌列出工作区，命令能返回数据说明平台已可用。
```
./build/cli --token "$ATOM_ADMIN_TOKEN" workspaces list
```

关键配置

配置项	必填	说明	示例
`ATOM_URL`	是	Atom 服务地址，CLI 与服务共用该变量	`https://your-atom-host`
`ATOM_SERVICE_TOKEN`	是	各服务向 Atom 出示的服务令牌，启动前必须已存在	`your-atom-service-token`
`ATOM_ADMIN_TOKEN`	是	CLI 执行管理类命令时使用的管理员令牌	`your-atom-admin-token`
`MG_CLI_ATOM_TIMEOUT`	否	CLI 请求超时设置，交互模式默认 90 秒	`90s`