SSD Nodes Learn Hosting plans →

VPS-ல் DeepSeek Harness-ஐ பாதுகாப்பாக நிறுவுவது எப்படி?

Linux VPS-ல் DeepSeek Harness-ஐ நிறுவி, npm version-ஐ pin செய்து, port 3080-ஐ SSH tunnel மூலம் பாதுகாப்பாக அணுகுவதற்கான வழிமுறைகளை இந்த வழிகாட்டி விரிவாக விளக்குகிறது.

DeepSeek Harness என்றால் என்ன

DeepSeek Harness (dsh) என்பது ஒரு Node.js agent runtime ஆகும். இதை நீங்கள் ஒரு VPS-ல் (virtual private server) இயக்கலாம். இதை இயக்குவதற்கான பாதுகாப்பான வழி, 127.0.0.1-உடன் பிணைத்து (bind), உங்கள் browser மூலம் SSH (secure shell) tunnel வழியாக அணுகுவதாகும். இது terminal-ல் இயங்குவதற்குப் பதிலாக, port 3080-ல் ஒரு web UI-ஐ (user interface) வழங்குகிறது. இந்த வழிகாட்டி குறிப்பிடும் 0.1.0-rc.6 release-ல், அந்த web server-க்கு எனத் தனியாக password கிடையாது. எனவே, port 3080-ஐ public-ஆகத் திறந்தால், அதை அணுகும் எவரும் உங்கள் கோப்புகளைப் படிக்கவும், உங்கள் Linux user-ஆக கட்டளைகளை (commands) இயக்கவும் முடியும். 0.2.0-rc.2 முதல் 11 November 2026-ன் 0.2.2-rc.2 வரையிலான புதிய releases-ல், அந்த process-க்கான புதிய token-ஐக் கொண்ட startup URL ஒன்று உருவாக்கப்பட்டு, அது session cookie-ஆக மாற்றப்படுகிறது. இருப்பினும், அவை இயல்பாகவே loopback-ல் மட்டுமே கேட்கின்றன (listen) மற்றும் அனைத்து interface-களிலும் பிணைக்கப்படுவதை மறுக்கின்றன.

DeepSeek இதை MIT உரிமத்தின் கீழ், @deepseek-ai/dsh என்ற npm package-ஆக வெளியிடுகிறது. இந்தத் திட்டம் தன்னை ஒரு developer preview என்று விவரிக்கிறது மற்றும் இணக்கத்தன்மையை (compatibility) பாதிக்கும் மாற்றங்கள் எதிர்பார்க்கப்படலாம் என்று கூறுகிறது. கீழே குறிப்பிடப்பட்டுள்ள பதிப்பு August 2026 release ஆகும். 12 November 2026 அன்று, npm-ன் latest tag 0.2.2-rc.1-ஐக் குறிக்கிறது. GitHub-ல் 11 November 2026 அன்று வெளியிடப்பட்ட dsh-v0.2.2-rc.2 என்று tag செய்யப்பட்ட புதிய prerelease 0.2.2-rc.2 பட்டியலிடப்பட்டுள்ளது. முக்கியமான server-களில் எதையும் பதிவிறக்கும் முன், repository-ஐச் சரிபார்க்கவும்.

இதன் முழு வடிவமைப்பிலும் ஒரு முக்கியக் கருத்து உள்ளது: அனைத்தும் ஒரு plugin. Model adapter, tool registry, session log, sandbox, scheduler மற்றும் agent loop ஆகிய அனைத்தும் ஒரே shared context-ல் ஏற்றப்படும் plugins ஆகும். இவற்றில் எதை வேண்டுமானாலும் மாற்றலாம். plugins-க்கு மேலாகச் செயல்படும் privileged core என்று எதுவும் இல்லை. இதுவே இந்த harness-ஐ முயற்சி செய்யத் தூண்டுகிறது, அதே சமயம் இதுவே உண்மையான ஆபத்தும் உள்ள இடமாகும். இந்த வடிவமைப்பு சரியானதா என்பது நீங்கள் எதை அடிப்படையாகக் கொண்டு அளவிடுகிறீர்கள் என்பதைப் பொறுத்தது. Claude Code மற்றும் Omnigent-உடன் இது எவ்வாறு ஒப்பிடப்படுகிறது என்ற பகுதி, model coupling, உரிமம் மற்றும் ஒவ்வொரு கருவிக்கும் எவ்வளவு VPS தேவை என்பது குறித்த பிற தீர்வுகளுடன் இந்த plugin-அடிப்படையிலான வடிவமைப்பை ஒப்பிடுகிறது.

Harness என்பது ஒரு model அல்ல

Harness என்பது agent loop-ஐ இயக்குகிறது. Reasoning என்பது வேறொரு இடத்தில் உள்ள model-ல் நடக்கிறது, எனவே நீங்கள் ஒரு API (application programming interface) key-ஐ அல்லது நீங்கள் சொந்தமாக host செய்யும் model endpoint-ன் முகவரியை வழங்கும் வரை எதுவும் இயங்காது. இந்தப் பதிவில் உள்ள அனைத்தும் harness configuration பற்றியது, model-ன் செயல்பாடு பற்றியது அல்ல. இவ்விரண்டிற்கும் இடையிலான வேறுபாட்டை நீங்கள் தெளிவாகப் புரிந்துகொள்வது அவசியம்; இல்லையெனில், ஒரு சிக்கல் எந்தப் பக்கத்தில் உள்ளது என்பதைக் கண்டறிய நீங்கள் ஒரு மதியப் பொழுதை வீணடிக்க நேரிடும்.

