Как открыть web UI DSH на VPS
DSH слушает 127.0.0.1:3080, поэтому URL из терминала не откроется на ноутбуке. Узнайте три безопасных способа подключения и какой использовать нельзя.
Почему web UI DSH не открывается на вашем ноутбуке
web UI DSH привязан к loopback-интерфейсу, поэтому URL, который вывел ваш терминал, работает только на машине, где он был выведен. npx @deepseek-ai/dsh web сообщает launch URL в формате http://127.0.0.1:3080/?token=..., а 127.0.0.1 для любого компьютера, который читает этот адрес, означает «компьютер, на котором его читают». Ваш ноутбук обращается к собственному loopback-интерфейсу и не находит там процесс, который прослушивает этот адрес. Если проблема именно в непонятном адресе, материал почему dsh вообще выводит http://127.0.0.1:3080 подробнее объясняет его назначение. Не изменяйте адрес, к которому привязан DSH. Вместо этого создайте аутентифицированный путь с ноутбука к loopback-адресу VPS.
Использование loopback по умолчанию является правильным, и все методы на этой странице его сохраняют. За портом 3080 работает агент, который выполняет shell-команды на сервере, а web UI не содержит страницы входа. Сейчас DSH аутентифицирует браузер с помощью launch token: при каждом запуске процесса создаётся новый token, напечатанный URL содержит его, а при первом посещении token заменяется на session cookie. Этот token является единственным bearer credential, передаваемым в URL, поэтому loopback остаётся наиболее важным уровнем защиты: прямые подключения к сокету должны исходить с VPS, включая подключения, перенаправленные через SSH или proxy.
К чему привязывается DSH и как проверить свою конфигурацию
По состоянию на 4 ноября 2026 README DeepSeek Harness сообщает, что npx @deepseek-ai/dsh web «по умолчанию запускает Web UI на http://127.0.0.1:3080». В справочнике CLI того же репозитория указано, что порт по умолчанию остаётся 3080, значение --host «должно задавать один конкретный локальный адрес, а не wildcard», а при --host 0.0.0.0 процесс завершается с ошибкой использования. DSH — это предварительная версия для разработчиков. README прописывает заглавными буквами, что возможны изменения, нарушающие совместимость. Проверьте оба значения в собственной установке, а не доверяйте любой странице, включая эту.
dsh --profile web --dump-config
ss -ltnp | grep 3080--dump-config выводит составленное дерево конфигурации, не запуская агент, но оставляет выражения невычисленными и не разрешает аргументы приложения. Поэтому это не дамп итоговых адреса и порта, используемых процессом. ss показывает, что сейчас действительно прослушивается. Рабочая строка выглядит так:
LISTEN 0 511 127.0.0.1:3080 0.0.0.0:* users:(("node",pid=8123,fd=24))Смотрите на локальный адрес прослушивания, а не на адрес узла-пира. 127.0.0.1:3080 — это только loopback, что и требуется. Другие адреса в 127/8, ::1 и их формы, сопоставленные с loopback, также оставляют DSH доступным только локально. Адрес, отличный от loopback, обслуживает сеть, которой принадлежит этот адрес, и она может быть публичной. Если ss вообще не выводит строк, на порту 3080 ничего не прослушивается. Перед настройкой туннеля проверьте, не остановился ли DSH и не использует ли он другой порт. Инструкции по достижению этого состояния приведены в разделе установка и запуск DeepSeek Harness на VPS.
Флаги действуют только в рамках одного запуска. Чтобы сохранить значение, измените слой исправлений профиля. dsh --profile <name> запускает профиль с адресом $DSH_HOME/profiles/<name>. Слои накладываются в следующем порядке: исправления bundle, собственный cordis.patch.yml профиля, $DSH_HOME/cordis.patch.yml уровня home, затем любой оверлей --patch. Параметры прослушивания находятся в плагине @deepseek-ai/dsh-host-webserver как host и port. Перед редактированием прочитайте собственное составленное дерево с помощью --dump-config. При первом запуске web-профиль создаёт себя из поставляемого шаблона, а в предварительной версии структура этого шаблона постоянно меняется.
Строка запуска также содержит данные для аутентификации. DSH выводит корневой URL с токеном процесса в запросе token. Браузер может передать его только как GET /?token=..., но не в заголовке Authorization. Для вызывающих API предусмотрен отдельный обмен GET /connect?token=..., который не используется браузером. Корневой запрос устанавливает подписанную cookie HttpOnly с атрибутом SameSite=Strict и перенаправляет на чистый URL. При каждом запуске процесса создаётся новый токен. По умолчанию cookie истекает через 30 days; это значение задаёт cookieMaxAgeDays. Запрос документа или API без действительных учётных данных получает ответ 401. Статические ресурсы остаются общедоступными. Скопируйте весь выведенный URL вместе с токеном, поскольку каждый описанный ниже способ заканчивается его открытием.
Второй уровень защиты: доверенный список для /api
Доставить пакеты на порт 3080 — только половина задачи. У DSH есть дополнительная проверка. Из-за неё возникает труднообъяснимая ошибка: страница загружается, интерфейс отображается, а затем ничего не работает.
Плагин @deepseek-ai/dsh-client-connection содержит параметр trustedHosts. В README указано правило: заголовок Host должен содержать loopback-адрес, собственный адрес привязки listener на любом порту или совпадать с записью trustedHosts. Если браузер отправляет заголовок Origin, в нём должен быть указан тот же authority. Эта проверка выполняется перед аутентификацией для каждого запроса. Она отклоняет любой запрос /api, который ей не соответствует. Браузер отображает отказ так:
transport failure for /api/host.describe: HTTP 403Поэтому любой proxy перед DSH должен объявлять имя, которое вводит пользователь в браузере. CLI принимает параметр --trusted-host <authority>. Его можно указывать несколько раз:
dsh web --trusted-host dsh.example.comПроверка сопоставляет authority, то есть host и port, и нормализует стандартные порты для схемы listener. Запись без порта, например dsh.example.com, соответствует этому имени на любом порту. Поэтому она также охватывает dsh.example.com:8443. Запись с портом, например dsh.example.com:8443, соответствует только указанным host и port. Другие варианты она не охватывает. Для loopback отдельная запись не нужна, поэтому и localhost:3080, и 127.0.0.1:3080 проходят проверку. Ошибка 403 без очевидной причины почти всегда означает, что имя в адресной строке отличается от имён в доверенном списке. Ошибка 401 связана с другой проблемой: проверка пропустила запрос, но у браузера нет действительного session cookie для этого authority.
Эта проверка контролирует origin. Она не является аутентификацией. Сам браузер запрещает странице устанавливать заголовок Host, поэтому проверка не позволяет странице с другого сайта управлять вашим agent. Любой клиент, который не является браузером, может свободно записать этот заголовок. Рассматривайте trustedHosts как параметр совместимости для proxy и средство защиты браузерных запросов, а не как аутентификацию или ограничение доступа к порту.
Вариант 1: локальный SSH-туннель
Сначала используйте этот вариант, поскольку на сервере ничего не требуется менять.
ssh -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vps-L открывает listener на вашем ноутбуке и перенаправляет каждое подключение к 127.0.0.1:3080 в том виде, в котором это имя разрешается на VPS. -N означает «не выполнять удалённую команду», поэтому сессия используется только для перенаправления. Указание локальной стороны как 127.0.0.1:3080 вместо простого 3080 сделано намеренно: оно привязывает listener на ноутбуке к loopback. Поэтому параметр GatewayPorts в конфигурации SSH-клиента не сможет незаметно опубликовать agent в сети, к которой подключён ваш ноутбук.
Откройте в браузере на ноутбуке URL запуска, который вывел DSH, вместе с token. Поскольку перенаправление слушает на 127.0.0.1:3080, выведенный http://127.0.0.1:3080/?token=... работает без изменений. Простого http://localhost:3080 недостаточно в новой сессии браузера: без cookie DSH отвечает кодом 401. После первого посещения cookie выполняет эту задачу, но она привязана только к имени хоста. Поэтому продолжайте использовать имя, которое открыли первым: cookie для 127.0.0.1 не отправляется на localhost. Заголовок Host указывает на loopback, поэтому проверка /api проходит без дополнительной настройки. Текущая реализация UUID в DSH использует crypto.getRandomValues(), поэтому для запуска ей больше не требуется crypto.randomUUID(), доступный только в защищённом контексте.
Добавьте -f, чтобы ssh после завершения аутентификации перевёл процесс в фоновый режим:
ssh -f -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vpsЧестный компромисс. Новый listener не открывается на публичном адресе, и правила firewall не изменяются. Поэтому увеличение поверхности атаки минимально. Весь контроль доступа обеспечивается конфигурацией SSH. Это делает SSH только по ключу с отключённым входом по паролю обязательным условием, а не дополнительной мерой. Недостаток в том, что туннель привязан к одной клиентской сессии. Он завершается, когда ноутбук переходит в спящий режим. После этого его нужно запускать вручную. Кроме того, такой доступ не работает с телефона.
Вариант 2: Tailscale serve на VPS
Tailscale создаёт частную сеть между вашими устройствами. После установки на VPS этот сервер получает адрес 100.x.y.z, доступный через Tailscale. Политики контроля доступа определяют, какие устройства могут подключаться. Если предоставить сервер в общий доступ, этот доступ получают устройства внешнего пользователя.
Одного подключения к этой сети недостаточно. Именно на этом этапе часто возникают проблемы. DSH не принимает подключения на адресе 100.x.y.z, потому что слушает loopback-интерфейс. При открытии http://100.x.y.z:3080 в браузере возвращается отказ в подключении, поскольку на этом адресе нет привязанного сокета. --host действительно принимает подключения на этот конкретный адрес, но привязка не к loopback-интерфейсу использует обычный HTTP, если не настроить TLS. При запуске DSH предупреждает о привязке HTTP к адресу не на loopback-интерфейсе. Используемый здесь loopback-слушатель это предупреждение не вызывает. Текущая реализация UUID работает без защищённого контекста, но обычный HTTP всё равно передаёт launch token и cookie по этому HTTP-соединению.
tailscale serve соединяет эти два компонента. Он работает на VPS, принимает трафик из вашей частной сети и проксирует его на локальный адрес:
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
sudo tailscale serve --bg --https=443 localhost:3080
tailscale serve statustailscale serve status выводит URL в формате https://<machine>.<tailnet>.ts.net/. Запустите DSH с этим именем в списке доверенных, иначе /api вернёт 403, как описано выше:
dsh web --public-url https://your-vps.your-tailnet.ts.net/ --trusted-host your-vps.your-tailnet.ts.net--public-url задаёт URL запуска, который выводится и открывается, DSH_WEB_URL, а также URL Web GUI в контексте выполнения агента. Поэтому URL запуска формируется с именем tailnet и открывается на телефоне без изменений. Сам по себе этот параметр ничего не разрешает, поэтому --trusted-host по-прежнему нужен. Выведенный URL содержит действительный credential. Вставляйте его только на свои устройства.
Tailscale завершает настоящее HTTPS-соединение с сертификатом, выпущенным для этого имени. Это защищает launch token и session cookie между браузером и VPS. Сервис не открыт в публичном Интернете: serve принимает трафик Tailscale, включая доступ, предоставленный через общий доступ к серверу.
Не заменяйте здесь tailscale funnel. Это та же группа команд, предназначенная для публичного Интернета. Она разместит агента с доступом к shell на hostname, который может разрешить любой пользователь. Перед выполнением любой из этих команд прочитайте как serve оставляет трафик внутри вашего tailnet, а funnel публикует его. Вариант всей этой конфигурации для телефона описан в разделе доступ к self-hosted агенту с телефона.
Недостаток этого подхода — зависимость от Tailscale. Каждое устройство, которому нужен UI, должно использовать Tailscale и иметь доступ к VPS через ваш tailnet или общий доступ к серверу. Кроме того, членством в сети управляет coordination server, который вы не запускаете самостоятельно. Если это неприемлемо, self-hosted control server Headscale использует тот же протокол на оборудовании, которым вы владеете.
Вариант 3: reverse proxy с аутентификацией TLS
Используйте этот вариант, если браузер не может подключиться к частной сети, например на компьютере, которым вы не администрируете. Теперь вы публикуете имя хоста в Интернете, поэтому аутентификация должна быть полноценной и выполняться самим прокси. Launch token DSH — это один bearer-токен в URL, общий для всех, кто им владеет, поэтому он не считается таким уровнем защиты.
TLS означает Transport Layer Security — шифрование, лежащее в основе https://. Направьте nginx на loopback-порт и добавьте перед ним пароль. Блок map должен находиться в контексте http, поэтому создайте для него отдельный файл в /etc/nginx/conf.d/:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}Затем настройте сам сайт:
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 Host $host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cookie_flags ~ secure;
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 nginxКоманда nginx -t должна вывести syntax is ok и test is successful. Если вместо этого она выводит ошибку, nginx продолжает обслуживать старую конфигурацию, поэтому пока ничего не сломано. Затем запустите DSH, указав публичное имя как доверенное, поскольку proxy_set_header Host $host передаёт dsh.example.com, а иначе защита отклонит этот запрос. Параметр --public-url добавляет это имя в печатаемый launch URL, чтобы вы могли открыть его напрямую:
dsh web --public-url https://dsh.example.com/ --trusted-host dsh.example.comТри директивы здесь критически важны. Заголовки Upgrade и Connection позволяют интерфейсу установить WebSocket-соединение; без них обновление соединения завершается ошибкой. proxy_read_timeout 3600s увеличивает допустимый интервал между чтениями от upstream с значения по умолчанию 60 секунд до одного часа; это не ограничение общей продолжительности запуска агента. proxy_cookie_flags ~ secure помечает cookie сессии DSH Secure как доступную только по HTTPS, чего требует публичное руководство по развёртыванию DSH: backend работает по обычному HTTP и без этой настройки выдаёт cookie без такого атрибута. DSH также может самостоятельно обслуживать HTTPS с помощью --tls-cert и --tls-key, но он не получает и не обновляет сертификаты и не добавляет пароль, поэтому в данном случае не заменяет прокси. Обоснование остальных настроек приведено в разделе конфигурация reverse proxy nginx с пояснением каждой директивы, а сравнение самих прокси — в разделе сравнение nginx с Caddy и Traefik.
Важно понимать, что даёт basic auth. Она останавливает автоматические сканеры и намного лучше открытого порта. Но перед shell устанавливается один общий пароль без второго фактора и без возможности отозвать доступ у одного человека, пока все используют одну и ту же учётную запись. Любой, кто узнает пароль и получит launch URL или cookie сессии, сможет выполнять команды от имени пользователя, под которым запущен DSH. Если доступ нужен нескольким людям, сначала установите полноценный identity proxy, а перед дальнейшим расширением доступа прочитайте правила безопасного запуска coding agent на VPS.
Что произойдёт, если привязаться к 0.0.0.0 и открыть порт
Очевидный способ — изменить адрес привязки и открыть порт в firewall. DSH блокирует использование wildcard-адреса. --host отклоняет 0.0.0.0, а плагин @deepseek-ai/dsh-host-webserver отклоняет неопределённый адрес во всех вариантах записи при загрузке конфигурации: 0.0.0.0, :: и IPv4-mapped формы. При этом host принимает конкретный литерал IPv4- или IPv6-адреса. Поэтому указание публичного IP-адреса — допустимая для DSH настройка. Существуют сторонние плагины, которые заменяют строку webserver и обходят отклонение wildcard-адреса. Они поставляются с предупреждениями, и эти предупреждения обоснованны. Тот же уровень плагинов гораздо полезнее использовать в обратном направлении: ограничения расходов и правила разрешений для инструментов сужают набор действий агента, а не расширяют область, на которой он принимает подключения.
Вот что фактически даёт публичная привязка без TLS. Порт 3080 отвечает на публичном IP-адресе по обычному HTTP. При запуске DSH выводит предупреждение, если non-loopback привязка обслуживает обычный HTTP. Но это только предупреждение: listener всё равно открывается. Страницы входа нет. Единственной защитой служит launch token. Он передаётся через Интернет в открытом виде внутри URL. То же относится к session cookie после её выдачи. Защита /api проверяет заголовок Host, который любой клиент, не являющийся браузером, может указать самостоятельно. Кроме того, она в любом случае разрешает адрес привязки на любом порту. Поэтому добавление вашего адреса в trustedHosts ничего не меняет для атакующего, у которого есть curl. В собственной документации DSH прямо указано, что ни рекламируемый URL, ни эта защита не ограничивают доступ к самому listening port. За этим портом находится агент, который выполняет shell-команды от имени вашего пользователя. Он также имеет доступ к данным в $DSH_HOME, где DSH хранит профили и API keys. Перехваченный token или cookie позволяет удалённо выполнить код на сервере от имени вашего пользователя и оплачивать использование провайдера за ваш счёт. Сканеры постоянно проверяют всё адресное пространство, поэтому отсутствие IP-адреса в списке не является защитой. Все секреты, которые может прочитать агент, передаются вместе с shell.
Все описанные выше способы нужны именно для того, чтобы вам не приходилось делать это. SSH forward — правильный вариант по умолчанию для одного пользователя на одном ноутбуке. Перейдите на tailscale serve, если используется телефон или нужен полноценный сертификат. Публичный reverse proxy следует оставлять для случая, когда UI должен быть доступен из браузера, который вы не администрируете. Перед ним должна быть настроена полноценная аутентификация.
FAQ
Почему http://127.0.0.1:3080 не открывается на моём ноутбуке?
Потому что 127.0.0.1 означает «машина, которая читает этот адрес». DSH выводит этот адрес на VPS, где он корректен. Ноутбук читает ту же строку и обращается к собственному loopback-интерфейсу, где ничего не прослушивает порт. Проверьте серверную сторону с помощью ss -ltnp | grep 3080 на VPS. Строка с 127.0.0.1:3080 означает, что DSH запущен и намеренно привязан к loopback. Вам нужен туннель или прокси, а не другой адрес привязки. После этого используйте полный URL запуска с его токеном.
Можно ли запустить dsh web с параметром --host 0.0.0.0?
Нет. Согласно справочнику CLI репозитория, проверенному 4 November 2026, параметр --host должен указывать один конкретный локальный адрес, а не wildcard-адрес, а при использовании --host 0.0.0.0 процесс завершается с ошибкой использования. Плагин webserver отклоняет этот адрес при загрузке конфигурации. Конкретный адрес, например ваш публичный IP-адрес, принимается, но без TLS он обслуживает обычный HTTP. DSH предупреждает об этом при запуске, поэтому токен запуска, защищающий shell, передаётся по сети в открытом виде. Community plugins обходят проверку wildcard-адреса. Если вы используете такой плагин, настройка firewall и защита транспорта становятся вашей ответственностью.
Почему все вызовы /api за reverse proxy возвращают HTTP 403?
Защитный барьер /api отклоняет любой запрос, если его заголовок Host не содержит loopback-адрес, адрес привязки listener или значение из trustedHosts. За прокси этот заголовок содержит ваше публичное имя, поэтому барьер отклоняет запрос, а браузер записывает transport failure for /api/host.describe: HTTP 403. Запустите DSH с параметром --trusted-host <your name> и укажите в нём имя из адресной строки браузера. Запись без порта сопоставляется с этим именем на любом порту. Запись с портом должна точно совпадать с именем хоста и портом. Если вызовы возвращают 401, проверка барьером пройдена, но у браузера нет действительной сессии для этого authority. Откройте напечатанный URL запуска с его токеном.
Почему интерфейс DSH загружается, но не завершает запуск через обычный HTTP?
Текущая реализация UUID в DSH использует crypto.getRandomValues(). Она работает вне secure contexts, поэтому прежняя ошибка запуска crypto.randomUUID() больше не объясняет этот симптом. Проверьте неудачные запросы в браузере. Код 403 указывает на проверку Host/Origin, а код 401 — на отсутствующие или недействительные учётные данные. Откройте полный URL запуска с его токеном и сравните --trusted-host со значением authority, отображаемым в браузере. Для удалённого доступа используйте HTTPS или SSH forward, поскольку обычный HTTP по-прежнему раскрывает токен запуска и cookie сессии на этом участке соединения.
Какой способ следует использовать одному разработчику?
SSH local forward. Он ничего не добавляет на сервер, не изменяет правила firewall и использует уже доверенный SSH key. Выполните ssh -f -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vps, затем откройте URL запуска, напечатанный DSH, http://127.0.0.1:3080/?token=..., сохранив его токен без изменений. Перейдите к tailscale serve, если хотите открыть интерфейс на телефоне или получить доступ, который сохранится после перехода ноутбука в спящий режим.