DeepSeek Harness Web UI не открывается: разбор

Последнее обновление: 18 августа 2026 года. Команды и порядок проверки сверены с доступным README DeepSeek Harness, а коды ответов и ограничения — с официальной документацией DeepSeek API.

По опубликованной документации, CLI-компонент DeepSeek Harness устанавливается как отдельный пакет и предоставляет команду dsh; поэтому при симптоме «страница не открывается» первым делом нужно проверить не браузер, а сам процесс и адрес, который вывела команда. (github.com)

Рекомендация на эту неделю: не переустанавливайте окружение после первого сбоя. Сначала подтвердите, что dsh web действительно запущен, определите фактический локальный адрес, затем проверьте безопасный канал доступа, ключ DeepSeek API, выбор модели, рабочую область и только после этого — approvals и выполнение задачи. На удалённом Mac не следует сразу открывать локальный интерфейс в публичную сеть.

Эта статья предназначена:

• для разработчиков, которые впервые запускают Web UI на macOS и получают пустую страницу или ошибку соединения;
• для AI Agent-инженеров, у которых интерфейс загружается, но модель или рабочий каталог недоступны;
• для DevOps-специалистов, сопровождающих удалённые Mac-узлы и сетевой доступ к ним.

Одна и та же жалоба «DeepSeek Harness Web UI не открывается» может означать четыре принципиально разные ситуации:

1. команда не установлена или оболочка не видит dsh;
2. процесс стартует и сразу завершается;
3. процесс работает, но порт занят либо адрес введён неправильно;
4. страница открывается, но приложение не может загрузить модель, рабочую область или выполнить действие.

Если смешать эти состояния, восстановление превращается в повторную установку без доказательств причины. Мы рекомендуем фиксировать для каждого теста время, команду, полный вывод терминала и адрес, по которому выполнялась проверка.

У Web UI есть и скрытые ограничения, которые часто принимают за сбой интерфейса:

• локальный адрес на удалённом Mac не становится автоматически доступным с ноутбука;
• ключ, сохранённый в одном профиле или окружении, может не использоваться текущей сессией;
• каталог запуска и рабочая область могут быть разными сущностями;
• выполнение может ждать явного подтверждения операции, пока браузер выглядит «зависшим»;
• ошибка API может возникнуть после успешной загрузки страницы и не свидетельствует о падении веб-процесса.

Начните с терминала, в котором запускается сервис. Не закрывайте его до завершения первичной диагностики.

Проверьте наличие команды:

command -v dsh
dsh --help
dsh web --help

Если оболочка возвращает, что команда не найдена, проблема относится к установке или переменной PATH, а не к Web UI. Если dsh --help работает, но dsh web --help завершается ошибкой, сохраняйте этот вывод: он точнее описывает несовместимость версии или неверный синтаксис, чем сообщение браузера.

Затем повторите запуск:

dsh web

Проверьте три сигнала:

• команда остаётся активной и не возвращает приглашение оболочки сразу;
• в терминале появляется адрес для доступа;
• после запуска не выводятся сообщения о занятом порте, отсутствующей конфигурации или невозможности загрузить компонент.

Если процесс завершился, не переходите к проверке браузера. Сначала разберите последнюю строку журнала. На этом этапе не следует самостоятельно угадывать порт, путь конфигурации или переменную окружения: конкретные значения могут изменяться между версиями и должны подтверждаться текущим dsh web --help и фактическим логом.

Когда процесс вроде бы работает, откройте второе окно терминала и выполните:

ps aux | grep '[d]sh'

Если в выводе нет процесса, первоначальная команда не удержала сервис. Если процесс есть, проверьте, какой адрес слушается:

lsof -nP -iTCP -sTCP:LISTEN

Команда покажет активные TCP-порты, но связывать конкретный порт с DeepSeek Harness можно только после сопоставления PID и процесса. Это важнее, чем копирование адреса из старой вкладки браузера.

После подтверждения процесса протестируйте адрес с того же компьютера, где запущен dsh web. Если терминал вывел, например, локальный URL, используйте именно его, включая схему, имя хоста и порт.

Для базовой проверки можно применить:

curl -I http://127.0.0.1:ПОРТ

Здесь ПОРТ — фактическое значение из текущего вывода или справки, а не число из старой инструкции. Возможны несколько результатов:

• ответ HTTP получен — сервис отвечает, поэтому ищите ошибку в адресе браузера, прокси, расширении или удалённом канале;
• соединение отклонено — процесс не слушает этот адрес, завершился или используется другой порт;
• тайм-аут — проверьте интерфейс прослушивания и локальные правила фильтрации;
• ответ есть, но браузер показывает пустую страницу — сохраните заголовки и проверьте консоль браузера, не меняя сразу конфигурацию.