இதை நீங்கள் UI-ல் Settings மற்றும் அதற்குள் Models பகுதிக்குச் சென்று configure செய்யலாம். DeepSeek-க்கு எனத் தனி card உள்ளது, தற்போதைய releases-ல் அதன் கீழே உள்ள "Add model provider" பொத்தான் இரண்டு modes-ஐத் திறக்கும். "Third-party model provider" என்பது OpenAI மற்றும் Anthropic போன்ற, harness-ன் catalog-ல் உள்ள providers-ஐ உள்ளடக்கியது; இதில் நீங்கள் key-ஐ paste செய்தால், catalog-ஆனது endpoint மற்றும் model பட்டியலை வழங்கும். "Custom model API" என்பது சுவாரஸ்யமான விருப்பம்: இதற்கு lowercase provider ID, display name, base URL, API protocol, credential மற்றும் குறைந்தது ஒரு model தேவை. Protocol picker-ல் OpenAI Chat Completions, OpenAI Responses, Anthropic Messages மற்றும் Gemini API ஆகிய விருப்பங்கள் உள்ளன, எனவே இவற்றில் ஏதேனும் ஒன்றைப் பயன்படுத்தும் gateway அல்லது local server-ஐ நீங்கள் configure செய்யலாம்; request-format மாற்றங்களைக் கொண்ட endpoints-க்கு compatibility settings தேவைப்படும். Custom providers, உங்களுக்காக model பட்டியலை நிரப்ப OpenAI-compatible GET /models endpoint-ஐயும் query செய்ய முடியும்.

இதே VPS-ல் உள்ள ஒரு model-ஐ harness-க்கு எப்படிச் சுட்டிக்காட்டுவது என்பது இதுதான். Ollama, http://127.0.0.1:11434/v1/-ல் OpenAI-compatible API-ஐ வழங்குகிறது, மேலும் API key field-ல் எந்த string-ஐயும் உள்ளிடலாம், வழக்கமாக ollama பயன்படுத்தப்படுகிறது, ஏனெனில் OpenAI-style client-க்கு ஒரு மதிப்பு தேவைப்படுகிறது, ஆனால் Ollama அதை அலட்சியப்படுத்திவிடும். Ollama-வின் சொந்த ஆவணங்களும் ollama launch dsh-ஐ விவரிக்கின்றன, இது @deepseek-ai/dsh விடுபட்டிருந்தால் அதை install செய்து, ஒரு Ollama model-க்கு எதிராகத் தொடங்கும், எனவே கீழே உள்ள pin-ஐ நம்புவதற்கு முன்பு அது எந்த version-ஐ install செய்கிறது என்பதைச் சரிபார்க்கவும். உங்கள் VPS-ல் பொருந்தக்கூடிய ஒரு சிறிய model, ஒரு agent-ஐ இயக்குவதற்குப் போதுமானதா என்பது கடினமான கேள்வி, மேலும் Ollama மற்றும் vLLM ஆகியவற்றுக்கு இடையிலான வேறுபாடு உங்கள் RAM-ல் எவ்வளவு செலவாகும் என்பதைத் தீர்மானிக்கிறது.

UI-ல் தட்டச்சு செய்யப்படும் Keys, write-only முறையில் இருக்கும். Harness அவற்றை $DSH_HOME/.credentials.yaml-ல் சேமிக்கிறது, மேலும் settings-ல் credential reference மட்டுமே இருக்கும், தற்போதைய releases இதை active profile-ன் patch file-ஆன $DSH_HOME/profiles/<profile>/cordis.patch.yml-ல் எழுதும் (profile என்பது dsh web-க்கான web ஆகும்). $DSH_HOME இயல்பாக ~/.dsh-ஐக் கொண்டிருக்கும். இந்த credentials file-ஐ ஒரு password file போலக் கையாளவும், ஏனெனில் அது அப்படித்தான்: அதை வாசிக்கும் எவரும் உங்கள் API budget-ஐச் செலவிட முடியும். Settings வழியாகச் செல்வதற்குப் பதிலாக அந்த files-ஐ நேரடியாக edit செய்ய விரும்பினால், dsh config files, keys மற்றும் model endpoints பற்றிய விளக்கம் ஒவ்வொரு key-யும் என்ன செய்கிறது என்பதையும், ஒவ்வொரு mode-லும் உங்கள் கணினியிலிருந்து என்ன வெளியேறுகிறது என்பதையும் காட்டும்.

நிறுவுவதற்கு முன் உங்களுக்குத் தேவையானவை

  • SSH அணுகல் கொண்ட, Ubuntu 24.04 அல்லது தற்போதைய Linux இயங்குதளம் கொண்ட ஒரு VPS.
  • Node.js 24.9 அல்லது அதற்குப் பிந்தைய பதிப்பு. ஏனெனில், இந்தத் திட்டத்தின் முதன்மை கிளை (main branch) மற்றும் 0.2.2-alpha.2 இப்போது >=24.9.0-ஐக் குறிப்பிடுகின்றன. மேலும், இதன் CI சோதனைகள் Node 24-ஐப் பயன்படுத்துகின்றன, இது Node 24.9 மற்றும் Node 26 ஆகியவற்றுடன் இணக்கத்தன்மை சரிபார்ப்பைக் கொண்டுள்ளது; இதில் Node 22-க்கான பணி (job) இல்லை. 0.2.1-rc.4 வழியாக வெளியிடப்பட்ட பதிப்புகள் (tagged releases) Node 22.19-ஐ ஏற்கத்தக்கதாகக் குறிப்பிட்டிருந்தாலும், தற்போதைய கட்டுமானத்திற்கு அது குறைந்தபட்சத் தேவையாக இல்லை.
  • root அல்லாத ஒரு சாதாரண பயனர் கணக்கு. ஏனெனில், இந்த ஏஜென்ட் எந்தப் பயனர் செயல்முறையைத் தொடங்குகிறாரோ, அந்தப் பயனரின் உரிமையிலேயே shell கட்டளைகளை இயக்கும்.
  • நீங்கள் plugins நிறுவத் திட்டமிட்டால், உங்கள் PATH-ல் pnpm இருக்க வேண்டும். ஏனெனில், plugin கட்டளை அதைத்தான் அழைக்கும்.
  • உங்கள் firewall மற்றும் உங்கள் சேவை வழங்குநரின் தனிப்பட்ட network firewall-ல் port 3080 மூடப்பட்டிருக்க வேண்டும்.

