SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor ・更新日 2026-11-06

VPSでdshをsystemd常駐させる方法

VPSでdshをsystemdサービスとして常駐させる手順です。専用ユーザー、バージョン固定、Restart設定、journalctlログ、SSHトンネルによるUI接続を解説します。

VPS 上で dsh を端末から切り離して実行する

VPS 上で dsh を端末から切り離して実行するには、systemd の unit ファイルを1つ用意し、dsh の所有者となる専用ユーザーを作成します。dsh は DeepSeek Harness のコマンドラインランチャーです。DeepSeek Harness は DeepSeek のエージェントランタイムで、MIT ライセンスの下、2026年8月に developer preview として公開されました。harness はモデルそのものではなく、モデルを取り囲むプログラムです。そのため、systemd で管理するのは ループ、ツール、権限であり、DeepSeek の推論処理ではありません。quickstart では npx @deepseek-ai/dsh web と入力するよう案内されています。これは正しい方法ですが、SSH(secure shell)セッションを閉じると同時に終了します。

unit ファイルを使うと、4つの問題を同時に解決できます。再起動後もサービスが復旧します。出力は画面を流れ続けるのではなく、journal に記録されます。root ではないアカウントで実行できます。また、指定したバージョンを実行できます。今回はこの点が通常以上に重要です。upstream は次のように大文字で明記しています。

DeepSeek Harness は現在 developer preview であり、急速に変更されています。互換性を破壊する変更が発生します。

このガイドでは、dsh が手動で正常に動作することを前提とします。動作しない場合は、まず VPS への DeepSeek Harness のインストールから始め、npx @deepseek-ai/dsh web でページが表示される状態になってから戻ってきてください。

まず Node を確認する。npm の警告だけでは不十分

node -v

Ubuntu 24.04 の標準パッケージは Node 18(2026 年 8 月時点で 18.19.1)です。今年公開されたパッケージに対しては古いバージョンです。npm 自体は Node のバージョンを確認します。npm のドキュメントによると、パッケージの engines フィールドは engine-strict を有効にしない限り「警告を出すだけ」です。公開されている @deepseek-ai/dsh マニフェストには engines フィールドがありません(0.1.0-rc.7、0.2.1-rc.2、0.2.1-rc.4 について 2026 年 10 月 27 日に確認)。一方、リポジトリではこのフィールドが宣言されています。npm は依存関係の engine 要件も確認します。固定されている 0.2.1-rc.2 リリースは commander: ^15.0.0 を宣言しています。また、Commander 15 は Node >=22.12.0 を要求します。そのため、Ubuntu の Node 18 にインストールすると、通常の npm 設定では EBADENGINE 警告が出ます。デフォルトでは、この警告によってインストールは停止しません。実行時エラーになる前に Node を確認してください。

リポジトリが要求する最低バージョンも上がっています。0.2.1-rc.2 ソースは ^22.19.0 || >=24.0.0 を受け入れますが、master ブランチの CLI パッケージは現在 >=24.9.0 を宣言しており、Node 22 はこの要件を満たしません。NodeSource から Node 24 をインストールします。これは長期サポート(LTS)系列で、2026 年 10 月 20 日からメンテナンス期間に入っています。現在のビルドは両方の範囲を満たします。Node 26 は 2026 年 10 月 28 日に LTS になったと、Node.js のリリーススケジュールに記載されています。

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 は、24.9.0 以上の v24 バージョンを表示するはずです。less の行があるのは、リモートスクリプトをそのまま bash にパイプすると、内容を確認していないコードが実行されるためです。

unit を作成する前に実行を確認する

npx @deepseek-ai/dsh@0.2.1-rc.2 web

この状態で実行したままにします。2 つ目の SSH セッションから、次を実行します。

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/

HTTP ステータスコードが返れば、Web プロファイルは loopback で待ち受けています。デフォルトではここに bind します。401 が返ることを想定し、成功とみなします。UI は、表示された URL に含まれる launch token でブラウザーを認証し、その token と引き換えに署名付き session cookie を発行します。どちらも含まないリクエストには 401 を返します。000 と curl: (7) Failed to connect to 127.0.0.1 port 3080 が同時に表示される場合、待ち受けていません。最初のターミナルに理由が表示されています。先に進む前に Ctrl+C で手動実行を停止します。すでに別のプロセスが使用しているポートに bind しようとする unit は、Error: listen EADDRINUSE: address already in use 127.0.0.1:3080 で失敗します。