Не используйте старую вкладку как источник истины: после перезапуска адрес, профиль или порт могли измениться. Также не подменяйте localhost адресом удалённого имени без проверки DNS и маршрута.

Важно. Успешный curl на удалённом Mac доказывает только локальную доступность приложения на этом узле. Он не доказывает, что ваш ноутбук может безопасно и корректно подключиться к нему через сеть.

Локальный запуск и удалённый доступ — разные задачи. По умолчанию Web UI предназначена для обращения с того же узла, где запущен процесс. Если страница доступна на Mac, но не открывается на другом устройстве, сначала исключите сетевую проблему, а не меняйте настройки приложения.

Для временной проверки предпочтительнее защищённый SSH-туннель с локальным перенаправлением порта:

ssh -N -L ЛОКАЛЬНЫЙ_ПОРТ:127.0.0.1:УДАЛЁННЫЙ_ПОРТ пользователь@удалённый-mac

После установления туннеля браузер обращается к локальному адресу на вашем компьютере, а соединение передаётся к Web UI на удалённом Mac. Значения портов должны соответствовать текущему процессу; мы не рекомендуем подставлять их наугад.

Проверяйте канал в таком порядке:

1. войдите на удалённый Mac по SSH;
2. выполните там локальный curl;
3. оставьте SSH-сессию с перенаправлением активной;
4. откройте локальный адрес на рабочем компьютере;
5. сравните поведение страницы через туннель и непосредственно на удалённом узле.

Если локальный curl на удалённом Mac не работает, туннель ничего не исправит. Если локально всё работает, а через туннель нет, проверяйте SSH-параметры, правила доступа и соответствие портов.

В инструкции по удалённому Mac мы рекомендуем рассматривать сетевую публикацию как отдельный эксплуатационный проект, а не как быстрый способ «починить браузер». Без аутентификации, ограничения источников, журналов и понятного жизненного цикла сессий публичное прослушивание Web UI не является безопасным откатом.

Если страница открылась, но модель отсутствует в списке или задача не отправляется, переходите к конфигурации провайдера и ключа. Не путайте сохранение строки API Key с успешной проверкой доступа.

Нужно проверить:

• ключ сохранён в том профиле, который использует текущая Web UI;
• в значении нет пробела в начале или конце;
• выбран правильный провайдер и endpoint;
• имя модели совпадает с актуальным каталогом;
• удалённый Mac имеет исходящий доступ к API;
• системное время и сертификаты на узле не вызывают ошибку TLS;
• после изменения ключа создана новая сессия или выполнена повторная загрузка конфигурации.

В официальной таблице ошибок DeepSeek API код 401 означает ошибку аутентификации, 402 — недостаточный баланс, 422 — некорректные параметры, 429 — превышение ограничения частоты, а 500 и 503 относятся к серверной ошибке и перегрузке соответственно. (api-docs.deepseek.com)

Сохраняйте код ответа и тело ошибки, но не публикуйте сам ключ. Для быстрой классификации:

• 401 — повторно проверьте ключ и профиль;
• 402 — проверьте состояние баланса;
• 422 — сверяйте параметры запроса и модель;
• 429 — уменьшайте параллелизм и частоту повторов;
• 500/503 — повторите запрос после паузы и сравните результат с минимальной задачей.

Актуальные имена моделей и endpoint следует сверять по официальной странице моделей и стоимости DeepSeek API, а формат запроса — по документации метода создания чат-комп completion. Название модели из старой конфигурации нельзя считать действующим только потому, что оно раньше отображалось в интерфейсе. (api-docs.deepseek.com)

Симптом «рабочую область нельзя выбрать» обычно связан не с моделью, а с состоянием файловой системы. Новая Web UI должна получить добавленный и выбранный рабочий каталог; место, из которого запущена команда, может быть лишь стартовой директорией процесса.

Проверьте путь на том же Mac, где работает dsh:

pwd
ls -ld /путь/к/проекту
test -d /путь/к/проекту && echo "каталог существует"

Затем убедитесь, что пользователь процесса может читать каталог:

find /путь/к/проекту -maxdepth 1 -type f -print

Не ограничивайтесь проверкой через Finder или вашу локальную IDE. На удалённом узле путь может отличаться, репозиторий может находиться в другом домашнем каталоге, а процесс — запускаться под другим пользователем.

Проверяйте три условия:

1. каталог существует именно на удалённом Mac;
2. пользователь, запустивший dsh web, имеет права чтения и необходимые права записи;
3. рабочая область не находится на отключённом томе, сетевом ресурсе или каталоге, доступ к которому требует интерактивного разрешения.

После исправления пути перезагрузите страницу и создайте новую сессию. Если старое состояние продолжает показывать недоступный каталог, не делайте вывод, что исправление не сработало: интерфейс мог сохранить прежний контекст.

Когда страница и модель работают, но задача не завершается, разделите ожидание на три слоя:

• Web UI ждёт подтверждения операции;
• DeepSeek API ещё обрабатывает запрос;
• сессия или сетевой канал потеряли состояние.

Сначала ищите в интерфейсе запрос на approval: выполнение команды, изменение файла, доступ к рабочей области или другой потенциально опасный шаг может требовать явного действия пользователя. Если подтверждение ожидается, пустая область ответа не равна падению агента.

Затем смотрите журнал терминала и сохраняйте:

• время отправки;
• идентификатор или текст ошибки;
• HTTP-код;
• название модели;
• размер задачи в общих чертах;
• момент последнего ответа от сервера.

Официальная документация DeepSeek указывает, что если инференс не начался в течение 10 минут, сервер закрывает соединение; для длительных запросов могут также использоваться keep-alive-пустые строки или комментарии SSE. (api-docs.deepseek.com) Это означает, что длительное ожидание нельзя диагностировать только по индикатору в браузере.

Для проверки используйте минимальную задачу без побочных эффектов: прочитать один небольшой файл, вывести его структуру или вернуть короткий текст без записи на диск. Не запускайте сразу миграцию, массовое переименование или установку зависимостей — такая задача не позволяет отличить approval от API-задержки и файловой ошибки.

dsh web запущен, но браузер не открывает страницу

Сначала проверьте, что процесс не завершился и адрес взят из текущего терминала. Выполните локальный curl, сопоставьте PID с прослушиваемым портом и только затем проверяйте браузер. Если локальный HTTP-ответ есть, проблема уже относится к адресу, прокси или удалённому маршруту, а не к установке DeepSeek Harness.

Как выбрать рабочую область в DeepSeek Harness

Добавьте каталог через Web UI и выберите его как отдельную рабочую область. Не считайте текущую директорию запуска автоматически выбранной. На удалённом Mac проверяйте путь непосредственно на сервере: локальный путь Finder, SSH-путь и путь процесса могут не совпадать, особенно при запуске под отдельной учётной записью.

Ключ сохранён, но модель всё равно недоступна

Сохраните копию конфигурации без секретного значения, проверьте активный профиль, endpoint и точное имя модели, затем создайте новую сессию. Если в журнале есть HTTP-код, используйте его для классификации: 401 требует проверки аутентификации, 429 — контроля частоты, а 503 — повторной попытки после паузы.

Как проверять Web UI на удалённом Mac

Сначала выполните локальный тест на удалённом узле, затем используйте SSH-туннель. Не публикуйте локальный интерфейс в интернет до настройки сетевых ограничений, аутентификации и журналирования. Такой порядок позволяет точно установить, неисправно ли приложение или только внешний маршрут доступа.

После исправления отдельных симптомов не возвращайтесь сразу к рабочей задаче. Выполните короткую приёмку:

• [ ] страница открывается по актуальному адресу;
• [ ] выбранная модель отображается в интерфейсе;
• [ ] тестовый запрос возвращает ответ;
• [ ] рабочая область указывает на существующий каталог;
• [ ] агент читает небольшой файл без изменения содержимого;
• [ ] команда без побочного эффекта выполняется после approval;
• [ ] новая сессия сохраняется и восстанавливается после обновления страницы;
• [ ] в журнале нет повторяющихся 401, 422, 429 или 503.

Перед перезапуском сохраните конфигурацию без API Key, список выбранной модели, путь рабочей области, команду запуска и фрагмент журнала с временем. Секреты переносите отдельно и не включайте их в скриншоты, тикеты или shell history.

Выбирайте откат, если после изменения версии одновременно нарушились запуск, загрузка модели и состояние рабочей области; если сломан только один слой, сначала сохраняйте текущие логи и откатывайте именно конфигурацию, а не всю систему. Для долгоживущего удалённого узла полезно иметь проверенный снимок окружения или акт поставки, чтобы следующий апгрейд не превращался в восстановление «с нуля».

Если текущая схема построена на случайном домашнем Mac, ручном пробросе портов и неповторяемой конфигурации, её слабые места очевидны: трудно восстановить исходное состояние, сложно отделить сетевую ошибку от ошибки процесса, а повторный запуск часто зависит от конкретного пользователя и открытого терминала. Для временной работы или проверки DeepSeek Harness аренда удалённого Mac через доступные варианты Mac-окружения JEXCLOUD может быть рациональнее: вы получаете заранее определённый узел, фиксируете способ доступа и сохраняете процедуру возврата. При этом для постоянной тяжёлой нагрузки, требования к физическим портам или полностью автономной работы собственный Mac всё ещё может оказаться лучшим выбором.

После успешной диагностики сохраните снимок среды, команду запуска и проверенный порядок доступа — это даст более предсказуемый результат при следующем обновлении, чем повторная установка DeepSeek Harness по памяти.