Ubuntu 24.04-ன் சொந்த nodejs தொகுப்பு, இந்தத் திட்டத்திற்குத் தேவையானதை விடப் பழையது. எனவே, அந்த வெளியீட்டில் apt install nodejs-ஐப் பயன்படுத்துவதற்குப் பதிலாக, NodeSource அல்லது nvm மூலம் Node-ஐ நிறுவவும். Ubuntu 26.10-ன் அதிகாரப்பூர்வ களஞ்சியம் (repository) Node 24.19.0-ஐக் கொண்டுள்ளது, இது Node 24.9 என்ற குறைந்தபட்சத் தேவையை விட அதிகம். உங்கள் VPS புதியது என்றால், எதையும் செய்வதற்கு முன் SSH-ஐப் பலப்படுத்துவது பத்து நிமிடங்களுக்கு மதிப்புடையது. ஏனெனில், நீங்கள் பயன்படுத்தப்போகும் tunnel-ன் பாதுகாப்பு, அதன் பின்னணியில் உள்ள SSH server-ன் தரத்தைப் பொறுத்தே அமையும்.

DeepSeek Harness-ஐ ஒரு VPS-ல் நிறுவுதல் மற்றும் ஒரு குறிப்பிட்ட version-ல் நிலைநிறுத்துதல்

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

npx தொகுப்பைப் பதிவிறக்கி அதன் dsh binary-ஐ இயக்குகிறது. web என்பது --profile web-க்கான ஒரு alias ஆகும்; இது browser application-ஐத் தொடங்கும், மேலும் அந்த process அது listening-ல் இருக்கும் முகவரியை அச்சிடும். இயல்புநிலை முகவரி http://127.0.0.1:3080 ஆகும். அந்த எண்கள் ஒரு அலங்காரமான இயல்புநிலை அல்ல, அவை ஒரு binding முடிவாகும். உங்கள் laptop-லிருந்து அதை அணுகுவதற்கு முன்பு, dsh ஏன் loopback முகவரியை அச்சிடுகிறது என்பதைப் படித்துப் புரிந்துகொள்ளவும்.

Version-ஐ நிலைநிறுத்தவும் (Pin). நீங்கள் npx @deepseek-ai/dsh web-ஐ இயக்கும்போது, அது latest tag எதைக் குறிக்கிறதோ அதைத் தீர்மானிக்கிறது; ஒருவேளை நீங்கள் இயக்கும் project-ல் ஏற்கனவே ஒரு copy நிறுவப்பட்டிருந்தால், npx அமைதியாக அதையே பயன்படுத்தும். எப்படியிருப்பினும், நீங்கள் version-ஐத் தேர்வு செய்யவில்லை; இந்த project ஏற்கனவே பல release candidates-ஐ வெளியிட்டுள்ளது, மேலும் breaking changes வரக்கூடும் என்றும் கூறியுள்ளது. 0.1.0-rc.6 என்பது இங்கே நிலைநிறுத்தப்பட்ட ஆகஸ்ட் 2026 version ஆகும். 12 நவம்பர் 2026 அன்று latest என்பது 0.2.2-rc.1-ஐக் குறிக்கிறது; இது ஒரு tokenized startup URL-ஐ அச்சிடும் release ஆகும். GitHub-ல் புதிய prerelease 0.2.2-rc.2 பட்டியலிடப்பட்டுள்ளது, எனவே repository-ஐப் படித்த பிறகு, திட்டமிட்டு version-ஐ மாற்றுவதே சரியான முறையாகும். ஒரு pinned version என்பது, இன்று நீங்கள் அமைக்கும் server அடுத்த மாதமும் அதேபோல் செயல்படும் என்பதாகும்; இதனால், தற்செயலாக நடக்கும் மாற்றத்திற்குப் பதிலாக, நீங்கள் எடுக்கும் முடிவாக upgrade அமையும். ஒரு pinned command தவறான build-ஐத் தொடங்கினாலோ அல்லது நிறுவ மறுத்தாலோ, பொதுவான dsh நிறுவல் மற்றும் version பிழைகள் பகுதியில் npx cache-ஐ நீக்குவது மற்றும் உங்கள் Node எந்த npm-ஐப் பயன்படுத்துகிறது என்பதைச் சரிபார்ப்பது பற்றிப் பார்க்கவும்.

தினசரி பயன்பாட்டிற்கு, ஒவ்வொரு முறையும் தீர்மானிப்பதற்குப் பதிலாக, அதை ஒருமுறை நிறுவவும்.

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

இரண்டாவது வரியை இயக்குவது அவசியம், ஏனெனில் launcher மற்றும் web app ஆகிய இரண்டும் தனித்தனி flag தொகுப்புகளைக் கொண்டுள்ளன. dsh --help, launcher-ன் சொந்த விருப்பங்களைக் காட்டுகிறது. dsh --profile web --help, web application ஏற்கும் flags-ஐக் காட்டுகிறது; இங்கேதான் --port, --host மற்றும் மீண்டும் பயன்படுத்தக்கூடிய --trusted-host ஆகியவை உள்ளன.

இப்போது அது எதில் listening-ல் உள்ளது என்பதை உறுதிப்படுத்தவும்.

ss -tlnp | grep 3080

Local address column-ல் 127.0.0.1:3080 என்று இருக்க வேண்டும். அது 0.0.0.0:3080 என்று இருந்தால், UI அனைத்து interface-களிலும் listening-ல் உள்ளது என்று அர்த்தம்; எனவே, உங்கள் firewall மட்டுமே அதற்கும் இணையத்திற்கும் இடையில் உள்ளது. வேறு எதையும் செய்வதற்கு முன்பு அந்த process-ஐ நிறுத்தவும்.

port 3080-ஐ ஏன் ஒருபோதும் பொதுவெளியில் வெளியிடக்கூடாது

0.1.0-rc.6-ல் உள்ள web server-க்கு எந்தவிதமான authentication அடுக்கு இல்லை. அதன் configuration ஒரு listen host மற்றும் listen port-ஐ மட்டுமே கொண்டுள்ளது; இதுவே அதன் முழுமையான பாதுகாப்பு பரப்பு. Loopback அல்லாத deployments-க்கு, இது ஒரு login திரை அல்ல, மாறாக ஒரு தனிப்பட்ட trusted-host அமைப்பாகும்.

