Суулгах — AiHummer Баримт бичиг

AiHummer суулгагдана зочин-орчин нутгийн. Суулгалт таны хувийн данснаас эхэлнэ my.aihummer.ru: та бүртгүүлж, авна хувийн суулгах холбоос мөн таны сервер дээр нэг командыг ажиллуулна. Суулгах скрипт нь таны архитектурт тохирсон гарын үсэгтэй багцыг татаж авч, нэг суулгах үндсийг байрлуулдаг ~/.aihummer (суулгагчийг ажиллуулсан хэрэглэгчийн гэр directory-д), systemd нэгжүүдийг бүртгэж, хүссэн тохиолдолд сайдкаруудыг бэлтгэнэ. Энэ процессын аль нэг хэсэгт ч контейнер байхгүй.

[!NOTE] Энэ нь хост-д зориулсан орчинд суулгах бөгөөд systemd дор ажиллаж буй хувилбарын tarball юм, гүй Docker. Гүүр, сайдкарыг болон плагинуудыг тус бүр нь өөрийн systemd байдлаар ажиллуулдаг үйлчилгээ.

[!NOTE] Эхлэхээсээ өмнө танд хэрэгтэй зүйлс:

a Линукс SSH-ээр холбогдож болох сервер (x86_64 эсвэл arm64);

sudo эрх (эсвэл rootless суулгах хүсэлтэй байдал — доор үзнэ үү);

PostgreSQL хамт pgcrypto өргөтгөл — эсвэл суулгагчийг нөөцлөхийг зөвшөөр хэрэглэгчийн горимын кластер (rootless горимд үүнийг өөрөө хийдэг);

төвд бүртгэл my.aihummer.ru таны хувийн авах суурилуулах холбоос.

Бүх шаардлагын жагсаалт нь дээр байна Шаардлагууд хуудас.

Алхам 1: хувийн суулгах холбоосоо аваарай

Нийтийн суулгах скрипт байхгүй — суулгах холбоос нь хувийн мөн таны дансны порталд гаргасан:

Бүртгүүлэх my.aihummer.ru (утасны дугаар + нууц үг; имэйл бас шаардлагатай).
Өргөдөл нээнэ үү Суулгалт дэлгэцийг үзээд “Хувийн суулгах холбоос авах” дээр дарна уу.
Портал нь таны хувийн холбоостой ажиллахад бэлэн командыг харуулж байна.

Порталын тухай илүү дэлгэрэнгүй мэдээлэл (төлбөрийн мэдээлэл, баримт бичгүүд, төлөвлөгөө) энд байна Хувийн данс хуудас.

Алхам 2: нэг командыг суурилуулах

“Суулгах” дэлгэцээс командыг хуулах бөгөөд үүнийг өөрийн сервер дээр (Linux x86_64/arm64) ажиллуулна уу:

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

Хувийн холбоос дараах маягтай харагдана https://my.aihummer.ru/dl/<token>/install.sh бөгөөд таны дансанд холбогдсон байдаг.

[!IMPORTANT] Холбоос нэг удаагийнх: яг нэг суулгалтад ажиллана. Суулгагч түүгээр install.sh файлыг татсан тэр мөчид холбоос зарцуулсанд тооцогдоно. Тэр командыг дахин ажиллуулбал «холбоосыг аль хэдийн ашигласан» гэсэн алдаа гарна — энэ бол эвдрэл биш, хамгаалалт юм. Юу хийх вэ: хувийн кабинетынхаа «Суулгах» дэлгэцийг нээгээд шинэ холбоос авна; энэ нь үнэгүй бөгөөд шууд болно.

30 хоног гэдэг нь дахин суулгахад биш, багц файлуудыг татахад хамаарна: суулгачихсан хувилбар нь холбоос суулгалтад зарцуулагдсанаас хойш ч удаан хугацаанд өөрийн холбоосоороо шинэчлэгдсээр байна.

Скрипт таны CPU архитектурыг илрүүлж, тохирох багцыг түүний хамт татаж авдаг .sha256 чексам ба хамт гарын үсэг .sig гарын үсэг, хоёуланг нь баталгаажуулж, суулгалтын үндсийг задлаж, гарцыг үйлчилгээ бүртгэдэг. Үүнийг үзнэ үү Өөрчлөлтийн түүх одоогийн хувилбарын хувьд.

