跳到主要内容
版本:0.8.4

规划和部署

选择 Engine 主机​

macOS、Windows 和 Linux 都可以运行完整的 Clawuno Engine,供远程用户连接。操作系统并不决定一台电脑是不是“服务器”;真正的差别在于 Engine 的生命周期由什么管理。

主机形态可供远程用户访问生命周期与适用场景
Apple Silicon Mac 上的 macOS App可以App 管理本机 Engine。Mac 用户必须保持登录,Clawuno 也必须保持运行。适合有人管理的工作站或小型共享部署。
Windows x64 Desktop App可以Desktop 与 EngineHost 运行在已登录用户的会话中。适合有人管理的工作站或小型共享部署。
Linux x64 / ARM64 Docker可以Docker 管理不依赖桌面会话的 Engine-only 部署。最适合无人值守、持续在线或由管理员集中运维的服务器。

macOS 和 Windows 安装包都包含可供远程用户使用的完整 Engine 与 Web Client,并不是只能作为客户端。Linux Docker 更适合长期在线,但不是唯一可以作为服务器的平台。

准备 macOS 或 Windows 主机​

  1. 按照分平台安装指南安装正式 0.8.4 App,打开 App 并完成首次设置。
  2. 让主机用户保持登录,并让 Clawuno 保持运行。明确退出 App 会停止它管理的 Local Engine,并中断该 Engine 上正在执行的工作。
  3. 完成本机设置后,在 系统设置 → 用户 → 设置远程登录 补充真实邮箱和密码,再开放远程访问或开通团队版;从计划使用的受保护地址验证登录。
  4. 按下方网络边界为 Engine 提供稳定、受保护的访问地址,并明确谁负责主机会话、App 更新、备份和重启恢复。

准备 Linux 主机​

  • x86-64 或 ARM64 Linux 宿主机;
  • Docker Engine 与 Docker Compose v2;
  • Python 3.9+、curl 和 openssl;
  • 安装和解压至少预留 12 GiB 可用空间,另加实例备份所需空间;以目标版本的容量检查为准;
  • 独立的持久化数据目录;
  • 由管理员控制的备份目标;
  • 远程用户访问时所需的 DNS 与 TLS 终止。

Docker Engine 和 Compose 是独立前置条件,不由 Clawuno 发布 CDN 提供。部署前确认可以访问 daemon。

从 0.8.4 起,Linux 发行在全球统一使用 CDN,不按地区选择来源,也不再新增 GHCR 发行。首次安装或所有现有 0.8.1–0.8.3 安装的一次性迁移,都运行:

curl -fsSL https://releases.clawuno.com/install.sh | bash

迁移会更新选定实例与宿主管理工具,并保留数据。请先等待正在执行的工作结束。如需指定实例并固定目标版本:

curl -fsSL https://releases.clawuno.com/install.sh | bash -s -- --version 0.8.4 --instance NAME

将 NAME 替换为目标实例,或改用 --dir /absolute/deployment/path。无人值守迁移须添加 --yes 明确授权中断正在执行的工作;未获该授权时,不应把此参数加入自动化任务。

迁移后使用 sudo clawuno upgrade,可添加 --version VERSION,以及 --instance NAME 或 --dir PATH;自动化须以 --yes 明确授权中断。非交互多实例场景必须明确选择目标。

签名发布元数据验证归档大小、SHA-256 和镜像身份。缓存归档与已加载镜像只有验证通过后才可复用,不能只信任 tag。已有下载文件可通过安装器或升级命令的 --archive /absolute/path/image.tar.gz 提供,仍须匹配签名元数据。同镜像升级不会重启 Engine 或改动数据,即使宿主管理工具发生更新。

install-cn.sh 保留为原样传递参数的兼容别名,不再是地区选项。历史签名文件、归档及已发布镜像保留用于恢复,不删除或改写。升级失败后须恢复匹配的镜像与数据快照,不要用旧代码运行可能已迁移的数据。迁移与自动化示例见 Linux 安装指南。

容器以非 root 用户运行,不挂载 Docker Socket,程序文件系统只读,持久化状态位于外部数据目录。不要把宿主机根目录、管理员凭据或 Docker Socket 挂载给 Clawuno。

从其他电脑连接​

macOS 和 Windows App 都可以作为客户端,连接运行在 macOS、Windows 或 Linux 上的远程 Engine:

  1. 从 App 标题栏或应用菜单打开 Engine 连接;
  2. 选择 添加远程 Engine;
  3. 填写名称和受保护的 Engine 地址,然后选择 验证并连接;
  4. 使用该 Engine 上已经配置的账号登录。

普通桌面浏览器或手机浏览器也可以直接打开 Engine 网址。浏览器客户端不提供原生 Desktop Browser Tab、本机文件夹选择和 App 托管更新等能力。

把某个 Desktop 窗口切换到远程 Engine 不会迁移数据,也不会停止本机 Engine。Agent 执行、Managed Chromium、Office 处理、Workspace 文件和定时 Work 都留在当前选择的 Engine 主机;Desktop Browser Tab 和本地下载则发生在客户端电脑。Linked Folder 因此必须是 Engine 主机能够访问的目录,而不是只存在于远程客户端上的目录。

网络边界​

无论使用哪个主机平台,都不要把 Engine 原始端口直接暴露到公网。需要远程访问时:

  1. 让 Engine 位于防火墙之后、私有网络中,或只通过受控隧道访问;
  2. 优先使用管理员维护的反向代理终止 HTTPS;也可以使用私有组网或 loopback 隧道建立受控访问路径;
  3. 一致转发原始公开 origin;
  4. 用防火墙限制到允许的网络;
  5. 经反向代理验证登录、流式响应、文件上传下载和长时间请求。

macOS 与 Windows Desktop 可以保存用户明确输入的 HTTP 地址,但 App 会持续提示登录信息、聊天和文件可能被监听或篡改。常规远程访问应使用 HTTPS。不要把 9700 端口直接暴露到公网。

Linked Folder​

只挂载明确批准的目录。Linked Folder 保持原有所有权与备份策略。Clawuno 不应为了让挂载可用而递归修改宿主数据的所有权。

开放给同事使用前检查​

确认版本与安装目标一致(0.8.4),并验证管理员与远程用户登录、主机重启/退出行为、模型访问、Workspace/Agent 创建、文件上传下载、Office 预览、Engine Browser、定时 Work,以及存放在程序安装目录之外的备份。使用 macOS 或 Windows 作主机时,还要验证主动退出主机 App 后远程访问会明确失败,并在已登录的主机用户重新启动 Clawuno 后恢复。