Instalacja DeepSeek Harness na VPS i bezpieczny dostęp
Instrukcja konfiguracji DeepSeek Harness na serwerze Linux. Dowiedz się, jak przypiąć wersję npm, ograniczyć dostęp do portu 3080 oraz zestawić bezpieczny tunel SSH.
Czym jest DeepSeek Harness
DeepSeek Harness (dsh) to środowisko uruchomieniowe agenta oparte na Node.js, które można uruchomić na serwerze VPS (virtual private server). Bezpieczny sposób jego obsługi polega na powiązaniu z 127.0.0.1 i uzyskiwaniu dostępu przez przeglądarkę za pośrednictwem tunelu SSH (secure shell). Narzędzie udostępnia interfejs webowy (web UI) na porcie 3080, zamiast działać wyłącznie w terminalu. W wersji 0.1.0-rc.6, na której opiera się ten poradnik, serwer webowy nie wymaga własnego hasła. Oznacza to, że wystawienie portu 3080 na świat daje każdemu dostęp do agenta, który może odczytywać pliki i wykonywać polecenia z uprawnieniami użytkownika Linux. Nowsze wydania, od 0.2.0-rc.2 do 0.2.2-rc.2 z dnia 11 listopada 2026 (najnowsza wersja wymieniona w serwisie GitHub w dniu 12 listopada 2026), wyświetlają przy starcie adres URL z unikalnym tokenem sesji, który jest następnie wymieniany na ciasteczko. Mimo to, domyślnie nadal nasłuchują one na interfejsie zwrotnym (loopback) i odmawiają powiązania ze wszystkimi interfejsami sieciowymi.
DeepSeek udostępnia oprogramowanie na licencji MIT jako pakiet npm @deepseek-ai/dsh. Projekt jest określany jako wersja poglądowa dla programistów (developer preview), w której należy spodziewać się zmian niekompatybilnych wstecz. Poniżej wskazano wersję z sierpnia 2026 roku. W dniu 12 listopada 2026 tag latest w rejestrze npm wskazuje na 0.2.2-rc.1. GitHub wymienia nowszą wersję przedpremierową 0.2.2-rc.2, oznaczoną tagiem dsh-v0.2.2-rc.2 i wydaną 11 listopada 2026 roku. Przed instalacją na istotnym serwerze należy sprawdzić repozytorium projektu.
Cała architektura opiera się na jednej koncepcji: wszystko jest wtyczką. Adapter modelu, rejestr narzędzi, dziennik sesji, piaskownica (sandbox), harmonogram oraz pętla agenta to wtyczki ładowane do wspólnego kontekstu, z których każdą można wymienić. Nie istnieje uprzywilejowane jądro, które byłoby jedynie uzupełniane przez wtyczki. To właśnie czyni Harness wartym uwagi, ale stanowi również główne źródło ryzyka. Ocena tego rozwiązania zależy od przyjętych kryteriów, a artykuł porównanie z Claude Code i Omnigent zestawia architekturę opartą na wtyczkach z dwoma innymi podejściami w zakresie integracji modeli, licencji oraz wymagań sprzętowych dla serwera VPS.
Harness to nie model
Harness uruchamia pętlę agenta. Proces wnioskowania odbywa się w modelu w innym miejscu, więc nic nie zadziała, dopóki nie podasz klucza API (application programming interface) lub adresu punktu końcowego modelu hostowanego samodzielnie. Wszystko w tym wpisie dotyczy konfiguracji harnessa, a nie zachowania modelu, a rozróżnienie między tymi dwoma elementami warto wyjaśnić, zanim spędzisz popołudnie na debugowaniu, po której stronie leży problem.
Konfigurację przeprowadza się w interfejsie użytkownika w sekcji Settings, a następnie Models. DeepSeek posiada własną kartę, a w bieżących wydaniach przycisk "Add model provider" poniżej otwiera dwa tryby. "Third-party model provider" obejmuje dostawców, dla których harness dostarcza katalog, takich jak OpenAI czy Anthropic, gdzie wklejasz klucz, a katalog dostarcza punkt końcowy i listę modeli. "Custom model API" to ciekawsza opcja: wymaga ona podania identyfikatora dostawcy małymi literami, nazwy wyświetlanej, bazowego adresu URL, protokołu API, danych uwierzytelniających oraz co najmniej jednego modelu. Selektor protokołu oferuje OpenAI Chat Completions, OpenAI Responses, Anthropic Messages oraz Gemini API, dzięki czemu można skonfigurować bramkę lub lokalny serwer obsługujący jeden z tych standardów; punkty końcowe z różnicami w formacie żądań wymagają ustawień kompatybilności. Niestandardowi dostawcy mogą również odpytać punkt końcowy GET /models zgodny z OpenAI, aby automatycznie uzupełnić listę modeli.
W ten sposób wskazujesz harnessowi model znajdujący się na tym samym VPS. Ollama udostępnia API zgodne z OpenAI pod adresem http://127.0.0.1:11434/v1/, a pole klucza API przyjmuje dowolny ciąg znaków, zgodnie z konwencją ollama, ponieważ klient w stylu OpenAI wymaga wartości, a Ollama ją ignoruje. Dokumentacja Ollama opisuje również ollama launch dsh, który instaluje @deepseek-ai/dsh, jeśli go brakuje, i uruchamia go z modelem Ollama, więc sprawdź, która wersja jest instalowana, zanim polegniesz na poniższym przypięciu. To, czy model wystarczająco mały, aby zmieścić się na VPS, jest wystarczająco dobry do obsługi agenta, to trudniejsze pytanie, a różnica między Ollama a vLLM jako lokalnym serwerem modelu decyduje o tym, ile pamięci RAM pochłonie odpowiedź.
Klucze wpisane w interfejsie są typu write-only. Harness przechowuje je w $DSH_HOME/.credentials.yaml, a ustawienia zachowują jedynie odniesienie do danych uwierzytelniających, które bieżące wydania zapisują w pliku patch aktywnego profilu, $DSH_HOME/profiles/<profile>/cordis.patch.yml (profil to web dla dsh web). $DSH_HOME domyślnie przyjmuje wartość ~/.dsh. Traktuj plik z danymi uwierzytelniającymi jak plik z hasłami, ponieważ nim jest: każdy, kto go odczyta, może wydać Twój budżet API. Jeśli chcesz edytować te pliki bezpośrednio, zamiast klikać w Settings, przewodnik po plikach konfiguracyjnych dsh, kluczach i punktach końcowych modeli pokazuje, co robi każdy klucz i co opuszcza Twój serwer w każdym z trybów.
Wymagania wstępne przed instalacją
- VPS z systemem Ubuntu 24.04 lub innym aktualnym systemem Linux oraz dostępem przez SSH
- Node.js 24.9 lub nowszy, ponieważ główna gałąź projektu oraz
0.2.2-alpha.2deklarują obecnie>=24.9.0, a testy CI sprawdzają Node 24 z weryfikacją kompatybilności dla Node 24.9 i Node 26, bez zadania dla Node 22; oznaczone wydania w0.2.1-rc.4nadal wymieniały Node 22.19 jako dopuszczalny, jednak nie jest to już minimalna wersja, dla której budowany jest projekt - zwykłe konto użytkownika, nie
root, ponieważ agent wykonuje polecenia powłoki jako użytkownik, który uruchomił proces pnpmw zmiennej PATH, jeśli planowana jest instalacja wtyczek, ponieważ polecenie wtyczki wywołuje je w powłoce- port 3080 zamknięty na zaporze sieciowej oraz na zewnętrznej zaporze sieciowej dostawcy
Własny pakiet nodejs w systemie Ubuntu 24.04 jest starszy niż wymagania środowiska, dlatego w tym wydaniu należy zainstalować Node z NodeSource lub nvm, zamiast korzystać z apt install nodejs. Oficjalne repozytorium Ubuntu 26.10 zawiera Node 24.19.0, co przekracza wymagane minimum 24.9. Jeśli VPS jest świeżo zainstalowany, warto poświęcić dziesięć minut na zabezpieczenie SSH przed wykonaniem jakichkolwiek innych czynności, ponieważ tunel, na którym będziesz polegać, jest tak bezpieczny, jak serwer SSH, który go obsługuje.
Instalacja DeepSeek Harness na VPS z przypiętą wersją
node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 webnpx pobiera pakiet i uruchamia jego plik binarny dsh. web to alias dla --profile web, który uruchamia aplikację przeglądarkową, a proces wypisuje adres, na którym nasłuchuje. Wartością domyślną jest http://127.0.0.1:3080. Te liczby to decyzja o powiązaniu (binding), a nie kosmetyczne ustawienie domyślne, a dlaczego dsh wypisuje adres loopback wyjaśnia, na co harness odpowie, a na co nie, zanim zaczniesz szukać go z poziomu laptopa.
Przypnij wersję. npx @deepseek-ai/dsh web rozwiązuje to, na co wskazuje tag latest w momencie uruchomienia, chyba że projekt, z którego go uruchamiasz, ma już zainstalowaną kopię – w takim przypadku npx po cichu użyje tej kopii. Tak czy inaczej, to nie Ty wybierasz wersję, a projekt wydał już kilka kandydatów do wydania (release candidates) i zapowiada zmiany powodujące awarie (breaking changes). 0.1.0-rc.6 to wersja z sierpnia 2026 przypięta w tym miejscu. 12 listopada 2026 latest wskazuje na 0.2.2-rc.1, wydanie, które wypisuje tokenizowany adres URL startowy; GitHub wymienia nowszą wersję przedpremierową 0.2.2-rc.2, więc przejście na inną wersję jest dokładnie tym rodzajem aktualizacji, którą należy przeprowadzić celowo po przeczytaniu repozytorium. Przypięta wersja oznacza, że serwer skonfigurowany dzisiaj będzie zachowywał się tak samo w przyszłym miesiącu, więc aktualizacja staje się decyzją, a nie przypadkiem, który odkrywasz. Gdy przypięte polecenie nadal uruchamia niewłaściwą kompilację lub odmawia instalacji, typowe błędy instalacji i wersji dsh opisują czyszczenie pamięci podręcznej npx oraz sprawdzanie, którego npm używa zestaw Node.
Do codziennego użytku zainstaluj go raz, zamiast rozwiązywać zależności przy każdym starcie.
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --helpDrugą linię warto uruchomić, ponieważ program uruchamiający i aplikacja internetowa mają oddzielne zestawy flag. dsh --help pokazuje opcje samego launchera. dsh --profile web --help pokazuje flagi akceptowane przez aplikację internetową, gdzie znajdują się --port, --host oraz powtarzalna --trusted-host.
Teraz potwierdź, na czym odbywa się nasłuchiwanie.
ss -tlnp | grep 3080Kolumna adresu lokalnego powinna wskazywać 127.0.0.1:3080. Jeśli wskazuje 0.0.0.0:3080, interfejs użytkownika nasłuchuje na wszystkich interfejsach, więc tylko firewalle chronią go przed Internetem i należy zatrzymać proces przed wykonaniem jakichkolwiek innych działań.
Dlaczego nigdy nie należy udostępniać portu 3080
Serwer WWW w 0.1.0-rc.6 nie posiada warstwy uwierzytelniania. Jego konfiguracja określa jedynie hosta i port nasłuchiwania, co stanowi pełną powierzchnię ataku. Kontrola dostępu w wdrożeniach innych niż loopback opiera się na ustawieniu zaufanych hostów, co nie jest ekranem logowania.
Nowsze wydania wprowadzają zabezpieczenia. Od wersji 0.2.0-rc.2 podczas uruchamiania wyświetlany jest adres URL zawierający unikalny token dla danego procesu. Przeglądarka, która go otworzy, otrzymuje podpisane ciasteczko sesyjne i zostaje przekierowana na ten sam adres bez tokena. Mechanizm weryfikacji Host/Origin przed /api akceptuje tylko połączenia z interfejsu loopback, własnego adresu powiązanego z procesem oraz autorytetów wskazanych w --trusted-host. Jest to realne zabezpieczenie, jednak dokumentacja projektu ostrzega, że wyświetlony adres URL jest poświadczeniem, które należy udostępniać tylko zaufanym użytkownikom, a protokół HTTP przesyła je bez szyfrowania. Od wersji 0.2.1-alpha.2 aplikacja WWW może również powiązać się z konkretnym adresem lokalnym i obsługiwać HTTPS za pomocą --tls-cert oraz --tls-key. Rozwiązuje to problem przesyłania danych otwartym tekstem, ale nie eliminuje ryzyka ekspozycji. Utrudnia to nadużycie otwartego portu, ale nie czyni go bezpiecznym do publikacji w sieci.
Należy wziąć pod uwagę, co znajduje się za tym portem. Agent edytuje pliki w obszarze roboczym i wykonuje polecenia powłoki, a poświadczenia dostawcy znajdują się na dysku w tym samym katalogu. W starszych wersjach otwarty port 3080 to zdalna powłoka z interfejsem czatu, działająca z uprawnieniami użytkownika, który ją uruchomił, z dołączonym kluczem API. Do przejęcia kontroli nie jest potrzebny żaden exploit. Wystarczy numer portu. W wersjach z tokenem startowym wymagany jest również token, który posiada każdy, kto ma dostęp do terminala, dzienników usługi lub niezaszyfrowanego ruchu sieciowego.
Interfejs CLI (command line interface) potwierdza to podejście. Od wersji 0.1.0-rc.6 celowo nie obsługuje on --host 0.0.0.0 i kończy działanie błędem składni zamiast uruchomienia, a nowsze 0.2.2-alpha.2 również odrzuca taką konfigurację przy starcie. Ta odmowa jest zamierzoną funkcją, więc nie należy szukać poprawek usuwających to ograniczenie.
Dopuszczalne są dwa inne sposoby wdrożenia, jeśli tunelowanie nie jest odpowiednim rozwiązaniem. Można umieścić serwer w prywatnej sieci nakładkowej (overlay network), tak aby posiadał adres dostępny tylko dla własnych urządzeń, co zapewnia własny serwer kontrolny Headscale. Alternatywnie można zastosować reverse proxy, które uwierzytelni żądanie przed przekazaniem go na port 3080, na przykład poprzez serwer logowania jednokrotnego Authentik z funkcją forward auth. Reverse proxy bez uwierzytelniania nie stanowi zabezpieczenia. Jest jedynie dłuższym adresem URL.
Dostęp do interfejsu WWW przez tunel SSH
Wykonaj to polecenie na komputerze lokalnym, a nie na serwerze.
ssh -N -L 3080:127.0.0.1:3080 you@your-server-L otwiera port 3080 na komputerze lokalnym i przekazuje cały ruch nawiązujący z nim połączenie przez szyfrowaną sesję SSH. Część 127.0.0.1:3080 jest rozwiązywana po stronie serwera, więc połączenie dociera do harness z interfejsu loopback, dokładnie tak, jakby użytkownik znajdował się bezpośrednio przy maszynie. Flaga -N informuje, aby nie uruchamiać zdalnej powłoki, ponieważ wymagane jest jedynie przekierowanie portu.
Następnie otwórz http://127.0.0.1:3080 w lokalnej przeglądarce. W przypadku wersji z tokenem startowym, otwórz pełny adres URL wyświetlony przez serwer wraz z tokenem; gdy harness jest uruchamiany przez SSH, wyświetla linię startową, ale nie podejmuje próby otwarcia przeglądarki. Jeśli port 3080 jest już zajęty na komputerze lokalnym, zmień liczbę po lewej stronie: ssh -N -L 3180:127.0.0.1:3080 you@your-server, a następnie przejdź pod adres http://127.0.0.1:3180, zmieniając port w adresie URL z tokenem w ten sam sposób. Liczba po lewej stronie odnosi się do portu lokalnego, a liczba po prawej do portu na serwerze, dlatego modyfikacji podlega tylko lewa wartość.
Zapisz to w ~/.ssh/config, aby uniknąć ponownego wpisywania.
Host dsh
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/id_ed25519
LocalForward 3080 127.0.0.1:3080Następnie ssh -N dsh uruchamia tunel. Komunikat przeglądarki o odrzuceniu połączenia zazwyczaj oznacza, że tunel jest aktywny, ale po drugiej stronie żadna usługa nie nasłuchuje, ponieważ SSH przekazuje port niezależnie od tego, czy harness jest uruchomiony. Sprawdź stan serwera za pomocą polecenia ss wskazanego powyżej.
Utrzymanie procesu w działaniu po wylogowaniu
Polecenie npx kończy działanie wraz z zamknięciem powłoki. Usługa użytkownika systemd działa w tle i przywraca proces po awarii lub restarcie systemu. Poniższa jednostka jest celowo minimalistyczna; jeśli wymagane jest uruchomienie procesu na dedykowanym koncie z ograniczonymi uprawnieniami, z przypiętą wersją oraz przeszukiwalnymi logami, konfiguracja headless systemd dla dsh opisuje to szczegółowo.
loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dshParametr enable-linger jest istotny, ponieważ usługi użytkownika są domyślnie zatrzymywane po zakończeniu ostatniej sesji, więc bez niego proces zostanie przerwany w momencie zamknięcia tunelu. Należy użyć ścieżki bezwzględnej wyświetlonej przez command -v dsh i umieścić ją w jednostce, ponieważ systemd nie przeszukuje zmiennej PATH zdefiniowanej w powłoce logowania.
[Unit]
Description=DeepSeek Harness web UI
After=network-online.target
[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.targetParametr WorkingDirectory nie jest opcjonalny. Proces dsh używa katalogu, z którego został wywołany, jako domyślnej lokalizacji w systemie plików, więc usługa uruchomiona w niewłaściwym miejscu wskazuje agentowi błędny folder. Katalog ten jest jedynie wartością domyślną: nowy interfejs Web UI nie ma wybranego obszaru roboczego, dopóki nie zostanie on dodany w sekcji Choose workspace, a dokumentacja projektu zaleca dodanie katalogu, w którym uruchomiono dsh. Dokumentacja nie zawiera oznaczenia wersji, a ten sam zapis znajduje się w 0.1.0-rc.7, więc należy spodziewać się go również w przypiętym wydaniu. Należy ustawić katalog jednostki na katalog projektu, a następnie wybrać ten obszar roboczy w interfejsie.
systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dshJednostka, która nie chce się uruchomić, zazwyczaj posiada błędną ścieżkę ExecStart lub korzysta z wersji Node, której plik binarny nie akceptuje; journalctl --user -u dsh -n 50 wskazuje przyczynę. W wydaniu z tokenem startowym, dziennik systemd jest również miejscem, w którym pojawia się URL z tokenem, a każdy restart generuje nowy. Ten sam schemat dotyczy utrzymywania dowolnego agenta programistycznego na VPS, a typy błędów są identyczne.
Zakres uprawnień wtyczki
Wtyczka to moduł dostarczający usługi, typowane zdarzenia oraz odwracalne efekty do współdzielonego kontekstu. Punkty rozszerzeń wymagają wnikliwej analizy:
- rejestracja dostawcy modelu w
ctx.llm - dodawanie narzędzi dla modelu w
ctx.tools - dostarczanie backendu powłoki w
ctx.shell - zapewnianie dostępu do systemu plików lub polityk w
ctx.fs - rejestracja poleceń użytkownika w
ctx.commands - wykonywanie zadań w tle przez
ctx.jobs - opakowywanie uruchamianych procesów backendem
ctx.sandbox - przechwytywanie żądań i wywołań narzędzi przez zdarzenia
agent/*oraztools/* - rozszerzanie trwałego stanu sesji
- sterowanie interfejsem użytkownika przez
ctx.agents
Należy przeanalizować tę listę z perspektywy atakującego. Wtyczka może dostarczyć warstwę systemu plików oraz warstwę powłoki, a także pośredniczyć w każdym wywołaniu narzędzia przez model. Brak okien dialogowych z prośbą o uprawnienia między wtyczką a tymi punktami styku, ponieważ wtyczka jest zwykłym kodem Node ładowanym do tego samego procesu co reszta aplikacji. Instalacja wtyczki oznacza uruchomienie obcego kodu z uprawnieniami agenta, a uprawnienia agenta są tożsame z uprawnieniami użytkownika Unix.
Jest to ta sama decyzja o zaufaniu, którą podejmuje się podczas podłączania serwera MCP do agenta na VPS, gdzie MCP oznacza model context protocol. Z tego samego powodu bezpieczne uruchamianie agenta programistycznego na VPS zaczyna się od konfiguracji konta, na którym działa proces, a nie od modelu, oraz dlatego ataki na łańcuch dostaw npm są tak dotkliwe dla serwerów: etap instalacji stanowi moment przejęcia kontroli, a system nie wyświetla żadnych ostrzeżeń.
Źródła wtyczek
Wtyczki znajdują się w profilach. Profil to nazwany zestaw przechowywany w $DSH_HOME, domyślnie w ~/.dsh. Każdy katalog profilu zawiera zainstalowane wtyczki spoza głównego drzewa. Interfejs CLI zarządza nimi, przekazując argumenty bezpośrednio do pnpm, używając katalogu profilu jako katalogu roboczego.
dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-uiPonieważ argumenty docierają do pnpm w niezmienionej formie, add, remove, update oraz why zachowują się tak samo, jak w każdym projekcie pnpm, a wtyczka może być pakietem npm lub odwołaniem do GitHub. pnpm musi najpierw znajdować się w PATH. W Node 24 polecenie corepack enable pnpm dodaje je tam. Node 25 przestał dystrybuować Corepack, więc w Node 25 i nowszych należy zainstalować go za pomocą npm install -g pnpm.
Wyszukiwanie odbywa się poprzez temat (topic) w serwisie GitHub. Autorzy wtyczek dodają temat dsh-plugin do swoich repozytoriów, a przeglądanie tego tematu pozwala sprawdzić, co jest dostępne. Temat to etykieta, którą autor przypisuje do własnego repozytorium. Nikt go nie weryfikuje ani nie podpisuje, a strona tematu jest sortowana według liczby gwiazdek, co odzwierciedla popularność, a nie bezpieczeństwo.
Obecne wydania zawierają również eksperymentalny pakiet niestandardowych indeksów wtyczek. Po włączeniu go w sekcji Plugins, karta Discover umożliwia dodanie indeksu, który jest plikiem JSON pobieranym z podanego adresu URL. Mechanizm nie posiada własnego indeksu, sprawdza format pliku, ale nie weryfikuje tytułów, autorów ani źródeł deklarowanych przez rynek. Każdy podmiot na ścieżce sieciowej może zmodyfikować indeks przesyłany przez nieszyfrowane http:. Rynek to katalog stworzony przez kogoś innego, a nie wynik weryfikacji.
Cztery nawyki pozwalają zachować kontrolę. Przed instalacją należy przeczytać kod źródłowy, ponieważ większość wtyczek jest na tyle mała, że można to zrobić w dziesięć minut. Należy przypiąć konkretną wersję lub commit zamiast śledzić gałąź. Mechanizm należy uruchamiać na użytkowniku, który nie posiada żadnych innych zasobów, na serwerze VPS, który można w razie potrzeby zresetować. Agentowi należy nadać własny klucz API z określonym limitem wydatków, oddzielny od klucza używanego przez usługi produkcyjne. Jeśli chcesz sprawdzić, które pliki wtyczki niosą ryzyko, przewodnik po weryfikacji wtyczek dsh omawia manifest, punkt wejścia oraz punkty rozszerzeń rejestrowane przez wtyczkę.
Jeśli przed podjęciem decyzji wolisz porównać różne projekty, wielozadaniowy mechanizm Omnigent rozwiązuje ten sam problem przy użyciu innej struktury, a różnice stają się oczywiste po uruchomieniu wtyczek. Jeśli zdecydujesz się na utrzymywanie dwóch lub trzech takich rozwiązań na jednym serwerze zamiast wyboru jednego, umieszczenie każdego mechanizmu za jednym własnym API pozwoli uniknąć tworzenia tunelu dla każdego portu, kosztem dodania kolejnej usługi, którą należy powiązać z interfejsem loopback i zabezpieczyć silnym hasłem już w pierwszym dniu.
Co ulega awarii jako pierwsze
Wersja Node jest zbyt stara. Główna gałąź projektu oraz 0.2.2-alpha.2 wymagają Node 24.9 lub nowszego. Testy CI sprawdzają Node 24 oraz zapewniają kompatybilność z Node 24.9 i Node 26, nie uwzględniając Node 22. Starsze wersje oznaczone tagami do 0.2.1-rc.4 uznawały Node 22.19 za dopuszczalny, jednak projekt nie kompiluje się już z użyciem tej wersji. Starsze środowisko uruchomieniowe zawodzi przy starcie, ponieważ kod wykorzystuje składnię i API, których ono nie posiada. Przed wykonaniem jakichkolwiek innych czynności uruchom node --version.
Port 3080 jest już zajęty. Przyczyną może być drugi zestaw narzędzi, zawieszony proces lub inna aplikacja korzystająca z portu 3080. Zidentyfikuj proces za pomocą ss -tlnp | grep 3080, a następnie zatrzymaj go lub uruchom zestaw narzędzi w innym miejscu za pomocą dsh web --port 3180. --port należy do aplikacji webowej, więc musi zostać uruchomiony po web.
Przeglądarka nie może połączyć się przez tunel. Upewnij się, że w przeglądarce wpisano 127.0.0.1, a nie publiczny adres serwera, ponieważ przekierowany port istnieje tylko na Twoim laptopie. Następnie sprawdź, czy zestaw narzędzi nasłuchuje na serwerze, ponieważ SSH konfiguruje przekierowanie niezależnie od tego, czy po drugiej stronie działa jakakolwiek usługa.
dsh plugin kończy się natychmiastowym błędem. Polecenie to jest nakładką na pnpm, więc brak pliku binarnego pnpm przerywa działanie przed rozpoczęciem pracy jakiejkolwiek wtyczki. W wersji Node 25 i nowszych jest to stan domyślny, ponieważ Corepack nie jest już dostarczany wraz z Node.
Agent nie widzi projektu. Nowy interfejs webowy nie ma wybranego obszaru roboczego, dopóki nie zostanie on dodany, a kompozytor sesji pozostaje niedostępny do tego momentu. Proces wykorzystuje katalog, w którym został uruchomiony, jedynie jako domyślną lokalizację systemu plików, więc jednostka, której WorkingDirectory wskazuje na katalog domowy, kieruje agenta właśnie tam. Wybierz obszar roboczy w interfejsie lub popraw jednostkę i przeładuj ją.
FAQ
Czy wystawienie interfejsu webowego DeepSeek Harness na porcie 3080 jest bezpieczne?
Nie. W przypiętym 0.1.0-rc.6 serwer WWW nie posiada własnego mechanizmu logowania, a agent działający w tle edytuje pliki i wykonuje polecenia powłoki jako użytkownik, który uruchomił proces, przy czym klucz API dostawcy jest przechowywany na tym samym dysku. Od wersji 0.2.0-rc.2, wliczając w to 0.2.2-rc.1, wydanie latest pakietu npm z 12 listopada 2026 oraz nowszą wersję przedpremierową 0.2.2-rc.2, adres URL wyświetlany przy starcie zawiera token sesji, który przeglądarka wymienia na ciasteczko. Adres ten jest jednak poświadczeniem, które w przypadku zwykłego HTTP jest przesyłane w formie niezaszyfrowanej, dlatego zalecenie pozostaje niezmienne. Należy utrzymać nasłuchiwanie na 127.0.0.1 i uzyskiwać dostęp przez tunel SSH. Sprawdza się również prywatna sieć nakładkowa (overlay network) lub reverse proxy, które uwierzytelnia każde żądanie przed przekazaniem go do portu. Od wersji 0.1.0-rc.6 interfejs CLI odrzuca --host 0.0.0.0 i kończy działanie błędem składni, a 0.2.2-alpha.2 również odrzuca to rozwiązanie, co wskazuje na stanowisko autorów w tej kwestii.
Czy potrzebuję klucza API DeepSeek, czy mogę użyć modelu lokalnego?
Oba rozwiązania są poprawne, ponieważ harness jest środowiskiem uruchomieniowym, a nie modelem. W sekcji Settings, a następnie Models, można wkleić klucz do karty DeepSeek lub innego dostawcy, albo wybrać "Add model provider" i "Custom model API", podając bazowy adres URL obsługujący standardy OpenAI Chat Completions, OpenAI Responses, Anthropic Messages lub Gemini API. Lokalny serwer Ollama odpowiada pod adresem http://127.0.0.1:11434/v1/ i akceptuje dowolny ciąg znaków w polu klucza API. Klucze są zapisywane w $DSH_HOME/.credentials.yaml, którego domyślna lokalizacja to ~/.dsh/.credentials.yaml.
Do jakich zasobów uzyskuje dostęp wtyczka zainstalowana w DeepSeek Harness?
Wtyczka otrzymuje uprawnienia konta, na którym uruchomiono harness. Wtyczka to kod Node ładowany do tego samego procesu, a punkty rozszerzeń obejmują backend powłoki, warstwę systemu plików, rejestr narzędzi oraz zdarzenia otaczające każde wywołanie narzędzia. Żaden mechanizm nie izoluje wtyczki od tych elementów, chyba że sama wtyczka zapewnia własne środowisko uruchomieniowe (sandbox). Przed instalacją należy zapoznać się z kodem źródłowym i uruchamiać harness jako użytkownik, który nie posiada dostępu do żadnych istotnych danych.
Którą wersję należy zainstalować i czy będzie ona nadal działać?
Należy zainstalować konkretną wersję, na przykład npx @deepseek-ai/dsh@0.1.0-rc.6 web. Jest to wersja z sierpnia 2026, przypięta w tym miejscu. W dniu 12 listopada 2026 tag latest w npm wskazuje na 0.2.2-rc.1; GitHub wymienia nowszą wersję przedpremierową 0.2.2-rc.2, wydaną 11 listopada, a bieżący interfejs CLI wymaga środowiska Node 24.9 lub nowszego. Projekt jest określany jako wersja poglądowa dla programistów (developer preview), w której należy spodziewać się zmian naruszających kompatybilność, dlatego nieprzypięte polecenie może zachowywać się inaczej z dnia na dzień. Przed aktualizacją należy sprawdzić repozytorium i liczyć się z tym, że klucze konfiguracyjne oraz interfejsy wtyczek mogą ulegać zmianom, dopóki wersja zaczyna się od cyfry 0.