microsoft/azureiotedge-hub

Azure IoT Edge Hub

镜像概述

本仓库包含Azure IoT Edge Hub的官方容器镜像。IoT Edge Hub是构成Azure IoT Edge运行时的两个容器模块之一（另一个是Azure IoT Edge Agent）。容器源代码可在https://github.com/Azure/iotedge/tree/main/edge-hub%E8%8E%B7%E5%8F%96%E3%80%82

核心功能与特性

IoT Edge Hub是IoT Edge的核心数据平面组件，主要特性包括：

• 本地代理：作为IoT Hub的本地代理，公开与IoT Hub相同的协议端点，确保客户端可像连接IoT Hub一样无缝连接到IoT Edge运行时。
• 双向通信：支持云与边缘之间的双向数据通信。
• 本地模块通信：允许容器化模块通过Azure IoT SDK和消息路由进行本地通信。
• 扩展离线能力：支持IoT Edge的扩展离线功能，确保边缘设备在断网时仍能正常运行。

使用场景与适用范围

IoT Edge Hub适用于需要在物联网边缘设备实现以下功能的场景：

• 本地设备与云端的双向数据交换
• 边缘设备上多个容器化模块间的消息路由与通信
• 网络不稳定或无网络环境下的离线数据处理与存储
• 降低云端连接带宽需求，实现数据本地处理后再上传

使用方法与配置说明

IoT Edge Hub容器会作为IoT Edge运行时初始化的一部分自动部署，不应直接使用docker run命令启动。如需部署和使用，请参考快速入门教程完成IoT Edge运行时的初始化。

支持信息

如对本镜像有任何问题或疑问，请通过https://github.com/Azure/iotedge/issues%E4%B8%8E%E6%88%91%E4%BB%AC%E8%81%94%E7%B3%BB%E3%80%82

许可条款

• ***声明：容器许可信息

MICROSOFT SOFTWARE LICENSE TERMS

MICROSOFT AZURE IOT EDGE RUNTIME CONTAINERS

本许可条款是您与微软公司（或其关联公司）之间的协议。条款适用于上述软件以及任何微软服务或软件更新（除非此类服务或更新附带新的或额外条款，在此情况下，不同条款将前瞻性适用，且不改变您或微软关于更新前软件或服务的权利）。如果您遵守本许可条款，您将获得以下权利。使用本软件即表示您接受这些条款。

安装和使用权利

a) 一般规定。您可以在您的设备上安装和使用任意数量的软件副本。除非微软通过其他协议允许，否则您不得在实时操作环境中使用本软件。
b) 第三方软件。本软件可能包含第三方应用程序，微软（而非第三方）根据本协议向您授予许可。任何第三方应用程序的包含通知仅供您参考。
c) 微软服务协议。本软件的某些功能提供对在线服务的访问或依赖于在线服务。这些服务（而非软件）的使用受《微软服务协议》中的单独条款和隐私政策管辖，网址为[***]

时效性软件

a) 期限。本协议在您接受时生效，并在以下较早时间终止：(i) 软件商业版本首次可用后30天；或(ii) 微软终止本协议。微软可自行决定延长本协议。
b) 通知。您可能会通过软件定期收到关于此日期的提醒通知。
c) 数据访问。当软件停止运行时，您可能无法访问软件中使用的数据。

预发布软件

本软件是预发布版本，可能无法正常运行，且可能与商业发布版本不同。

反馈

如果您向微软提供有关软件的反馈，您即免费授予微软以任何方式和目的使用、分享和商业化您的反馈的权利。您不得提供受以下许可约束的反馈：因微软将您的反馈纳入其软件或文档中，而要求微软向第三方许可其软件或文档。这些权利在本协议终止后仍然有效。

数据收集

软件可能收集关于您及您使用软件的信息并发送给微软。微软可使用此信息提供服务并改进微软的产品和服务。产品文档中说明了您的选择退出权利（如有）。软件的某些功能可能允许从访问或使用软件的应用程序用户那里收集数据。如果您使用这些功能在应用程序中启用数据收集，您必须遵守适用***，包括获得任何所需的用户同意，并维护明确的隐私政策，准确告知用户您如何使用、收集和分享他们的数据。您可以在产品文档和微软隐私声明（[***]

许可范围

本软件是许可使用，而非出售。微软保留所有其他权利。除非适用赋予您更多权利（尽管有此限制），否则您不得（且无权）：
a) 规避软件中仅允许您以特定方式使用的技术限制；
b) 对软件进行反向工程、反编译或反汇编；
c) 移除、最小化、阻止或修改软件中微软或其供应商的任何通知；
d) 在未获得微软事先书面批准的情况下，向任何第三方披露软件的基准测试结果；
e) 将软件用于商业、非营利或创收活动；
f) 以违反的方式使用软件或创建或传播***软件；或
g) 分享、发布、分发或借出软件，将软件作为独立托管解决方案供他人使用，或将软件或本协议转让给任何第三方。

出口限制

您必须遵守适用于软件的所有国内和国际出口******，包括对目的地、最终用户和最终用途的限制。有关出口限制的更多信息，请访问[***]

支持服务

微软在本协议下无义务提供任何软件支持服务。所提供的任何支持均"按原样"、"存在所有缺陷"且不提供任何形式的保证。

更新

