安装部署

准备服务器，通过云账号或 SSH 部署 Margo Node，连接模型并完成可用性确认和升级。

Margo Node 在你的服务器上运行 Agent 和工具，MargoWork 工作台用于连接并操作它。下面按准备、部署、连接模型和确认可用的顺序完成；已有可用环境时，可以直接返回快速开始。

1. 准备服务器

项目	要求
CPU 与内存	推荐 1 核 CPU、2 GB 内存；内存不能低于 2 GB。
系统与架构	Linux x86_64，使用 systemd。
安装权限	root，或具备免密 sudo 权限的账号。
网络	服务器能下载安装包并访问所用模型服务；公网地址和访问入口可达。
SSH 部署	准备公网 IP、用户名和私钥，SSH 端口为 22。
云账号部署	准备所选厂商要求的凭据，并拥有目标实例的查询和部署权限。

安装程序还会检查公网 80 / 443 端口。已有服务占用端口、网络不可达或实例不满足条件时，先按具体提示处理。

云账号凭据、SSH 凭据和模型 API Key 用途不同：云账号或 SSH 用于部署服务器，模型 Key 用于让 Agent 调用模型。只配置前者还不能完成对话。

点击工作台左上角的服务器选择器，选择管理服务器，再点击添加。两种方式选择一种即可，完成后都需要回到 MargoWork 确认连接。

方式	需要填写什么	适用情况
云账号部署	云厂商凭据，选择云账号、产品和实例	通过界面列出的云厂商连接现有实例。
SSH 部署	公网 IP、用户名和私钥	已有服务器，能够通过 SSH 登录。

安装任务提交后，部分字段或方式切换会暂时锁定。先看当前任务的状态和可用操作，不重复创建另一条安装任务来替代结果确认。

选择云账号部署，页面逐行显示支持的云厂商。
在对应厂商右侧点击添加，填写并保存云账号凭据。
点击已添加账号的厂商行，展开服务器选择。首次展开只查询当前类型；支持轻量服务器的厂商默认先查询轻量服务器。
核对实例名称、地域、公网 IP 和状态，选择可部署实例。切换类型时，各类型首次查询一次；已加载的列表保存在本机，刷新网页后仍可复用。需要更新时，点击类型选择右侧的刷新图标。
点击部署 Server。
查看安装进度，等待服务器连接确认。

厂商 / 产品	凭据与准备差异
阿里云 ECS / 轻量应用服务器	使用 RAM 用户的 AccessKey ID 与 AccessKey Secret；选择与实例一致的云产品。
腾讯云 CVM / 轻量应用服务器	使用 CAM 用户的 SecretId 与 SecretKey；CVM 与轻量实例分开选择。
火山引擎 ECS	准备 AccessKey ID 与 SecretAccessKey；实例需有公网 IP，云助手需可用，并具备相应查询和部署权限。

当前能通过云账号部署的厂商，以界面提供的列表为准。其他服务器可使用满足上述条件的 SSH 部署。

实例列表为空时，先核对云账号和所选产品；实例不可选时，查看具体条件提示。查询失败与“没有实例”是两种情况，先使用当前页面的重试操作确认。

出现 SSH 登录失败时，检查用户名和私钥；连接失败或超时时，检查公网 IP、22 端口及防火墙。提示需要 sudo 时，确认账号具有免密 sudo 权限。

**SSH 连接中断不等于安装失败。**如果页面正在确认安装状态，先刷新或重试确认原任务，等明确结果后再决定是否重新部署。

只有页面明确确认安装和连接完成，才进入下一步。不要用加载动画消失、SSH 命令退出或输入框清空代替最终状态。

Server 准备就绪后，点击连接 AI 服务，配置当前 Node 使用的模型服务。也可以选择稍后设置，以后从设置中完成。

完整的服务商、API Key、OAuth、模型测试与保存流程见账户与配置。选择稍后设置只跳过本次配置步骤，不会让缺失的模型凭据自动可用。

完成标志：服务器连接成功，并且 Agent 使用所选模型返回了实际结果。

服务器已连接但任务失败时，按错误区分模型凭据、额度、网络和权限问题；常见处理见服务器连接问题与任务没有结果。

从服务器选择入口切换目标 Node，再核对当前 App、对话和文件范围。模型服务、MCP 和 Skills 配置需要在相应运行环境下确认。

切换环境不会自动把原环境的文件和配置搬到新环境。继续旧任务时，先回到原来的 Node 和 App。

打开服务器详情中的版本区域，查看当前版本与最新版本。出现可升级入口时，核对目标版本并确认升级。

重启会短暂中断连接，数据和配置保留。解绑、卸载是另外的管理操作，执行前阅读确认页面列出的影响范围；日常升级使用版本区域的升级入口。

升级后的具体排查见升级后仍显示旧版本。