SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Pasang DeepSeek Harness di VPS Secara Selamat

Ketahui cara memasang DeepSeek Harness pada VPS Linux dengan selamat. Panduan ini merangkumi penetapan versi npm, konfigurasi plugin, dan akses port 3080 melalui tunnel SSH.

Apakah itu DeepSeek Harness

DeepSeek Harness (dsh) ialah runtime ejen Node.js yang boleh anda jalankan pada VPS (virtual private server). Cara paling selamat untuk menjalankannya adalah dengan mengikatnya kepada 127.0.0.1, dan mengaksesnya melalui tunnel SSH (secure shell) daripada pelayar web anda. Ia menyediakan UI (user interface) web pada port 3080 dan bukannya berjalan di dalam terminal. Dalam keluaran 0.1.0-rc.6 yang ditetapkan oleh panduan ini, pelayan web tersebut tidak meminta kata laluan. Oleh itu, port 3080 yang didedahkan kepada umum akan membolehkan sesiapa sahaja yang menemuinya untuk menggunakan ejen yang boleh membaca fail anda serta menjalankan arahan sebagai pengguna Linux anda. Keluaran yang lebih baharu, daripada 0.2.0-rc.2 sehingga 0.2.2-rc.2 bertarikh 11 November 2026, iaitu keluaran terbaharu yang disenaraikan di GitHub pada 12 November 2026, akan mencetak URL permulaan yang membawa token baharu untuk proses tersebut dan menukarnya dengan session cookie. Walau bagaimanapun, ia masih mendengar pada loopback secara lalai dan tetap menolak untuk mengikat pada setiap antara muka rangkaian.

DeepSeek menerbitkannya di bawah lesen MIT sebagai pakej npm @deepseek-ai/dsh. Projek ini menyifatkan dirinya sebagai pratonton pembangun dan menyatakan bahawa perubahan yang menjejaskan keserasian (breaking changes) dijangka akan berlaku. Versi yang ditetapkan di bawah adalah keluaran Ogos 2026. Pada 12 November 2026, tag latest pada npm merujuk kepada 0.2.2-rc.1. GitHub menyenaraikan pratonton keluaran (prerelease) yang lebih baharu iaitu 0.2.2-rc.2, yang ditag sebagai dsh-v0.2.2-rc.2 dan dikeluarkan pada 11 November 2026. Semak repositori tersebut sebelum anda menyalin sebarang bahagian ke dalam pelayan yang penting.

Satu idea utama merangkumi keseluruhan reka bentuknya: segala-galanya adalah pemalam (plugin). Penyesuai model, pendaftaran alatan, log sesi, sandbox, penjadual dan gelung ejen itu sendiri adalah pemalam yang dimuatkan ke dalam satu konteks kongsi, dan mana-mana daripadanya boleh diganti. Tiada teras istimewa yang hanya dihiasi oleh pemalam. Itulah yang menjadikan harness ini berbaloi untuk dicuba, dan di situlah juga terletaknya risiko sebenar. Sama ada pertukaran ini berbaloi bergantung kepada apa yang anda bandingkan, dan bagaimana ia dibandingkan dengan Claude Code dan Omnigent meletakkan reka bentuk "segalanya adalah pemalam" di samping dua penyelesaian lain dari segi gandingan model, lesen dan keperluan sumber VPS bagi setiap satu.

Harness bukanlah model

Harness menjalankan gelung ejen. Proses penaakulan berlaku dalam model di tempat lain, jadi tiada apa-apa yang akan berfungsi sehingga anda memberikan kunci API (application programming interface) atau alamat endpoint model yang anda hoskan sendiri. Segala perkara dalam catatan ini adalah konfigurasi harness dan bukannya kelakuan model, dan garis pemisah antara kedua-duanya perlu difahami dengan jelas sebelum anda menghabiskan waktu petang untuk menyahpepijat punca masalah.