0.1.0-rc.7 は 18 August 2026 時点の公開バージョンでした。このバージョンは、このガイドが前提とするブラウザー認証より古いものです。Connection README には、アクセス制御は到達性ポリシーであり、「Web carrier provides no authentication layer」と記載されています。11 October 2026 には、latest tag が 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 で現在のバージョンを確認し、実行するバージョンを決めて固定してください。

指定したバージョンをグローバルにインストールする

unit file 内で npx を使用するのは適切ではありません。バージョン指定がない場合や、対応するローカルインストールがない場合、プロセスの起動時にパッケージバージョンを解決します。そのため、3 か月後に再起動すると、こちらで何も変更していなくても、プレビュー段階の agent の別のビルドが起動する可能性があります。パッケージやキャッシュデータがない場合も npm registry が必要です。そのため、registry の応答が遅いと、起動が遅延したり失敗したりします。npm はキャッシュを利用した実行やオフライン実行にも対応しています。次のように、バージョンを記録したうえで 1 回だけインストールします。

sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh

command -v dsh は、npm が NodeSource 由来の場合は /usr/bin/dsh を、Ubuntu 独自のパッケージ由来の場合は /usr/local/bin/dsh を出力します。unit file には、実際に出力されたパスを使用してください。npm ls -g は正確なバージョンを出力します。6 週間後に動作が変わり、何をインストールしたか思い出せなくなったときに必要な情報です。インストールに失敗した場合、実行後に command -v dsh が何も出力しない場合、または要求したものと異なるバージョンが返る場合は、unit file を作成する前に dsh のインストールとバージョンに関する一般的な失敗を確認してください。

サービス以外を所有しないユーザー

エージェントはシェルコマンドを実行します。それが役割です。root として実行すると、すべてのツール呼び出しが root 権限で実行されるため、ログインシェルを持たない専用アカウントを用意します。

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 がプロファイルを保存するディレクトリである DSH_HOME になります。プロファイルは、独自のパッチ層を上に重ねた、名前付きのプラグインバンドル群です。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を保持するか書き換えるかは、/etc/sudoers内の env_reset、env_keep、always_set_homeなどの設定によって異なります。設定を誤ると、初回実行時に 自分の ホームディレクトリをキャッシュと状態保存先として使用しようとします。その結果、権限エラーが発生したり、サービスが後で使用しない場所に状態が保存されたりします。curlチェックにステータスコードが表示されたら、Ctrl+C で停止します。

unit ファイル

/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.target

ExecStart=には、command -v dshで取得した絶対パスを指定します。systemd はコマンド名だけが指定された場合、固定されたパスの一覧を検索します。ただし、その一覧はシェルのPATHではありません。絶対パスを指定すれば、この不確実性をなくせます。

WorkingDirectory=は相対パスの基準となるディレクトリです。また、引数なしでlsを実行するツール呼び出しは、ここから開始します。エージェントに渡すワークスペースを指定します。ディレクトリが存在しない場合、またはサービスユーザーがそこへ移動できない場合、dsh が実行される前に unit はstatus=200/CHDIRで失敗します。

ProtectHome=trueは、プロセスから/homeと/rootを隠します。サービスがアクセスするすべてのものは/var/lib/dsh配下にあるため、ここでは安全です。ワークスペースに/home配下のパスを指定すると、エージェントはそのディレクトリが存在しないと報告します。この行を思い出すまで、原因が分かりにくい状態になります。ProtectSystem=fullにより、/usr、/boot、/etcは読み取り専用になります。このサービスがそこへ書き込む必要はありません。

さらに制限したくなりますが、通常は適切ではありません。ProtectSystem=strictを指定すると、カーネルの疑似ファイルシステムを除くファイルシステム全体が読み取り専用になります。この unit のPrivateTmp=true、/tmp、/var/tmpと組み合わせると、ワークスペースへの書き込みはEROFS: read-only file systemで失敗します。このレベルの制限が必要な場合は、同じ編集でReadWritePaths=/var/lib/dshを追加します。

