DeepSeekDSH
修复报错EnglishGitHub
菜单
独立社区指南与 DeepSeek 无隶属关系。下载版本与教程参考
首页报错修复

Browser Did Not Open Automatically

DeepSeek Harness 启动后浏览器没有自动打开，先确认终端出现服务地址，再手动复制完整 Web UI URL 访问。页面按本机、无图形环境和远程 SSH 场景说明处理方法，检查浏览器、启动参数与端口转发。浏览器未弹出但手动访问成功时，可继续配置模型；仍无法访问则转查进程、监听端口和连接错误，并保留终端输出。

维护：DeepSeekDSH（独立站点）
本页内容

核对错误信息

在页面或终端中查找下面的错误码或提示词。完整信息可能因操作系统和版本不同而略有差异。

Browser did not open automatically
browser did not open
web browser did not launch
DSH browser not opening

搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。

处理要点

终端显示 DSH 已就绪时，把它打印的 URL 复制到同一台电脑的浏览器中。DSH 通过 SSH 运行时，先建立端口转发。只有你本来就不希望自动打开浏览器时，才使用 --no-open。

错误含义

即使系统没有自动打开浏览器，DSH Web 服务仍可能已经正常运行。

常见原因

  • 默认浏览器拉起失败。
  • DSH 运行在 SSH 或无桌面的环境中。
  • 桌面策略阻止程序自动打开浏览器。
  • 启动命令使用了 --no-open。

对应文档与源码

DSH 相关链接固定到 0.1.5-rc.2 / c291e79；涉及系统和运行环境的说明见对应官方文档。

Browser launcher implementationWeb Bundle 中有独立的 openBrowser() 启动逻辑。打开浏览器只是服务启动后的便利步骤，因此浏览器窗口没弹出并不等于 Web Server 启动失败。Official quick startREADME 说明本机启动会打开默认浏览器，而 SSH 启动只打印宿主机 URL；同时也支持 --no-open。

修复步骤

  1. 01

    确认 DSH 已经就绪

    查看终端最后打印的 Web UI URL，并确认后面没有继续出现启动错误。

  2. 02

    在同一台电脑手动打开 URL

    把终端打印的准确地址复制到浏览器，使用 DSH 时不要关闭终端。

  3. 03

    SSH 场景建立端口转发

    在自己的电脑上执行下面命令，保持 SSH 连接，再访问本地 http://127.0.0.1:3080。

    ssh -L 3080:127.0.0.1:3080 user@server
  4. 04

    确实不需要自动打开时使用 --no-open

    这个官方参数只启动服务并打印 URL，不尝试打开浏览器。

    npx @deepseek-ai/dsh web --no-open

检查结果

  • 手动打开的 URL 可以加载 DSH。
  • 使用 Web UI 时终端进程保持运行。
  • SSH 场景下端口转发连接保持打开。
不要做什么
  • 查看终端 URL 前，不要把“没有自动打开”直接判断为服务失败。
  • 不要为了方便把 DSH 服务直接暴露到公网。

常见问题速查

Browser did not open automatically 怎么修？

终端显示 DSH 已就绪时，把它打印的 URL 复制到同一台电脑的浏览器中。DSH 通过 SSH 运行时，先建立端口转发。只有你本来就不希望自动打开浏览器时，才使用 --no-open。

Browser did not open automatically 是什么意思？

即使系统没有自动打开浏览器，DSH Web 服务仍可能已经正常运行。

怎么确认 Browser did not open automatically 已经修好？

手动打开的 URL 可以加载 DSH。 使用 Web UI 时终端进程保持运行。 SSH 场景下端口转发连接保持打开。

来源与版本

本页于 2026-09-11 对照官方仓库核验。网站使用的已发布版本基线为 0.1.5-rc.1；源码核验快照为 0.1.5-rc.2（c291e79）。

官方 README、核验时的源码、GitHub Discussions