தனிப்பட்ட Telegram பாட் VPS முகவரை எளிதில் அணுக உதவும். ஆனால் இணைப்பு மட்டுமே சரியான நபருக்குப் பதில் வருவதை நிரூபிக்காது. புதிய Hermes Agent தரவுக் கோப்பகத்தில் தொடங்கி ஓர் எண் Telegram ID அனுமதித்து உண்மைப் பதிலும் உறுதியான நிறுத்த வழியும் பார்க்கிறோம். அடிப்படை NousResearch இன் v0.22.2 Docker வழிமுறைகள் மற்றும் Telegram வழிமுறைகள், 19 அக்டோபர் 2026 அன்று சரிபார்த்தவை. BIG CHANGE இங்கு VPS இயக்கவோ படிமம் பெறவோ பாட் உருவாக்கவோ மாதிரி அழைக்கவோ இல்லை.

பெரிய மாற்றம்

  • மாறியது என்ன: டைஜெஸ்டால் நிலைநிறுத்திய, பதிப்பு சரிபார்த்த Docker படிமமும் தனியான /opt/data மவுண்டும் இந்த நுழைவாயிலின் மென்பொருள், நிலையை அடையாளப்படுத்துகின்றன.
  • இது ஏன் முக்கியம்: Telegram எண் அனுமதிப் பட்டியலும் உண்மையான தனிப் பதிலும் சரியான கணக்கு பயன்படுத்துமா காட்டுகின்றன.
  • கவனிக்க வேண்டியது: இணைத்தல் அல்லது பொது அனுமதி அணுகலை விரிவாக்கலாம். தீங்கற்ற கோரிக்கை கருவிகளைக் கட்டுப்படுத்தாது. உரிமை, பதிவுகள், மறுதொடக்கம், நிறுத்தம் பார்க்கவும்.

SSH மூலம் Linux VPS நிர்வகிக்கும் அதிகாரம், செயல்படும் Docker Engine, ஹோஸ்ட் மீட்பு அணுகல், BotFather பாட் உருவாக்கும் Telegram கணக்கு, தகுதியுள்ள Hermes மாதிரி வழங்குநர் கணக்கு தேவை. VPS கட்டமைப்பு, வளங்களை அதிகாரப்பூர்வ amd64/arm64 படிமத்துடன் ஒப்பிடுங்கள்; வழிகாட்டி முன் அணுகல், கட்டண விதிகளைப் பாருங்கள். Docker ஏற்கெனவே வேலை செய்வதாகக் கருதுகிறோம்; நிறுவல், ஃபயர்வால் OS/வழங்குநரைப் பொறுத்தது. ஹோஸ்டிலிருந்து Telegram, மாதிரிக்கு வெளிச்செல்லும் இணைப்பு தேவை. தனித் தரவுக் கோப்பகமும் வரையறுக்கப்பட்ட வாசிப்பாளரும் வைத்திருங்கள்: /opt/data இல் சான்றுகள், அமர்வுகள், பதிவுகள் இருக்கும். Docker கையேடு இந்த மவுண்டை நிலையான அதிகாரப்பூர்வ தரவு மூலமாகச் சொல்கிறது.

1. அமைப்புமுன் படிமத்தை நிலைப்படுத்தவும்

SSH மூலம் இணைந்து அதே ஷெல்லில் இருக்கவும். stable குறிச்சொல் மாறலாம். படிமம் பெற்று களஞ்சிய டைஜெஸ்ட் எழுதி, படிமமே கூறும் பதிப்பு 0.22.2 என்பதை உறுதிசெய்யவும். வேறு பதிப்பு, டைஜெஸ்ட் இல்லை, பழைய தரவு அல்லது hermes என்ற கொள்கலன் இருந்தால் நிறுத்துங்கள். உண்மைப் பதிப்புக்கு வழிமுறைகளை மாற்றி அல்லது பொருந்தும் ஆவணப் படிமம் பெற்ற பிறகே தொடருங்கள். டைஜெஸ்ட் படிமத்தை நிலைப்படுத்தும்; தனியாகப் பதிப்பை நிரூபிக்காது.

