ego-browser 把 CitroLabs/ego-lite 接进 DeepSeek Harness，用结构化 ego_* 工具驱动浏览器并配实时观察窗。下面按阿里云 ECS 的部署路径列出要配的环境。
事实：仓库 Fisfzy/dsh-ego-browser，npm 包 dsh-ego-browser 0.8.6、插件本体 MIT；星标 195、综合分 64.4、周下载 880；本站已在 dsh 0.2.0-rc.2 下真实安装成功（L4 · 真实安装）；engines.dsh 地板 >=0.1.2-rc.1，Node ≥22；工具清单 README 两处口径不一致（33 / 32）。
ECS 实例规格与镜像
插件内置受管 Chrome/CDP 宿主（runtime/，MIT），但实例要留余量：单任务空间简单流程 2 vCPU / 4 GiB 起步，多任务空间或长会话应加内存而非 CPU。镜像用主流 Linux 发行版即可，关键是 Node ≥22 与任一 Chromium 系浏览器。
安全组、SSH 隧道与出网
入站只放行 SSH（22）；DSH Web / 观察窗端口是调试入口，不要开公网入站，走 SSH 隧道 ssh -L 9000:127.0.0.1:9000 <user>@<ecs-public-ip> 后本地访问。出网上，Linux 用 FFmpeg 时安装器从 GitHub 下载固定 tag 构建件，受限时可用 githubMirror 替换 https://github.com 前缀；无公网 IP 可用 NAT 网关。
无显示器、root、Docker 与浏览器发现
无显示器的云主机 / 容器已被兜住：内置 --no-sandbox wrapper 随包自带，root / Docker / 无显示器一键跑；但浏览器本体是硬前提，插件自动发现 Chrome / Chromium / Brave / Edge，最小化镜像里可能都没有，此时装上任一 Chromium 系浏览器，或用 EGO_LINUX_CHROME 指定路径。
X11、DISPLAY 与 FFmpeg 缓存
只有选 FFmpeg 后端、走显示来源采集时才碰到 X11：需要 Chromium 与 FFmpeg 共享 DISPLAY，无头云主机通常没有真实 X 显示。托管 FFmpeg 装到 ~/.dsh/cache/ego-browser/ffmpeg/，不写入插件目录；下载固定资源 SHA-256，只提取主程序。
DSH peer 包与安装命令
DSH peer 包不全在公共 npm registry，普通 pnpm install 可能解析 @deepseek-ai/* peer 失败，应走 DSH profile 安装；ECS 上更稳妥的是 dsh plugin --profile web add dsh-ego-browser。
坑一 · 包名旧了会挂进恢复模式
现象：DSH Desktop 2.0.5+ 启动挂恢复模式，报 @dsh-external/ego-browser 身份无效；因 2.0.5 起校验 profile 依赖名须等于包实际 name，而包名是 dsh-ego-browser。解决：把 profile 的 package.json 依赖键与 dsh.profile.bundles 条目两处都改。
坑二 · DSH 版本低于地板
现象：DSH 0.1.1-rc.x 装最新版不工作；因 engines.dsh 地板 >=0.1.2-rc.1，0.1.0/0.1.1-rc.x 需用 v0.8.0 及更早版本。解决：升级 DSH 或退回插件旧版。
坑三 · ECS 上找不到浏览器
现象：云主机发现不了 Chrome，工具调用失败；因插件自动发现 Chrome/Chromium/Brave/Edge，容器里可能都没有。解决：用 EGO_LINUX_CHROME 指定路径，root 下用自带 --no-sandbox wrapper。
坑四 · 没装 better-sidebar 或多装旧版
现象：观察窗只在右下角当浮动球，或外链拦截不生效；因 dsh-better-sidebar 非 peer 依赖（靠 ctx.get() 消费），urlTarget 需 v0.12.2+，低于此静默失效。解决：装且 ≥ 0.12.2（推荐 ≥ 0.17.1）；不装仍可用浮动观察球。
坑五 · FFmpeg 后端选不了或选了失效
现象：设置页选不了 FFmpeg，或已保存的后端后来失效；因 auto 不检测成功也不自动下载，Windows 必须是含 gfxcapture 的构建，解包依赖系统 tar。解决：用一键下载装兼容构建；Wayland 缺 Portal/PipeWire 时切回 CDP。
坑六 · 重启后要重新登录
现象：重启 DSH 后所有站点掉登录；因运行期 Cookie 仅优雅关闭时落盘，强杀不落盘。解决：重启前优雅关闭，或用 ego_login_import 从系统浏览器导入（配合磁盘持久化 Profile 可跨重启保留）。
总结
在阿里云 ECS 上跑 ego-browser，关键是把实例规格与镜像、安全组与 SSH 隧道、出网与公网 IP、浏览器发现、X11 与 DISPLAY、peer 包安装配齐；想对照同类插件的中文清单与安装形态见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合：云主机上长期托管 agent 浏览器任务的团队；用 ECS 做自动化表单 / 登录流程的开发与运维；在 Docker 里跑无头 DSH 会话、只需 ego_* 工具的场景；用 SSH 隧道远程查看观察窗的用户。不适合：要求内核级无头快照与大规模并发抓取的场景（Linux 用 CDP DOMSnapshot 重建语义树）；只在 TUI / headless 宿主上期待观察窗的用户；无法提供 DSH peer 包、只能普通 pnpm install 的环境。
标签：ego-browser、DeepSeek Harness、阿里云 ECS、云主机部署、环境配置
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