Anda mengkonfigurasinya dalam UI di bawah Settings dan kemudian Models. DeepSeek mempunyai kadnya sendiri, dan dalam release semasa, butang "Add model provider" di bawahnya membuka dua mod. "Third-party model provider" meliputi penyedia yang disertakan katalognya oleh harness, seperti OpenAI dan Anthropic, di mana anda menampal kunci dan katalog tersebut membekalkan endpoint serta senarai model. "Custom model API" ialah pilihan yang menarik: ia memerlukan ID penyedia huruf kecil, nama paparan, URL asas, protokol API, kelayakan dan sekurang-kurangnya satu model. Pemilih protokol menawarkan OpenAI Chat Completions, OpenAI Responses, Anthropic Messages dan Gemini API, jadi anda boleh mengkonfigurasi gateway atau pelayan tempatan yang menggunakan salah satu daripadanya; endpoint dengan perbezaan format permintaan memerlukan tetapan keserasian. Penyedia tersuai juga boleh membuat pertanyaan kepada endpoint GET /models yang serasi dengan OpenAI untuk mengisi senarai model bagi pihak anda.

Begitulah cara anda menghalakan harness kepada model pada VPS yang sama. Ollama mendedahkan API yang serasi dengan OpenAI pada http://127.0.0.1:11434/v1/, dan medan kunci API menerima sebarang rentetan, biasanya ollama, kerana klien gaya OpenAI memerlukan nilai dan Ollama mengabaikannya. Dokumentasi Ollama sendiri juga menerangkan ollama launch dsh, yang memasang @deepseek-ai/dsh jika ia tiada dan memulakannya terhadap model Ollama, jadi semak versi yang dipasangnya sebelum anda bergantung pada pin di bawah. Sama ada model yang cukup kecil untuk dimuatkan dalam VPS anda cukup baik untuk memacu ejen adalah soalan yang lebih sukar, dan perbezaan antara Ollama dan vLLM sebagai pelayan model tempatan menentukan berapa banyak RAM anda yang diperlukan untuk jawapan tersebut.

Kunci yang ditaip ke dalam UI adalah tulis-sahaja (write-only). Harness menyimpannya dalam $DSH_HOME/.credentials.yaml, dan tetapan hanya menyimpan rujukan kelayakan, yang ditulis oleh release semasa ke dalam fail patch profil aktif, $DSH_HOME/profiles/<profile>/cordis.patch.yml (profil tersebut ialah web untuk dsh web). $DSH_HOME ditetapkan secara lalai kepada ~/.dsh. Anggap fail kelayakan sebagai fail kata laluan, kerana ia memang begitu: sesiapa yang membacanya boleh menghabiskan bajet API anda. Jika anda ingin mengedit fail tersebut secara terus dan bukannya mengklik melalui Settings, panduan fail konfigurasi dsh, kunci dan endpoint model menunjukkan fungsi setiap kunci dan perkara yang keluar dari kotak anda dalam setiap mod.

Prasyarat sebelum pemasangan

  • sebuah VPS yang menjalankan Ubuntu 24.04 atau sistem Linux semasa yang lain, dengan akses SSH
  • Node.js 24.9 atau lebih baharu, kerana branch utama projek dan 0.2.2-alpha.2 kini mengisytiharkan >=24.9.0 dan ujian CI-nya menggunakan Node 24 dengan semakan keserasian pada Node 24.9 dan Node 26, tanpa job untuk Node 22; release bertanda melalui 0.2.1-rc.4 masih menyenaraikan Node 22.19 sebagai boleh diterima, namun itu bukan lagi tahap minimum yang digunakan oleh projek untuk binaan
  • akaun pengguna biasa, bukan root, kerana ejen menjalankan arahan shell sebagai sesiapa yang memulakan proses tersebut
  • pnpm dalam PATH jika anda bercadang untuk memasang plugin, memandangkan arahan plugin akan memanggilnya melalui shell
  • port 3080 ditutup pada firewall anda dan pada firewall rangkaian berasingan pembekal anda