软件可能会定期检查更新，并为您下载和安装更新。您只能从微软或授权来源获取更新。微软可能需要更新您的系统以向您提供更新。您同意在不另行通知的情况下接收这些自动更新。更新可能不包括或支持所有现有软件功能、服务或外围设备。

完整协议

本协议以及微软可能为补充、更新或第三方应用程序提供的任何其他条款，构成软件的完整协议。

适用***和争议解决地

如果您在美国或加拿大获得软件，您居住的州或省（如果是企业，则为主要营业地所在州或省）的管辖本协议的解释、违约索赔以及所有其他索赔（包括消费者保护、不正当竞争和侵权索赔），无论冲突原则如何。如果您在其他国家获得软件，则适用该国***。如果存在美国联邦管辖权，您和微软同意就所有法院审理的争议接受华盛顿州金县联邦法院的专属管辖权和审判地。否则，您和微软同意就所有法院审理的争议接受华盛顿州金县高等法院的专属管辖权和审判地。

消费者权利；地区差异

本协议描述了某些权利。您可能在您的州、省或国家的下享有其他权利，包括消费者权利。除了您与微软的关系外，您还可能对向您提供软件的一方享有权利。如果您的州、省或国家的不允许，本协议不会改变这些其他权利。例如，如果您在以下地区获得软件，或适用的国家要求，则以下条款适用于您：
a) 澳大利亚。根据《澳大利亚消费者法》，您享有法定保证，本协议无意影响这些权利。
b) 加拿大。如果您在加拿大获得本软件，您可以通过关闭自动更新功能、断开设备与互联网的连接（但当您重新连接到互联网时，软件将恢复检查和安装更新）或卸载软件来停止接收更新。产品文档（如有）也可能指定如何为您的特定设备或软件关闭更新。
c) 德国和奥地利
i. 保证。经适当许可的软件将基本按照随附微软材料中的描述运行。但是，微软不对许可软件提供合同保证。
ii. 责任限制。对于故意行为、重大过失、基于《产品责任法》的索赔以及死亡或人身伤害，微软根据成文法承担责任。
在遵守上述第ii条的前提下，微软仅在违反以下重大合同义务时对轻微过失承担责任：这些义务的履行有助于本协议的适当履行，违反这些义务将危及本协议的目的，且一方可始终信赖另一方会遵守这些义务（所谓的"核心义务"）。在其他轻微过失情况下，微软不对轻微过失承担责任。

免责声明

本软件按"原样"许可。您自行承担使用风险。微软不提供任何明示保证、担保或条件。在适用***允许的范围内，微软排除所有默示保证，包括适销性、特定用途适用性和不侵权。

损害赔偿限制和排除

尽管有前述免责声明，如果您有任何获得损害赔偿的依据，您仅可从微软及其供应商处获得不超过5.00的直接损害赔偿。您不得获得任何其他损害赔偿，包括后果性损害、利润损失、特殊损害、间接损害或附带损害。
此限制适用于：(a) 与软件、服务、第三方互联网网站上的内容（包括代码）或第三方应用程序相关的任何事项；以及(b) 在适用允许的范围内，违约、保证、担保或条件索赔；严格责任、过失或其他侵权索赔；或任何其他索赔。
即使微软知道或应当知道损害的可能性，此限制也适用。由于您的州、省或国家可能不允许排除或限制附带损害、后果性损害或其他损害，上述限制或排除可能不适用于您。

请注意：由于本软件在加拿大分发，本协议中的某些条款以下以法文提供。
Remarque: Ce logiciel étant distribué au Canada, certaines des clauses dans ce contrat sont fournies ci-dessous en français.
EXONÉRATION DE GARANTIE. Le logiciel visé par une licence est offert « tel quel ». Toute utilisation de ce logiciel est à votre seule risque et péril. Microsoft n’accorde aucune autre garantie expresse. Vous pouvez bénéficier de droits additionnels en vertu du droit local sur la protection des consommateurs, que ce contrat ne peut modifier. La ou elles sont permises par le droit locale, les garanties implicites de qualité marchande, d’adéquation à un usage particulier et d’absence de contrefaçon sont exclues.
LIMITATION DES DOMMAGES-INTÉRÊTS ET EXCLUSION DE RESPONSABILITÉ POUR LES DOMMAGES. Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages directs uniquement à hauteur de 5,00 $ US. Vous ne pouvez prétendre à aucune indemnisation pour les autres dommages, y compris les dommages spéciaux, indirects ou accessoires et pertes de bénéfices.
Cette limitation concerne:
• tout ce qui est relié au logiciel, aux services ou au contenu (y compris le code) figurant sur des sites Internet tiers ou dans des programmes tiers; et
• les réclamations au titre de violation de contrat ou de garantie, ou au titre de responsabilité stricte, de négligence ou d’une autre faute dans la limite autorisée par la loi en vigueur.
Elle s’applique également, même si Microsoft connaissait ou devrait connaître l’éventualité d’un tel dommage. Si votre pays n’autorise pas l’exclusion ou la limitation de responsabilité pour les dommages indirects, accessoires ou de quelque nature que ce soit, il se peut que la limitation ou l’exclusion ci-dessus ne s’appliquera pas à votre égard.
EFFET JURIDIQUE. Le présent contrat décrit certains droits juridiques. Vous pourriez avoir d’autres droits prévus par les lois de votre pays. Le présent contrat ne modifie pas les droits que vous confèrent les lois de votre pays si celles-ci ne le permettent pas.