> ## Documentation Index > Fetch the complete documentation index at: https://docs.devin.ai/llms.txt > Use this file to discover all available pages before exploring further. # 气隙环境下的 Devin Desktop 与 CLI > 面向管理员的气隙版 Devin Desktop 与 CLI 概述：Cognition 提供哪些内容、你需要准备哪些内容、身份验证方式以及所使用的端点。 > [!NOTE] > > 本文档适用于 Devin 的联邦部署。[返回 Devin 文档](/zh/get-started/devin-intro) 气隙版 Devin Desktop 和 Devin CLI 专为无法访问互联网的网络环境而设计。推理请求会发送到你自行托管的模型端点，访问权限由经过签名并在本地校验的许可证文件控制，所有事件都会写入本地审计日志。 本指南面向负责安装、配置和维护该产品的管理员，采用运行手册的形式编排：每个页面介绍部署的一个环节，并在末尾列出可能遇到的错误代码及处理方法。 > [!NOTE] > > **Beta 版。** 气隙版目前以 Beta 版形式提供，支持的平台包括 macOS (Apple 芯片和 Intel) 、Linux (x86\_64 和 aarch64) 以及 Windows (x64 和 arm64) 。 *** ## 产品构成 | 组件 | 功能 | | - | - | | **Devin Desktop (气隙版) ** | 桌面应用程序，从门户的气隙下载页面安装。它内置气隙版 Devin CLI 作为智能体，并在本地与其通信。它不支持 cloud 登录，不包含 Cascade，也不会自动更新。 | | **Devin CLI (气隙版) ** | 终端智能体。既可在 shell 中独立运行 (`devin`) ，也可作为 Desktop 内的智能体运行。它从你编写的模型文件中读取模型目录，并从你安装的许可证文件中读取授权信息。 | Desktop 与其内置的 CLI 基于同一个发布版本 commit 构建，因此单个 Desktop 文件包即可完成一次完整且自洽的安装。 ## 开始之前 ### 由 Cognition 提供 | 项目 | 相关说明 | | - | - | | 门户访问权限，并已为您的团队开通处于活跃状态的本地部署授权 (由您的账户团队设置) | [安装](/zh/federal/air-gapped/install) | | 门户气隙下载页面上提供的 Desktop 文件包 (以及 Desktop 隧道 CLI) ，并附有 SHA-256 校验和 | [安装](/zh/federal/air-gapped/install)、[更新](/zh/federal/air-gapped/updates) | | 由门户签发的已签名许可证文件；用于验证这些文件的公钥已内嵌在二进制程序中 | [许可证](/zh/federal/air-gapped/license) | ### 你需要提供 | 项目 | 相关说明 | | - | - | | 一台运行受支持平台的主机，并已将许可证文件安装到 `/etc/devin/license.devin-onprem-license` (Windows：`C:\ProgramData\Devin\license.devin-onprem-license`) 或 `DEVIN_LICENSE_FILE` 指定的路径 | [许可证](/zh/federal/air-gapped/license) | | 您网络内的一个或多个兼容 OpenAI 的模型端点，需在模型文件中进行配置，该文件位于 `/etc/devin/models.json` (Windows：`C:\ProgramData\Devin\models.json`) 或 `DEVIN_MODELS_FILE` 指定的路径 | [模型文件](/zh/federal/air-gapped/models-file) | | 可选：一个 OIDC 身份提供商，用于在许可证之外额外要求用户登录 | [SSO (单点登录) ](/zh/federal/air-gapped/sso) | | 可选：如果您的模型端点或 IdP 使用的证书不在操作系统信任存储中，则需提供私有 CA 文件包 | [网络与证书](/zh/federal/air-gapped/network-and-certificates) | ## 产品使用的端点 气隙版 CLI 和 Desktop 完全通过主机上的文件进行配置。它们使用的端点就是你所配置的端点： * 您的模型文件中列出的**模型端点**。不存在 cloud 模型目录：模型列表、模型选择器和推理路由均来自该文件。端点必须使用 `https://`；只有回环主机 (`localhost`、`127.0.0.0/8`、`[::1]`) 才接受普通的 `http://`，例如运行在同一台机器上的 vLLM 或 Ollama 服务器。 * **您的身份提供商** (如果你启用了 SSO (单点登录) ) 。CLI 会读取签发方的 OIDC 自动发现文档，并使用其中的授权端点、令牌端点和 JWKS 端点。 * 你在本地配置的 **MCP 服务器** (如有) 。 * **门户** (`windsurf.fedstart.com`) ，管理员通过浏览器访问该门户，下载文件包并签发许可证。 审计日志和诊断信息报告均写入本地磁盘。`devin update` 已禁用；新版本需使用从门户下载的文件包进行安装 (参见[更新](/zh/federal/air-gapped/updates)) 。 ## 访问控制方式 1. **许可证** (始终启用) 。CLI 启动时，会使用嵌入在二进制程序中的公钥验证许可证文件的签名和有效期。如果没有有效的许可证，CLI 将无法启动；请参阅[许可证](/zh/federal/air-gapped/license)。 2. **SSO (单点登录) ** (可选) 。如果你创建了一个指定 `"mode": "sso"` 的认证文件，则每个用户还必须通过 `devin auth login` 登录您的 IdP。你可以将登录权限限定为指定组的成员，正在运行的会话也会根据缓存的令牌重新验证；请参阅 [SSO](/zh/federal/air-gapped/sso)。 这两种机制均由 CLI 强制执行，因此无论是单独在终端中使用，还是 Desktop 中的智能体，都同样适用。 ## 后续步骤 > **[安装](/zh/federal/air-gapped/install)** > > 从门户下载并校验安装包，完成安装后运行首次健康检查。 > **[错误代码](/zh/federal/air-gapped/error-codes)** > > 完整的 `LIC`、`IDP`、`MDL`、`NET` 和 `CFG` 错误代码目录，以及运维人员的相应处理措施。 > **[故障排查](/zh/federal/air-gapped/troubleshooting)** > > `devin airgap doctor` 运行手册，以及需要提交给支持团队的信息。 > **[磁盘存储格式](/zh/federal/air-gapped/on-disk-formats)** > > 各操作系统下的配置路径，以及供 SIEM 摄取的审计日志 JSONL schema。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.