Pakej nodejs milik Ubuntu 24.04 adalah lebih lama daripada yang diperlukan oleh harness, jadi pada release tersebut pasang Node daripada NodeSource atau nvm dan bukannya menggunakan apt install nodejs. Repositori rasmi Ubuntu 26.10 menyenaraikan Node 24.19.0, yang melebihi tahap minimum Node 24.9. Jika VPS tersebut masih baharu, mengukuhkan SSH sebelum melakukan perkara lain adalah berbaloi untuk dilakukan dalam masa sepuluh minit, kerana tunnel yang bakal anda gunakan hanya akan sebaik pelayan SSH di sebaliknya.

Memasang DeepSeek Harness pada VPS, dengan versi yang ditetapkan

node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 web

npx memuat turun pakej dan menjalankan binari dsh miliknya. web ialah alias bagi --profile web, yang memulakan aplikasi pelayar, dan proses tersebut memaparkan alamat yang sedang didengarinya. Nilai lalai ialah http://127.0.0.1:3080. Nombor tersebut merupakan keputusan pengikatan dan bukannya nilai lalai kosmetik, dan mengapa dsh memaparkan alamat loopback menjelaskan perkara yang akan dan tidak akan dijawab oleh harness tersebut sebelum anda mencarinya daripada komputer riba anda.

Tetapkan versi tersebut. npx @deepseek-ai/dsh web menyelesaikan apa sahaja yang ditunjuk oleh tag latest pada minit anda menjalankannya, melainkan projek yang anda jalankan daripadanya sudah mempunyai salinan yang dipasang, yang mana npx akan menggunakan salinan tersebut secara senyap. Walau apa pun, anda bukanlah pihak yang memilih versi tersebut, dan projek itu telah mengeluarkan beberapa calon keluaran dan menyatakan bahawa perubahan yang memecahkan keserasian akan berlaku. 0.1.0-rc.6 ialah versi Ogos 2026 yang ditetapkan di sini. Pada 12 November 2026 latest menunjuk kepada 0.2.2-rc.1, satu keluaran yang memaparkan URL permulaan bertoken; GitHub menyenaraikan pra-keluaran yang lebih baharu 0.2.2-rc.2, jadi beralih kepada versi lain adalah jenis naik taraf yang perlu dilakukan dengan sengaja selepas membaca repositori tersebut. Versi yang ditetapkan bermakna kotak yang anda sediakan hari ini akan berkelakuan sama pada bulan depan, jadi naik taraf menjadi keputusan yang anda buat dan bukannya kemalangan yang anda temui. Apabila arahan yang ditetapkan masih memulakan binaan yang salah atau enggan dipasang sama sekali, ralat pemasangan dan versi dsh yang biasa merangkumi cara mengosongkan cache npx dan menyemak npm yang digunakan oleh Node anda.

Untuk kegunaan harian, pasang sekali sahaja dan bukannya menyelesaikannya semula pada setiap permulaan.

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

Baris kedua itu berbaloi untuk dijalankan, kerana pelancar dan aplikasi web membawa set flag yang berasingan. dsh --help menunjukkan pilihan pelancar itu sendiri. dsh --profile web --help menunjukkan flag yang diterima oleh aplikasi web, iaitu tempat --port, --host dan --trusted-host yang boleh diulang berada.

Sekarang sahkan perkara yang didengarinya.

ss -tlnp | grep 3080

Lajur alamat tempatan sepatutnya membaca 127.0.0.1:3080. Jika ia membaca 0.0.0.0:3080, UI sedang mendengar pada setiap antara muka, jadi hanya firewall anda yang menghalangnya daripada internet, dan anda harus menghentikan proses tersebut sebelum melakukan perkara lain.

Mengapa anda tidak boleh mendedahkan port 3080

Pelayan web dalam 0.1.0-rc.6 tidak mempunyai lapisan pengesahan. Konfigurasinya hanya mendedahkan hos pendengar dan port pendengar, dan itulah keseluruhan permukaan serangannya. Kawalan akses untuk penggunaan bukan loopback adalah tetapan hos dipercayai yang berasingan, yang bukanlah skrin log masuk.