ここにはどの Type= を指定すべきか

Type=execです。dsh はフォアグラウンドで動作し、fork しないためです。デフォルトより優れている点は、実際のエラーメッセージを確認できることです。Type=simpleでは、systemd は fork が完了するとすぐに起動成功と判断します。バイナリが存在するかどうかを確認する前の段階です。そのため、systemctl start dshは正常終了し、失敗は journal にしか現れません。Type=execでは、systemd は execve() が成功するまで待機します。そのため、ExecStart= の入力ミスが、入力したコマンド自体の失敗として返され、すぐに確認できます。

誤った2つの指定は、どちらも処理が停止したように見えます。Type=forkingは、親プロセスが終了するまで systemd に待機させます。dsh は終了しないため、TimeoutStartSecの期限(デフォルトは90秒)まで起動処理がブロックされ、その後 Job for dsh.service failed because a timeout was exceeded. と報告されます。Type=notifyは、sd_notify経由で READY=1 メッセージを待機します。メッセージを送信しない Node プロセスでは、同じように処理が停止します。systemd のサービス型に関する詳しい比較では、notifyを組み込む価値がある場面など、残りの内容も説明しています。

大きな失敗として現れる再起動ルール

Restart=on-failureは、終了コードが 0 以外の場合、または異常なシグナルで終了した場合に再起動します。正常に終了した場合は unit をそのまま停止します。systemd は、このサービス種別では SIGHUP、SIGINT、SIGTERM、SIGPIPE を正常なシグナルとして扱います。これはプレビュービルドに適した動作です。dsh が、受け付けない設定を読み込んだために 0 で終了した場合、unit は停止したままになります。systemctl status dsh には inactive (dead) と表示されるため、そこで確認できます。Restart=always を指定すると、同じ事象が再起動ループになり、遠目には正常に動作しているように見えます。

レート制限は省略されがちな設定です。systemd のデフォルトは、10 秒以内に 5 回の起動です。RestartSec=5s を指定すると、10 秒の期間内に 5 回の起動へ到達することがないため、起動時にクラッシュする unit が再起動を永久に繰り返し、その事実を把握できるのは journal だけになります。StartLimitIntervalSec=300 と StartLimitBurst=5 を使用すると、5 分以内の起動を 5 回まで許可し、その期間内の次の起動を拒否します。systemd は処理をあきらめ、unit を failed の状態に置きます。Start request repeated too quickly. と記録されます。原因を修正したら、sudo systemctl reset-failed dsh でこの状態を解除します。どちらの設定も [Unit] に記述し、[Service] には記述しません。認識されないオプションは無視されず、警告ログが出力されます。

起動して確認する

sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dsh

enable --nowには2つの役割があります。enableは再起動後にサービスを復旧させる設定で、--nowは今回のブートでサービスを起動します。単独のsystemctl startは次回の再起動後には失われます。カーネル更新では再起動が必要になるためです。

systemctl status dshには、Active: active (running)、Main PID、Memory:の行が表示されるはずです。次に、サービスがどこで待ち受けているかを確認します。

sudo ss -lntp | grep 3080

127.0.0.1:3080になっていることを確認します。別のアドレスが表示された場合、--hostフラグによって、そのアドレスが属するネットワーク上で待ち受ける設定になっています。TLS を設定していなければ、平文の HTTP を提供します。その出力に表示されるプロセス名はnodeであり、dshではありません。dshバイナリは Node スクリプトであるため、pgrep -x dshでは何も見つからないためです。代わりにsystemctl show -p MainPID dshを使用します。

次に、1 回再起動します。再起動後に一度も稼働したことがないサービスは、まだサービスとはいえません。

sudo reboot

再接続し、systemctl is-active dshを実行します。activeが出力されます。

journalctl でログを読む

dsh が stdout と stderr に出力するすべての内容は、unit name の下で 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 は priority で絞り込みます。unit 内の SyslogIdentifier=dsh により、これらの行には node ではなく dsh が付与されます。unit で絞り込まずに journal の出力を初めて読む場合、この違いが重要になります。