Хувийн холбоос бас энэ хувилбарыг таны хэрэглэгчийн портал аккаунттой холбодог: суурилуулагч нь холбоосоос токенийг хадгалдаг, жишээ нь анхны бүртгэлд нь нийлүүлэгч рүү илгээдэг, портал нь жишээг автоматаар таны данстай холбодог. Танай имэйл шууд тухайн жишээнийх болдог баталгаажуулсан холбоо — Вэбийн интерфэйс дээр ‘имэйлийг хавсаргаж баталгаажуулах’ гэсэн тусдаа алхам байхгүй бөгөөд лицензийг гар аргаар ямар ч алхамгүйгээр олгож өгдөг.

[!WARNING] Таны хувийн холбоос нь тараахад зориулсан таны түлхүүр юм. Үүнийг нийтлэх хэрэггүй: хэн ч Токен хүчинтэй байх хугацаанд холбоосыг барьснаар таны нэрийн өмнөөс бүтээлүүдийг татаж авах боломжтой.

Үндсэн зохион байгуулалтыг суулгана уу

Бүх зүйл ганц хавтасны дор байрлана. Аль хавтас байх нь суулгагчийг хэрхэн ажиллуулснаас хамаарна:

Хэрхэн суулгасан	Суулгалтын үндэс	Тохиргоо	Үйлчилгээ хэний нэрээр ажиллах
Энгийн суулгалт (`sudo` ашиглан)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	Тусдаа `aihummer` үйлчилгээний бүртгэл
Root-гүйгээр (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	Таны өөрийн хэрэглэгч

Энгийн суулгалт файлуудыг таны гэрийн хавтсанд тавихгүй, үйлчилгээг таны нэрээр ч ажиллуулахгүй: түүнд зориулж эрх нь хязгаарлагдсан тусдаа aihummer хэрэглэгч үүсгэнэ. Энэ нь зориудаар хийгдсэн — үйлчилгээг эзэмдсэн этгээд таны хувийн файлууд руу нэвтэрч чадахгүй.

Үндсэн хавтас доторх бүтэц хоёр горимд адилхан (доор энгийн суулгалтыг харууллаа):

/home/.aihummer/
├── bin/        gateway binary and the aihummer CLI
├── etc/        configuration (gateway.env)
├── share/      static assets for the administration interface
├── sidecars/   optional STT/TTS/etc services
├── plugins/    installed marketplace plugins
├── systemd/    unit files (symlinked into /etc/systemd/system)
├── state/      runtime state
├── data/       blob/media storage
└── logs/       service logs

Үүсгэсэн systemd нэгжийн файлууд руу systemd/ Тэд бөгөлнөсөн холбоостой /etc/systemd/system/, тиймээс тэдгээр нь тогтмол удирдлагатай байдаг systemctl тушаалууд.

Шуурхай суулгалтгүй

sudo/root эрх шаардлагагүй. Суулгах командыг sudo-гүй ажиллуулбал суулгагч rootless горимд шилжинэ: нэгжүүд systemd --user хүрээнд (~/.config/systemd/user файлд) бүртгэгдэж, aihummer CLI болон cosign ~/.aihummer/bin дотор байрлана. Хэрэв AIHUMMER_DATABASE_URL өгөөгүй бол суулгагч суулгалтын үндсэн хавтас дотор хэрэглэгчийн горимын PostgreSQL кластер бэлтгэнэ. Үйлчилгээг systemctl --user ... командаар удирдана. Үйлчилгээг хэрэглэгч нэвтрэхийг хүлээлгүй хост ачаалахад эхлүүлэхийн тулд lingering-ийг идэвхжүүлнэ үү:

loginctl enable-linger $USER

Сайдкар сонголт

Хөнгөн жинтэй медиа сайдкарууд — STT (faster-whisper), TTS (edge-tts) болон видео — хайрцгаас гаргаж шууд суулгах, ямар ч асуулт, анхааруулгагүй: эргэлтийн дуу шууд ажиллана. Аль нь ч орчны хувьсагчидтайгаар идэвхигүй болгож болно AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Вэб хайлт (SearXNG) болон хөтөч (CloakBrowser) нь гарын үсэг зурсан багцад шигтгэгдсэн бөгөөд анхдагчаар офлайнаар суулгагддаг — суурилуулагч тэдгээрийн талаар цаашид асуухгүй. Энэ үйлдлийг тугнуудаар өөрчилж болно — энэ нь бүрэн жагсаалт юм:

Түц	Нөлөө
`--no-search` / `--no-browser`	Энэ сайдкартаа алгас
`--external-search=URL` / `--external-browser=URL`	Суулгахын оронд энэ URL дээр байгаа үйлчилгээнийхээ оронд ашиглаарай
`--browser-engine=cloak\|chrome`	Хөтчийн хөдөлгүүр (анхдагчаар `cloak`)
`--with-search` / `--with-browser`	v1.0.14-с хойш илүүц — энэ нь аль хэдийн анхдагч үйлдэл юм
`--with-embedder`	Семантик оруулах төхөөрөмжийг суулгана (оролцох: PyTorch-ыг татаж авна — хэдэн зуун MB)

Хайлт болон хөтөч нь tty-гүйгээр ч суулгагддаг: тэдгээрийн агуулга нь багцаас авагддаг тул үүнд интернэт хандалт шаардлагагүй. Хоёуланг нь суулгах явц блоклодоггүй — агуулга байхгүй эсвэл Python-ы хувилбар дэмжигдээгүй бол үйлчилгээ зүгээр л тохируулагдаагүй үлдэх ба суулгалт хэзээ ч тасалдахгүй. Мөн оруулахыг идэвхжүүлэх боломжтой AIHUMMER_WITH_EMBEDDER=1; үүнийгүйгээр санах ой нь утгын үгийн нөөц хайлтаар ажилладаг. Хэрэглэгчийн интерфэйсийн хэл нь тохируулсан байдаг AIHUMMER_LANG=ru|en (эсвэл суулгагч tty дээр асуудаг). PostgreSQL холболт tty дээр асуулагддаг; харин харилцангүй суулгалтуудад тохируулах AIHUMMER_DATABASE_URL урьдчилан. tty дээр суулгагч нь нөөцлөлтөөс сэргээх боломжийг бас санал болгодог.

# Install the gateway with the embedder, without the browser (search is on by default)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

Хажуугийн тэрэгнүүдийг URL-аар ханддаг учир та төрөлх болон гадаадыг чөлөөтэй хольж, хэд хэдэн гарцыг нэг нийтлэг хажуугийн тэрэглүү чиглүүлж болно.

Багцын жинхэнэ эсэхийг хэрхэн шалгадаг вэ

Хувийн кабинетаас өгсөн холбоос үргэлж одоогийн хувилбарыг суулгана — энэ бол жирийн бөгөөд цорын ганц зам. «Илүү шинэ хувилбар» сонгох шаардлагагүй: нийлүүлэгчийн ажлын хэрэглээнд гаргасан багцыг та авна.

Багц бүр — анхны суулгалтад ч, шинэчлэлт бүрд ч — таны архитектурт тохирсон tarball хэлбэрээр ирэх бөгөөд хажууд нь .sha256 шалгах нийлбэр, .sig (cosign) гарын үсэг байрлана. Суулгагч юуг ч задлахаасаа өмнө хоёуланг нь шалгана. Танд гар аргаар шалгах хэрэг огт гарахгүй.

Хүлээгдэх үр дүн: шалгалтууд чимээгүй өнгөрч, суулгалт үргэлжилнэ. Аль нэг нь таарахгүй бол суулгагч алдаа заан зогсох бөгөөд ажиллаж буй хувилбарт хүрэхгүй — эвдэрсэн буюу солигдсон файл таны сервер лүү орохгүй.

Хэрэв нийлүүлэгч таныг эрт туршилтын хөтөлбөрт урьсан бол хувийн кабинетын «Суулгах» дэлгэц дээр сонголтын товч гарч ирж, сонгосон хувилбарт тань тусдаа холбоос олгоно — Инстанс хэсгээс үзнэ үү.

Суурилуулалтыг шалгах

Суулгагч дууссаны дараа үйлчилгээ болон бэлэн байдлын холбоосыг шалгана уу:

systemctl status aihummer-gateway
curl -fsS http://localhost:8780/healthz
curl -fsS http://localhost:8780/readyz

/healthz амьд болон хувилбарыг тайлагнадаг; /readyz PostgreSQL-г шалгаж, буцаана 503 өгөгдлийн сан хүрэх боломжгүй байхад. Багцласан aihummer CLI мөн өгдөг aihummer status болон aihummer doctor түргэн эрүүл мэндийн тоймыг харах.

Амжилттай суулгасны дараа та юу харах вэ: тийм aihummer-gateway үйлчилгээнд active (running), а 200 –аас, –ээс /healthz болон /readyz, ба анхны админ нууц үг нь /home/.aihummer/etc/initial-admin-password.txt (rootless суулгалтын үед ~/.aihummer/etc/initial-admin-password.txt) ийн тулд анхны нэвтрэлт.

Үйлдвэрлэлийн шалгах жагсаалт

Нэг суулгах тушаал тавихад гарц ажиллаж эхэлнэ, гэхдээ энэ нь бүтээгдэхүүнд бэлэн биш. Ил болгохоос өмнө дуусга:

TLS — шлюзын урд HTTPS-ийг дуусгах (урвуу прокси / өөрийн) гэрчилгээ); итгэлгүй сүлжээнд энгийн портыг хэзээ ч ил задгай ашиглаж болохгүй.
🔴 Урвуу проксид WebSocket дэмжлэгийг асаана уу. Гар утас болон ширээний компьютерийн програм гарцтай wss://-ээр холбогддог тул прокси нь Upgrade ба Connection толгойг дамжуулах ёстой. Энэ тохиргоогүй прокси 101 Switching Protocols-ын оронд 200 төлөвтэй энгийн хуудас буцаадаг — програм үүнийг «үйлчилгээ хариу өгөхгүй байна» гэж уншдаг ч гарц бүрэн ажиллаж, бүртгэлд нь ганц ч алдаа байдаггүй. Nginx Proxy Manager дээр энэ нь холбогдох Proxy Host-ын Websockets Support унтраалга, энгийн nginx дээр — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; мөн location блокт proxy_http_version 1.1.