Keluaran yang lebih baharu telah menambah ciri ini. Bermula dari 0.2.0-rc.2, proses permulaan akan mencetak URL yang membawa token baharu untuk proses tersebut; pelayar yang membukanya akan menerima kuki sesi yang ditandatangani dan dihalakan semula ke alamat yang sama tanpa token tersebut. Pagar Host/Origin di hadapan /api hanya menerima sambungan loopback, alamat bind pelayan itu sendiri, dan pihak berkuasa yang anda namakan dengan --trusted-host. Itu adalah kelayakan sebenar, namun dokumentasi projek itu sendiri memberi amaran bahawa URL yang dicetak adalah kelayakan yang hanya boleh dikongsi dengan pengguna yang dimaksudkan, dan HTTP biasa menghantarnya tanpa penyulitan. Sejak 0.2.1-alpha.2, aplikasi web juga boleh mengikat satu alamat tempatan yang konkrit dan menyediakan HTTPS sendiri dengan --tls-cert dan --tls-key. Ini menyelesaikan masalah teks biasa, bukan masalah pendedahan. Ia menjadikan port yang terdedah lebih sukar untuk disalahgunakan. Ia tidak menjadikannya sesuatu yang boleh diterbitkan secara umum.

Sekarang, pertimbangkan apa yang berada di sebalik port tersebut. Ejen tersebut menyunting fail dalam ruang kerja dan menjalankan arahan shell, manakala kelayakan pembekal anda tersimpan pada cakera di sebelahnya. Jadi, pada keluaran yang disematkan, port 3080 yang terbuka adalah shell jauh dengan antara muka sembang, yang berjalan sebagai pengguna yang memulakannya, dengan kunci API anda dilampirkan. Sesiapa pun tidak memerlukan eksploitasi untuk itu. Mereka hanya memerlukan nombor port tersebut. Pada keluaran dengan token pelancaran, mereka juga memerlukan token tersebut, yang sudah pun dimiliki oleh sesiapa sahaja yang boleh membaca terminal anda, log perkhidmatan anda, atau trafik anda yang tidak disulitkan.

CLI (antara muka baris arahan) bersetuju dengan perkara ini. Bermula 0.1.0-rc.6, ia secara sengaja tidak menyokong --host 0.0.0.0 dan akan keluar dengan ralat penggunaan dan bukannya bermula, dan 0.2.2-alpha.2 yang lebih baharu masih menolaknya semasa permulaan. Penolakan itu adalah satu ciri, jadi jangan cari tampalan (patch) untuk membuangnya.

Dua kaedah penggunaan lain adalah munasabah apabila tunnel tidak sesuai untuk anda. Letakkan kotak tersebut pada rangkaian overlay peribadi supaya ia memegang alamat yang hanya boleh dihalakan oleh peranti anda sendiri, iaitu apa yang diberikan oleh pelayan kawalan Headscale yang dihoskan sendiri. Atau letakkan reverse proxy di hadapannya yang mengesahkan permintaan sebelum ia mencapai port 3080, contohnya pelayan daftar masuk tunggal Authentik yang melakukan forward auth. Reverse proxy tanpa pengesahan di hadapannya bukanlah kawalan keselamatan. Ia hanyalah URL yang lebih panjang.

Capai UI web melalui terowong SSH

Jalankan arahan ini pada komputer riba anda, bukan pada pelayan.

ssh -N -L 3080:127.0.0.1:3080 you@your-server

-L membuka port 3080 pada komputer riba anda dan memajukan sebarang sambungan kepadanya melalui sesi SSH yang disulitkan. Bahagian 127.0.0.1:3080 diselesaikan pada pelayan, jadi sambungan sampai ke harness daripada loopback, tepat seperti anda sedang menggunakan mesin tersebut. -N menyatakan jangan mulakan shell jauh, kerana anda hanya mahukan pemajuan tersebut sahaja.