必要になる前に、reboot 後も journal が保持されることを確認します。

journalctl -u dsh -b -1

これが Specifying boot ID or boot offset has no effect, no persistent journal was found を出力する場合、journal は /run に保存されており、reboot のたびに破棄されます。Storage=auto の場合は、ディレクトリを作成して daemon を再起動します。Storage=volatile が設定されている場合は、先に persistent に変更します。

sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald

sudo journalctl --flush を実行すると、persistent storage に切り替わり、現在の boot のログがディスクに書き込まれます。

SSH トンネル経由で UI にアクセスし、公開ポートは使用しない

dsh はデフォルトで 127.0.0.1:3080 で Web UI(ユーザーインターフェース)を提供します。デフォルトは loopback ですが、選択肢はそれだけではありません。--host にはローカルインターフェースの具体的な IPv4 または IPv6 アドレスを 1 つ指定できます。loopback 以外のアドレスを指定すると、--tls-cert と --tls-key も渡さない限り、起動時に警告を表示したうえで、そのアドレスが属するネットワークに対して平文 HTTP でサービスを提供します。dsh が拒否するのはワイルドカードです。--host 0.0.0.0 を指定すると、エラーは次のように始まります。

webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:

続いて、「すべてのインターフェースに bind すると、リモートコード実行をネットワークに公開することになる」と説明し、「ローカルインターフェースの具体的な IPv4 または IPv6 アドレスを 1 つ指定して bind する」よう求めます。ホスト名など、IP リテラルではない値を指定すると、代わりに is not a concrete IPv4 or IPv6 address literal で失敗します。

それでもデフォルトのままにしてください。Web API(アプリケーションプログラミングインターフェース)がエージェントを駆動し、エージェントは shell コマンドを実行します。dsh はこの API の前段に認証を置いています。Host と Origin のチェックに加え、表示された URL に含まれる launch token を UI が署名済みの session cookie と交換します。ただし平文 HTTP では、この token がネットワーク上を平文で通過します。また、upstream のドキュメントにも、Host チェックはリスニングポート自体を保護しないと記載されています。実際のホスト名で UI を公開する必要がある場合は、DeepSeek の公開デプロイガイドにある --public-url と --trusted-host を使ったリバースプロキシ、または --tls-cert と --tls-key を使ったネイティブ TLS を確認してください。移動する前に、起動時の出力にある 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 は laptop のポート 3080 を開き、そこに到着したすべての通信を、VPS 上で解決される 127.0.0.1:3080 へ転送します。-N はリモートコマンドを実行しない指定です。そのため、session はトンネルを開いたまま保持するだけです。これを実行したままにし、journalctl -u dsh -n 100 --no-pager で起動時に dsh が表示した URL を確認して、ブラウザで開きます。この URL には launch token が含まれます。サインインしていないブラウザで http://127.0.0.1:3080/ だけを開くと、401 が返ります。token は実行中のプロセスに属しますが、それと交換される session cookie はプロセスより長く存続します。この cookie は dsh が $DSH_HOME/.credentials.yaml に保持する secret で署名され、デフォルトで 30 日間有効です。そのため、すでにサインインしたブラウザでは、再起動後でも URL だけを再度開けます。新しいブラウザを使う場合、または cookie の有効期限が切れた場合にだけ、journal から新しい URL を取得する必要があります。URL は credential として扱ってください。upstream は、意図したユーザーにだけ共有するよう求めています。また、system journal を読めるユーザーはその URL も読めます。UI に入ったら、Settings、Models の順に進み、DeepSeek API key を入力します。workspace directory もここで選択します。workspace には、サービスユーザーが所有するディレクトリである /var/lib/dsh/workspace を指定してください。そうしないと、エージェントの file tools が EACCES: permission denied で失敗します。

laptop でポート 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 で別のローカルポートを指定し、3080 を 3081 に変更した URL を開きます。入力内容は自分のマシン上の ~/.ssh/config に保存できます。

Host dsh-vps
  HostName 203.0.113.10
  User you
  LocalForward 3080 127.0.0.1:3080