புதிய releases-ல் இது சேர்க்கப்பட்டுள்ளது. 0.2.0-rc.2-லிருந்து, startup-ன் போது அந்த process-க்கான புதிய token-ஐக் கொண்ட URL ஒன்று திரையில் தோன்றும்; அதைத் திறக்கும் browser ஒரு signed session cookie-ஐப் பெற்று, token இல்லாத அதே முகவரிக்கு திருப்பி விடப்படும். /api-க்கு முன்னால் உள்ள Host/Origin fence, loopback, listener-ன் சொந்த bind முகவரி மற்றும் --trusted-host மூலம் நீங்கள் குறிப்பிடும் authorities ஆகியவற்றை மட்டுமே ஏற்கும். இது ஒரு உண்மையான credential ஆகும். இருப்பினும், திரையில் தோன்றும் அந்த URL-ஐ நீங்கள் அனுமதிக்கும் பயனர்களுடன் மட்டுமே பகிர வேண்டும் என்றும், plain HTTP-ல் அது encryption இன்றி அனுப்பப்படும் என்றும் திட்டத்தின் ஆவணங்கள் எச்சரிக்கின்றன. 0.2.1-alpha.2-லிருந்து, இந்த web app ஒரு குறிப்பிட்ட local முகவரியை bind செய்து, --tls-cert மற்றும் --tls-key மூலம் HTTPS-ஐயும் வழங்க முடியும். இது plaintext பிரச்சினையைத் தீர்க்குமே தவிர, வெளிப்படும் (exposure) சிக்கலைத் தீர்க்காது. இது ஒரு exposed port-ஐ தவறாகப் பயன்படுத்துவதை கடினமாக்குமே தவிர, அதை பொதுவெளியில் வெளியிடுவதற்கு ஏற்றதாக மாற்றாது.

இப்போது அந்த port-க்கு பின்னால் என்ன இருக்கிறது என்று பார்ப்போம். இந்த agent workspace-ல் உள்ள கோப்புகளைத் திருத்துகிறது மற்றும் shell commands-ஐ இயக்குகிறது; உங்கள் provider credentials அதன் அருகிலேயே disk-ல் சேமிக்கப்பட்டுள்ளன. எனவே, pinned release-ல் திறந்திருக்கும் port 3080 என்பது, உங்கள் API key-யுடன், அதைத் தொடங்கிய பயனர் உரிமைகளுடன் இயங்கும் ஒரு remote shell ஆகும். இதற்கு எந்த exploit-ம் தேவையில்லை; port எண் தெரிந்தாலே போதும். Launch token கொண்ட release-ல், அந்த token-ம் தேவைப்படும்; ஆனால் உங்கள் terminal, service logs அல்லது unencrypted traffic-ஐ அணுகக்கூடிய எவருக்கும் அந்த token ஏற்கனவே தெரிந்திருக்கும்.

CLI (command line interface)-ம் இதை உறுதிப்படுத்துகிறது. 0.1.0-rc.6-லிருந்து, இது திட்டமிட்டே --host 0.0.0.0-ஐ ஆதரிப்பதில்லை; அதைத் தொடங்க முயன்றால் usage error-ஐக் காட்டி வெளியேறிவிடும். புதிய 0.2.2-alpha.2-ம் startup-ன் போது அதை நிராகரிக்கிறது. இந்த நிராகரிப்பு ஒரு பாதுகாப்பு அம்சம்; எனவே இதை நீக்கும் patch-ஐத் தேட வேண்டாம்.

Tunnel வசதி உங்களுக்குப் பொருந்தவில்லை எனில், வேறு இரண்டு முறைகள் நியாயமானவை. உங்கள் சாதனங்கள் மட்டுமே அணுகக்கூடிய ஒரு private overlay network-ல் அந்த box-ஐ வைக்கலாம்; இதற்கு self-hosted Headscale control server உதவும். அல்லது, port 3080-ஐ அடையும் முன்பே கோரிக்கையை அங்கீகரிக்கும் (authenticate) ஒரு reverse proxy-ஐ முன்னால் வைக்கலாம்; உதாரணமாக, forward auth செய்யும் Authentik single sign-on server-ஐப் பயன்படுத்தலாம். எந்தவிதமான authentication-ம் இல்லாத reverse proxy ஒரு பாதுகாப்பு கட்டுப்பாடு அல்ல; அது வெறும் நீண்ட URL மட்டுமே.

SSH tunnel வழியாக web UI-ஐ அணுகுதல்

இதை server-ல் இயக்க வேண்டாம், உங்கள் laptop-ல் இயக்கவும்.

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

-L உங்கள் laptop-ல் 3080 port-ஐத் திறந்து, அதனுடன் இணையும் அனைத்தையும் encrypted SSH session வழியாக அனுப்புகிறது. 127.0.0.1:3080 பகுதி server-ல் தீர்மானிக்கப்படுகிறது (resolved), எனவே நீங்கள் அந்த machine-க்கு முன்னால் அமர்ந்திருப்பது போலவே, loopback வழியாக இணைப்பு harness-ஐ வந்தடைகிறது. -N என்பது remote shell-ஐத் தொடங்க வேண்டாம் என்று கூறுகிறது, ஏனெனில் உங்களுக்கு port forwarding மட்டுமே தேவை.

பிறகு உங்கள் local browser-ல் http://127.0.0.1:3080-ஐத் திறக்கவும். Launch token கொண்ட ஒரு release-ல், server வெளியிட்ட முழுமையான startup URL-ஐத் திறக்கவும் (token-உடன்); SSH வழியாக harness தொடங்கப்படும்போது, அது startup வரியை அச்சிடும், ஆனால் உங்களுக்காக browser-ஐத் திறக்காது. உங்கள் laptop-ல் 3080 port ஏற்கனவே பயன்பாட்டில் இருந்தால், இடதுபுற எண்ணை மாற்றவும்: ssh -N -L 3180:127.0.0.1:3080 you@your-server, பிறகு http://127.0.0.1:3180-க்குச் செல்லவும்; token உள்ள URL-லும் அதேபோல port-ஐ மாற்றவும். இடதுபுற எண் local-ஐக் குறிக்கும், வலதுபுற எண் server-ஐக் குறிக்கும், எனவே இடதுபுற எண் மட்டுமே மாறும்.