Kemudian buka http://127.0.0.1:3080 dalam pelayar web tempatan anda. Pada keluaran yang mempunyai token pelancaran, buka URL permulaan penuh yang dipaparkan oleh pelayan sebaliknya, termasuk token tersebut; apabila harness dimulakan melalui SSH, ia masih mencetak baris permulaan tetapi tidak cuba membuka pelayar untuk anda. Jika port 3080 sudah digunakan pada komputer riba anda, tukar nombor di sebelah kiri: ssh -N -L 3180:127.0.0.1:3080 you@your-server, kemudian layari ke http://127.0.0.1:3180, dengan menukar port dalam URL bertoken dengan cara yang sama. Nombor di sebelah kiri adalah tempatan dan nombor di sebelah kanan adalah milik pelayan, jadi hanya nombor di sebelah kiri yang berubah.

Simpan ia dalam ~/.ssh/config supaya anda tidak perlu menaipnya lagi.

Host dsh
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  LocalForward 3080 127.0.0.1:3080

Selepas itu, ssh -N dsh memulakan terowong tersebut. Pelayar yang melaporkan bahawa sambungan ditolak biasanya bermaksud terowong sudah aktif tetapi tiada apa-apa yang mendengar di bahagian hujung sana, kerana SSH memajukan port tersebut sama ada harness sedang berjalan atau tidak. Semak pelayan dengan arahan ss di atas.

Pastikan harness terus berjalan selepas anda log keluar

Arahan npx akan tamat bersama shell anda. Servis pengguna systemd akan terus bertahan, dan ia akan menghidupkan semula harness selepas kegagalan atau but semula. Unit di sini sengaja dibuat minimum; jika anda mahu harness berjalan di bawah akaunnya sendiri yang dikunci, dengan versi yang ditetapkan di dalam unit dan log yang boleh anda cari, persediaan systemd headless untuk dsh merangkumi perkara itu sepenuhnya.

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger penting kerana servis pengguna biasanya berhenti apabila sesi terakhir anda berakhir, jadi tanpanya harness akan mati sebaik sahaja anda menutup terowong tersebut. Ambil laluan mutlak yang dipaparkan oleh command -v dsh dan letakkannya dalam unit tersebut, kerana systemd tidak mencari PATH yang dibina oleh shell log masuk anda.

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

WorkingDirectory bukan sekadar kosmetik. Proses dsh menggunakan direktori panggilannya sebagai lokasi sistem fail lalai, jadi servis yang dimulakan di tempat yang salah akan menghalakan ejen ke folder yang salah. Walau bagaimanapun, direktori itu hanyalah lalai: UI Web yang baharu tidak mempunyai ruang kerja yang dipilih sehingga anda menambah satu di bawah Choose workspace, dan panduan projek memberitahu anda untuk menambah direktori tempat anda memulakan dsh. Panduan tersebut tidak membawa penanda versi, dan perkataan yang sama sudah ada dalam 0.1.0-rc.7, jadi jangkakan ia pada keluaran yang ditetapkan juga. Tetapkan direktori unit kepada projek tersebut, kemudian pilih ruang kerja itu dalam UI.

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

Unit yang enggan bermula hampir selalu disebabkan oleh laluan ExecStart yang salah atau versi Node yang ditolak oleh binari, dan journalctl --user -u dsh -n 50 menamakan yang mana satu. Pada keluaran dengan token pelancaran, jurnal juga merupakan tempat URL permulaan bertoken itu mendarat, dan setiap permulaan semula akan memaparkan yang baharu. Corak yang sama merangkumi mengekalkan mana-mana ejen pengekodan hidup pada VPS, dan mod kegagalannya adalah sama.

Perkara yang dibenarkan untuk dilakukan oleh pemalam