これで、ssh -N dsh-vps がコマンド全体になります。このトンネルがエージェントへの唯一の接続経路になるため、保護を担うのは SSH daemon です。鍵のみを使用し、password authentication は無効にしてください。残りの VPS の SSH を hardening する方法も、通常以上に重要になります。その VPS が database や staging box を背後に置く小規模な private network に発展した場合は、subnet router でそれらのアドレスを tailnet に広告する方法により、サービスごとの転送を減らせます。ただし、dsh がデフォルトの loopback で動作している場合、UI 自体は引き続きトンネル経由で到達します。

key を unit file に記述してはいけません。Environment= の値は systemctl show dsh -p Environment が表示するもので、サーバー上のすべてのユーザーが実行できます。インストールした plugin が環境変数に key を必要とする場合は、/etc/dsh.env に保存し、root が所有する mode 600 のファイルにして、EnvironmentFile=/etc/dsh.env で参照してください。systemd は exec 時に root としてそのファイルを読み込み、systemctl show は内容を表示しません。各設定がディスク上のどのファイルに実際に保存されるのか、また DeepSeek API ではなくローカルの Ollama endpoint を dsh に指定したときにサーバー外へ何が送信されるのかについては、dsh の key、model、endpoint を設定する方法で説明します。

実行コスト

推論は VPS 上ではなく、DeepSeek の API で実行されます。サーバーで負担するのは、Node プロセス、配信する UI、そしてエージェントが実行する各コマンドです。最初の 2 つは負荷が安定しており、小さいものです。3 つ目には、この unit file による制限がありません。

他人の環境で測った数値を信用せず、自分のサーバーで最低限の負荷を測定します。

systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2

MemoryCurrent の単位は bytes です。アイドル中ではなく、エージェントの処理中に監視してください。

Tool call はサービスの子プロセスなので、同じ control group に入り、同じ制限の対象になります。エージェントが npm install や workspace 内の test suite を実行すると、harness 自体を大幅に上回るメモリを使用することがあります。1 GB の VPS で問題になるのはこの状況です。kernel がプロセスを 1 つ選んで kill し、journalctl -k | grep -i "out of memory" には選択されたプロセスを示す Out of memory: Killed process 行が表示されます。そのプロセスが問題の原因とは限りません。

意図的に limit を設定して対処します。[Service] section の MemoryMax= と CPUQuota= により、影響を unit 内に収められます。そのため、暴走した build を kill でき、サーバー全体が停止する事態を防げます。systemd でメモリと CPU に上限を設定するでは、数値と障害発生時の動作を説明します。DSH_HOME 配下の session history や、エージェントが workspace に書き込むデータによって disk 使用量も増加します。そのため、普段使用している disk 監視の仕組みに du -sh /var/lib/dsh を追加してください。

接続と切断を繰り返す interactive agent が必要なら、service は適した構成ではありません。永続的な tmux session で agent を実行する構成の方が適しています。常時起動し、tunnel 経由で到達可能にしたい場合は、dsh を unit として実行してください。

障害パターンと表示される文字列

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= からユーザー認証情報を特定または変更できなかったか、ユーザー名前空間を設定できませんでした。この unit で通常考えられる原因は、存在しないアカウントです。id dsh で確認します。

status=200/CHDIR. WorkingDirectory= が存在しないか、service user がそこへ移動できません。sudo -u dsh ls /var/lib/dsh/workspace で直接再現できます。

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. 何かがすでにポートを使用しています。通常は、別の terminal で実行した 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. unit が起動回数のレート制限に達し、処理を中止しました。本当のエラーは、その上にある行に記録されています。再試行する前に sudo systemctl reset-failed dsh を実行します。

unit が active (running) なのにブラウザーに何も表示されない場合。 VPS 上で確認します。そこで curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ がステータスコードを出力するなら、VPS 上の listener は応答しています。次にポート転送を確認します。このコードだけでは、すべてが読み込まれたとは限りません。upstream によると、オプションの plugin に失敗しても readiness は抑止されないため、plugin のエラーについても journalctl -u dsh -n 200 --no-pager を確認します。ブラウザーに 401 が表示される場合、有効な session cookie がなく、URL にも有効な launch token がありません。bare URL を開いたか、token が前回の再起動より前のものだからです。現在のプロセスが出力した URL を開きます。

