losant/edge-agent
losant
Losant边缘代理服务，用于在边缘设备上运行，连接Losant物联网平台，实现数据处理与工作流执行等边缘计算功能。
10 次收藏下载次数: 0状态：社区镜像维护者：losant仓库类型：镜像最近更新：1 个月前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Losant Gateway Edge Agent 镜像文档
镜像概述和主要用途
Losant Gateway Edge Agent 是一款安装在所有 Losant Edge Compute 设备上的服务，用于管理边缘工作流的部署与执行。该服务作为 Losant 边缘计算平台的核心组件，负责协调设备与云端的通信、工作流生命周期管理及本地数据处理。
核心功能和特性
- 工作流管理：部署、执行和监控边缘工作流，支持本地离线运行
- 多架构支持：兼容
amd64、arm、arm64等主流硬件架构 - 持久化存储：内置数据持久化机制，支持外部卷挂载
- 网络通信：提供 HTTP 端点用于工作流触发，支持 MQTT 协议与云端通信
- 灵活配置：支持通过环境变量、配置文件或命令行标志进行参数配置
- 本地代理：可选启用本地 MQTT 代理，支持边缘设备间通信
- 健康监控：内置健康检查端点，可配置离线状态告警
使用场景和适用范围
适用于所有 Losant Edge Compute 设备，尤其适合以下场景：
- 工业物联网（IIoT）边缘设备的本地数据处理与分析
- 需要低延迟响应的边缘计算应用
- 间歇性网络环境下的离线工作流执行
- 分布式边缘设备的统一管理与协调
支持的标签
- 标准版本：
1.57.0,1.57,1,latest - 按架构划分：
1.57.0-amd64,1.57-amd64,1-amd64,latest-amd64；1.57.0-arm,1.57-arm,1-arm,latest-arm；1.57.0-arm64,1.57-arm64,1-arm64,latest-arm64 - Alpine 轻量版本：
1.57.0-alpine,1.57-alpine,1-alpine,latest-alpine - Alpine 架构版本：
1.57.0-alpine-amd64,1.57-alpine-amd64,1-alpine-amd64,latest-alpine-amd64；1.57.0-alpine-arm,1.57-alpine-arm,1-alpine-arm,latest-alpine-arm；1.57.0-alpine-arm64,1.57-alpine-arm64,1-alpine-arm64,latest-alpine-arm64
快速参考
帮助资源
- Losant Gateway Edge Agent 安装教程
- Losant Gateway Edge Agent 使用教程
- Losant 官方文档
- Losant 社区论坛
维护者
Losant
支持的架构
amd64, arm, arm64
使用方法和配置说明
前置准备
安装 Docker 并拉取镜像的详细步骤，请参考 安装说明。有关使用 Docker 命令管理 Agent 的更多信息，可查阅 Agent 管理示例。
基本启动示例（文档）
consoledocker run -d --name myAgent \ -e 'DEVICE_ID=<你的设备ID>' \ -e 'ACCESS_KEY=<你的访问密钥>' \ -e 'ACCESS_SECRET=<你的访问密钥密钥>' \ docker.xuanyuan.run/losant/edge-agent
挂载持久化存储（文档）
consoledocker run -d --name myAgent \ -e 'DEVICE_ID=<你的设备ID>' \ -e 'ACCESS_KEY=<你的访问密钥>' \ -e 'ACCESS_SECRET=<你的访问密钥密钥>' \ -v /docker/host/dir:/data \ docker.xuanyuan.run/losant/edge-agent
默认情况下，持久化数据存储在 VOLUME /data 目录。可通过 --volumes-from some-volume-container 或 -v /docker/host/dir:/data 进行挂载（详见 https://docs.docker.com/storage/volumes/%EF%BC%89%E3%80%82
暴露 HTTP 端点用于触发（文档）
consoledocker run -d --name myAgent \ -e 'DEVICE_ID=<你的设备ID>' \ -e 'ACCESS_KEY=<你的访问密钥>' \ -e 'ACCESS_SECRET=<你的访问密钥密钥>' \ -p <主机端口>:8080 \ docker.xuanyuan.run/losant/edge-agent
默认情况下，Losant Agent 在 8080 端口暴露 HTTP 端点，可通过 -p 参数将其映射到主机端口（详见 https://docs.docker.com/engine/reference/commandline/run/#publish-or-expose-port--p-expose%EF%BC%89%E3%80%82
使用自定义配置文件（文档）
可通过挂载自定义配置文件启动 Agent：
consoledocker run -d --name myAgent \ -v /host/dir/custom-config.toml:/etc/losant/losant-edge-agent-config.toml \ docker.xuanyuan.run/losant/edge-agent
容器内 /etc/losant/losant-edge-agent-config.toml 文件为示例配置，可作为自定义配置的基础模板。
配置选项说明
大多数配置项可通过环境变量（Docker 最常用）、配置文件或命令行标志设置。优先级为：命令行标志 > 环境变量 > 配置文件。
配置项对照表
| 环境变量 | 配置文件选项 | 命令行标志 |
|---|---|---|
CONF_PATH | N/A | -f <路径> 或 --conf-path <路径> |
DEVICE_ID | gateway.id | --device-id <你的设备ID> |
ACCESS_KEY | gateway.key | --access-key <你的访问密钥> |
ACCESS_SECRET | gateway.secret | --access-secret <你的访问密钥密钥> |
LOGGER_OUT | logger.out | --logger-out <目标> |
LOGGER_LEVEL | logger.level | --logger-level <级别> |
STORE_PATH | store.path | --store-path <路径> |
BROKER_HOST | gateway.host | N/A |
BROKER_PROTOCOL | gateway.protocol | N/A |
BROKER_CLIENT_SSL_KEY_PATH | gateway.clientSsl.keyPath | N/A |
BROKER_CLIENT_SSL_KEY | N/A | N/A |
BROKER_CLIENT_SSL_CERT_PATH | gateway.clientSsl.certificatePath | N/A |
BROKER_CLIENT_SSL_CERT | N/A | N/A |
WORKFLOW_DIRECTORY | workflow.directory | --workflow-directory <路径> |
UDP_ADDRESS | udp.address | --udp-address <IP地址> |
QUEUE_OFFLINE_MESSAGES | gateway.queueOfflineMessages | --queue-offline-messages <true,false> |
OFFLINE_MESSAGE_REPLAY_ORDER | gateway.offlineMessageReplayOrder | --offline-message-replay-order <oldestFirst,newestFirst> |
SUBSCRIBE_TO_PERIPHERAL_UPDATES | gateway.subscribeToPeripheralUpdates | --subscribe-to-peripheral-updates <true,false,floating,peripheral> |
WEBSERVER_ENABLED | webserver.enabled | --webserver-enabled <true,false> |
WEBSERVER_PORT | webserver.port | --webserver-port <端口> |
WEBSERVER_ADDRESS | webserver.address | --webserver-address <IP地址> |
WEBSERVER_USERNAME | webserver.username | --webserver-username <用户名> |
WEBSERVER_PASSWORD | webserver.password | --webserver-password <密码> |
WEBSERVER_SSL_KEY_PATH | webserver.ssl.keyPath | --webserver-ssl-key-path <路径> |
WEBSERVER_SSL_KEY | N/A | N/A |
WEBSERVER_SSL_CERT_PATH | webserver.ssl.certificatePath | --webserver-ssl-cert-path <路径> |
WEBSERVER_SSL_CERT | N/A | N/A |
WEBSERVER_SSL_BUNDLE_PATH | webserver.ssl.bundlePath | --webserver-ssl-bundle-path <路径> |
WEBSERVER_SSL_BUNDLE | N/A | N/A |
LOCAL_BROKER_ENABLED | localBroker.enabled | --local-broker-enabled <true,false> |
LOCAL_BROKER_PORT | localBroker.port | --local-broker-port <端口> |
LOCAL_BROKER_ADDRESS | localBroker.address | --local-broker-address <地址> |
LOCAL_BROKER_USERNAME | localBroker.username | --local-broker-username <用户名> |
LOCAL_BROKER_PASSWORD | localBroker.password | --local-broker-password <密码> |
LOCAL_BROKER_SSL_KEY_PATH | localBroker.ssl.keyPath | --local-broker-key-path <路径> |
LOCAL_BROKER_SSL_KEY | N/A | N/A |
LOCAL_BROKER_SSL_CERT_PATH | localBroker.ssl.certificatePath | --local-broker-ssl-key-path <路径> |
LOCAL_BROKER_SSL_CERT | N/A | N/A |
LOCAL_BROKER_SSL_BUNDLE_PATH | localBroker.ssl.bundlePath | --local-broker-ssl-cert-path <路径> |
LOCAL_BROKER_SSL_BUNDLE | N/A | --local-broker-ssl-bundle-path <路径> |
HEALTH_CHECK_ENABLED | healthCheck.enabled | N/A |
HEALTH_CHECK_PORT | healthCheck.port | N/A |
HEALTH_CHECK_OFFLINE_IS_UNHEALTHY | healthCheck.offlineIsUnhealthy | N/A |
| N/A | N/A | -V 或 --version |
| N/A | N/A | -h |
配置项详情
CONF_PATH
- 描述：Agent 配置文件路径
- 默认值：
/etc/losant/losant-edge-agent-config.toml（示例配置文件路径）
DEVICE_ID [必填]
- 描述：Agent 的 Losant 设备 ID，需对应 Losant 账户中的 边缘计算设备
- 配置文件路径：
gateway.id - 命令行标志：
--device-id <你的设备ID>
ACCESS_KEY [必填]
- 描述：用于 Agent 认证的 Losant 访问密钥，需对应设备的 设备访问密钥
- 配置文件路径：
gateway.key - 命令行标志：
--access-key <你的访问密钥>
ACCESS_SECRET [必填]
- 描述：用于 Agent 认证的 Losant 访问密钥密钥，需对应设备的 设备访问密钥
- 配置文件路径：
gateway.secret - 命令行标志：
--access-secret <你的访问密钥密钥>
LOGGER_OUT
- 描述：日志输出目标，可选
console（控制台）或文件路径 - 默认值：
console - 配置文件路径：
logger.out - 命令行标志：
--logger-out <目标>
LOGGER_LEVEL
- 描述：日志级别，可选
error、warn、info、verbose - 默认值：
info - 配置文件路径：
logger.level - 命令行标志：
--logger-level <级别>
STORE_PATH
- 描述：Agent 持久化存储目录路径
- 默认值：
/data/losant-edge-agent-store.db - 配置文件路径：
store.path - 命令行标志：
--store-path <路径>
BROKER_HOST
- 描述：Agent 连接的 broker 主机名
- 默认值：
broker.losant.com - 配置文件路径：
gateway.host
BROKER_PROTOCOL
- 描述：连接 broker 使用的协议
- 默认值：
mqtts - 配置文件路径：
gateway.protocol
WORKFLOW_DIRECTORY
- 描述：本地工作流文件存放目录路径
- 默认值：
/data/workflows - 配置文件路径：
workflow.directory - 命令行标志：
--workflow-directory <路径>
UDP_ADDRESS
- 描述：UDP 触发器绑定的 IP 地址
- 默认值：
0.0.0.0（绑定所有网络接口） - 配置文件路径：
udp.address - 命令行标志：
--udp-address <IP地址>
QUEUE_OFFLINE_MESSAGES
- 描述：是否在离线时缓存消息以便后续发送
- 默认值：
true - 配置文件路径：
gateway.queueOfflineMessages - 命令行标志：
--queue-offline-messages <true,false>
OFFLINE_MESSAGE_REPLAY_ORDER
- 描述：离线消息重放顺序，可选
oldestFirst（先旧后新）或newestFirst（先新后旧） - 默认值：
oldestFirst - 配置文件路径：
gateway.offlineMessageReplayOrder - 命令行标志：
--offline-message-replay-order <oldestFirst,newestFirst>
SUBSCRIBE_TO_PERIPHERAL_UPDATES
- 描述：是否订阅外设更新主题，可选
true（订阅所有）、false（不订阅）、floating（仅浮动外设）、peripheral（仅指定外设） - 默认值：
true - 配置文件路径：
gateway.subscribeToPeripheralUpdates - 命令行标志：
--subscribe-to-peripheral-updates <true,false,floating,peripheral>
WEBSERVER_ENABLED
- 描述：是否启用 Agent Web 服务器
- 默认值：
true（启用） - 配置文件路径：
webserver.enabled - 命令行标志：
--webserver-enabled <true,false>
WEBSERVER_PORT
- 描述：Web 服务器端口
- 默认值：
8080 - 配置文件路径：
webserver.port - 命令行标志：
--webserver-port <端口>
WEBSERVER_ADDRESS
- 描述：Web 服务器绑定的 IP 地址
- 默认值：
0.0.0.0（绑定所有网络接口） - 配置文件路径：
webserver.address - 命令行标志：
--webserver-address <IP地址>
WEBSERVER_USERNAME
- 描述：Web 服务器基本认证用户名（需与密码同时配置才生效）
- 默认值：无（不启用认证）
- 配置文件路径：
webserver.username - 命令行标志：
--webserver-username <用户名>
WEBSERVER_PASSWORD
- 描述：Web 服务器基本认证密码（需与用户名同时配置才生效）
- 默认值：无（不启用认证）
- 配置文件路径：
webserver.password - 命令行标志：
--webserver-password <密码>
LOCAL_BROKER_ENABLED
- 描述：是否启用本地 MQTT 代理
- 默认值：
false（禁用
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 edge-agent 镜像标签
docker pull docker.xuanyuan.run/losant/edge-agent:<标签>
DockerHub 原生拉取命令
docker pull losant/edge-agent:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"