Что значит http://127.0.0.1:3080 в DeepSeek Harness
Сообщение http://127.0.0.1:3080 означает, что веб-интерфейс привязан к локальному адресу. Используйте SSH-туннель для доступа к нему. Публикация порта 3080 в сеть небезопасна.
Что означает dsh web: http://127.0.0.1:3080
При запуске веб-профиля DeepSeek Harness на VPS выводится строка следующего вида, после чего процесс ожидает:
dsh web: http://127.0.0.1:3080/?token=...127.0.0.1 — это loopback-адрес. Это адрес, который машина использует для взаимодействия с самой собой. Сокет, привязанный к 127.0.0.1, принимает соединения только от процессов на этой же машине и ниоткуда больше. Таким образом, эта строка сообщает две вещи одновременно: где прослушивается веб-интерфейс и кто имеет право к нему обратиться. Только машина, на которой запущен dsh. Часть ?token= в конце — это уникальный случайный ключ доступа, который процесс генерирует при каждом запуске. Подробнее об этом ниже.
Именно поэтому URL не работает, если вставить его в браузер на вашем ноутбуке. 127.0.0.1 вашего ноутбука — это сам ноутбук. Harness прослушивает 127.0.0.1 на VPS, а это другая машина с собственным стеком loopback. Ничего не сломано. Вам нужно перенаправить соединение.
В официальном README значение по умолчанию указано прямо: «Команда запускает веб-интерфейс на http://127.0.0.1:3080 по умолчанию и открывает его в браузере по умолчанию при локальном запуске». При работе через SSH браузер открыть негде, поэтому URL остается вам для ручного использования. Адрес привязки задается плагином веб-сервера @deepseek-ai/dsh-host-webserver. В версии 0.2.0-rc.2, которую мы используем в этом руководстве, ключ host описан как «Listen host; поддерживаются два значения: loopback и all-interfaces». Loopback используется, если вы не измените настройки. Если концепция портов для вас нова, как работают порты в Linux описывает модель «адрес плюс порт», на которой всё это базируется.
Почему веб-интерфейс привязывается только к localhost
dsh — это агентская оболочка, которая является программой, управляющей моделью: она контролирует цикл работы, вызовы инструментов и права, с которыми эти вызовы выполняются. Вкладка браузера — это панель управления процессом, который запускает shell-команды, читает и записывает файлы в выбранной вами рабочей директории и расходует ваш API-ключ модели. Любой, кто может открыть эту страницу, получает все возможности пользователя, от имени которого запущен dsh. Сеть — не единственный путь к получению такого доступа: установленный плагин работает в том же процессе с теми же правами, поэтому проверка dsh-плагина перед установкой требует такой же осторожности, как и выбор того, на каком интерфейсе слушает сервер.
Таким образом, порт 3080 — это не просто панель мониторинга для чтения. Загрузка этой страницы дает возможность выполнения команд на сервере.
Открыв указанный URL, вы сразу попадаете в список сессий. Здесь нет экрана входа и нет учетных записей пользователей. Доступ к странице ограничивается токеном в конце URL: корневая страница обменивает его на подписанный сессионный cookie и перенаправляет на чистый адрес. После этого каждый RPC-вызов и WebSocket-поток, который UI выполняет без валидного cookie, получает 401 Unauthorized. Однако не всё на этом порту защищено. Документация плагина Connection гласит, что статические ресурсы остаются публичными, а сам веб-сервер не имеет общесерверной аутентификации или политики происхождения, поэтому каждый плагин, владеющий маршрутом, устанавливает свои правила. На этих защищенных маршрутах плагин Connection также отвечает 403, когда заголовок Host не является loopback-адресом или хостом, которому вы явно доверяете. На loopback-интерфейсе это разумный второй уровень защиты после основного контроля доступа, который обеспечивает операционная система, пропуская только локальные процессы. Это не повод открывать порт наружу. Токен остается в истории вашего терминала и в любом логе, куда попал вывод при запуске. Руководство проекта по reverse proxy прямо указывает, что ни проверка Host, ни опубликованный URL не защищают сам слушающий порт. Документация веб-сервера предупреждает, что привязка к адресу, отличному от loopback, «все равно открывает незащищенные маршруты и статические ресурсы для этой сети». А в версии 0.2.0-rc.2 плагин веб-сервера не имеет собственной поддержки TLS. Автоматизированные сканеры постоянно проверяют редкие порты, поэтому считайте, что опубликованный порт 3080 будет обнаружен.
Не открывайте порт 3080 в вашем firewall и не устанавливайтеhostвеб-сервера в значение0.0.0.0или в ваш публичный IP-адрес на публичном VPS. Такая комбинация делает выполнение команд на вашем сервере доступным любому, кто узнает URL.
Текущие релизы уже подталкивают вас к этому: флаг --host самого веб-приложения запрещает привязку ко всем интерфейсам. Однако в версии 0.2.0-rc.2 ключ конфигурации host плагина веб-сервера все еще принимает 0.0.0.0, поэтому правка конфигурации все еще может открыть его. Документация веб-сервера в основной ветке проекта и в релизе 0.2.1-rc.5, на который сейчас указывает тег latest в npm, идет дальше: она отклоняет неопределенный адрес при загрузке и добавляет опциональную настройку tls. Она по-прежнему принимает любой конкретный адрес локального интерфейса, поэтому указание host на публичный IP вашего VPS все так же открывает UI.
Та же логика применима к любой среде выполнения агентов, которую вы размещаете на сервере, поэтому безопасный запуск агента для программирования на VPS начинается с того же правила: управляющий порт агента остается приватным, а доступ к нему осуществляется через доверенный вами инструмент.
Как открыть веб-интерфейс dsh с моего ноутбука?
Существует три надежных способа, и каждый из них оставляет привязку harness к интерфейсу loopback.
- SSH-туннель. Никакие новые службы не прослушивают публичный интерфейс, а учетные данные у вас уже есть. Это рекомендуемый способ.
- Частная оверлейная сеть, благодаря которой интерфейс доступен с ваших устройств и скрыт от всех остальных.
- Reverse proxy, который выполняет TLS termination (transport layer security) и требует пароль перед пересылкой любого запроса.
Разница между ними заключается в том, как именно ваш браузер получает доступ к loopback. Ни один из этих способов не требует переноса harness с интерфейса loopback.
Доступ через SSH-туннель
Выполните эту команду на своем ноутбуке, а не на VPS:
ssh -N -L 3080:127.0.0.1:3080 you@your-vpsОставьте процесс запущенным, затем откройте в локальном браузере полный URL dsh, который был выведен в консоль, http://127.0.0.1:3080/?token=... вместе с токеном. Веб-интерфейс загрузится, обменяет токен на сессионную cookie и удалит токен из адресной строки. Ваш браузер отправит 127.0.0.1:3080 в качестве заголовка Host, что соответствует loopback-адресу, поэтому туннель пройдет проверку Host без дополнительной настройки.
Аргумент -L содержит три поля, разделенных двоеточиями. Первое — порт, который нужно открыть на вашем ноутбуке. Второе и третье — адрес и порт, на которые будет перенаправлено каждое соединение. Важная деталь: 127.0.0.1 в среднем поле разрешается SSH-сервером на VPS уже после того, как трафик туда поступил. Это означает loopback-адрес самого VPS, а не вашего компьютера. Именно этот адрес dsh был выведен в консоль, поэтому туннель работает, в отличие от прямого подключения через браузер.
-N указывает SSH не запускать удаленную команду, поэтому вы получаете только перенаправление портов без оболочки. Для фонового туннеля, который сообщает об ошибках, а не молчит:
ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps-f переводит процесс в фоновый режим после аутентификации. ExitOnForwardFailure=yes важнее, чем кажется: без этого флага SSH успешно установит соединение, даже если перенаправление не удалось, и вы получите рабочую сессию с неработающим туннелем без предупреждения. ServerAliveInterval=30 отправляет keepalive каждые 30 секунд, чтобы простаивающий туннель не разрывался из-за таймаутов NAT на роутерах в кафе или отелях.
Что вы должны увидеть
На VPS проверьте, какой адрес фактически прослушивается:
ss -ltnp | grep 3080Корректный результат указывает на loopback-адрес:
LISTEN 0 511 127.0.0.1:3080 0.0.0.0:* users:(("node",pid=1042,fd=21))Если в колонке локального адреса указано 0.0.0.0:3080, значит, веб-интерфейс доступен на всех интерфейсах, включая публичный. Публичный IP вашего VPS в этой колонке означает ту же проблему. Остановите процесс и исправьте привязку (bind), прежде чем продолжать. Если ss показывает сокет, но оставляет поле users: пустым, запустите команду с sudo, так как в противном случае имя процесса для сокета, принадлежащего другому пользователю, скрыто.
Если туннель не запускается
SSH выводит следующее сообщение и завершает работу:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080Проблема на стороне вашего ноутбука, а не сервера. Какой-то локальный процесс уже занял порт 3080, часто это старый туннель, который вы забыли закрыть. Выберите другой свободный локальный порт:
ssh -N -L 3081:127.0.0.1:3080 you@your-vpsИзменилось только первое поле, теперь переходите по адресу http://127.0.0.1:3081/?token=... с тем же токеном, пока процесс продолжает слушать порт 3080. Эти два числа не обязаны совпадать. Сессионная cookie привязана к хосту и порту в адресной строке, поэтому для нового локального порта нужно снова использовать URL с токеном.
Если туннель поднялся, но браузер сообщает об отказе в соединении или пустом ответе, значит, трафик дошел до VPS, но на той стороне ничего нет. Либо процесс dsh завершился, либо он привязался к другому порту. Проверьте это с помощью ss -ltnp | grep 3080 на сервере. Если страница возвращает 401 Unauthorized, значит, туннель в порядке, а у вашего браузера просто нет валидной cookie для этого адреса: откройте выведенный URL еще раз, включая токен. После перезапуска берите URL из нового вывода, так как каждый процесс генерирует новый токен.
Еще один нюанс. Фоновый процесс npx @deepseek-ai/dsh web завершается при закрытии оболочки, поэтому туннель упадет, как только вы выйдете из системы. Запускайте его внутри tmux или как пользовательский сервис systemd, что решает ту же проблему, описанную в поддержании работы агента кодирования на VPS. В systemd строка dsh web: вместе с токеном попадает в лог сервиса, поэтому читайте данные оттуда. Пока вы работаете с SSH, стоит сначала выполнить укрепление безопасности SSH на вашем VPS, так как туннель делает ваш SSH-логин единственным входом к агенту.
Доступ через частную оверлейную сеть
Оверлейная сеть предоставляет вашему VPS и ноутбуку адреса в частной сети, к которой подключаются только ваши устройства. Tailscale — популярный выбор, и его команда serve идеально подходит для этого случая: tailscaled запускается на VPS и подключается к localhost:3080 напрямую, поэтому связка остается на loopback-интерфейсе.
tailscale serve --bg localhost:3080
tailscale serve statusИнтерфейс становится доступен по имени вашего устройства внутри tailnet по протоколу HTTPS, при этом открывать порты на публичном интерфейсе не требуется. Для этого необходимо включить HTTPS-сертификаты для вашего tailnet, иначе serve не сможет предоставить сертификат. Поскольку браузер теперь отправляет имя tailnet в качестве заголовка Host, запускайте связку с доверенным именем, иначе API-запросы получат 403. Запись без указания порта соответствует любому порту:
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.netЗатем откройте https://your-vps.your-tailnet.ts.net/?token=..., используя токен из вывода команды. Чтобы отключить доступ, повторите команду с флагом off:
tailscale serve --https=443 offИспользуйте serve, никогда не используйте funnel. Функция Funnel публикует тот же целевой ресурс в публичный интернет, что выставляет среду выполнения агента на открытый порт, защищенный только URL-токеном. Эти две команды выглядят почти одинаково, но выполняют противоположные действия, поэтому ознакомьтесь с разницей между Tailscale Serve и Funnel перед вводом любой из них. В статье Tailscale как частная сеть описан процесс настройки.
Доступ через reverse proxy с проверкой пароля
Это вариант, который действительно открывает порт в Интернет, поэтому аутентификация — единственное, что отделяет постороннего от выполнения команд на вашем сервере. Выбирайте его, если доступ к UI нужен нескольким пользователям и использование туннеля для каждого из них нецелесообразно.
Harness работает на 127.0.0.1:3080. nginx запущен на той же машине, поэтому он может обращаться к loopback, слушает порт 443 и использует сертификат вместе с файлом паролей.
server {
listen 443 ssl;
server_name dsh.example.com;
ssl_certificate /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;
auth_basic "dsh";
auth_basic_user_file /etc/nginx/dsh.htpasswd;
location / {
proxy_pass http://127.0.0.1:3080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_read_timeout 3600s;
proxy_buffering off;
}
}Создайте файл паролей и перезагрузите конфигурацию:
sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginxnginx -t должен вывести syntax is ok, а затем test is successful. Перезагрузка с поврежденным файлом завершится неудачей, оставив текущую конфигурацию в рабочем состоянии, поэтому сначала изучите ошибку, а не перезапускайте сервис вслепую.
Три из этих строк проксирования — не просто украшение. Заголовки Upgrade и Connection пропускают рукопожатие WebSocket, без них страница загрузится, но не будет обновляться. proxy_read_timeout 3600s увеличивает таймаут неактивности nginx с 60 секунд до часа; это не ограничивает общую продолжительность выполнения агента. Зафиксированная версия 0.2.0-rc.2 по умолчанию отправляет WebSocket-пинги каждые две секунды, поддерживая соединение активным во время длительного шага агента. proxy_buffering off отключает буферизацию для проксируемых HTTP-ответов; на WebSocket-фреймы это не влияет. Построчный разбор конфигурации nginx reverse proxy объясняет остальное, а выбор между nginx, Caddy и Traefik описывает реализацию того же решения с автоматическими сертификатами.
Harness также должен знать о прокси. proxy_set_header Host $host передает имя, видимое браузеру, без изменений — именно этого требует руководство по проксированию для данного проекта, поэтому запускайте dsh с доверенным именем, иначе он ответит 403:
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.comПосле этого каждый пользователь один раз открывает https://dsh.example.com/?token=..., используя токен из строки dsh web:, и браузер сохраняет сессионную cookie. Бэкенд устанавливает эту cookie без флага Secure, а руководство по проксированию рекомендует добавить его на стороне прокси при использовании HTTPS. В nginx версии 1.19.3 или новее это делает proxy_cookie_flags ~ secure; в блоке location.
Держите порт 3080 закрытым в файрволе независимо от выбранного прокси, чтобы единственный путь внутрь проходил через аутентифицированный прокси. Основы работы с ufw описывают необходимые правила. Базовая аутентификация поверх TLS — это лишь минимальный уровень, а не полноценная модель безопасности: любой, у кого есть этот пароль и URL с токеном, получает доступ к shell на вашем сервере. По возможности отдавайте предпочтение туннелям.
Как изменить порт, на котором прослушивает dsh web?
--port относится к веб-приложению, а не к средству запуска (launcher). В документации CLI приведен прямой пример:
dsh --profile web --port 8080dsh web является псевдонимом --profile web, поэтому dsh web --port 8080 — это та же самая команда. Средство запуска анализирует только свои собственные флаги, а всё, что идет после них, передает загружаемому профилю. Поэтому флаги средства запуска должны стоять первыми, а первый токен, который средство запуска не распознает, начинает аргументы приложения. Размещайте --port после профиля, но никогда не перед ним.
Считывайте URL, который выводит команда, вместо того чтобы предполагать его, так как эта строка сообщает адрес, к которому сервер фактически привязался, вместе с токеном, который вам понадобится. Затем обновите последнее поле вашего туннеля, чтобы оно соответствовало:
ssh -N -L 3080:127.0.0.1:8080 you@your-vpsДля постоянного изменения порт указывается в конфигурации профиля, а не в командной строке. Профили web и headless автоматически инициализируются при первом использовании из поставляемых шаблонов, расположенных в ~/.dsh. В этой же директории хранятся ваш API key и настройки конечных точек моделей, поэтому настройка ключей, моделей и конечных точек dsh — это сопутствующий материал для чтения, если вы в любом случае редактируете эти файлы. Чтобы увидеть, что именно применяется после объединения всех уровней конфигурации:
dsh --dump-configАдрес прослушивания берется из двух ключей в плагине веб-сервера: host и port. В версии 0.2.0-rc.2 его остальные ключи настраивают только сжатие ответов, а в 0.2.1-rc.2 и основной ветке добавлен опциональный ключ tls. Установка port в значение 0 запрашивает у операционной системы свободный порт, что задокументировано как "ноль запрашивает порт, назначенный ОС". Это гарантирует отсутствие конфликтов, но плохо подходит для туннеля, так как номер порта меняется при каждом перезапуске.
Почему dsh завершается с ошибкой address already in use?
Это происходит потому, что другой процесс уже занял этот адрес и порт, поэтому ядро отклоняет повторный вызов bind. Node сообщает об этом следующим образом:
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080Прежде чем что-либо менять, найдите процесс, удерживающий порт:
sudo ss -ltnp | grep 3080Поле users:(("node",pid=1042,fd=21)) указывает имя процесса и его PID. Обычно это предыдущий экземпляр dsh, который, как вы полагали, был остановлен, но часто продолжает работать в отсоединённом окне tmux. Остановите его с помощью kill 1042 или запустите новый экземпляр на другом порту. Учтите, что 127.0.0.1:3080 и 0.0.0.0:3080 также конфликтуют друг с другом, так как привязка ко всем интерфейсам уже включает в себя loopback.
Закрепите версию, так как это предварительная версия для разработчиков
В README прямо сказано: DeepSeek Harness находится на стадии предварительного просмотра для разработчиков и быстро развивается, поэтому возможны изменения, нарушающие обратную совместимость. Если этот темп — причина ваших сомнений, сравнение dsh с Claude Code и Omnigent поможет оценить его в сопоставлении с двумя другими инструментами, находящимися на разных этапах того же пути.
Неуказанная версия npx @deepseek-ai/dsh web не привязана к конкретному релизу, поэтому вы не контролируете, какая сборка будет запущена. Документация npm гласит, что имя пакета без спецификатора «будет сопоставлено с любой версией, существующей в локальном проекте», а отсутствующий в проекте пакет устанавливается в папку кэша npm. Какая именно сборка запустится, зависит от того, что уже есть на машине, поэтому перезапуск может привести к запуску CLI, отличного от того, который вы тестировали, с другими флагами. Закрепите версию, чтобы перезапуск не приводил к обновлению:
npx @deepseek-ai/dsh@0.2.0-rc.2 webПо состоянию на ноябрь 2026 года (проверено 2026-11-01), тег npm latest указывает на 0.2.1-rc.5, выпущенный на GitHub 2026-10-30. Согласно записям GitHub, 0.2.1-rc.4 был выпущен 2026-10-28 в 02:49 UTC, примерно через четыре дня и одиннадцать часов после 0.2.1-rc.3, вышедшего 2026-10-23 в 15:26 UTC. Таким образом, на машине без локальной копии обычная команда npx @deepseek-ai/dsh сейчас загрузит релиз-кандидат 0.2.1, а не ту сборку, которую закрепляет это руководство. Закрепленный 0.2.0-rc.2 был выпущен на GitHub 2026-09-29. Сборка 0.1.0-rc.7, которую это руководство рекомендовало закрепить в августе, теперь отстает на множество предварительных релизов, охватывая остаток ветки 0.1 и переходя в 0.2. Проверьте, что именно загрузит обычная команда npx, прежде чем принимать её:
npm view @deepseek-ai/dsh versionnpm view @deepseek-ai/dsh dist-tags выводит список всех тегов сразу; это способ отличить релиз-кандидат от альфа-версии перед тем, как закрепить её.
Если установка закрепленной версии не удается или npx продолжает запускать старую сборку после того, как вы закрепили новую, ошибки установки и версионирования помогут разобраться с очисткой кэша npx и проверкой того, какой npm использует ваш Node.
В предварительных релизах флаги могут перемещаться между лаунчером и веб-приложением. Если --port перестает вести себя так, как описано в этом руководстве, запросите у самого приложения список флагов, вместо того чтобы угадывать их:
dsh --profile web --helpИнформацию об установке, настройке рабочего пространства и ключе модели см. в разделе установка DeepSeek Harness на VPS. Для краткого руководства только по этапу доступа, подключение к веб-интерфейсу dsh на VPS описывает настройку туннеля без лишних пояснений.
FAQ
Почему я не могу открыть http://127.0.0.1:3080 в браузере на своем ноутбуке?
Потому что 127.0.0.1 означает машину, за которой вы работаете. Веб-интерфейс DeepSeek Harness привязан к адресу loopback на VPS, поэтому к нему могут подключаться только процессы внутри самого VPS. У вашего ноутбука свой собственный loopback, и на нем никто не слушает порт 3080. Перенаправьте порт через SSH с помощью ssh -N -L 3080:127.0.0.1:3080 you@your-vps, а затем откройте полный URL, http://127.0.0.1:3080/?token=..., локально. Средняя часть аргумента -L разрешается на стороне сервера, что и позволяет направить запрос к harness. Если не указать токен, вы получите 401 Unauthorized, пока в браузере не появится сессионная cookie.
Безопасно ли привязывать веб-интерфейс dsh к 0.0.0.0 на публичном VPS?
Нет. Веб-интерфейс — это панель управления агентом, который выполняет shell-команды и редактирует файлы от имени пользователя, запустившего dsh. В нем нет учетных записей пользователей и экрана входа: единственным удостоверением является токен в URL, статические ресурсы отдаются без него, а в документации проекта прямо указано, что порт прослушивания не защищен. Привязка ко всем интерфейсам на публичном IP делает выполнение команд на вашем сервере доступным любому, кто узнает URL и подключится к порту 3080. Привязка напрямую к публичному IP несет те же риски. Оставьте привязку на 127.0.0.1, закройте порт 3080 на межсетевом экране и используйте SSH-туннель, частную оверлейную сеть или reverse proxy с авторизацией по паролю.
Как оставить веб-интерфейс dsh запущенным после закрытия SSH-сессии?
Процесс npx @deepseek-ai/dsh web, запущенный в foreground, является дочерним для вашей оболочки входа, поэтому он завершается при выходе из нее. Запустите его внутри сессии tmux и отсоединитесь с помощью Ctrl-b d, либо запустите как пользовательский сервис systemd с включенным lingering. Туннель и harness независимы: вы можете разрывать и восстанавливать SSH-туннель сколько угодно раз, не затрагивая работающий harness, при условии, что у процесса harness есть родитель, который продолжает работать после завершения вашей сессии.
Почему веб-интерфейс dsh зависает во время долгой работы агента при использовании nginx?
Проверьте соединение WebSocket и лог ошибок nginx. Значение proxy_read_timeout по умолчанию в nginx составляет 60 секунд между операциями чтения, но версия 0.2.0-rc.2 по умолчанию отправляет WebSocket-пинги каждые две секунды, поэтому долгий шаг работы агента сам по себе не вызывает этот таймаут. proxy_read_timeout 3600s; увеличивает допустимое время неактивности до часа. proxy_buffering off; отключает буферизацию для HTTP-ответов, но не для WebSocket-фреймов. Передайте заголовки Upgrade и Connection с помощью proxy_http_version 1.1;, чтобы рукопожатие WebSocket прошло успешно. Без этих заголовков страница загружается, но не получает обновлений.