Terminal
set -eu
docker info >/dev/null
docker container inspect hermes >/dev/null 2>&1 && { echo 'Container hermes already exists; stop here.'; exit 1; }
HERMES_DATA="$HOME/.hermes"
if [ -e "$HERMES_DATA" ]; then echo 'Hermes data path already exists; stop here.'; exit 1; fi
mkdir -m 700 "$HERMES_DATA"
docker pull nousresearch/hermes-agent:stable
docker image inspect nousresearch/hermes-agent:stable --format '{{json .RepoDigests}}'
IMAGE_REF="$(docker image inspect nousresearch/hermes-agent:stable --format '{{index .RepoDigests 0}}')"
if ! printf '%s\n' "$IMAGE_REF" | grep -Eq '^nousresearch/hermes-agent@sha256:[0-9a-f]{64}$'; then
  echo 'No valid repository digest; stop here.'; exit 1
fi
printf 'Pinned image: %s\n' "$IMAGE_REF"
VERSION_OUTPUT="$(docker run --rm "$IMAGE_REF" --version)"
printf 'Image version: %s\n' "$VERSION_OUTPUT"
if ! printf '%s\n' "$VERSION_OUTPUT" | grep -Eq '(^|[^0-9])v?0[.]22[.]2([^0-9]|$)'; then
  echo 'Image version is not 0.22.2; stop here.'; exit 1
fi

set -eu Docker இல்லை, பெறுதல்/சோதனை அல்லது பதிப்புக் கட்டளை தோல்வியில் தொடர் நிற்கும். வெளிப்படையான சோதனை வெற்று டைஜெஸ்ட் அல்லது வேறு பதிப்பையும் நிறுத்தும். அடுத்து அமைப்பைச் செய்யாதீர்கள். பதிவு செய்த nousresearch/hermes-agent@sha256:… மதிப்பை வையுங்கள். கீழே அமைப்பும் நுழைவாயிலும் IMAGE_REF பயன்படுத்துவதால் குறிச்சொல் மாறி மறைமுகமாக மாற்றாது. உண்மை VPS இல் வாசகர் பார்க்க வேண்டியது; கட்டுரையில் சரிபார்த்த படிம டைஜெஸ்ட் இல்லை. ஹோஸ்டின் இயல்பு கோப்பு அமைப்பில் புதிய தனிக் கோப்பகம்; ஒரே தரவில் இரு நுழைவாயில்கள் கூடாது.

2. வழங்குநரும் தனி அனுப்புநரும் அமைக்கவும்

மவுண்ட் கோப்பகத்துடன் Docker அமைப்பு வழிகாட்டி இயக்கவும். கணக்கு அனுமதிக்கும் மாதிரிப் பாதை தேர்ந்து சான்றுறுதி செய்து வழங்குநர்/மாதிரி பார்க்கவும். அணுகல், கட்டணம் கணக்கைச் சார்ந்தவை. சேமித்த அமைப்பு வெற்றிகரமான மாதிரி கோரிக்கை அல்ல.

Terminal
docker run -it --rm -v "$HERMES_DATA:/opt/data" "$IMAGE_REF" setup

Telegram இல் @BotFather இடம் /newbot மூலம் பாட் கேட்டு டோக்கனை ரகசியமாக வையுங்கள். அனுப்புநரின் Telegram எண் பயனர் ID பெறவும்; உதாரணமாக Telegram கையேடு இணைத்த சோதனை முறையில். பயனர் பெயர் ID அல்ல. வழிகாட்டி அல்லது hermes gateway setup டோக்கன், பட்டியல் எழுதலாம். கையால் TELEGRAM_BOT_TOKEN=<private token> மற்றும் TELEGRAM_ALLOWED_USERS=<your numeric ID> வையுங்கள் $HERMES_DATA/.env இல்; கொள்கலனில் அது /opt/data/.env. டோக்கனை கட்டளை, வரலாறு, பகிர்ந்த குறிப்பு அல்லது கட்டுரையில் இடாதீர்கள்.

