ফোন থেকে Hermes agent-এ পৌঁছানোর নিরাপদ উপায়
VPS-এ চলা Hermes agent ফোনে ব্যবহার করুন private mesh network, TLS ও login-সহ public HTTPS endpoint বা SSH দিয়ে। ফোন হারালে access কীভাবে revoke করবেন, তাও জানুন।
ফোন থেকে আপনার Hermes agent-এ পৌঁছানোর 3টি উপায়
ফোন থেকে আপনার Hermes agent-এ পৌঁছাতে এর web dashboard ব্যবহার করবেন। আসল সিদ্ধান্ত হলো, dashboard-এর সামনে কী থাকবে। প্রথম উপায় হলো একটি private mesh network, যেখানে dashboard শুধু Tailscale address-এ listening করবে এবং কোনো port Internet-এর দিকে উন্মুক্ত থাকবে না। দ্বিতীয় উপায় হলো TLS (transport layer security) ও login-সহ reverse proxy-এর পেছনে একটি public endpoint। এখানে সেই login-ই আপনার server-এর একটি terminal-এ প্রবেশাধিকার সুরক্ষিত রাখার একমাত্র ব্যবস্থা। তৃতীয় উপায় হলো terminal app থেকে SSH (secure shell) ব্যবহার করা। এতে setup সবচেয়ে কম এবং access সবচেয়ে বেশি পাওয়া যায়।
এই guide শুরু হচ্ছে নিজের VPS-এ Hermes agent চালানো যেখানে শেষ হয়েছে, সেখান থেকে। agent install করা আছে, এটি command line-এ সাড়া দেয়, এবং এখন আপনি এটি নিজের ফোনে ব্যবহার করতে চান।
নিচের command-গুলো v2026.8.3 tag অনুযায়ী লেখা হয়েছে। এটি 3 August 2026-এ প্রকাশিত এবং release notes-এ v0.20.0 হিসেবে চিহ্নিত। Hermes ঘন ঘন release করে। তাই main অনুসরণ না করে machine-এ একটি tag নির্দিষ্ট করে দিন। installer একটি commit গ্রহণ করে:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --versionএই pin-এর জন্য ওই tag-এর installer ব্যবহার করুন। বর্তমান installer নতুন PM dependency system প্রত্যাশা করে। hermes --version বাস্তবে install করা সংস্করণ দেখায়। এই পৃষ্ঠার কোনো flag ব্যবহার করার আগে সেটির সঙ্গে tag মিলিয়ে নিন।
রিপোজিটরিতে কী আছে এবং কী নেই
Hermes রিপোজিটরিতে কোনো iOS বা Android অ্যাপ নেই। নেটিভ ক্লায়েন্ট হলো hermes desktop (alias hermes gui), যা macOS, Windows এবং Linux-এর জন্য একটি Electron অ্যাপ্লিকেশন। এটি লোকাল agent-এর পরিবর্তে remote agent-এর সঙ্গে সংযুক্ত হতে পারে: Settings-এর Gateway অংশে remote URL হিসেবে http://<server-address>:9119 সেট করুন, অথবা অ্যাপ চালু করার আগে HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119 export করুন। এতে দ্বিতীয় laptop-এর সমস্যা সমাধান হয়। ফোনের ক্ষেত্রে এর কোনো কাজ নেই।
ফোন থেকে আপনি যে interface ব্যবহার করবেন, সেটি হলো hermes dashboard, অর্থাৎ browser interface। এটি configuration, session, cron job, skill, log এবং messaging platform পরিচালনা করে। এতে একটি terminal-ও সংযুক্ত আছে: server একটি PTY (pseudo-terminal)-এর পেছনে hermes --tui চালু করে এবং output page-এ stream করে। সরু screen-এ session switcher একটি slide-over panel-এ ভাঁজ হয়ে যায়। তাই phone-এও layout ঠিক থাকে।
নতুন release-গুলোতে hermes webapp ব্যবহার করে browser-এর মাধ্যমে Desktop workspace-ও চালানো যায়। এটি আলাদা gateway surface, যার নিজস্ব port এবং public URL setting আছে। নিচের নির্দেশনাগুলো dashboard-এর জন্য প্রযোজ্য।
ডিফল্টভাবে dashboard 127.0.0.1:9119-এ listen করে এবং server-এই একটি browser tab খোলে। headless VPS (virtual private server)-এ এটি কোনো কাজে আসে না। browser ছাড়া এটি চালু করুন এবং socket পরীক্ষা করুন:
hermes dashboard --no-open
ss -lntp | grep 9119127.0.0.1:9119-এ listener থাকলে সেটি শুধু server থেকেই reach করা যায়। 0.0.0.0:9119-এ listener থাকলে machine যে সব network-এর সঙ্গে সংযুক্ত, সেগুলো সব জায়গা থেকে—public network-সহ—এটি reach করা যায়। আপনি কতটা exposed থাকবেন, তা ওই এক লাইনই নির্ধারণ করে। তাই অনুমান না করে লাইনটি পড়ুন।
Option 1: Tailscale দিয়ে একটি private mesh
এটি বেছে নিন, যদি এটি না বেছে নেওয়ার নির্দিষ্ট কারণ না থাকে। Tailscale হলো WireGuard-এর ওপর তৈরি একটি mesh VPN (virtual private network)। আপনি যে প্রতিটি device enrol করবেন, সেটি একটি স্থায়ী address পাবে এবং অন্য device-গুলোর সঙ্গে সরাসরি অথবা encrypted relay-এর মাধ্যমে যুক্ত হবে। আপনার phone-ও একই mesh-এ যুক্ত হবে, তাই dashboard-এর জন্য কোনো public port খোলা লাগবে না।
Server-এ:
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4Phone-এ Tailscale app install করুন এবং একই account দিয়ে sign in করুন। Server-এ tailscale status চালালে phone-টি তার name-সহ তালিকাভুক্ত হবে। এখন tailscale ip -4 যে address দেখিয়েছে, dashboard-কে সেই address-এ bind করুন:
hermes dashboard --host 100.101.102.103 --port 9119 --no-open0.0.0.0-এর বদলে mesh address-এ bind করলে socket শুধু সেই mesh IP-র উদ্দেশে আসা connection গ্রহণ করবে। আপনার public IP address scan করলে 9119 port-এ কিছু পাওয়া যাবে না, কারণ ওই address-এ কোনো কিছু listen করছে না। তবে এতে socket-টি Tailscale interface-এর সঙ্গে বাঁধা হয় না। Linux kernel documentation-এ বিষয়টি স্পষ্টভাবে বলা আছে: IP address নির্দিষ্ট interface-এর নয়, পুরো host-এর মালিকানাধীন। একই provider network-এর কোনো machine থেকে public interface-এ আসা 100.101.102.103-এর উদ্দেশে পাঠানো packet এখনও dashboard-এ পৌঁছাতে পারে। Interface-টিকেও বাধ্যতামূলক করতে incoming traffic-এর জন্য ufw-এর default deny বজায় রাখুন এবং sudo ufw allow in on tailscale0 to any port 9119 proto tcp দিয়ে শুধু mesh-এ port-টি allow করুন। আবার ss -lntp | grep 9119 চালিয়ে listener নিশ্চিত করুন।
Bind address authentication-ও নির্ধারণ করে, এবং এখানেই অনেকে ভুল করেন। v2026.8.3-এ 127.0.0.1-এ bound dashboard-এ login থাকে না, যদিও public_url configured থাকে। অন্য যেকোনো address-এ auth gate বাধ্যতামূলক, এবং কোনো provider configured না থাকলে server start হতে অস্বীকার করে। Project এটিকে failing closed বলে। প্রথমবার এটি interactive ভাবে চালান; তখনই username ও password setup করার প্রস্তাব দেবে এবং সেগুলো ~/.hermes/config.yaml-এর মধ্যে dashboard.basic_auth হিসেবে সংরক্ষণ করবে। এর বদলে ~/.hermes/.env-এর মাধ্যমে একই provider configure করতে পারেন। Project-এর নিজস্ব working example-এ এভাবেই করা হয়েছে:
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-stringopenssl rand -base64 32 দিয়ে সেই secret generate করুন। Project-এর dashboard documentation-এ এই command ব্যবহার করা হয়েছে; config comment-এ 32 বা তার বেশি random byte, base64 অথবা hex চাওয়া হয়েছে। এরপর secret-টি পরিবর্তন করবেন না। এটি password provider-এর session token sign করে, তাই এটি পরিবর্তন করলে ওই provider ব্যবহারকারী প্রতিটি device sign out হয়ে যাবে। একই file-এ আপনার model API key-ও থাকে, তাই chmod 600 ~/.hermes/.env দিয়ে সেটির permission সীমিত রাখুন।
Mesh-এর অন্য একটি machine থেকে gate পরীক্ষা করুন, তারপর এটি নির্ভরযোগ্য বলে ধরে নিন:
curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'true-এর পরে ["basic"] দেখালে বোঝায় gate চালু আছে এবং password provider-ই উত্তর দিচ্ছে। Project-এর নিজস্ব documentation ওই provider সম্পর্কে স্পষ্ট: এটি trusted network অথবা VPN-এর জন্য, এবং public internet-এর দিকে উন্মুক্ত dashboard-এর জন্য উপযুক্ত নয়। Mesh-এ আপনার পরিস্থিতি ঠিক এমনই।
Tailnet-এর ভেতরে HTTPS ব্যবহারের জন্য নিচের Tailscale Serve setup-এ এমন একটি নতুন release দরকার, যাতে Host এবং WebSocket Origin check-এ public_url support থাকে। v2026.8.3 pin-এ এটি কাজ করে না: public_url যাই থাকুক, loopback bind শুধু loopback Host name গ্রহণ করে। ওই pin-এ উপরের direct mesh IP ব্যবহার করুন। Upgrade করার পর ওই check-গুলো যাচাই করুন। Serve এখানে loopback address-এ proxy করবে, তাই এই setup-এ dashboard mesh address-এর বদলে 127.0.0.1-এ start করুন। এরপর:
sudo tailscale serve --bg localhost:9119
sudo tailscale serve statusবর্তমান Hermes dashboard documentation অনুযায়ী, public URL হিসেবে tailscale serve status যে HTTPS origin দেখায় সেটি ব্যবহার করুন:
dashboard:
public_url: "https://vps.tail1234.ts.net"ওই line না থাকলে dashboard Host header-এ থাকা MagicDNS name প্রত্যাখ্যান করবে। Name-টি loopback host না হওয়ায় backend loopback-এ listen করলেও auth gate চালু থাকবে। Tailscale machine-এর MagicDNS name-এর জন্য issue করা certificate দিয়ে TLS terminate করে। ফলে browser warning দেখানো বন্ধ করবে এবং session cookie-তে Secure flag যুক্ত হবে। প্রথমে Tailscale admin console-এর DNS page-এ MagicDNS এবং HTTPS Certificates enable করুন। সেখানেই acknowledgement পড়ুন: আপনার machine name এবং tailnet DNS name public certificate transparency ledger-এ প্রকাশিত হয়, যা যে কেউ পড়তে পারে।
এখানে প্রকৃত খরচ হলো coordination server। আপনার phone এবং VPS-এর মধ্যকার traffic end-to-end encrypted থাকে, Tailscale DERP relay-এর মধ্য দিয়ে গেলেও। তবে কোন device mesh-এর অন্তর্ভুক্ত হবে তা নির্ধারণকারী account আপনার hardware-এ থাকে না। এটি গুরুত্বপূর্ণ হলে Headscale, self-hosted Tailscale control server ব্যবহার করে control plane নিজে চালান এবং tailscale up --login-server https://headscale.example.com দিয়ে client-গুলোকে তার দিকে নির্দেশ করুন। Mesh বাদ দিয়ে peer হাতে configure করতে চাইলে plain WireGuard এবং Tailscale-এর তুলনা অংশে কী কী সুবিধা ছাড়তে হবে তা ব্যাখ্যা করা হয়েছে।
Option 2: একটি public HTTPS endpoint এবং এর ভেতরের ফাঁদ
কখনও mesh ব্যবহার করা যায় না। কোনো work phone-এ VPN client install করার অনুমতি নাও থাকতে পারে। তখন dashboard-কে reverse proxy-এর পেছনে রাখতে হয়। এই loopback HTTPS setup-এর জন্যও উপরে বর্ণিত নতুন public hostname support প্রয়োজন; public_url সেটিকে v2026.8.3-এ কার্যকর করে না। dashboard-কে loopback-এ রাখুন এবং certificate ব্যবস্থাপনার দায়িত্ব Caddy-কে দিন:
hermes.example.com {
reverse_proxy 127.0.0.1:9119
}Caddy নিজে certificate সংগ্রহ ও renew করে। এর reverse_proxy অতিরিক্ত directive ছাড়াই WebSocket upgrade pass through করে, যা dashboard-এর embedded terminal-এর জন্য প্রয়োজন। nginx-এ Upgrade এবং Connection header নিজে যোগ করতে হয়। nginx-এ Certbot দিয়ে Let's Encrypt certificate issue করা-এ TLS অংশটি ব্যাখ্যা করা হয়েছে। Login callback যেন সঠিক host-এ যায়, সে জন্য Hermes-কে public name জানান:
dashboard:
public_url: "https://hermes.example.com"এখন ফাঁদটি দেখুন। Auth gate অনুরোধটি কোন address থেকে এসেছে তা নয়, bind address দেখে সিদ্ধান্ত নেয়। বর্তমান release-গুলোতে dashboard.public_url (অথবা HERMES_DASHBOARD_PUBLIC_URL) কোনো non-loopback host-এর নাম দিলে gate-টিও চালু হয়, এমনকি backend loopback-এ থাকলেও। তাই উপরের setting gate সক্রিয় করে এবং provider configure না করা পর্যন্ত dashboard start হতে অস্বীকার করে। public_url unset রাখলে gate বন্ধ থাকে। তবে কে প্রবেশ করবে, তা proxy একাই নির্ধারণ করে না। dashboard Host header-ও পরীক্ষা করে। এই loopback setup-এ বর্তমান release-গুলো loopback name এবং public_url-এ ঘোষিত host গ্রহণ করে। অন্য যেকোনো ক্ষেত্রে তারা 400 response দেয়। Pinned v2026.8.3 এখানে শুধু loopback name গ্রহণ করে এবং public_url কখনও পরীক্ষা করে না। Caddy browser-এর Host অপরিবর্তিতভাবে forward করে। তাই public_url ছাড়া উপরের block-টি reject হবে, serve হবে না। বিপদ তৈরি হয় যখন কোনো proxy Host backend address-এ rewrite করে। nginx defaultভাবে ঠিক এটিই করে। আপনি নিজে proxy_set_header Host set না করলে এটি proxy_pass target পাঠায়। এমন request check পাস করে এবং কোনো login ছাড়াই dashboard-এ পৌঁছে যায়। Terminal-এর WebSocket আরও একটি Origin check চালায়। Pin অনুযায়ী, Origin header উপস্থিত থাকলে সেটিকে bound host target করতে হবে। এতে public hostname-এ থাকা browser আটকানো যায়। কিন্তু কোনো script একেবারেই Origin না পাঠালে সেটি এই check পেরিয়ে যায়। আপনি যা-ই configure করুন, বাস্তবে কী publish হয়েছে তা পরীক্ষা করুন:
curl -s https://hermes.example.com/api/status | jq '.auth_required'এটি যদি false print করে, তাহলে Internet আপনার server-এর terminal থেকে মাত্র একটি URL দূরে। কোনো exploit জড়িত নয় এবং log-এ কিছুই অভিযোগ করবে না। Request 400 response দিয়ে ব্যর্থ হলে Host check সেটি প্রত্যাখ্যান করেছে। Public hostname support থাকা release-এ public_url এবং একটি login provider set করে সমস্যাটি সমাধান করুন। Check এড়াতে header rewrite করবেন না। v2026.8.3-এ আগে direct mesh IP route ব্যবহার করুন অথবা upgrade করুন। Open dashboard-এর জন্য দুটি সমাধান আছে, এবং অন্তত একটি ব্যবহার করা উচিত। হয় proxy-তে authentication বসান এবং forward auth ব্যবহার করে Authentik-কে self-hosted single sign-on provider হিসেবে সামনে রাখুন, অথবা dashboard-এর নিজস্ব OIDC (OpenID Connect) provider configure করুন:
HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"সঠিকভাবে configure করলেও এই option-এর একটি ন্যূনতম ঝুঁকি থাকে, যা কমানো যায় না। Public login page-এ যে কেউ পৌঁছাতে এবং আক্রমণ করতে পারে। এর পেছনে আপনার VPS-এ একটি shell রয়েছে। Username ও password এ ধরনের access-এর জন্য দুর্বল সুরক্ষা। তাই public bind-এর ক্ষেত্রে documentation OAuth বা OIDC ব্যবহারের পরামর্শ দেয়। Login rate limit করুন, proxy port এবং SSH ছাড়া সব কিছুর জন্য ufw বন্ধ রাখুন, এবং সময়ে সময়ে access log পড়ুন।
বিকল্প 3: মোবাইল টার্মিনাল থেকে SSH এবং mosh
সবচেয়ে কম পরিশ্রমের পদ্ধতি হলো ফোনে একটি টার্মিনাল অ্যাপ ইনস্টল করা, তাতে একটি SSH key লোড করা এবং agent-এর নিজস্ব text interface ব্যবহার করা।
ssh you@vps.example.com
tmux new -A -s phone
hermes --tuitmux new -A -s phone phone নামের একটি session-এ যুক্ত হয়। এমন session না থাকলে এটি তৈরি করে। ফলে connection বিচ্ছিন্ন হলেও agent চলতে থাকে এবং পরের বার একই জায়গায় ফিরে আসেন।
এই পদ্ধতিটি ফোন থেকে Claude Code পরিচালনা করার সময় ব্যবহৃত পদ্ধতির মতোই।
মোবাইল network-এর ওপর সাধারণ SSH ব্যবহার করা অস্বস্তিকর। ফোনের address পরিবর্তন হলে বা ফোন sleep-এ গেলে connection বিচ্ছিন্ন হয়ে যায়। mosh এই সমস্যা সমাধান করে। এটি UDP (user datagram protocol)-এর ওপর চলে এবং byte stream-এর বদলে terminal state sync করে। তাই wifi থেকে cellular network-এ হাঁটতে হাঁটতেও session চালু থাকে:
sudo apt install -y mosh
sudo ufw allow 60000:61000/udpফোন থেকে mosh you@vps.example.com চালান। mosh আপনার বিদ্যমান SSH login ব্যবহার করে mosh-server চালু করে। এরপর এটি session-টি 60000 থেকে 61000-এর মধ্যে একটি UDP port-এ স্থানান্তর করে। তাই এই range-টি খুলতে হয়। প্রতিটি session-এর জন্য একটি port প্রয়োজন। ফলে কমসংখ্যক concurrent session থাকা server-এ 60000 থেকে 60010-এর মতো ছোট range-ও খোলা যায়।
নিরাপত্তার ঝুঁকিটি সরল। SSH session হলো একটি shell, আর shell ওই account যা কিছু করতে পারে তার সবই করতে পারে। তাই চুরি হয়ে যাওয়া unlocked phone এবং আপনার file-এর মধ্যে agent-এর approval prompt-ই শেষ প্রতিরোধ হিসেবে থাকে। এই কাজের জন্য একটি dedicated non-root account ব্যবহার করুন এবং শুধু key authentication রাখুন। আপনি বহন করেন এমন কোনো device-এ key রাখার আগে VPS-এ SSH hardening করা সম্পন্ন করুন।
মোবাইল নেটওয়ার্কে কী কী কাজ করে না
চারটি বিষয় ঘটে। এগুলোর কোনোটিই configuration পরিবর্তন করে সমাধান করা যায় এমন bug নয়।
আপনি না দেখলেও dashboard আপনাকে logout করে দেয়। কত দ্রুত এটি ঘটে, তা login provider-এর ওপর নির্ভর করে। username ও password provider ডিফল্টভাবে 12 ঘণ্টা কার্যকর একটি access token জারি করে। এই সময়সীমা session_ttl_seconds-এর মাধ্যমে dashboard.basic_auth-এ নির্ধারিত হয়। তবে এই মানটি শুধু dashboard background-এ কত ঘন ঘন refresh হবে তা নিয়ন্ত্রণ করে; আপনি কতক্ষণ signed in থাকবেন, তা নয়। প্রতিটি refresh নতুন 30 দিনের refresh token তৈরি করে। তাই refresh ছাড়া 30 দিন না পেরোনো পর্যন্ত password login সক্রিয় থাকে। HERMES_DASHBOARD_BASIC_AUTH_SECRET বা dashboard.basic_auth.secret-এর মাধ্যমে স্থায়ী signing secret configure না থাকলে backend restart-এর পরও login শেষ হয়ে যায়। কারণ Hermes প্রতিবার চালু হওয়ার সময় নতুন signing key তৈরি করে। Nous Portal OAuth provider 15 মিনিটের TTL (time to live) সহ access token জারি করে এবং প্রতিটি ব্যবহারে পরিবর্তিত হওয়া refresh token দিয়ে background-এ সেগুলো renew করে। তাই শুধু access token-এর মেয়াদ শেষ হলে আপনাকে /login-এ ফেরত পাঠানো হয় না। এটি ঘটে refresh session হারিয়ে গেলে। v0.21.3-এর আগের release-গুলোতে (tag v2026.9.14, প্রকাশিত 14 September 2026) phone background থেকে ফিরে এসে একই সময়ে একাধিক request পাঠাতে পারত। এতে সদ্য পরিবর্তিত refresh token আবার ব্যবহৃত হতো, provider-এর reuse detection সক্রিয় হতো এবং পুরো session revoke হয়ে যেত। ফলে আপনি login screen-এ ফিরে আসতেন, আর তখন যা লিখছিলেন তা হারিয়ে যেত। v0.21.3 এই request-গুলোকে একটি refresh ভাগ করে ব্যবহার করায়। Nous Portal-এর দিকেও এখন refresh session প্রতিবার rotate হওয়ার সময় তার 30 দিনের window বাড়ায়। তবে 30 দিন idle থাকলে session এখনও শেষ হয়ে যায়। এই পৃষ্ঠার শুরু থেকে v2026.8.3 pin ব্যবহার করলে মাঝে মাঝে জোর করে login করতে হতে পারে। কোনো কিছু নষ্ট হয়নি। আবার sign in করুন।
ডিফল্টভাবে background tab-এ embedded terminal টিকে থাকে না। Dashboard-এর documented terminal connection PTY-এর পেছনে TUI (text user interface) চালু করে এবং tab বন্ধ হলে সেটিকে সঠিকভাবে বন্ধ করে। আবার খুললে নতুন একটি TUI চালু হয়। Mobile browser memory খালি করতে background tab বাতিল করে দিতে পারে। তাই যথেষ্ট সময় অন্য app-এ গেলে ওই terminal শেষ হয়ে যায়। আপনার chat history নিরাপদ থাকে, কারণ session server-এ সংরক্ষিত হয় এবং hermes sessions list এখনও সেগুলো দেখায়। Pinned server-এ attachment token ব্যবহার করে opt-in keep-alive connection-ও চালু করা যায়। এটি detached PTY 30 মিনিট ধরে রাখে। যে session টিকে থাকবে এমন ব্যবস্থা দরকার হলে SSH-এর ওপর tmux ব্যবহার করুন।
Idle connection নীরবে বন্ধ হয়ে যায়। Mobile carrier-গুলো NAT (network address translation) table-এর entry খালি করতে idle TCP connection বন্ধ করে দেয়। Screen বন্ধ হলে phone প্রায় সম্পূর্ণভাবে network service দেওয়া বন্ধ করে। কিছুক্ষণ কোনো data না পাঠানো WebSocket আপনি unlock করার সময় সাধারণত আগেই বন্ধ হয়ে যায়। Page শুধু আপনি touch করার পর reconnect করে। এ কারণেই phone-এ SSH-এর চেয়ে mosh ভালো মনে হয়। mosh-এর এমন কোনো connection থাকে না যা হারাতে পারে।
কোনো notification push হয় না। Dashboard বা SSH session কোনোটিই আপনার phone জাগাতে পারে না। Device-এ কোনো Hermes app নেই। তাই platform-এর push service-এ পৌঁছানোর কোনো পথও নেই। দীর্ঘ agent run শেষ হয়ে যায়, আর আপনি পরেরবার দেখার সময় তা জানতে পারেন।
বার্তা gateway-এর মাধ্যমে notification পৌঁছায়
শেষ সমস্যাটির সমাধান হলো gateway। এটি agent-এ পৌঁছানোর সম্পূর্ণ ভিন্ন একটি পদ্ধতি। hermes gateway agent-কে Telegram, Discord, Slack, WhatsApp, Signal এবং email-সহ বিভিন্ন messaging platform-এর সঙ্গে সংযুক্ত করে। এরপর আপনি এমন একটি app-এর ভেতর agent-এর সঙ্গে কথা বলতে পারেন, যেটি ইতিমধ্যে আপনার phone-এ push channel পরিচালনা করে, background delivery সামলায় এবং network সংযোগ বিচ্ছিন্ন হলেও তা মোকাবিলা করে।
hermes gateway setup
hermes gateway install
hermes gateway statushermes gateway install gateway-কে systemd service হিসেবে নিবন্ধন করে, তাই reboot-এর পরে এটি আবার চালু হয়। Installer-এর gateway stage এই ধাপটি আপনার হয়ে চালাতে পারে। তবে installer-এর কোনো অংশই hermes dashboard-এর জন্য unit তৈরি করে না। তাই restart-এর পরে dashboard নিজে থেকে ফিরে আসবে না। আপনি যে অংশগুলোর ওপর নির্ভর করেন, সেগুলোর জন্য unit লিখুন। ফাইলটি তৈরির পদ্ধতি VPS-এ systemd service ও timer লেখা-এ দেখানো হয়েছে।
কোনো conversation ছাড়াই scheduled job একইভাবে একটি ফলাফল পাঠাতে পারে:
hermes send -t telegram -s "Backup report" -f /home/you/report.txtএখানে authorisation-এর নীতি হলো default হিসেবে access অস্বীকার করা। কোনো allowlist বা অনুমোদিত pairing না থাকলে এবং GATEWAY_ALLOW_ALL_USERS unset থাকলে প্রত্যেক user-এর access প্রত্যাখ্যান করা হয়। এটিই সঠিক প্রাথমিক অবস্থা। যেসব account-কে অনুমতি দিতে চান, সেগুলোর নাম ~/.hermes/.env-এ লিখুন:
TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789অথবা numeric ID paste না করে code-based pairing ব্যবহার করুন। Chat-ধরনের DM platform-এর জন্য এটিই default। ~/.hermes/config.yaml-এ unauthorized_dm_behavior: pair ব্যবহার করে এটি স্পষ্টভাবে সেট করতে পারেন। কোনো অজানা account agent-কে message পাঠালে একটি আট অক্ষরের code পায়। আপনি অনুমোদন না করা পর্যন্ত আর কিছু ঘটে না:
hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789Code এক ঘণ্টা পরে মেয়াদোত্তীর্ণ হয়। একজন user প্রতি দশ মিনিটে একটি code-এর অনুরোধ করতে পারে। পাঁচটি ব্যর্থ প্রচেষ্টার পরে ওই account-এর access lock হয়ে যায়।
চুরি হওয়া ফোনের ক্ষতির পরিধি সীমিত করা
যে ফোন আপনার agent-এ পৌঁছাতে পারে, সেই ফোন আপনার সার্ভারে command চালাতে পারে। আর ফোন হারিয়ে যেতে পারে। ফোনটি যার হাতে থাকবে, সে এখন কী করতে পারবে তা নির্ধারণ করুন।
Approval চালু রাখুন। approvals.mode-এর default হলো smart। এটি ঝুঁকি যাচাই করতে একটি auxiliary model ব্যবহার করে এবং শুধু কম-ঝুঁকির command স্বয়ংক্রিয়ভাবে approve করে। এটিকে off সেট করা মানে --yolo দিয়ে সবকিছু চালানোর সমান। HERMES_YOLO_MODE=1 ব্যবহার করেও একই কাজ environment-এর মাধ্যমে করা যায়। এই অবস্থায় agent-এর সঙ্গে যোগাযোগ করে এমন ফোন সঙ্গে রাখবেন না। approvals.cron_mode: deny সেট করুন, যাতে আপনি ঘুমানোর সময় scheduled job নিজে থেকে approve করতে না পারে।
approvals:
mode: smart
cron_mode: denyAgent-এর জন্য ক্ষতির সম্ভাব্য পরিসর ছোট করুন। terminal.backend: docker command-গুলো এমন একটি container-এর ভিতরে চালায়, যেখানে অল্প কিছু Linux capability ছাড়া বাকি সব capability বাদ দেওয়া হয়, no-new-privileges সেট করা হয় এবং process-এর সংখ্যা সীমাবদ্ধ করা হয়। ফলে prompt-এর বদলে container-ই boundary হিসেবে কাজ করে। terminal.cwd working directory নির্দিষ্ট করে। HERMES_WRITE_SAFE_ROOT আপনার নির্দিষ্ট করা directory-গুলোর মধ্যে write_file এবং patch সীমাবদ্ধ রাখে। এসব directory-এর বাইরে লেখার চেষ্টা blocked হয় এবং approval দিয়েও তা override করা যায় না।
export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermesHermes ইতিমধ্যেই ~/.ssh, ~/.aws, ~/.kube এবং /etc/sudoers-এ write block করে। ~/.hermes/.env-এর মতো নিজস্ব secret store-এও write block করে। Disk-এর অন্যত্র থাকা project .env file read করা blocked থাকে, তবে সেগুলোতে write করা যায়। আপনার approval setting যা-ই হোক, এটি destructive command-এর একটি কঠোর তালিকা প্রত্যাখ্যান করে। এটিকে ন্যূনতম সুরক্ষা হিসেবে দেখুন, আপনার সম্পূর্ণ পরিকল্পনা হিসেবে নয়। Agent-টি সাধারণ user হিসেবে চালান, কখনোই root হিসেবে নয়। একই যুক্তি unattended অবস্থায় চলতে থাকা যেকোনো coding agent-এর ক্ষেত্রেও প্রযোজ্য। VPS-এ Claude Code নিরাপদে চালানো বিষয়টি আরও বিস্তারিতভাবে দেখায়।
এরপর প্রয়োজনের আগে revocation-এর ধাপগুলো লিখে রাখুন। Tailscale admin console থেকে device সরিয়ে দিলে mesh access সঙ্গে সঙ্গে বন্ধ হয়। HERMES_DASHBOARD_BASIC_AUTH_SECRET পরিবর্তন করে restart করলে সব device-এর password-provider dashboard session বাতিল হয়, কারণ ওই value provider-এর session token sign করে। ~/.ssh/authorized_keys থেকে ফোনের public key মুছে দিলে ওই key দিয়ে নতুন SSH login বন্ধ হয়। বিদ্যমান SSH এবং mosh session আলাদাভাবে terminate করতে হবে। hermes pairing revoke telegram <user-id> একটি messaging account সরিয়ে দেয়। ফোনটিতে provider key পড়তে পারে এমন কোনো তথ্য থাকলে hermes auth logout <provider> দিয়ে সেগুলো বাতিল করুন এবং upstream থেকে নতুন key জারি করুন।
ফলাফল অনুমান না করে পরীক্ষা করুন। এগুলো নিজের box-এ চালানোর command। এগুলো কী output দেবে তা আপনার setup-এর ওপর নির্ভর করে:
tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deepLog-গুলো ~/.hermes/logs/-এর অধীনে থাকে। কোনো incident-এর পর সেগুলো পড়ুন। Incident না ঘটলেও মাঝে মাঝে পড়ুন।
FAQ
iOS বা Android-এর জন্য কি Hermes-এর কোনো অফিসিয়াল mobile app আছে?
না। Hermes repository-তে command line interface, web dashboard এবং macOS, Windows ও Linux-এর জন্য একটি Electron desktop client রয়েছে। iOS বা Android-এর জন্য কোনো first-party build নেই। ফোন থেকে browser-এ web dashboard, SSH client অথবা hermes gateway-এর মাধ্যমে সংযুক্ত messaging platform ব্যবহার করতে পারেন। Third-party mobile client রয়েছে, তবে সেগুলো third-party code এবং আপনার agent-এর credentials ধারণ করে। তাই কোনোটি install করার আগে source code পড়ুন।
ফোনে Hermes dashboard আমাকে log out করে কেন?
এটি login provider-এর ওপর নির্ভর করে। Nous Portal OAuth provider 15 minute TTL-সহ access token দেয় এবং rotating refresh token ব্যবহার করে background-এ token renew করে। তাই শুধু access token expire হলে আপনাকে /login-এ পাঠানো হয় না। v0.21.3-এর আগের release-গুলোতে (tag v2026.9.14) background থেকে ফোন ফিরে এলে একই সময়ে একাধিক request পাঠাতে পারত। এতে সদ্য rotated refresh token পুনরায় ব্যবহৃত হয়ে পুরো session revoke হতে পারত, যার ফলে login করা বাধ্যতামূলক হয়। v0.21.3 এই সমস্যা সমাধান করে। তবে 30 দিন idle থাকা refresh session এখনও expire হয়। Username এবং password provider-এর default access token 12 hour, যা session_ttl_seconds দ্বারা নির্ধারিত। এটি শুধু dashboard background-এ কত ঘন ঘন refresh করবে তা নিয়ন্ত্রণ করে। Providerটি 30 day refresh token ব্যবহার করে renew করে এবং প্রতিটি refresh-এর সময় সেটি পুনরায় issue করে। তাই password login 12 ঘণ্টা পরে শেষ হয় না। এই provider ব্যবহার করলে HERMES_DASHBOARD_BASIC_AUTH_SECRET-এ একটি স্থায়ী random value সেট করুন। ওই variable বা dashboard.basic_auth.secret-এ স্থায়ী secret না থাকলে Hermes প্রতিবার start হওয়ার সময় নতুন signing key তৈরি করে এবং প্রতিটি restart-এর পরে আপনাকে log out করে।
Hermes dashboard কি নিরাপদে public internet-এ প্রকাশ করতে পারি?
শুধু তখনই, যখন authentication নিজে যাচাই করেছেন। Bind address-এর ওপর ভিত্তি করে auth gate সক্রিয় হয়। বর্তমান release-গুলোতে dashboard.public_url কোনো non-loopback host নির্ধারণ করলেও এটি সক্রিয় হয়। তাই reverse proxy-এর পেছনে 127.0.0.1-এ bound dashboard থাকলেও public URL সেট না থাকলে login চাওয়া হয় না। v2026.8.3 pin-এ public_url সেট করলে loopback auth gate সক্রিয় হয় না এবং Host ও WebSocket Origin check-এর মাধ্যমে public hostname-ও অনুমোদিত হয় না। HTTPS proxy setup অনুসরণ করার আগে direct mesh IP route ব্যবহার করুন অথবা public hostname support-সহ কোনো release-এ upgrade করুন। এর Host check public hostname forward করা proxy প্রত্যাখ্যান করে। তবে nginx-এর default আচরণের মতো Host backend address-এ rewrite করা proxy-কে এটি প্রত্যাখ্যান করে না। curl -s https://your-host/api/status | jq '.auth_required' চালিয়ে ফলাফল দেখুন। Username ও password-এর বদলে OAuth বা OIDC ব্যবহার করুন, কারণ project-এর docs অনুযায়ী password provider trusted network এবং VPN-এর জন্য। Private mesh ব্যবহার করলে এই প্রশ্নই থাকে না। তাই এটিই ভালো default।
আমার কি Tailscale account দরকার, নাকি control plane নিজে host করতে পারি?
আপনি এটি নিজে host করতে পারেন। Headscale হলো Tailscale coordination server-এর একটি open implementation। Official Tailscale client-গুলো tailscale up --login-server https://headscale.example.com ব্যবহার করে এতে connect করতে পারে। এরপর mesh-এ প্রবেশের অনুমতিপ্রাপ্ত device-গুলোর তালিকার নিয়ন্ত্রণ আপনার হাতে থাকবে। এর বিনিময়ে আপনাকে ওই server চালাতে ও back up করতে হবে। Serverটি down থাকলে কোনো device enrol বা re-authenticate করতে পারবেন না।
Agent কোনো job শেষ করলে ফোনে notification কীভাবে পাব?
Messaging gateway ব্যবহার করুন। Dashboard এবং SSH ফোনকে wake করার কোনো উপায় দেয় না, কারণ notification গ্রহণ করার জন্য device-এ কোনো Hermes app নেই। hermes gateway setup ব্যবহার করে agent-কে Telegram, Signal, Discord বা অন্য কোনো supported platform-এর সঙ্গে connect করুন। এরপর সেই platform-এর নিজস্ব app notification deliver করবে। একটি cron job hermes send -t telegram -s "Job done" -f /path/to/report.txt ব্যবহার করে একটি মাত্র message-ও push করতে পারে। এতে model call করার প্রয়োজন হয় না।