இதை ~/.ssh/config-ல் சேமிக்கவும், மீண்டும் மீண்டும் தட்டச்சு செய்வதைத் தவிர்க்கவும்.

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

அதன்பிறகு, ssh -N dsh tunnel-ஐத் தொடங்கும். Browser-ல் "connection was refused" என்று காட்டினால், tunnel செயல்படுகிறது ஆனால் மறுமுனையில் எந்த service-ம் இயங்கவில்லை என்று அர்த்தம்; ஏனெனில் harness இயங்கினாலும் இல்லாவிட்டாலும் SSH port-ஐ forward செய்யும். மேலே உள்ள ss கட்டளையைப் பயன்படுத்தி server-ஐச் சரிபார்க்கவும்.

நீங்கள் வெளியேறிய பிறகும் harness-ஐத் தொடர்ந்து இயங்க வைத்தல்

ஒரு npx கட்டளை உங்கள் shell-உடன் முடிந்துவிடும். ஒரு systemd user service உங்கள் வெளியேற்றத்திற்குப் பிறகும் இயங்கும், மேலும் ஒரு crash அல்லது reboot-க்கு பிறகு அது harness-ஐ மீண்டும் கொண்டுவரும். இங்குள்ள unit மிக எளிமையானது; harness-ஐ அதற்கென பிரத்யேகமான, பாதுகாக்கப்பட்ட கணக்கின் கீழ் இயக்க விரும்பினால், unit-க்குள் version-ஐக் குறிப்பிட்டு, தேடக்கூடிய logs-உடன் அமைக்க dsh-க்கான headless systemd அமைப்பு என்பதை முழுமையாகப் பார்க்கவும்.

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

enable-linger முக்கியமானது, ஏனெனில் உங்கள் கடைசி session முடிவடையும் போது user services வழக்கமாக நின்றுவிடும். எனவே, இது இல்லையென்றால் நீங்கள் tunnel-ஐ மூடியவுடன் harness நின்றுவிடும். command -v dsh மூலம் காட்டப்படும் முழுமையான பாதையை (absolute path) எடுத்து unit-ல் பதிவிடவும், ஏனெனில் உங்கள் login shell உருவாக்கும் PATH-ஐ systemd தேடாது.