இந்த $HERMES_DATA/config.yaml (/opt/data/config.yaml இல், கொள்கலன் பாதை) அனுமதியற்ற தனிச் செய்திகளின் பொது நடத்தையை அமைக்கவும்:

YAML
unauthorized_dm_behavior: ignore

அமைப்புக் கொள்கலன் வெளியேறியபின் படிமம் $HERMES_DATA உரிமையாளரை இயக்க UID 10000 ஆக்கியிருக்கலாம். தொடக்கம் .env ஐ முறை 600 மற்றும் ஏற்கெனவே உள்ள config.yaml ஐ 640 ஆகக் கட்டுப்படுத்தும்; அப்போது புதிதாக உருவான அமைப்புக்கும் அதே இறுக்கம் தேவைப்படலாம். சாதாரண SSH பயனர் கோப்பைத் திறக்க முடியாமல் போகலாம். விசைகள் இல்லாவிட்டால் அங்கீகரிக்கப்பட்ட ஹோஸ்ட் நிர்வாகி குறிப்பிட்ட இரு கோப்புகளை sudo மூலம் பார்த்து மாற்றி இயக்க உரிமையாளர், தனி முறையை மீட்கலாம். UID 10000 பதிப்பி உள்நுழைவு பயனர் உரிமையுள்ள $HOME வழி செல்லாமல் போகலாம்; அதனால் ஹோஸ்ட் நிர்வாக அதிகாரம். ஹோஸ்டில் sudo மற்றும் vi இருந்தால் ரகசியமற்ற உரிமையாளர்/முறையைப் பார்த்துப் பயன்படுத்தவும். வேறு UID அல்லது கோப்பு இல்லையெனில் முதலில் அணுகல் தீர்க்கவும்.

Terminal
sudo stat -c '%u:%g %a %n' "$HERMES_DATA" "$HERMES_DATA/.env" "$HERMES_DATA/config.yaml"
# Expected: directory owner 10000 and mode 700; .env owner 10000 and mode 600.
# config.yaml should have owner 10000; its first-boot mode can vary.
sudo vi "$HERMES_DATA/.env"
sudo vi "$HERMES_DATA/config.yaml"
sudo chown 10000:10000 "$HERMES_DATA/.env" "$HERMES_DATA/config.yaml"
sudo chmod 700 "$HERMES_DATA"
sudo chmod 600 "$HERMES_DATA/.env"
sudo chmod 640 "$HERMES_DATA/config.yaml"
sudo stat -c '%u:%g %a %n' "$HERMES_DATA" "$HERMES_DATA/.env" "$HERMES_DATA/config.yaml"

இறுதி stat வெளியீடு இரு கோப்பின் UID/GID 10000, கோப்பக முறை 700, .env முறை 600 மற்றும் config.yaml முறை 640 காட்ட வேண்டும். இவை மேற்தரவு; ரகசியங்கள் அல்ல. chown இரு கோப்பும் பதிப்பி மாற்றுக் கோப்பும் மட்டும் இலக்கு. sudo அல்லது vi இல்லாவிட்டால் அங்கீகரித்த ஹோஸ்ட் முறையில் அதே மதிப்பைப் பாருங்கள். அனைவருக்கும் வாசிப்பு தராதீர்கள்; கொள்கலன் பயனரை மீள்மேப் செய்யாதீர்கள்.

