lamassuiot/lamassuiot
GitHub: lamassuiot/lamassuiot
Lamassu IoT 是一个为工业场景设计的 IoT 优先 PKI 平台，解决设备身份与自动化证书管理问题。
Stars: 11 | Forks: 4
# Lamassu IoT
[](https://codecov.io/gh/lamassuiot/lamassuiot)
[](https://deepwiki.com/lamassuiot/lamassuiot)
Lamassu IoT 是一个为工业环境构建的 IoT 优先公钥基础设施（PKI）平台，能够实现安全的设备身份、自动化证书生命周期管理，并与云和边缘生态系统集成。该仓库托管了驱动 Lamassu 部署的源代码、基础架构组件和 SDK。
## 为何选择 Lamassu IoT？
- **工业级安全性** – 强化加密引擎、硬件密钥存储和可审计的证书工作流。
- **云与边缘就绪** – 可插拔的存储、事件总线和加密层支持 AWS、Vault、本地部署和混合环境。
- **运营自动化** – 针对大规模 IoT 舰队设计的设备 onboarding、策略管理和续期流程。
- **开发者友好** – SDK、连接器以及定义完善的 API 可加速与现有平台的集成。
## 代码库结构
在开发 Lamassu 时需主要考虑以下 3 个代码仓库：
- **后端**：本仓库（`lamassuiot/lamassuiot`）—— 核心服务、API、域逻辑和 SDK 组件
- **仪表板**：[lamassuiot/lamassu-ui](https://github.com/lamassuiot/lamassu-ui) —— 基于 React 的 Web 界面，用于管理 CA、证书、设备和系统配置
- **Helm 图表**：[lamassuiot/lamassu-helm](https://github.com/lamassuiot/lamassu-helm) —— Kubernetes 部署清单及生产环境的 Helm Chart
## 代码库布局
| 路径 | 说明 |
| ---- | ---- |
| [`backend/`](backend/) | 驱动 Lamassu IoT 的域服务（CA、设备管理器、告警等） |
| [`connectors/`](connectors/) | 与云提供商（如 AWS IoT）及其他外部系统的集成 |
| [`core/`](core/) | 共享业务逻辑、域模型和跨服务工具 |
| [`engines/`](engines/) | 模块化加密、存储、文件系统和事件总线适配器 |
| [`monolithic/`](monolithic/) | 用于简化部署和演示的单体构建选项 |
| [`sdk/`](sdk/) | 与 Lamassu API 和服务交互的语言特定工具 |
| [`shared/`](shared/) | HTTP、AWS 辅助工具和子系统编排的通用库 |
| [`ci/`](ci/) | 持续集成工作流和自动化脚本 |
## 快速开始
### 前置条件
- [Go 1.24+](https://go.dev/doc/install)
- Docker（用于运行 PostgreSQL、Vault 或消息代理等依赖）
- Kubernetes 集群（可选，生产部署推荐使用）
### 克隆并引导项目
```
# 克隆仓库
git clone https://github.com/lamassuiot/lamassuiot.git
cd lamassuiot
# 同步 go.work 模块并整理依赖
go work sync
go mod tidy -e ./...
# 运行完整测试套件
go test ./...
```
### 本地运行服务 —— 开发模式
运行所有 Lamassu 服务的一体化模式非常简单，只需执行以下命令即可。请注意 `docker` 是必需的环境依赖。该单体启动器会运行并配置所需的基础架构（即 PostgreSQL、RabbitMQ），作为 Docker 容器。要启动它，请执行以下命令：
```
go run ./monolithic/cmd/development/main.go
```
应用就绪后，将出现如下日志：
UI 和 API 现在可通过以下地址访问（要调用 API，请在 URL 路径后添加 `/api`）：
```
http://localhost:8080
https://localhost:8443
```
如需生产部署或 Helm Chart，请参考[官方文档](https://www.lamassu.io/docs/)。
## 支持与社区
- 📚 文档：https://www.lamassu.io/docs/
- 🐛 问题反馈：[GitHub Issues](https://github.com/lamassuiot/lamassuiot/issues)
- 💬 讨论：[GitHub Discussions](https://github.com/lamassuiot/lamassuiot/discussions)
## 许可证
本项目根据 [Mozilla Public License Version 2.0](LICENSE) 授权。
Lamassu IoT 是一个为工业环境构建的 IoT 优先公钥基础设施（PKI）平台，能够实现安全的设备身份、自动化证书生命周期管理，并与云和边缘生态系统集成。该仓库托管了驱动 Lamassu 部署的源代码、基础架构组件和 SDK。
## 为何选择 Lamassu IoT？
- **工业级安全性** – 强化加密引擎、硬件密钥存储和可审计的证书工作流。
- **云与边缘就绪** – 可插拔的存储、事件总线和加密层支持 AWS、Vault、本地部署和混合环境。
- **运营自动化** – 针对大规模 IoT 舰队设计的设备 onboarding、策略管理和续期流程。
- **开发者友好** – SDK、连接器以及定义完善的 API 可加速与现有平台的集成。
## 代码库结构
在开发 Lamassu 时需主要考虑以下 3 个代码仓库：
- **后端**：本仓库（`lamassuiot/lamassuiot`）—— 核心服务、API、域逻辑和 SDK 组件
- **仪表板**：[lamassuiot/lamassu-ui](https://github.com/lamassuiot/lamassu-ui) —— 基于 React 的 Web 界面，用于管理 CA、证书、设备和系统配置
- **Helm 图表**：[lamassuiot/lamassu-helm](https://github.com/lamassuiot/lamassu-helm) —— Kubernetes 部署清单及生产环境的 Helm Chart
## 代码库布局
| 路径 | 说明 |
| ---- | ---- |
| [`backend/`](backend/) | 驱动 Lamassu IoT 的域服务（CA、设备管理器、告警等） |
| [`connectors/`](connectors/) | 与云提供商（如 AWS IoT）及其他外部系统的集成 |
| [`core/`](core/) | 共享业务逻辑、域模型和跨服务工具 |
| [`engines/`](engines/) | 模块化加密、存储、文件系统和事件总线适配器 |
| [`monolithic/`](monolithic/) | 用于简化部署和演示的单体构建选项 |
| [`sdk/`](sdk/) | 与 Lamassu API 和服务交互的语言特定工具 |
| [`shared/`](shared/) | HTTP、AWS 辅助工具和子系统编排的通用库 |
| [`ci/`](ci/) | 持续集成工作流和自动化脚本 |
## 快速开始
### 前置条件
- [Go 1.24+](https://go.dev/doc/install)
- Docker（用于运行 PostgreSQL、Vault 或消息代理等依赖）
- Kubernetes 集群（可选，生产部署推荐使用）
### 克隆并引导项目
```
# 克隆仓库
git clone https://github.com/lamassuiot/lamassuiot.git
cd lamassuiot
# 同步 go.work 模块并整理依赖
go work sync
go mod tidy -e ./...
# 运行完整测试套件
go test ./...
```
### 本地运行服务 —— 开发模式
运行所有 Lamassu 服务的一体化模式非常简单，只需执行以下命令即可。请注意 `docker` 是必需的环境依赖。该单体启动器会运行并配置所需的基础架构（即 PostgreSQL、RabbitMQ），作为 Docker 容器。要启动它，请执行以下命令：
```
go run ./monolithic/cmd/development/main.go
```
应用就绪后，将出现如下日志：
UI 和 API 现在可通过以下地址访问（要调用 API，请在 URL 路径后添加 `/api`）：
```
http://localhost:8080
https://localhost:8443
```
如需生产部署或 Helm Chart，请参考[官方文档](https://www.lamassu.io/docs/)。
## 支持与社区
- 📚 文档：https://www.lamassu.io/docs/
- 🐛 问题反馈：[GitHub Issues](https://github.com/lamassuiot/lamassuiot/issues)
- 💬 讨论：[GitHub Discussions](https://github.com/lamassuiot/lamassuiot/discussions)
## 许可证
本项目根据 [Mozilla Public License Version 2.0](LICENSE) 授权。标签：API集成, AWS, DPI, EVTX分析, HashiCorp Vault, Helm, IoT安全, REST API, 云边协同, 公钥基础设施, 可观测性, 大型设备 fleet, 子域名突变, 审计, 工业安全, 提示词模板, 日志审计, 测试用例, 物联网, 监控, 硬件密钥存储, 硬加密引擎, 自动化证书管理, 设备身份, 证书生命周期, 请求拦截, 边缘计算