Как запустить dsh как systemd сервис на VPS
Настройте dsh для работы в фоновом режиме через systemd unit. В руководстве описано создание выделенного пользователя, правила перезапуска и логирование через journalctl.
Запуск dsh в фоновом режиме на VPS без терминала
Запуск dsh в фоновом режиме на VPS требует создания одного unit-файла systemd и выделенного пользователя для его работы. dsh — это интерфейс командной строки для DeepSeek Harness, среды выполнения агентов от DeepSeek, выпущенной под лицензией MIT в рамках developer preview в августе 2026 года. Harness — это программа, работающая вокруг модели, а не сама модель, поэтому под управлением systemd вы размещаете цикл выполнения, инструменты и права доступа, а не процесс инференса DeepSeek. В руководстве по быстрому старту предлагается ввести npx @deepseek-ai/dsh web, что верно, но этот процесс завершается сразу после закрытия SSH-сессии.
Unit-файл решает четыре задачи одновременно. Сервис автоматически перезапускается после перезагрузки системы. Его вывод направляется в журнал, а не прокручивается перед глазами. Он работает от имени пользователя, отличного от root. Кроме того, используется выбранная вами версия, что здесь критически важно, так как разработчики прямо предупреждают об этом:
DeepSeek Harness в настоящее время находится в стадии developer preview и активно развивается. БУДУТ ВНОСИТЬСЯ ИЗМЕНЕНИЯ, НАРУШАЮЩИЕ СОВМЕСТИМОСТЬ.
В этом руководстве предполагается, что dsh уже работает у вас при ручном запуске. Если это не так, начните с установки DeepSeek Harness на VPS и вернитесь, когда npx @deepseek-ai/dsh web начнет открывать страницу.
Сначала Node: предупреждений npm недостаточно
node -vСобственный пакет Ubuntu 24.04 содержит Node 18 (18.19.1 по состоянию на август 2026 года). Для пакета, опубликованного в этом году, это старая версия. npm проверяет версии Node. В документации указано, что поле engines пакета «выводит только предупреждения», если не включить engine-strict. В опубликованных манифестах @deepseek-ai/dsh вообще нет поля engines (проверено 27 октября 2026 года для 0.1.0-rc.7, 0.2.1-rc.2 и 0.2.1-rc.4), хотя репозиторий его объявляет. При этом npm также проверяет требования к версиям Node у зависимостей. Зафиксированный выпуск 0.2.1-rc.2 объявляет требование commander: ^15.0.0, а Commander 15 требует Node >=22.12.0. Поэтому его установка на Node 18 в Ubuntu при стандартных настройках npm приводит к предупреждению EBADENGINE. По умолчанию это предупреждение не останавливает установку. Поэтому проверьте Node до возникновения ошибки во время выполнения.
Минимальная поддерживаемая версия в репозитории также изменилась. Исходный код 0.2.1-rc.2 допускает ^22.19.0 || >=24.0.0, но CLI-пакет в ветке master теперь объявляет требование >=24.9.0, которому Node 22 не соответствует. Установите Node 24 из NodeSource. Это ветка долгосрочной поддержки (LTS), находящаяся в режиме обслуживания с 20 октября 2026 года. Её текущие сборки соответствуют обоим диапазонам. Согласно графику выпусков Node.js, Node 26 получил статус LTS 28 октября 2026 года.
curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -vКоманда node -v теперь должна вывести версию v24, равную 24.9.0 или выше. Строка less нужна потому, что передача удалённого скрипта напрямую в bash запускает код, который вы не прочитали.
Проверьте запуск вручную до создания unit
npx @deepseek-ai/dsh@0.2.1-rc.2 webОставьте этот процесс запущенным. Во втором сеансе SSH выполните:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/Любой код состояния HTTP означает, что web-профиль прослушивает loopback-интерфейс, к которому он привязывается по умолчанию. Ожидайте 401 и считайте проверку успешной: UI аутентифицирует браузеры с помощью launch token в URL из вывода, обменивая его на подписанную cookie сессии. Запрос без этих данных получает ответ 401. Сочетание 000 и curl: (7) Failed to connect to 127.0.0.1 port 3080 означает, что процесс не прослушивает порт. В первом терминале указана причина. Остановите ручной запуск с помощью Ctrl+C, прежде чем продолжить: unit, который пытается привязать уже занятый порт, завершается с ошибкой Error: listen EADDRINUSE: address already in use 127.0.0.1:3080.
0.1.0-rc.7 — версия, опубликованная 18 August 2026. Она предшествует браузерной аутентификации, на которой основано это руководство: в README для Connection указано, что ограничение является политикой доступности, а "the Web carrier provides no authentication layer". 11 October 2026 тег latest указывал на 0.2.0-rc.2. 27 October 2026 latest указывал на 0.2.1-rc.2, а next — на 0.2.1-rc.4, поэтому приведённые здесь команды фиксируют 0.2.1-rc.2. 4 November 2026 список версий в npm показывает, что и latest, и next имеют значение 0.2.1-rc.5; в приведённых здесь командах сохраняется существующая фиксация версии. Проверьте актуальное состояние с помощью npm view @deepseek-ai/dsh version, а затем зафиксируйте выбранную версию.
Установите закреплённую версию глобально
npx не подходит для использования внутри unit-файла. Если версия не указана и подходящая локальная установка отсутствует, команда определяет версию пакета при запуске процесса. Поэтому через три месяца перезапуск может запустить другую сборку агента на стадии preview, хотя с вашей стороны ничего не изменилось. Отсутствующие пакеты или данные кэша также требуют доступа к реестру npm. Поэтому медленный реестр может задержать или прервать запуск. npm также поддерживает выполнение с использованием кэша и в автономном режиме. Выполните установку один раз, указав записанную версию:
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dshcommand -v dsh выводит /usr/bin/dsh, если npm был установлен из NodeSource, и /usr/local/bin/dsh, если он был установлен из собственного пакета Ubuntu. Используйте путь, который команда фактически вывела, в unit-файле. npm ls -g выводит точную версию. Именно она понадобится через шесть недель, когда поведение изменится и вы не сможете вспомнить, что установили. Если установка завершается ошибкой, после этого command -v dsh ничего не выводит или полученная версия отличается от запрошенной, сначала устраните типичные ошибки установки и определения версии dsh, а затем создавайте unit-файл.
Пользователь только для сервиса
Агент выполняет команды shell. Это его основная задача. При запуске от имени root каждый вызов инструмента выполняется с правами root, поэтому создайте для него отдельную учётную запись без shell для входа.
sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh/var/lib/dsh/harness становится DSH_HOME — каталог, в котором dsh хранит профили. Профиль — это именованный стек пакетов плагинов с вашим собственным слоем исправлений поверх. Профили web и headless при первом запуске создаются на основе поставляемых шаблонов. Всё, что вы позже добавите в этот стек, будет выполняться от имени этого пользователя и получит собственный доступ агента к файлам и оболочке. Поэтому проверка плагина перед его установкой — такая же часть задачи, как создание учетной записи. При первом запуске записываются файлы и могут загружаться пакеты. Поэтому по возможности выполняйте его вручную и контролируйте процесс.
sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile webЯвно задайте HOME, а не полагайтесь на то, как с ним работает sudo: сохранит ли sudo значение HOME или перепишет его, зависит от настроек, включая env_reset, env_keep и always_set_home в /etc/sudoers. Если задать значение неправильно, при первом запуске программа попытается использовать домашний каталог вашего пользователя для кэша и состояния. Это приведёт к ошибкам доступа или сохранит состояние в каталоге, который сервис позже использовать не будет. Остановите процесс с помощью Ctrl+C после того, как проверка curl выведет код состояния.
Файл юнита
Напишите /etc/systemd/system/dsh.service:
[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5
[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
[Install]
WantedBy=multi-user.targetExecStart= принимает абсолютный путь, полученный из command -v dsh. systemd ищет команды без пути в фиксированном списке каталогов. Этот список не совпадает с PATH вашей оболочки, поэтому абсолютный путь исключает неоднозначность.
WorkingDirectory= задаёт каталог, относительно которого разрешаются относительные пути. В нём также начинается выполнение вызова инструмента, который запускает ls без аргументов. Укажите здесь рабочий каталог, передаваемый агенту. Если каталог отсутствует или пользователь сервиса не может войти в него, юнит завершится с ошибкой status=200/CHDIR ещё до запуска dsh.
ProtectHome=true скрывает /home и /root от процесса. В данном случае это безопасно, поскольку всё, с чем работает сервис, находится в /var/lib/dsh. Если указать для рабочего каталога путь под /home, агент сообщит, что каталог не существует. Это сбивает с толку, пока вы не вспомните об этой строке. ProtectSystem=full делает /usr, /boot и /etc доступными только для чтения. Сервису не требуется записывать в них.
Усилить изоляцию кажется логичным, но обычно это неверный шаг. ProtectSystem=strict делает всю файловую систему доступной только для чтения, кроме псевдофайловых систем ядра и, с учётом PrivateTmp=true, /tmp и /var/tmp этого юнита, поэтому запись в рабочий каталог завершается ошибкой EROFS: read-only file system. Если требуется такой уровень изоляции, добавьте ReadWritePaths=/var/lib/dsh в том же редактировании.
Какой тип Type= здесь подходит
Type=exec, так как dsh остается в foreground и не выполняет fork. Преимущество перед значением по умолчанию заключается в получении реального сообщения об ошибке. При Type=simple systemd считает запуск успешным сразу после выполнения fork, еще до того, как станет известно о существовании бинарного файла. Поэтому systemctl start dsh завершается успешно, а ошибка отображается только в журнале. При Type=exec systemd ожидает завершения execve(), поэтому опечатка в ExecStart= приведет к ошибке выполнения команды, которую вы только что ввели, и вы сразу её увидите.
Два других варианта приведут к зависанию. Type=forking указывает systemd ожидать завершения родительского процесса, а dsh никогда не завершается, поэтому запуск блокируется до истечения TimeoutStartSec (по умолчанию 90 секунд), после чего выдается ошибка Job for dsh.service failed because a timeout was exceeded.. Type=notify ожидает сообщение READY=1 через sd_notify, и процесс Node, который его не отправляет, зависает аналогичным образом. Полное сравнение типов сервисов systemd охватывает остальные случаи, включая ситуации, когда настройка notify оправдана.
Правила перезапуска с явной фиксацией ошибок
Restart=on-failure перезапускает сервис при завершении с ненулевым кодом или после некорректного сигнала и не трогает юнит после штатного завершения; systemd считает SIGHUP, SIGINT, SIGTERM и SIGPIPE штатными сигналами для этого типа сервиса. Именно такое поведение требуется для preview-сборки. Если dsh завершится с кодом 0, потому что прочитал неподходящую конфигурацию, юнит остановится и останется остановленным, а в systemctl status dsh будет указано inactive (dead). Restart=always превращает то же событие в цикл перезапусков, который издалека выглядит штатным.
Ограничение частоты — это часть конфигурации, о которой часто забывают. Значения по умолчанию в systemd — пять запусков за десять секунд. При использовании RestartSec=5s юнит никогда не достигает пяти запусков в десятисекундном интервале, поэтому сервис, завершающийся с ошибкой при запуске, перезапускается бесконечно, а информацию об этом можно найти только в журнале. StartLimitIntervalSec=300 вместе с StartLimitBurst=5 разрешает пять запусков за пять минут, после чего запрещает следующий запуск в течение этого интервала. systemd прекращает попытки и переводит юнит в состояние failed, записывая Start request repeated too quickly.. После устранения причины сбросьте это состояние командой sudo systemctl reset-failed dsh. Оба параметра нужно указывать в [Unit], а не в [Service]; неизвестные параметры записываются в журнал как предупреждения, а не игнорируются без уведомления.
Запуск и проверка
sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dshenable --now выполняет две задачи. enable обеспечивает автоматический запуск службы после перезагрузки, а --now запускает её в текущем сеансе. Служба, запущенная просто через systemctl start, не восстановится после перезагрузки, а обновления ядра требуют перезагрузки системы.
systemctl status dsh должен показать Active: active (running), Main PID и строку Memory:. После этого проверьте, на каком адресе ожидаются соединения:
sudo ss -lntp | grep 3080Вам нужен 127.0.0.1:3080. Если вы видите другой адрес, значит, флаг --host перенаправил слушающий сокет в сеть, к которой относится этот адрес, и сервис отдает обычный HTTP, если не настроен TLS. Имя процесса в выводе — node, а не dsh, так как бинарный файл dsh является скриптом Node, поэтому pgrep -x dsh ничего не находит. Используйте systemctl show -p MainPID dsh.
Затем выполните перезагрузку. Служба, которая не запускается автоматически после перезагрузки, еще не готова к работе.
sudo rebootПодключитесь снова и выполните systemctl is-active dsh. Команда выведет active.
Чтение журналов с помощью journalctl
Всё, что dsh записывает в stdout и stderr, попадает в journal под именем юнита.
journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err-f выводит новые строки, -n показывает последние N записей, а -p err фильтрует записи по приоритету. SyslogIdentifier=dsh в юните объясняет, почему эти строки помечены как dsh, а не как node. Это важно при первом чтении вывода journal без фильтрации по юниту.
Заранее проверьте, сохраняется ли journal после перезагрузки:
journalctl -u dsh -b -1Если команда выводит Specifying boot ID or boot offset has no effect, no persistent journal was found, journal хранится в /run, и при каждой перезагрузке его содержимое удаляется. При Storage=auto создайте каталог и перезапустите daemon. Если настроен Storage=volatile, сначала измените его на persistent:
sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journaldВыполните sudo journalctl --flush, чтобы включить постоянное хранение и записать журналы текущей загрузки на диск.
Доступ к UI через SSH-туннель вместо публичного порта
По умолчанию dsh предоставляет веб-интерфейс (UI) на 127.0.0.1:3080. Хотя по умолчанию используется loopback, это не единственный вариант: --host принимает конкретный IPv4- или IPv6-адрес локального интерфейса. Любой адрес, отличный от loopback, делает сервис доступным в сети по обычному HTTP (при запуске появится предупреждение, если не использовать --tls-cert и --tls-key). dsh запрещает использование wildcard-адресов. При попытке указать --host 0.0.0.0 возникнет ошибка следующего вида:
webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:В сообщении также указано, что «привязка ко всем интерфейсам делает возможным удаленное выполнение кода в сети», и рекомендуется «привязать конкретный IPv4- или IPv6-адрес локального интерфейса». Значение, не являющееся IP-адресом (например, имя хоста), приведет к ошибке is not a concrete IPv4 or IPv6 address literal.
Рекомендуется оставить настройки по умолчанию. Веб-API (интерфейс прикладного программирования) управляет агентом, который выполняет shell-команды. dsh защищает этот API: выполняются проверки Host и Origin, а в выведенном URL содержится токен запуска, который UI обменивает на подписанный сессионный cookie. Однако при использовании обычного HTTP этот токен передается по сети в открытом виде, а документация разработчика предупреждает, что проверка Host не защищает сам порт прослушивания. Если вам нужен UI на реальном доменном имени, в руководстве по публичному развертыванию DeepSeek описана настройка обратного прокси с --public-url и --trusted-host или использование нативного TLS с --tls-cert и --tls-key. Перед тем как менять настройки, стоит ознакомиться с тем, что на самом деле означает строка 127.0.0.1:3080 в выводе при запуске. Если сервером пользуетесь только вы, лучше пробросить порт с локальной машины:
ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10-L 3080:127.0.0.1:3080 открывает порт 3080 на вашем ноутбуке и перенаправляет весь трафик на 127.0.0.1:3080, разрешенный на VPS. -N означает, что удаленная команда не выполняется, сессия нужна только для поддержания туннеля. Оставьте его запущенным, найдите URL, который dsh вывел при старте с помощью journalctl -u dsh -n 100 --no-pager, и откройте его в браузере. Этот URL содержит токен запуска. Если открыть просто http://127.0.0.1:3080/ в браузере без активной сессии, вы получите ошибку 401. Токен привязан к запущенному процессу, но полученный сессионный cookie живет дольше: он подписан секретным ключом, который dsh хранит в $DSH_HOME/.credentials.yaml, и по умолчанию действует 30 дней. Поэтому браузер, в котором уже выполнен вход, сможет открыть URL даже после перезапуска. Новый URL из журнала нужен только для нового браузера или после истечения срока действия cookie. Относитесь к URL как к учетным данным: разработчики рекомендуют делиться им только с доверенными пользователями, при этом любой, кто может читать системный журнал, может прочитать и этот URL. После входа в систему введите API-ключ DeepSeek в разделе Settings — Models и выберите рабочую директорию. Укажите в качестве рабочей директории /var/lib/dsh/workspace (директорию, принадлежащую пользователю сервиса), иначе файловые инструменты агента вернут ошибку EACCES: permission denied.
Если порт 3080 занят на вашем ноутбуке, ssh сообщит об этом:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080Выберите другой локальный порт с помощью ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10, а затем откройте полученный URL, заменив 3080 на 3081. Чтобы не вводить команду каждый раз, сохраните настройки в ~/.ssh/config на локальной машине:
Host dsh-vps
HostName 203.0.113.10
User you
LocalForward 3080 127.0.0.1:3080После этого для запуска туннеля будет достаточно команды ssh -N dsh-vps. Теперь этот туннель — единственный путь к вашему агенту, поэтому безопасность обеспечивает SSH-демон: используйте только ключи, отключите аутентификацию по паролю и примените остальные рекомендации по укреплению безопасности SSH на вашем VPS. Если ваш VPS станет частью небольшой частной сети с базой данных или staging-сервером, анонсирование этих адресов в вашей tailnet с помощью subnet router избавит вас от необходимости настраивать проброс для каждого сервиса, хотя при использовании dsh на loopback доступ к самому UI по-прежнему будет осуществляться через туннель.
Ключ не должен находиться в unit-файле. Значения Environment= выводятся командой systemctl show dsh -p Environment, которую может запустить любой пользователь на сервере. Если плагину требуется ключ в переменных окружения, поместите его в /etc/dsh.env с правами 600, принадлежащий root, и сошлитесь на него через EnvironmentFile=/etc/dsh.env. systemd считывает этот файл от имени root во время выполнения, а systemctl show не выводит его содержимое. О том, в какой файл на диске попадает каждая настройка и что покидает ваш сервер, когда вы переключаете dsh на локальный эндпоинт Ollama вместо API DeepSeek, читайте в разделе настройка ключей, моделей и эндпоинтов dsh.
Стоимость эксплуатации
Инференс выполняется через API DeepSeek, а не на вашем VPS. Ваш сервер оплачивает работу процесса Node, обслуживаемого им интерфейса и каждой команды, которую агент решает выполнить. Первые два фактора стабильны и незначительны. Третий ничем не ограничен в данном unit-файле.
Определите базовое потребление на своем сервере, вместо того чтобы доверять чужим цифрам:
systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2MemoryCurrent измеряется в байтах. Отслеживайте этот показатель во время работы агента, а не в режиме ожидания.
Вызовы инструментов являются дочерними процессами сервиса, поэтому они попадают в ту же контрольную группу (cgroup) и учитываются в рамках тех же лимитов. Агент, запускающий npm install или набор тестов внутри рабочей директории, может потреблять значительно больше памяти, чем сама оболочка. На VPS с 1 GB ОЗУ именно здесь возникают сбои: ядро выбирает процесс и завершает его, а journalctl -k | grep -i "out of memory" показывает строку Out of memory: Killed process с указанием того, что было выбрано. Часто это не тот процесс, который вызвал проблему.
Решение заключается в установке осознанных ограничений. Параметры MemoryMax= и CPUQuota= в секции [Service] локализуют ущерб внутри юнита, поэтому вышедшая из-под контроля сборка будет завершена, вместо того чтобы привести к зависанию всего сервера. В ограничении памяти и CPU с помощью systemd описаны значения и поведение при сбоях. Дисковое пространство также расходуется: из-за истории сессий в DSH_HOME и любых данных, которые агент записывает в рабочую область, поэтому добавьте du -sh /var/lib/dsh в используемую вами систему мониторинга диска.
Если вам нужен интерактивный агент, к которому можно подключаться и отключаться, формат сервиса не подходит, и лучше использовать запуск агента в постоянной сессии tmux. Запускайте dsh как юнит, если он должен быть постоянно активен и доступен через туннель.
Типы сбоев и сообщения, которые вы увидите
status=203/EXEC. systemd не удалось запустить файл, и в логах Failed to locate executable /usr/local/bin/dsh: No such file or directory. Путь в ExecStart= не совпадает с тем, что вывел command -v dsh. Это ошибка, о которой Type=exec сообщает во время systemctl start, вместо того чтобы скрывать её.
status=217/USER. systemd не удалось определить или изменить учетные данные пользователя из User= и Group=, либо настроить пространство имен пользователя. Для этого юнита типичная причина — несуществующая учетная запись. Проверьте это с помощью id dsh.
status=200/CHDIR. WorkingDirectory= отсутствует, или пользователь сервиса не может войти в эту директорию. sudo -u dsh ls /var/lib/dsh/workspace воспроизводит это напрямую.
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Порт уже занят, обычно это процесс npx, оставшийся открытым в другом терминале. sudo ss -lntp | grep 3080 называет этот процесс.
EACCES: permission denied с последующим путем. Права доступа в /var/lib/dsh неверны, обычно из-за того, что первый запуск был выполнен от имени root или с неверным HOME. sudo chown -R dsh:dsh /var/lib/dsh исправляет это.
Start request repeated too quickly. Юнит достиг лимита частоты запуска и прекратил попытки. Реальная ошибка находится в строках выше. Выполните sudo systemctl reset-failed dsh перед повторной попыткой.
Юнит в состоянии active (running), но браузер ничего не показывает. Выполните проверку на VPS: если curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ выводит код состояния, значит, слушатель отвечает на VPS, поэтому далее проверьте проброс портов. Этот код не доказывает, что всё загрузилось: апстрим указывает, что сбои необязательных плагинов не отменяют статус готовности, поэтому изучите journalctl -u dsh -n 200 --no-pager на предмет ошибок плагинов. Код 401 в браузере означает отсутствие валидной сессионной cookie и отсутствие валидного токена запуска в URL — либо из-за того, что вы открыли «голый» URL, либо из-за того, что токен остался от предыдущего запуска. Откройте URL, который вывел текущий процесс.
Целенаправленное обновление
Фиксация версии означает, что обновление — это действие, которое вы выполняете намеренно, а не событие, происходящее без вашего ведома. Сначала ознакомьтесь с примечаниями к выпуску, так как предупреждения разработчиков о нарушении обратной совместимости являются основной причиной для фиксации. Создайте резервную копию каталога с состоянием, а затем замените версию:
sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pagerОткат выполняется аналогично npm install -g с использованием старой версии и восстановлением архива, что возможно только при наличии предварительно созданной копии. Среда выполнения агента на стадии предварительного тестирования — это именно тот тип ПО, где обновление может изменить формат конфигурации без вашего участия.
FAQ
Почему dsh останавливается, когда я закрываю сеанс SSH?
Потому что npx @deepseek-ai/dsh web — это процесс переднего плана, принадлежащий вашему сеансу входа, поэтому при завершении сеанса он останавливается. Юнит systemd вместо этого принадлежит системе инициализации, поэтому продолжает работать после отключения и снова запускается после перезагрузки. sudo systemctl enable --now dsh — это пара шагов, которая обеспечивает оба варианта: enable для перезагрузки, --now для текущей загрузки.
Следует ли использовать Type=simple или Type=exec для dsh?
Type=exec. dsh работает в переднем плане и не создаёт дочерний процесс, поэтому подходят оба варианта, но Type=exec заставляет systemd дождаться успешного выполнения execve(), прежде чем считать запуск успешным. Неправильный путь в ExecStart= в таком случае приводит к ошибке systemctl start, которую сразу показывает status=203/EXEC. С Type=simple та же ошибка возвращает успешный результат и остаётся только в журнале. Type=forking и Type=notify здесь также неверны: оба варианта ожидают истечения TimeoutStartSec, которое по умолчанию составляет 90 секунд.
Как открыть веб-интерфейс dsh с ноутбука?
Переадресуйте порт через SSH: ssh -N -L 3080:127.0.0.1:3080 you@your-vps, затем откройте в браузере URL, который dsh вывел при запуске. Найти его можно с помощью journalctl -u dsh. Этот URL содержит токен запуска, и браузер без аутентификации получает ответ 401 без этого токена. После входа cookie сеанса по умолчанию действует 30 дней и сохраняется после перезапуска сервиса. Оставьте для сервиса значение loopback по умолчанию. dsh отклоняет wildcard, например --host 0.0.0.0, как неопределённый адрес. Хотя конкретный локальный адрес принимается, привязка не к loopback обеспечивает обычный HTTP без TLS. В результате токен запуска агента, выполняющего shell-команды по сети, передаётся в открытом виде.
Можно ли запускать dsh от имени root, чтобы упростить работу с разрешениями?
Нет. Этот harness предназначен для выполнения команд и записи файлов, поэтому сервис и агент получают одинаковые привилегии. Создайте системную учётную запись с помощью useradd --system --shell /usr/sbin/nologin dsh, назначьте её владельцем /var/lib/dsh и добавьте NoNewPrivileges=true в юнит. Если после этого появляется EACCES: permission denied, обычно причиной являются файлы, оставшиеся после предыдущего запуска от имени root. Команда sudo chown -R dsh:dsh /var/lib/dsh удаляет такие файлы.
Какую версию dsh следует зафиксировать в юните?
Ту версию, которую показывает npm view @deepseek-ai/dsh version при настройке сервиса, установив её с помощью npm install -g @deepseek-ai/dsh@<that version> и записав результат там, где вы сможете его найти. На 18 August 2026 актуальной была 0.1.0-rc.7, на 11 October 2026 — 0.2.0-rc.2, а на 27 October 2026 — 0.2.1-rc.2; к этому моменту next уже имела версию 0.2.1-rc.4. На 4 November 2026 и latest, и next указывают на 0.2.1-rc.5. Сборки вплоть до 0.1.0-rc.7 не поддерживают аутентификацию в браузере, поэтому не фиксируйте одну из них для веб-профиля. Важно не само число версии, а то, что npx без версии разрешается в пакет во время запуска. Поэтому автоматический перезапуск может незаметно перевести сервис на сборку с другим форматом конфигурации.