மாற்றும்போது வழங்குநர் அமைப்பைக் காக்கவும். Telegram சிறப்பு unauthorized_dm_behavior மேலெழுதல் pair அமைக்கக்கூடாது; பொது GATEWAY_ALLOWED_USERS அல்லது GATEWAY_ALLOW_ALL_USERS அணுகலை அதிகரிக்கக்கூடாது. config.yaml இல் gateway.allow_all_users அல்லது மேல் நிலை allow_all_users இரண்டுமே true இல்லை, பொது/Telegram பட்டியலில் கூடுதல் அனுப்புநர் இல்லை எனவும் பாருங்கள். * பயன்படுத்தவோ குழுப் பட்டியல் சேர்க்கவோ இணைக் குறியீடு ஏற்கவோ வேண்டாம். புதிய கோப்பகம் மரபு உரிமை தவிர்க்கும்; தரவு இருந்தால் நிறுத்திப் பாருங்கள், மேலெழுதாதீர்கள். BotFather குழுத் தனியுரிமை இயங்கட்டும்; பாட்டை குழுவில் அல்லது நிர்வாகியாகச் சேர்க்காதீர்கள். நுழைவாயில் அணுகல் கையேடு பட்டியலும் நிலையான இணைப்பு உரிமையும் தனிப் பாதை என்கிறது. பாதுகாப்புக் கையேடு படி ignore அனுமதியற்ற தனிச் செய்தியை அமைதியாகக் கைவிடும்.

பட்டியல் உரையாடல் தொடங்குபவரைக் கட்டுப்படுத்தும், அனுமதிபெற்ற முகவரின் செயலை அல்ல. Hermes Telegram அமர்வில் இயல்பாக முனையக் கருவிகள் உள்ளன. அனுமதிக்கும் முன் கருவி, Docker மவுண்ட், வழங்குநர், ஹோஸ்ட் விதிகளைப் பார்க்கவும். தீங்கற்ற சோதனைக் கோரிக்கை வெறும் கோரிக்கையே.

3. தொடங்கி முதல் பதில் பார்க்கவும்

பதிவு டைஜெஸ்டில் பெயரிட்ட ஒரு கொள்கலன் இயக்கவும். வெளியிட்ட Docker கட்டளையின் விருப்ப -p 8642:8642 APIக்கானது; இங்கு விடுங்கள். தனி Telegramக்கு பொது API அல்லது பலகைத் துறை தேவையில்லை. படிமம் செயல்முறையைக் கண்காணிக்கும்; Docker unless-stopped கொள்கை Docker தொடங்கும்போது மறுதொடக்கம் நடத்தும். மவுண்ட் அமைப்பு, அமர்வுகளைப் பாதுகாக்கும்.

Terminal
docker run -d --name hermes --restart unless-stopped \
  -v "$HERMES_DATA:/opt/data" "$IMAGE_REF" gateway run
if ! {
  docker inspect hermes --format '{{.Image}} {{.State.Status}}' &&
  [ "$(docker inspect hermes --format '{{.State.Status}}')" = running ] &&
  docker logs --tail 50 hermes &&
  docker exec -u hermes hermes hermes pairing list
}; then
  echo 'State, logs or pairing check failed; stopping before any message.'
  docker stop hermes || true
  docker inspect hermes --format '{{.State.Status}}' || true
  exit 1
fi