Нэг тушаалаар шалгах (200 биш, 101 хүлээгдэнэ):
```
curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
  -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' \
  https://таны-домэйн/
```
Админ нууц үгийг солих мөн устгах initial-admin-password.txt; тохируулга эрх бүхий гаргагч (AIHUMMER_OIDC_ISSUER / LDAP / SAML) нийтэд дэлгэрүүлэхээс өмнө /admin/*.
Мастер түлхүүр болон өгөгдлийн санг нөөцлөнө үү — бичлэг AIHUMMER_MASTER_KEY (нууцууд түүнгүйгээр сэргээшгүй) ба тогтмол PostgreSQL нөөцлөлтийг тохируулна уу.
Үнэн загварыг утсаар холбох — багц AIHUMMER_LLM_* (эсвэл BYOK); үүнийггүй бол хариулт ирдэг тодорхойлогдсон дуурайлгаас.
Заавал нэг сувгийг холбох (Телеграмм эхлүүлэх) ба түүнд агент холбох.

Харах Эхний нэвтрэлт, Тохиргоо болон Нөөцлөлт ба ослын сэргээн босголт дэлгэрэнгүй мэдээллийн төлөө.

Хэрвээ энэ ажиллаж байсангүй бол

«холбоосыг аль хэдийн ашигласан» / суулгалт хоёр дахь удаагаа эхлэхгүй байна — холбоос нэг удаагийнх бөгөөд өмнөх оролдлого түүнийг зарцуулсан байна. Порталын «Суулгах» дэлгэцээс шинийг авч, командыг дахин ажиллуулна уу.
curl: (22) … 404 эсвэл “холболт буруу” — холбоос бүрэн бус хуулагдсан эсвэл хугацаа нь дууссан байна. Эмчилгээ нь мөн адил: шинэ холбоос.
дэмждэггүй архитектур — суулгалт нь Linux x86_64 ба arm64-ийг дэмждэг; Бусад платформуудын багц байхгүй.
/readyz буцаана 503 — гарц PostgreSQL-ийг харахгүй байна. Шалгана уу AIHUMMER_DATABASE_URL, өгөгдлийн санд хүрэх боломжтой байдал, мөн тэр pgcrypto өргөтгөл үүсгэгдсэн (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
Үйлчилгээ эхлээгүй — шалгах systemctl status aihummer-gateway болон journalctl -u aihummer-gateway; хурдан оношлогооны тест хийх aihummer doctor.
Sudo-гүйгээр суулгасан, хэрэглэгч системээс гарахад үйлчилгээ зогсдог — удаан хадгалахыг идэвхжүүлэх: loginctl enable-linger $USER (харах үндэсгүй).
Гарын үсгийн баталгаажуулалт амжилтгүй боллоо — суулгалтыг үргэлжлүүлээгүй; дараа дахин оролдоно уу эсвэл шинэ холбоос авах. Урлагийн бүтээлийг үргэлж үүнтэй харьцуулан баталгаажуулдаг .sha256 болон хамт гарын үсэг зурах .sig.

Дараа хаашаа явах вэ

Эхний удаа ажиллуулах: үзэх Эхний нэвтрэлт буцааж авах анхны админ нууц үгээс /home/.aihummer/etc/initial-admin-password.txt (rootless суулгалтын үед ~/.aihummer/etc/initial-admin-password.txt).
Тонг тохируулах: унших Тохиргоо.
Анхны гүйгээгээ заавартай хийхийг хүсч байна уу? Үүнийг ашиглаарай Хурдан эхлэлт.