Насб — AiHummer Ҳуҷҷатнигорӣ

AiHummer насб мекунад мизбон-меҳмон. Насб аз ҳисоби шахсии шумо оғоз меёбад my.aihummer.ruшумо сабти ном мекунед, ба даст меоред пайванди насби шахсӣ ва як фармонро дар сервери худ иҷро кунед. Скрипти насб як бастаи имзодашударо барои меъмории шумо зеркашӣ мекунад ва як решаи ягонаи насбро таҳия мекунад. ~/.aihummer (дар директорияи асосии корбаре, ки насбкунандаро иҷро кардааст), воҳидҳои systemd-ро сабт мекунад ва ихтиёрӣ sidecars-ро таъмин мекунад. Дар ин раванд ягон контейнери дигар вуҷуд надорад.

[!NOTE] Ин насби маҳаллӣ барои мизбон аст — як архиви нашриш аст, ки таҳти systemd кор мекунад не Докер. Шарҳгӯӣ, сайдкар ва плагинҳо ҳар яке ҳамчун системди худ равона мешаванд хизмат

[!NOTE] Чӣ ки шумо пеш аз оғоз талаб доред:

а Линукс сервер (x86_64 ё arm64) ки шумо метавонед тавассути SSH дастрас шавед;

sudo ҳуқуқҳо (ё омодагӣ ба насби беасос — нигаред ба поён)

PostgreSQL бо pgcrypto вазъият — ё ба насбкунанда иҷозат додан, ки таъмин кунад кластер дар ҳолати корбар (дар режими беасос онро худкор иҷро мекунад)

суратҳисоб дар 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, насбкунанда ба ҳолати беасос гузар мекунад: воҳидҳо сабт мешаванд дар systemd --user доираи (файлҳо дар ~/.config/systemd/user), ин aihummer CLI ва cosign заминро ба даст меоранд ~/.aihummer/bin, ва агар AIHUMMER_DATABASE_URL насбкунанда шартҳои як кластери PostgreSQL дар ҳолати корбарро дар дохили решаи насб нигоҳ намедорад. Хизматрасониҳо идора карда мешаванд бо systemctl --user ...Барои он ки хадамот ҳангоми оғоз шудани система (на танҳо ҳангоми воридшавии корбар) оғоз шаванд, linger-ро фаъол созед:

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 дастгирӣ нашавад, хидмат танҳо танзимнашуда мемонад, вале насб идома меёбад. Имкони фаъол кардани embedder низ мавҷуд аст AIHUMMER_WITH_EMBEDDER=1бе он хотира ба ҷустуҷӯи баргашти луғавӣ такя мекунад. Забони интерфейси корбарӣ аз ҷониби AIHUMMER_LANG=ru|en (дар акси ҳол насбкунанда дар tty мепурсад). Пайвасти PostgreSQL дар tty талаб карда мешавад; барои насбҳои ғайриинтерактивӣ танзим кунед AIHUMMER_DATABASE_URL Ҷиҳати пеш аз вақт. Дар TTY насбкунанда инчунин пешниҳод мекунад, ки аз нусхаи эҳтиётӣ барқарор созад.

# Насб кардани gateway бо embedder, бе браузер (ҷустуҷӯ бо пешфарз насб мешавад)
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 постгресқлро тафтиш мекунад ва бармегардонад 503 дар ҳоле ки пойгоҳи дода дастрас намешавад. Маҳсулоти ҳамроҳшуда aihummer CLI инчунин таъмин мекунад aihummer status ва aihummer doctor барои баррасии зуд ва умумӣ саломатӣ

Чиро пас аз насбкунии муваффақона мебинед: он aihummer-gateway хизмат дар active (running), як 200 аз /healthz ва /readyz, ва пароли аввалини маъмурӣ дар /home/.aihummer/etc/initial-admin-password.txt (ҳангоми насби бе root — ~/.aihummer/etc/initial-admin-password.txt) барои вуруди аввалин.

Рӯйхати тафтиши истеҳсолот

Як фармони насб кардани ягона тавассути он шлюзро ба кор медарорад, аммо он ҳанӯз барои истеҳсолот омода нестПеш аз ошкор кардани он, пур кунед:

TLS — хатми HTTPS пеш аз дарвоза (прокси баръакс / худи шумо) шаҳодатнома); ҳеҷ гоҳ порти оддиро дар шабакаи боварнопазир намоиш надиҳед.
🔴 Дастгирии веб‑сокетҳоро дар прокси баръакс фаъол кунед. Барномаи мобилӣ ва мизи корӣ ба шлюз тавассути wss:// пайваст мешавад, бинобар ин прокси бояд сарлавҳаҳои Upgrade ва Connection-ро гузаронад. Проксии бе ин танзим ба ҷои 101 Switching Protocols саҳифаи оддӣ бо ҳолати 200 бармегардонад — барнома инро «хидмат ҷавоб намедиҳад» мехонад, ҳол он ки шлюз солим аст ва дар журнали он ягон хато нест. Дар Nginx Proxy Manager ин калиди Websockets Support-и Proxy Host-и дахлдор аст, дар nginx-и оддӣ — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; дар блоки location ҳамроҳи proxy_http_version 1.1.

Санҷиш бо як фармон (101 интизор аст, на 200):
```
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); бе он посухҳо намеоянд аз тахмини ҳалкунанда.
Ҳадди аққал як каналро пайваст кунед (Telegram барои оғоз) ва як агенти онро ба он пайванд диҳед.

Дидан Воридшавии аввал, Танзимот ва Захираҳо ва Барқарорсозии Душвор барои тафсилот.

Агар кор намекард

«пайванд аллакай истифода шудааст» / насб бори дуюм оғоз намешавад — пайванд яккарата аст ва кӯшиши пешина онро аллакай сарф кардааст. Дар экрани «Насб» дар кабинет пайванди нав гиред ва фармонро дубора иҷро кунед.
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 (ҳангоми насби бе root — ~/.aihummer/etc/initial-admin-password.txt).
Насбро мутобиқ созед: хонед Танзимот.
Мехоҳед як дави аввалин бо роҳнамоӣ дошта бошед? Аз он истифода баред Оғози зуд.