கொள்கலன் running உள்ளதா, பதிவில் Telegram இணைப்பு/வழங்குநர் பிழை பாருங்கள்; செய்திமுன் இணைப் பட்டியல் படியுங்கள். முதல் வாசிப்பு தோற்றால் குறியீடு நிறுத்தி நிலை காட்டும்; தெரியாத CLI/உரிமை அனுமதி அல்ல. முதலில் exited உறுதிசெய்து ஆராயுங்கள்; உறுதியில்லாமல் செய்தி அல்லது மறுதொடக்கம் வேண்டாம். மற்ற அங்கீகரித்த அனுப்புநர் இருந்தால் நிறுத்தி நிலை பாருங்கள். docker exec நிறுத்திய கொள்கலனில் இயங்காது; சாதாரண படிம நுழைவு பழைய நுழைவாயிலைத் திருப்பலாம். புதிய இயல்பு UID நிறுவலில் கீழுள்ள ஆஃப்லைன் சோதனை நிலைப்படுத்திய Hermes CLI மட்டும் UID 10000, வலையின்றி, நுழைவாயில் தொடங்காமல் இயக்கும். ஆவண கட்டளை/நுழைவின் தழுவல்; BIG CHANGE சோதனை அல்ல. இயங்கும் UID, தரவு உரிமையாளர் இரண்டும் 10000 உறுதியானால் மட்டும் பயன்படுத்தவும். உரிமை, UID, CLI அல்லது அனுமதி தெளிவற்றால் நிறுத்திவைத்து மறுதொடக்கமுன் தீர்க்கவும்.

Terminal
if [ "$(docker exec -u hermes hermes id -u)" != 10000 ] || [ "$(stat -c %u "$HERMES_DATA")" != 10000 ]; then
  echo 'Runtime UID or data owner differs; stop for a host-specific repair.'; docker stop hermes; exit 1
fi
docker stop hermes
if [ "$(docker inspect hermes --format '{{.State.Status}}')" != exited ]; then
  echo 'Container is not exited; do not mount state in another container.'; exit 1
fi
docker run --rm --network none --user 10000:10000 \
  --entrypoint /opt/hermes/.venv/bin/hermes \
  -v "$HERMES_DATA:/opt/data" "$IMAGE_REF" pairing list
# For a listed unwanted Telegram user, read the exact numeric ID first:
printf 'Unwanted numeric Telegram user ID: '; IFS= read -r UNWANTED_ID
if ! printf '%s\n' "$UNWANTED_ID" | grep -Eq '^[0-9]+$'; then echo 'Invalid ID; leave gateway stopped.'; exit 1; fi
docker run --rm --network none --user 10000:10000 \
  --entrypoint /opt/hermes/.venv/bin/hermes \
  -v "$HERMES_DATA:/opt/data" "$IMAGE_REF" pairing revoke telegram "$UNWANTED_ID"
docker run --rm --network none --user 10000:10000 \
  --entrypoint /opt/hermes/.venv/bin/hermes \
  -v "$HERMES_DATA:/opt/data" "$IMAGE_REF" pairing list

இறுதிப் பட்டியலில் வேண்டாத ID இல்லாததைப் பாருங்கள். தனியாக $HERMES_DATA/.env மற்றும் config.yaml இல் பிற தளம்/பொது பட்டியல், * அல்லது அனைவருக்கும் அனுமதி அமைப்பு பார்த்து ஆவண வழியில் உரிமை நீக்குங்கள். எல்லாப் பாதையும் பார்க்கும்வரை நிறுத்துங்கள். ஓர் உருப்படி நீக்கம் தனி இணை/பொது அனுமதியை ரத்து செய்யாது. பார்த்தபின் docker start hermes மூலக் கொள்கலனை வேண்டுமென்றே மீட்கும்; செய்திமுன் பதிவும் பட்டியலும் மீண்டும் பாருங்கள்.

அனுமதித்த கணக்கில் பாட்டுடன் தனிப்பட்ட அரட்டை திறந்து “சுருக்கமான வாழ்த்துடன் பதிலளி” போன்ற தீங்கற்ற கோரிக்கை அனுப்புங்கள். உண்மைப் பதிலும் தொடர்புடைய பதிவு/அமர்வும் பாருங்கள். அனுப்புதல், தட்டச்சு அறிகுறி, நிலை, முடிந்த அமைப்பு பதில் அல்ல. Telegram /whoami செயலில் உள்ள செய்தி எல்லை காட்டலாம்; ஹோஸ்ட் உரிமை அல்ல. நுட்பமற்ற சான்று மட்டும் வையுங்கள்.

