运维
本地操作
如果您不希望让 appliance 保持在线，您始终可以在同一本地网络中使用浏览器，访问 appliance 的 IP 地址或主机名：
http://<appliance-host>以 admin 用户身份登录：
- 用户名：
admin - 密码： 为您的 appliance 生成的初始管理员密码
安装程序会在安装结束时显示此密码。该密码还以 APPLIANCE_ADMIN_PASSWORD 的形式保存在 appliance 主机的 /opt/ironflock/.env 中，只有 root 可以读取该文件：
sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env请在首次登录后更改密码。
忘记了管理员密码？请在 appliance 主机上运行以下命令设置新密码，命令会显示新密码：
curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
| sudo bash -s -- --reset-admin-password较早的 appliance： 在安装程序开始生成管理员密码之前安装的 appliance，初始密码为
ironflock。首次使用该密码登录时，系统会要求您设置新密码。
应用 Web UI
当已连接设备上的某个应用暴露出 Web 界面时，appliance 会通过其内置隧道使其可达。开箱即用，无需企业 IT 的任何参与——每个应用 UI 都通过纯 HTTP 发布在 appliance 地址的一个自动分配端口上（http://<appliance-host>:<port>），IronFlock UI 中会显示该链接。访问仍受 appliance 登录保护。
如需在共享的企业网络中使用受信任的 https:// URL——使用来自您 CA 的通配符证书，或使用终结 TLS 的反向代理——请参阅应用 UI 与 HTTPS。
账户关联
通过在 Appliance 的项目设置中以邮件方式邀请团队成员，为他们创建本地用户账户。邀请邮件包含受邀者所需的全部内容：
- 个人连接链接 — 在 ironflock.com 上打开该链接，即可将受邀者的 ironflock.com 账户连接到 Appliance。如果受邀者还没有 ironflock.com 账户，需要先使用被邀请的邮箱地址创建一个（只有两个邮箱地址一致时才会建立连接）。连接完成后，Appliance 会出现在其 ironflock.com 的项目选择器中，随即就能远程使用——无需手动密钥，也无需本地注册。
- 本地注册链接 — 可选：完成本地注册后，还可以直接在 Appliance UI（
http://<appliance-host>）上登录。
需要了解的几点：
- 已有的本地用户无需项目所有者重新发出邀请。他们在 Appliance UI 中打开自己的个人资料，在 连接到 ironflock.com 部分点击将连接链接发送到我的邮箱即可。
- 重新发送：再次邀请同一邮箱地址（或再次点击个人资料中的按钮）会签发一个新的连接链接。只有最近一封邮件中的链接有效。
- 如果 Appliance 无法发送邮件——例如在屏蔽邮件中继的受限企业网络中——连接链接会直接显示在 UI 中：邀请人复制该链接，通过任意渠道转交即可。该链接必须在可访问互联网的浏览器中打开。
- 断开连接：用户可以随时在 ironflock.com 上通过 个人资料 → 实例 → 已连接的实例 移除连接。重新打开最新的连接链接即可恢复连接。
实例所有者——即在 ironflock.com 上创建 Instance Key 的用户——会自动与实例的本地管理员账户建立连接；所有者无需邀请。
从在线商店同步应用
Appliance 包含一个本地 App Store——一个私有应用目录和容器镜像仓库，为本地网络中的设备提供应用。您可以通过从公共在线 IronFlock Store 同步应用来填充本地商店，前提是 Appliance 在同步时有可用的互联网连接。不需要永久的互联网连接；临时连接足以拉取您需要的应用。
前提条件
- 在公共 ironflock.com 平台上的账户。
- 您的 appliance 账户已连接到您的 ironflock.com 账户（参见账户关联）。实例所有者的管理员账户会自动连接。
应用同步工作原理
┌────────────────────┐ ┌────────────────────┐
│ Online IronFlock │ ◄──── account ─────► │ Appliance │
│ Store (cloud) │ connection │ local Store │
└────────────────────┘ └────────────────────┘
│ │
apps available to sync button shown
the connected account instead of install- 打开本地 App Store — 当 Appliance 处于活跃的互联网连接状态时，App Store 将显示您所连接的 ironflock.com 账户在在线平台上可用的所有应用。
- 同步所需应用 — 每个应用显示的不是 Install 按钮，而是 Sync 按钮。点击它会将应用——包括其容器镜像和元数据——从在线商店下载到本地商店。
- 添加设备 — 同步完成后，应用在本地商店中完全可用，您可以像平时一样将设备添加到应用，无需互联网连接。
更新工作流
当在线商店上发布了已同步应用的新版本时，该应用会再次显示 Sync 按钮。短暂将 Appliance 连接到互联网，同步更新的版本，然后通过标准应用升级流程将其部署到设备。
此设计让您完全掌控进入网络的内容——不会自动下载任何东西，互联网连接仅在同步步骤中需要。
自定义邮件发件人 (SMTP)
默认情况下，所有平台邮件——账户验证、密码恢复、邀请和报警通知——都通过 IronFlock 云端 SMTP 代理转发，显示为 [email protected]。要让邮件看起来像是从您自己的公司发出，可将 Appliance 指向您自己的 SMTP 服务器。
在 Appliance 主机上，编辑安装程序生成的环境文件 /opt/ironflock/.env，并设置以下变量：
SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company- 对于隐式 TLS（通常使用端口
465），请使用smtps://；对于 STARTTLS（端口587），请使用smtp://。 - 用户名或密码中的特殊字符需进行 URL 编码（例如
@→%40）。 SMTP_FROM_ADDRESS和SMTP_FROM_NAME决定了收件人在每封平台邮件的 发件人 头中看到的内容。
通过重启 stack 应用更改：
sudo systemctl restart ironflock.service重启后，所有身份验证邮件、平台通知和报警邮件都会通过您的 SMTP 服务器发送，并使用您公司的发件人地址和显示名称。
如果未设置
SMTP_CONNECTION_URI，Appliance 将继续通过使用您的许可证密钥进行身份验证的 IronFlock 云端 SMTP 代理转发邮件——无需额外配置，但邮件将带有 IronFlock 品牌标识。
维护
要更新 Appliance 上的 IronFlock 系统，每当有新版本可用时，管理员可以使用其个人资料中许可证部分的更新按钮。 Appliance 需要互联网连接以下载更新。更新完成后 IronFlock 会自动重启。
Linux 操作系统的更新需要由您自行维护。
许可证生命周期
您的许可证绑定到一台物理 Appliance。同一许可证不能同时在不同硬件上运行第二个 IronFlock 实例。在日常运行中，Appliance 离线工作——生产数据、仪表板、应用管理以及边缘设备控制全部在本机本地完成。
Appliance 何时需要互联网
仅在以下情况下需要互联网连接：
- 初次安装与 Appliance 更新 — 本来就需要从 IronFlock 分发服务器拉取软件；许可证的激活作为同一步骤的一部分完成。
- 周期性许可证重新校验 — 取决于您的方案：
- 月度 许可证：每 30 天一次。
- 年度 许可证：每 365 天一次。
- 永久 许可证：无需周期性重新校验——仅在安装和更新时需要互联网。
- 许可证迁移 到新硬件（见下文）。
- AI Multi Agent 服务 — 仅在该服务正在使用时需要。
宽限期与锁定
如果某次周期性重新校验无法连通云端（网络中断、临时性云端错误），Appliance 会进入 7 天宽限期。在宽限期内，Appliance 仍正常运行并自动重试。
如果连续 7 整天都未能成功重新校验，Appliance 会自我锁定：大多数操作将被拒绝，UI 中许可证显示为无效。要恢复运行，请恢复 Appliance 的互联网连接，并在 Appliance UI（本地 http://<appliance-host> 视图，或通过 ironflock.com 访问的实例）个人资料的许可证面板中点击”立即重新验证”。
将许可证迁移到新硬件（迁移）
许可证绑定到单台机器的硬件指纹。要将其迁移到另一台机器，您需要从 IronFlock 云端个人资料发起迁移：
- 在 ironflock.com 上打开 个人资料 → 实例。
- 在要迁移的实例上点击”重置硬件指纹”。
迁移要求当前绑定的 Appliance 处于在线状态。云端会回连到该 Appliance，请求其在本地自行吊销许可证，只有在此之后才会清除云端侧的指纹。这一握手过程确保旧的 Appliance 在新设备绑定时无法继续运行——避免同一许可证被意外双重使用。
解绑成功后：
- 按照安装的步骤设置新硬件，使用相同的 Instance Key。
- 新 Appliance 完成校验，绑定其硬件指纹，并成为活动设备。
旧硬件已损坏或无法访问时
如果先前绑定的 Appliance 已损坏或因其他原因无法连接，握手过程会超时，云端 UI 会显示 appliance_unreachable_contact_support。在这种情况下，请联系 IronFlock 团队——在核实所有权后，我们可以手动清除绑定关系。
提示：请在停用旧硬件之前、当其仍处于在线状态时发起迁移。当旧 Appliance 仍可访问时，整个流程对您和我们的支持团队而言都会快得多。