Pemalam ialah modul yang menyumbang perkhidmatan, acara bertaip dan kesan boleh balik kepada konteks yang dikongsi. Titik sambungan (extension points) adalah bahagian yang perlu diteliti dengan rapi:

  • mendaftarkan penyedia model pada ctx.llm
  • menambah alatan yang menghadap model pada ctx.tools
  • menyediakan backend shell di sebalik ctx.shell
  • menyediakan akses sistem fail atau polisi di sebalik ctx.fs
  • mendaftarkan arahan manusia pada ctx.commands
  • menjalankan kerja latar belakang melalui ctx.jobs
  • membalut proses yang dijana dengan backend ctx.sandbox
  • memintas permintaan dan panggilan alatan melalui acara agent/* dan tools/*
  • melanjutkan keadaan sesi yang tahan lama
  • memacu UI melalui ctx.agents

Baca senarai tersebut seperti cara penyerang membacanya. Pemalam boleh membekalkan lapisan sistem fail dan lapisan shell, serta boleh berada di tengah-tengah setiap panggilan alatan yang dibuat oleh model. Tiada dialog kebenaran yang menghalang antara pemalam dan titik sambungan tersebut, kerana pemalam hanyalah kod Node biasa yang dimuatkan ke dalam proses yang sama seperti segala-galanya. Memasang pemalam bermakna menjalankan kod orang asing dengan kebenaran ejen anda, dan kebenaran ejen anda adalah kebenaran pengguna Unix anda.

Ini adalah keputusan kepercayaan yang sama yang anda buat apabila menyambungkan pelayan MCP kepada ejen pada VPS, di mana MCP ialah protokol konteks model. Inilah juga sebab mengapa menjalankan ejen pengekodan dengan selamat pada VPS bermula dengan akaun yang menjalankannya dan bukannya dengan model, dan mengapa serangan rantaian bekalan npm memberi kesan yang sangat buruk pada pelayan: langkah pemasangan adalah titik kompromi, dan tiada apa-apa yang memberi amaran kepada anda.

Asal usul pemalam

Pemalam disimpan di dalam profil. Profil ialah komposisi bernama yang disimpan di bawah $DSH_HOME, yang secara lalai ditetapkan kepada ~/.dsh, dan setiap direktori profil menyimpan pemalam luar (out-of-tree) yang dipasangnya. CLI menguruskan pemalam ini dengan memajukan argumen anda terus ke pnpm, menggunakan direktori profil sebagai direktori kerja.

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

Oleh kerana argumen sampai ke pnpm tanpa diubah, add, remove, update dan why berfungsi seperti yang dilakukan dalam mana-mana projek pnpm, dan pemalam boleh berupa pakej npm atau rujukan GitHub. pnpm mesti wujud pada PATH terlebih dahulu. Pada Node 24, corepack enable pnpm meletakkannya di sana. Node 25 telah berhenti mengedarkan Corepack, jadi pada Node 25 dan versi lebih baharu, pasang ia dengan npm install -g pnpm sebagai gantinya.

Penemuan berfungsi melalui topik GitHub. Pengarang pemalam menambah topik dsh-plugin pada repositori mereka, dan melayari topik tersebut adalah cara anda mencari apa yang tersedia. Topik ialah label yang digunakan oleh pengarang pada repositori mereka sendiri. Tiada sesiapa yang menyemak atau menandatanganinya, dan halaman topik disusun mengikut bilangan bintang, yang mengukur populariti dan bukannya keselamatan.

Keluaran semasa juga membawa himpunan indeks pemalam tersuai (Custom plugin indexes) yang bersifat eksperimental. Hidupkannya di bawah Plugins dan tab Discover membolehkan anda menambah indeks, iaitu fail JSON yang diambil daripada URL yang anda bekalkan. Harness ini tidak menghantar indeksnya sendiri, ia menyemak format fail tetapi bukan tajuk, pengarang atau sumber yang didakwa oleh pasaran, dan sesiapa sahaja di laluan rangkaian boleh menulis semula indeks yang dihidangkan melalui http: biasa. Pasaran ialah katalog yang ditulis oleh orang lain, bukan satu bentuk semakan.

Empat tabiat memastikan perkara ini boleh diurus. Baca kod sumber sebelum memasang, kerana kebanyakan pemalam cukup kecil untuk dibaca dalam masa sepuluh minit. Tetapkan (pin) versi atau komit yang tepat dan bukannya menjejaki cawangan (branch). Jalankan harness di bawah pengguna yang tidak memiliki apa-apa aset lain, pada VPS yang anda sanggup bina semula. Berikan ejen kunci API sendiri dengan had perbelanjaan sendiri, berasingan daripada kunci yang digunakan oleh servis pengeluaran anda. Apabila anda ingin membaca pemalam dan ingin mengetahui fail mana yang membawa risiko, panduan menyemak pemalam dsh akan meneliti manifes, titik masuk dan titik sambungan yang didaftarkan oleh pemalam.

Jika anda lebih suka membandingkan reka bentuk sebelum memilih satu, harness berbilang ejen Omnigent menjawab masalah yang sama dengan struktur yang berbeza, dan pertukaran (trade-offs) menjadi jelas sebaik sahaja pemalam digunakan. Jika anda akhirnya menyimpan dua atau tiga daripadanya pada mesin yang sama dan bukannya memilih satu pemenang, meletakkan setiap harness di sebalik satu API yang dihoskan sendiri menjimatkan anda daripada perlu menyediakan satu terowong bagi setiap port, dengan kos satu lagi servis yang perlu diikat pada loopback dan diberikan kata laluan sebenar pada hari pertama.

Perkara yang tergendala dahulu

Node terlalu lama. Cawangan utama projek dan 0.2.2-alpha.2 memerlukan Node 24.9 atau lebih baharu. Ujian CI projek ini menggunakan Node 24 serta semakan keserasian pada Node 24.9 dan Node 26, tanpa sokongan untuk Node 22. Keluaran bertag yang lebih lama melalui 0.2.1-rc.4 menyenaraikan Node 22.19 sebagai versi yang boleh diterima, namun projek ini tidak lagi boleh dibina menggunakan versi tersebut. Runtime yang lebih lama akan gagal semasa permulaan kerana kod menggunakan sintaks dan API yang tidak disokong. Jalankan node --version sebelum melakukan perkara lain.

Port 3080 sudah digunakan. Ini mungkin disebabkan oleh harness kedua, proses yang tergantung, atau aplikasi lain yang turut menggunakan port 3080. Cari proses tersebut dengan ss -tlnp | grep 3080, kemudian hentikan proses itu atau mulakan harness di tempat lain dengan dsh web --port 3180. --port adalah milik aplikasi web, jadi ia diletakkan selepas web.

Pelayar tidak dapat menyambung melalui tunnel. Pastikan anda melayari 127.0.0.1 dan bukannya alamat awam pelayan, kerana port yang di-forward hanya wujud pada komputer riba anda. Kemudian, pastikan harness sedang mendengar pada pelayan, kerana SSH akan menyediakan forward tersebut sama ada terdapat respons daripada hujung sana atau tidak.

dsh plugin gagal serta-merta. Perintah ini merupakan wrapper kepada pnpm, jadi ketiadaan binari pnpm akan menghentikannya sebelum sebarang kerja pemalam bermula. Pada Node 25 dan lebih baharu, ini adalah keadaan lalai kerana Corepack tidak lagi disertakan bersama Node.

Ejen tidak dapat melihat projek anda. Web UI yang baharu tidak mempunyai ruang kerja (workspace) yang dipilih sehingga anda menambahkannya, dan session composer akan kekal tidak tersedia sehingga anda berbuat demikian. Proses tersebut menggunakan direktori tempat ia dimulakan hanya sebagai lokasi sistem fail lalai, jadi unit yang WorkingDirectory-nya adalah direktori home anda akan menghalakan ejen ke direktori home anda. Pilih ruang kerja dalam UI, atau betulkan unit tersebut dan muat semula.

FAQ

Adakah selamat untuk mendedahkan UI web DeepSeek Harness pada port 3080?

Tidak. Dalam 0.1.0-rc.6 yang dipinkan, pelayan web tidak mempunyai sistem log masuk sendiri. Ejen di sebaliknya menyunting fail dan menjalankan arahan shell sebagai pengguna yang memulakan proses tersebut, dengan kunci API pembekal anda disimpan pada cakera yang sama. Bermula dari 0.2.0-rc.2 dan seterusnya, termasuk 0.2.2-rc.1, keluaran latest npm pada 12 November 2026, serta pra-keluaran 0.2.2-rc.2 yang lebih baharu, URL permulaan yang dipaparkan membawa token pelancaran yang ditukar oleh pelayar untuk mendapatkan kuki sesi. Walau bagaimanapun, URL tersebut merupakan kelayakan yang dihantar tanpa penyulitan melalui HTTP biasa, jadi nasihat ini tidak berubah. Pastikan pendengar kekal pada 127.0.0.1 dan aksesnya melalui terowong SSH. Rangkaian tindanan peribadi (private overlay network), atau reverse proxy yang mengesahkan setiap permintaan sebelum ia sampai ke port tersebut, juga boleh digunakan. Setakat versi 0.1.0-rc.6, CLI menolak --host 0.0.0.0 dan keluar dengan ralat penggunaan, dan 0.2.2-alpha.2 juga masih menolaknya, yang menunjukkan pandangan penulis terhadap idea tersebut.

Adakah saya memerlukan kunci API DeepSeek, atau bolehkah saya menggunakan model tempatan?

Kedua-duanya boleh digunakan, kerana harness ini merupakan runtime dan bukannya model. Di bawah Settings kemudian Models, anda boleh menampal kunci ke dalam kad DeepSeek atau pembekal katalog, atau pilih "Add model provider" kemudian "Custom model API" dan berikan URL asas yang menyokong OpenAI Chat Completions, OpenAI Responses, Anthropic Messages atau Gemini API. Pelayan Ollama tempatan menjawab pada http://127.0.0.1:11434/v1/ dan menerima sebarang rentetan dalam medan kunci API. Kunci disimpan dalam $DSH_HOME/.credentials.yaml, yang secara lalai berada pada ~/.dsh/.credentials.yaml.

Apakah yang sebenarnya diperolehi oleh pemalam apabila memasang pemalam DeepSeek Harness?

Kebenaran akaun yang menjalankan harness tersebut. Pemalam ialah kod Node yang dimuatkan ke dalam proses yang sama, dan titik sambungan (extension points) merangkumi backend shell, lapisan sistem fail, pendaftaran alatan dan acara yang membungkus setiap panggilan alatan. Tiada apa-apa yang mengasingkan pemalam daripada bahagian tersebut melainkan pemalam itu sendiri menyediakan sandbox. Baca kod sumber sebelum anda memasang, dan jalankan harness sebagai pengguna yang tidak memiliki sebarang data penting anda.

Versi manakah yang perlu saya pasang, dan adakah ia akan terus berfungsi?

Pasang versi yang tepat, contohnya npx @deepseek-ai/dsh@0.1.0-rc.6 web. Itu adalah versi Ogos 2026 yang dipinkan di sini. Pada 12 November 2026, tag latest npm menghala ke 0.2.2-rc.1; GitHub menyenaraikan pra-keluaran 0.2.2-rc.2 yang lebih baharu, dikeluarkan pada 11 November, dan CLI semasa memerlukan Node 24.9 atau lebih baharu. Projek ini menggelarkan dirinya sebagai pratonton pembangun dan menyatakan bahawa perubahan yang memecahkan keserasian dijangka berlaku, jadi arahan yang tidak dipinkan boleh berkelakuan berbeza dari satu hari ke hari berikutnya. Semak repositori sebelum menaik taraf, dan jangkakan kunci konfigurasi serta antara muka pemalam akan berubah selagi versi masih bermula dengan 0.

Adakah artikel ini berguna?