பதிலில்லையெனில் முதலில் நிலையும் docker logs --tail 50 hermes படியுங்கள். டோக்கன், சரியான எண் TELEGRAM_ALLOWED_USERS மதிப்பு, மாதிரி சான்றுறுதி/தகுதி, வெளியிணைப்பு பாருங்கள். முடிவு தெரியாவிட்டால் மீளனுப்புமுன் அரட்டை/பதிவு படியுங்கள். ஆவண குளிர்தொடக்கம் நிலுவைப் புதுப்பிப்பை விடலாம்; நகல் தடுப்பு நினைவகத்தில் வரம்புள்ளது. துல்லியமாக ஒருமுறை அனுப்புதலுக்கு உறுதியில்லை.

4. மறுதொடக்கம், நிறுத்தம், மீட்பு பார்க்கவும்

முதல் சுற்று முடிந்தபின் அதே கொள்கலன் மறுதொடங்கி புதிய பதிவும் வைத்துள்ள /opt/data நிலையும் பார்த்து, பின்னர் புதிய தீங்கற்ற தனிக் கோரிக்கையும் பதிலும் பாருங்கள். நிறுத்தி Docker நிலை வாசிக்கவும். exited நிறுத்த அறிகுறி; அமைதியான அரட்டை போதாது. docker start hermes பிறகு வேண்டுமென்றே தொடரும் வழி.

Terminal
docker restart hermes
docker logs --tail 50 hermes
docker inspect hermes --format '{{.State.Status}}'
# After the restarted gateway is ready, send a new private test message.
docker stop hermes
docker inspect hermes --format '{{.State.Status}}'
# Expected after stop: exited
# When intentionally resuming later: docker start hermes

தோல்வியில் Docker/பதிவு, பின்னர் $HERMES_DATA/logs/gateways/default/current மற்றும் $HERMES_DATA/logs/container-boot.log, மவுண்ட், உரிமையாளர், நிலைப் படிமம்/பதிப்பு பாருங்கள். v0.22.2 வெளியீட்டுக் குறிப்புகள் தொடக்க உயிர்நிலைத் திருத்தம் கூறும்; உங்கள் ஹோஸ்ட் நிகழ்வு அல்ல. பழுதுக்குத் தரவு அழிக்காதீர்கள். டோக்கன் கசிந்தால் நிறுத்தி BotFather இல் ரத்து, மவுண்ட் .env இல் தனியாக மாற்றி அணுகல் பார்த்து மறுதொடங்கவும். வேண்டாத இணைப்பையும் ரத்து செய்து உண்மைப் பட்டியல் பாருங்கள்.

VPS, மாதிரி தனித்தனிக் கட்டணம் கேட்கலாம். உண்மைத் திட்டம், எல்லை, தொகையைப் பாருங்கள். நேரம், இலவச ஒதுக்கீடு, கிடைப்புத் தரம் வாக்குறுதி இல்லை. Telegram/வழங்குநர் செய்திகள் செயலாக்க, ஹோஸ்ட் ரகசியமும் நிலையும் வைத்திருக்கும். இது ஒரு ஹோஸ்ட், பாட்டின் முதல் பதில் சோதனை. தனி BIG CHANGE வழிகாட்டிகள் கூறுவது Hermes காப்பு, மீட்பு மற்றும் மீண்டும் நடக்கும் Hermes பணி.

மூலங்களும் கூடுதல் வாசிப்பும்

இந்த Docker அமைப்பு, Telegram அமைப்பு, நுழைவாயில் அணுகல், பாதுகாப்பு மற்றும் v0.22.2 வெளியீடு NousResearch முதன்மை மூலங்கள். விரைவுத் தொடக்கம் மாதிரி வழங்குநர் அமைப்பைக் கூறும். இவை வழிமுறை ஆவணம்; BIG CHANGE VPS/பாட் இயக்கிய பதிவல்ல.