意図的なアップグレード

Pinning により、アップグレードは不意に発生するものではなく、実施する操作になります。まずリリースノートを確認してください。互換性を損なう変更について upstream 自身が警告していることが、Pinning を行う理由そのものです。state directory をバックアップしてから、バージョンを切り替えます。

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 を古いバージョンで行い、さらにその tarball を復元します。tarball を作成していなければ、この方法は使えません。プレビュー段階の agent runtime は、アップグレードによって設定形式が内部で書き換えられる可能性が特に高いソフトウェアです。

FAQ

dsh は SSH セッションを閉じると停止するのはなぜですか?

npx @deepseek-ai/dsh web はログインセッションが所有するフォアグラウンドプロセスであるため、セッションが終了すると終了されます。一方、systemd unit は init システムが所有します。そのため、切断後も実行され、再起動後にも再び起動します。sudo systemctl enable --now dsh はこの両方を実現する手順です。enable は再起動に対応し、--now は今回のブートに対応します。

dsh では Type=simple と Type=exec のどちらを使うべきですか?

Type=exec。dsh はフォアグラウンドで実行され、fork も行わないため、どちらも動作します。ただし、Type=exec を使うと、systemd は execve() が成功するまで起動成功として扱いません。したがって、ExecStart= のパスが誤っている場合は、systemctl start が status=203/EXEC とともに明確に失敗します。Type=simple では、同じ誤りでも成功を返し、journal に埋もれます。Type=forking と Type=notify はこの用途ではどちらも誤りで、デフォルトでは 90 秒後に TimeoutStartSec が期限切れになるまで停止します。

ノート PC から dsh の Web UI を開くにはどうすればよいですか?

SSH 経由でポートを転送します: ssh -N -L 3080:127.0.0.1:3080 you@your-vps。その後、ブラウザーで、起動時に dsh が表示した URL を開きます。この URL は journalctl -u dsh で確認できます。この URL には起動トークンが含まれており、サインインしていないブラウザーはトークンがないと 401 を受け取ります。サインイン後のセッション Cookie はデフォルトで 30 日間有効で、サービスを再起動しても維持されます。サービスは loopback のデフォルト設定のままにしてください。dsh は --host 0.0.0.0 のような wildcard を未指定のアドレスとして拒否します。また、具体的なローカルアドレスは受け付けますが、loopback 以外に bind すると、TLS を設定しない限り平文の HTTP を提供します。その場合、ネットワーク経由で shell コマンドを実行する agent の起動トークンが平文で送信されます。

権限を単純にするため、dsh を root として実行できますか?

いいえ。harness はコマンドの実行とファイルの書き込みを担うため、サービスに付与された権限は agent にも付与されます。useradd --system --shell /usr/sbin/nologin dsh で system account を作成し、/var/lib/dsh をそのアカウントの所有に変更して、unit に NoNewPrivileges=true を追加してください。その後に EACCES: permission denied が発生した場合、通常の原因は、以前に root として実行した際に root 所有のファイルが残っていることです。sudo chown -R dsh:dsh /var/lib/dsh で解消できます。

unit では dsh のどのバージョンを固定すべきですか?

サービスを設定したときに npm view @deepseek-ai/dsh version が報告したバージョンを使用してください。npm install -g @deepseek-ai/dsh@<that version> でインストールし、後から確認できる場所に記録しておきます。2026 年 8 月 18 日時点では 0.1.0-rc.7 が最新で、2026 年 10 月 11 日時点では 0.2.0-rc.2、2026 年 10 月 27 日時点では 0.2.1-rc.2 が最新でした。その時点で next はすでに 0.2.1-rc.4 でした。2026 年 11 月 4 日には、latest と next の両方が 0.2.1-rc.5 を指しています。0.1.0-rc.7 ほど古い build には browser authentication がないため、web profile には使用しないでください。重要なのは番号そのものではありません。バージョンを指定しない npx は起動時に package を解決するため、unattended restart によって、config format が異なる build へ気付かないうちに移行する可能性があります。

この記事は役に立ちましたか?