[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 என்பது வெறும் அலங்காரத்திற்காக அல்ல. dsh செயல்முறை (process) தான் அழைக்கப்பட்ட கோப்பகத்தையே (directory) இயல்புநிலை கோப்பு முறைமை இருப்பிடமாகப் பயன்படுத்துகிறது. எனவே, தவறான இடத்தில் தொடங்கப்படும் ஒரு service, agent-ஐத் தவறான கோப்புறைக்குச் சுட்டிக்காட்டும். அந்த கோப்பகம் ஒரு இயல்புநிலை மட்டுமே: நீங்கள் Choose workspace என்பதன் கீழ் ஒன்றைத் தேர்ந்தெடுக்கும் வரை, புதிய Web UI-ல் எந்த workspace-ம் தேர்ந்தெடுக்கப்பட்டிருக்காது. நீங்கள் dsh-ஐத் தொடங்கிய கோப்பகத்தைச் சேர்க்குமாறு திட்டத்தின் வழிகாட்டி கூறுகிறது. அந்த வழிகாட்டியில் version குறிப்பு எதுவும் இல்லை, மேலும் அதே வாசகம் 0.1.0-rc.7-லும் உள்ளது, எனவே pinned release-லும் அதை எதிர்பார்க்கலாம். unit-ன் கோப்பகத்தை அந்தத் திட்டத்திற்கு அமைத்துவிட்டு, UI-ல் அந்த workspace-ஐத் தேர்ந்தெடுக்கவும்.

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

தொடங்க மறுக்கும் ஒரு unit, பெரும்பாலும் தவறான ExecStart பாதை அல்லது binary நிராகரிக்கும் ஒரு Node version காரணமாகவே இருக்கும், மேலும் journalctl --user -u dsh -n 50 எதில் தவறு என்பதைத் தெரிவிக்கும். launch token கொண்ட ஒரு release-ல், token-உடன் கூடிய startup URL-ம் journal-லிலேயே பதிவாகும், மேலும் ஒவ்வொரு முறை restart செய்யும்போதும் புதிய URL உருவாக்கப்படும். இதே முறைதான் எந்தவொரு coding agent-ஐயும் VPS-ல் தொடர்ந்து இயங்க வைத்தல் என்பதற்கும் பொருந்தும், மேலும் தோல்விக்கான காரணங்களும் ஒரே மாதிரியானவை.

ஒரு plugin என்ன செய்ய அனுமதிக்கப்படுகிறது

ஒரு plugin என்பது பகிரப்பட்ட சூழலில் (shared context) சேவைகள், தட்டச்சு செய்யப்பட்ட நிகழ்வுகள் (typed events) மற்றும் மாற்றக்கூடிய விளைவுகளை (reversible effects) வழங்கும் ஒரு தொகுதியாகும். இதில் உள்ள extension points-களை கவனமாகப் படிப்பது அவசியம்:

  • ctx.llm-ல் ஒரு model provider-ஐப் பதிவு செய்தல்
  • ctx.tools-ல் model-க்குத் தேவையான கருவிகளைச் சேர்த்தல்
  • ctx.shell-ன் பின்னால் shell backend-ஐ வழங்குதல்
  • ctx.fs-ன் பின்னால் filesystem அணுகல் அல்லது கொள்கையை வழங்குதல்
  • ctx.commands-ல் பயனர் கட்டளைகளைப் (human commands) பதிவு செய்தல்
  • ctx.jobs வழியாக பின்னணிப் பணிகளை இயக்குதல்
  • ctx.sandbox backend மூலம் உருவாக்கப்பட்ட செயல்முறைகளை (spawned processes) உள்ளடக்குதல் (wrap)
  • agent/* மற்றும் tools/* நிகழ்வுகள் மூலம் கோரிக்கைகள் மற்றும் tool calls-களை இடைமறித்தல்
  • நீடித்த அமர்வு நிலையை (durable session state) நீட்டித்தல்
  • ctx.agents மூலம் UI-ஐ இயக்குதல்

இந்த பட்டியலை ஒரு தாக்குபவர் (attacker) பார்ப்பது போலவே பாருங்கள். ஒரு plugin-ஆல் filesystem அடுக்கு மற்றும் shell அடுக்கை வழங்க முடியும், மேலும் model செய்யும் ஒவ்வொரு tool call-க்கும் இடையில் அது இருக்க முடியும். ஒரு plugin-க்கும் இந்த இணைப்புகளுக்கும் (seams) இடையே எந்த அனுமதிக் கோரிக்கையும் (permission dialog) இல்லை, ஏனெனில் ஒரு plugin என்பது மற்ற அனைத்தையும் போலவே அதே process-ல் ஏற்றப்படும் சாதாரண Node code ஆகும். ஒரு plugin-ஐ நிறுவுவது என்பது உங்கள் agent-ன் அனுமதிகளுடன் ஒரு அந்நியரின் code-ஐ இயக்குவதாகும், மேலும் உங்கள் agent-ன் அனுமதிகள் என்பது உங்கள் Unix பயனரின் அனுமதிகளே ஆகும்.

நீங்கள் ஒரு VPS-ல் உள்ள agent-உடன் MCP server-ஐ இணைக்கும்போது எடுக்கும் அதே நம்பிக்கைத் தீர்மானம் இதுவே, இங்கு MCP என்பது model context protocol ஆகும். இதனால்தான் VPS-ல் ஒரு coding agent-ஐப் பாதுகாப்பாக இயக்குவது என்பது model-ல் தொடங்காமல், அது இயங்கும் கணக்கிலிருந்து (account) தொடங்குகிறது. மேலும், npm supply chain தாக்குதல்கள் server-களை ஏன் கடுமையாகப் பாதிக்கின்றன என்பதற்கும் இதுவே காரணம்: நிறுவும் நிலையே (install step) சமரசமாக (compromise) மாறிவிடுகிறது, மேலும் எந்த எச்சரிக்கையும் உங்களுக்குத் தெரிவிக்கப்படுவதில்லை.

Plugins எங்கிருந்து வருகின்றன

Plugins அனைத்தும் profiles-ல் இருக்கும். ஒரு profile என்பது $DSH_HOME-ன் கீழ் சேமிக்கப்படும் பெயரிடப்பட்ட தொகுப்பாகும்; இது இயல்பாக ~/.dsh என அமையும். ஒவ்வொரு profile directory-யும் அது நிறுவும் out-of-tree plugins-ஐத் தன்னகத்தே கொண்டிருக்கும். CLI, உங்கள் arguments-ஐ நேரடியாக pnpm-க்கு அனுப்பி அவற்றை நிர்வகிக்கும்; அப்போது அந்த profile directory-யே working directory-யாகச் செயல்படும்.

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

Arguments மாற்றமின்றி pnpm-க்குச் செல்வதால், add, remove, update மற்றும் why ஆகியவை எந்தவொரு pnpm project-லும் செயல்படுவது போலவே செயல்படும். ஒரு plugin என்பது npm package-ஆகவோ அல்லது GitHub reference-ஆகவோ இருக்கலாம். pnpm முதலில் PATH-ல் இருக்க வேண்டும். Node 24-ல், corepack enable pnpm அதை அங்கு வைக்கும். Node 25-ல் Corepack விநியோகம் நிறுத்தப்பட்டதால், Node 25 மற்றும் அதற்குப் பிந்தைய பதிப்புகளில் npm install -g pnpm மூலம் அதை நிறுவவும்.

GitHub topic மூலம் plugins கண்டறியப்படுகின்றன. Plugin உருவாக்குநர்கள் தங்கள் repository-ல் dsh-plugin topic-ஐச் சேர்ப்பார்கள்; அந்த topic-ஐத் தேடுவதன் மூலம் என்னென்ன plugins உள்ளன என்பதை நீங்கள் அறியலாம். Topic என்பது ஒரு உருவாக்குநர் தனது repository-க்கு இடும் ஒரு label ஆகும். இதை யாரும் சரிபார்ப்பதில்லை, யாரும் கையொப்பமிடுவதில்லை. Topic பக்கம் stars எண்ணிக்கையின் அடிப்படையில் வரிசைப்படுத்தப்படுகிறது; இது பாதுகாப்பை விட பிரபலத்தையே அளவிடுகிறது.

தற்போதைய releases-ல் experimental Custom plugin indexes bundle வசதியும் உள்ளது. Plugins-ன் கீழ் இதைச் செயல்படுத்தினால், Discover tab மூலம் நீங்கள் ஒரு index-ஐச் சேர்க்கலாம். இது நீங்கள் வழங்கும் URL-லிருந்து பெறப்படும் ஒரு JSON கோப்பாகும். இந்த harness தனக்கென எந்த index-ஐயும் கொண்டிருக்கவில்லை. இது கோப்பின் வடிவத்தை மட்டுமே சரிபார்க்கும்; ஒரு சந்தை (market) குறிப்பிடும் தலைப்புகள், உருவாக்குநர்கள் அல்லது ஆதாரங்களை இது சரிபார்ப்பதில்லை. சாதாரண http: மூலம் வழங்கப்படும் index-ஐ network பாதையில் உள்ள எவரும் மாற்றியமைக்க முடியும். சந்தை என்பது வேறொருவர் எழுதிய பட்டியல் மட்டுமே, அது ஒரு மதிப்பாய்வு (review) அல்ல.

நான்கு பழக்கவழக்கங்கள் மூலம் இதை எளிதாக நிர்வகிக்கலாம். நிறுவும் முன் source code-ஐப் படிக்கவும், ஏனெனில் பெரும்பாலான plugins பத்து நிமிடங்களில் வாசிக்கும் அளவுக்குச் சிறியவை. ஒரு branch-ஐத் தொடர்வதற்குப் பதிலாக, சரியான version அல்லது commit-ஐ pin செய்யவும். வேறு எந்த முக்கியத் தரவுகளும் இல்லாத ஒரு user-ன் கீழ், தேவைப்பட்டால் மீண்டும் உருவாக்கக்கூடிய (rebuild) ஒரு VPS-ல் இந்த harness-ஐ இயக்கவும். உங்கள் production services பயன்படுத்தும் API key-யிலிருந்து தனித்து, இதற்கெனத் தனியான spending limit கொண்ட API key-யைப் பயன்படுத்தவும். ஒரு plugin-ஐ வாசிக்கும்போது எந்தெந்தக் கோப்புகள் ஆபத்தானவை என்பதை அறிய விரும்பினால், dsh plugin-ஐச் சரிபார்ப்பதற்கான வழிமுறை அதன் manifest, entry point மற்றும் அது பதிவு செய்யும் extension points ஆகியவற்றை விளக்குகிறது.

ஒன்றைத் தேர்ந்தெடுக்கும் முன் வடிவமைப்புகளை ஒப்பிட விரும்பினால், Omnigent multi-agent harness அதே சிக்கலுக்கு வேறு ஒரு கட்டமைப்பை வழங்குகிறது; plugins-ஐப் பயன்படுத்தத் தொடங்கும்போது அவற்றுக்கிடையேயான வேறுபாடுகள் தெளிவாகத் தெரியும். ஒரு தீர்வைத் தேர்ந்தெடுப்பதற்குப் பதிலாக இரண்டையோ அல்லது மூன்றையோ ஒரே server-ல் வைத்திருக்க விரும்பினால், ஒவ்வொரு harness-ஐயும் ஒரு self-hosted API-ன் பின்னால் வைப்பது ஒவ்வொரு port-க்கும் தனித்தனி tunnel அமைக்கும் வேலையைத் தவிர்க்கும். ஆனால், இதற்காக loopback-ல் பிணைக்கப்பட்டு, முதல் நாளிலேயே முறையான கடவுச்சொல் வழங்கப்பட வேண்டிய ஒரு கூடுதல் service-ஐ நீங்கள் பராமரிக்க வேண்டியிருக்கும்.

முதலில் செயலிழப்பவை

Node மிகவும் பழையதாக இருத்தல். திட்டத்தின் main branch மற்றும் 0.2.2-alpha.2 ஆகியவற்றுக்கு Node 24.9 அல்லது அதற்குப் புதிய பதிப்பு தேவை. இதன் CI சோதனைகள் Node 24-ஐயும், Node 24.9 மற்றும் Node 26-ல் இணக்கத்தன்மை சோதனையையும் செய்கின்றன; Node 22-ல் எந்தச் சோதனையும் இல்லை. 0.2.1-rc.4 வரையிலான பழைய tagged releases-ல் Node 22.19 ஏற்கத்தக்கதாகக் குறிப்பிடப்பட்டிருந்தது, ஆனால் தற்போது அந்தப் பதிப்பில் இந்தத் திட்டம் build செய்யப்படுவதில்லை. பழைய runtime-ல் புதிய syntax மற்றும் API-கள் இல்லாததால், service தொடங்கும்போதே செயலிழக்கும். மற்ற எதையும் செய்வதற்கு முன் node --version-ஐ இயக்கவும்.

Port 3080 ஏற்கனவே பயன்பாட்டில் இருத்தல். இரண்டாவது harness, பழைய process, அல்லது 3080-ஐப் பயன்படுத்தும் வேறொரு application இருக்கலாம். ss -tlnp | grep 3080 மூலம் அதைக் கண்டறிந்து, அதை நிறுத்தவும் அல்லது dsh web --port 3180 மூலம் harness-ஐ வேறொரு port-ல் தொடங்கவும். --port என்பது web app-க்கு உரியது, எனவே அது web-க்கு பின்னரே இயங்கும்.

Browser-ஆல் tunnel வழியாக இணைக்க முடியவில்லை. நீங்கள் 127.0.0.1-க்குச் சென்றதை உறுதிப்படுத்தவும்; server-ன் public address-க்குச் செல்ல வேண்டாம், ஏனெனில் forwarded port உங்கள் laptop-ல் மட்டுமே இருக்கும். பின்னர், harness server-ல் இயங்குகிறதா என்பதை உறுதிப்படுத்தவும், ஏனெனில் மறுமுனையில் எந்தப் பதிலும் இல்லாவிட்டாலும் SSH forward-ஐ அமைத்துவிடும்.

dsh plugin உடனடியாகச் செயலிழத்தல். இந்த command pnpm-ன் wrapper ஆகும், எனவே pnpm binary இல்லையென்றால், plugin வேலை தொடங்குவதற்கு முன்பே அது நின்றுவிடும். Node 25 மற்றும் அதற்குப் புதிய பதிப்புகளில் இதுவே இயல்பான நிலை, ஏனெனில் Corepack இப்போது Node-உடன் வருவதில்லை.

Agent-ஆல் உங்கள் திட்டத்தைப் பார்க்க முடியவில்லை. புதிய Web UI-ல் workspace-ஐச் சேர்க்கும் வரை எதுவும் தேர்ந்தெடுக்கப்படாது, அதுவரை session composer கிடைக்காது. இந்த process அது தொடங்கப்பட்ட directory-யையே இயல்புநிலை filesystem-ஆகக் கொள்ளும், எனவே WorkingDirectory உங்கள் home directory-ஆக இருக்கும் unit, agent-ஐ உங்கள் home directory-யையே பார்க்கச் செய்யும். UI-ல் workspace-ஐத் தேர்ந்தெடுக்கவும் அல்லது unit-ஐச் சரிசெய்து reload செய்யவும்.

FAQ

DeepSeek Harness web UI-ஐ port 3080-ல் பொதுவெளியில் வைப்பது பாதுகாப்பானதா?

இல்லை. இணைக்கப்பட்டுள்ள 0.1.0-rc.6-ல் உள்ள web server-க்கு எனத் தனியாக login வசதி இல்லை. இதன் பின்னணியில் இயங்கும் agent, அந்தச் செயல்முறையைத் தொடங்கிய பயனரின் உரிமைகளுடன் கோப்புகளைத் திருத்தவும், shell கட்டளைகளை இயக்கவும் செய்யும். உங்கள் provider API key அதே வட்டில் சேமிக்கப்பட்டிருக்கும். 0.2.0-rc.2 முதல், 0.2.2-rc.1 மற்றும் 12 November 2026 அன்று வெளியான npm-ன் latest release, அத்துடன் புதிய 0.2.2-rc.2 prerelease ஆகியவற்றில், தொடக்கத்தின் போது காட்டப்படும் URL-ல் ஒரு launch token இருக்கும். இதை browser ஒரு session cookie-ஆக மாற்றிக்கொள்ளும். இருப்பினும், அந்த URL ஒரு credential ஆகும்; plain HTTP-ல் அது குறியாக்கப்படாமல் (unencrypted) அனுப்பப்படுவதால், இந்த அறிவுரை மாறாது. listener-ஐ 127.0.0.1-ல் வைத்து, SSH tunnel வழியாக அணுகவும். ஒரு private overlay network அல்லது ஒவ்வொரு கோரிக்கையையும் port-க்குச் செல்லும் முன் அங்கீகரிக்கும் (authenticate) ஒரு reverse proxy-யையும் பயன்படுத்தலாம். பதிப்பு 0.1.0-rc.6 முதல், CLI --host 0.0.0.0-ஐ மறுத்து usage error-ஐக் காட்டும். 0.2.2-alpha.2-ம் இதை நிராகரிக்கிறது; இதன் மூலம் இந்த யோசனை குறித்து அதன் உருவாக்குநர்கள் என்ன நினைக்கிறார்கள் என்பதை நீங்கள் புரிந்துகொள்ளலாம்.

எனக்கு DeepSeek API key தேவையா, அல்லது local model-ஐப் பயன்படுத்தலாமா?

இரண்டையும் பயன்படுத்தலாம், ஏனெனில் இந்த harness ஒரு runtime மட்டுமே, model அல்ல. Settings மற்றும் Models பகுதிக்குச் சென்று, DeepSeek card-ல் அல்லது catalog provider-ல் ஒரு key-ஐ உள்ளிடலாம். அல்லது "Add model provider" என்பதைத் தேர்ந்தெடுத்து, "Custom model API" என்பதன் கீழ் OpenAI Chat Completions, OpenAI Responses, Anthropic Messages அல்லது Gemini API-ஐ ஆதரிக்கும் base URL-ஐ வழங்கலாம். ஒரு local Ollama server http://127.0.0.1:11434/v1/-ல் பதிலளிக்கும், மேலும் API key பகுதியில் எந்த string-ஐக் கொடுத்தாலும் அது ஏற்றுக்கொள்ளும். Keys $DSH_HOME/.credentials.yaml-ல் சேமிக்கப்படும், இது இயல்பாக ~/.dsh/.credentials.yaml-ஆக இருக்கும்.

DeepSeek Harness plugin-ஐ நிறுவுவதால் அந்த plugin-க்கு என்னென்ன உரிமைகள் கிடைக்கும்?

Harness-ஐ இயக்கும் கணக்கின் அனைத்து உரிமைகளும் அதற்கு உண்டு. ஒரு plugin என்பது அதே செயல்முறையில் ஏற்றப்படும் Node code ஆகும். shell backend, filesystem layer, tool registry மற்றும் ஒவ்வொரு tool அழைப்பையும் உள்ளடக்கிய events ஆகியவை இதில் அடங்கும். plugin-ஆகவே sandbox-ஐ வழங்கினால் ஒழிய, அந்தச் செயல்பாடுகளிலிருந்து plugin-ஐத் தனிமைப்படுத்த எந்த வசதியும் இல்லை. நிறுவுவதற்கு முன் source code-ஐப் படிக்கவும், உங்களுக்கு முக்கியமில்லாத கோப்புகளைக் கொண்ட ஒரு பயனரின் கணக்கில் harness-ஐ இயக்கவும்.

நான் எந்தப் பதிப்பை நிறுவ வேண்டும், அது தொடர்ந்து செயல்படுமா?

சரியான பதிப்பை நிறுவவும், உதாரணமாக npx @deepseek-ai/dsh@0.1.0-rc.6 web. இது இங்கே குறிப்பிடப்பட்டுள்ள August 2026 பதிப்பாகும். 12 November 2026 அன்று, npm-ன் latest tag 0.2.2-rc.1-ஐக் குறிக்கிறது. GitHub-ல் 11 November அன்று வெளியான புதிய prerelease 0.2.2-rc.2 பட்டியலிடப்பட்டுள்ளது. தற்போதைய CLI-க்கு Node 24.9 அல்லது அதற்குப் பிந்தைய பதிப்பு தேவை. இந்தத் திட்டம் தன்னை ஒரு developer preview என்று அழைக்கிறது, மேலும் இதில் மாற்றங்கள் எதிர்பார்க்கப்படுகின்றன. எனவே, பதிப்பை உறுதிப்படுத்தாத (unpinned) கட்டளைகள் ஒவ்வொரு நாளும் வெவ்வேறு விதமாகச் செயல்படலாம். upgrade செய்வதற்கு முன் repository-ஐச் சரிபார்க்கவும். பதிப்பு எண் 0-ல் தொடங்கும் வரை, config keys மற்றும் plugin interfaces மாறக்கூடும் என்பதை நினைவில் கொள்ளவும்.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?

#deepseek#agent-harness#self-hosting#nodejs#plugins