Орнату — AiHummer Құжаттама

AiHummer орнатады қожайындық-туған. Орталау сіздің жеке кабинетіңізде басталады my.aihummer.ru: сіз тіркелесіз, аласыз жеке орнату сілтемесі және серверде бір команданы орындаңыз. Орнату скрипті сіздің архитектураңыз үшін қолтаңбаланған пакетті жүктейді, бір орнату түбірін орналастырады ~/.aihummer (орнатушыны іске қосқан пайдаланушының үй каталогында) systemd бірліктерін тіркейді және қалау бойынша қосымша контейнерлерді дайындайды. Бұл процесс барысында еш жерде контейнерлер жоқ.

[!NOTE] Бұл — хост-тағы жергілікті орнату — systemd астында жұмыс істейтін шығарылым тарабы. емес Docker. Шлюз, сайдкарлар және плагиндер әрқайсысы өз жүйелік қызметі ретінде іске қосылады қызмет.

[!NOTE] Бастамас бұрын сізге қажет нәрселер:

а Линукс SSH арқылы қол жеткізе алатын сервер (x86_64 немесе arm64);

sudo құқықтар (немесе түбірсіз орнатуға ниет — төменде қараңыз);

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 күн мерзімі қайта орнатуға емес, артефактілерді жүктеп алуға қатысты: орнатылып қойған дана сілтеме орнатуға жұмсалғаннан кейін де сол сілтеме арқылы жаңарып отырады.

Скрипт сіздің процессор архитектураңызды анықтайды, сәйкес пакетті және оның бір бөлігін жүктейді .sha256 чексум және қос қол қою .sig қолтаңба, екеуін де тексереді, орнату түптамырын ашады және шлюз қызметін тіркейді. Қараңыз Өзгерістер журналы ағымдағы шығарылым үшін.

Жеке сілтеме де инстанцияны сіздің клиенттік портал тіркелгіңізге байлайды: орнатушы сілтемеден токенді сақтайды, инстанция оны сатушымен алғашқы тіркелу кезінде жібереді, және портал инстанцияны автоматты түрде сіздің есептік жазбаңызбен байланыстырады. Сіздің электрондық поштаңыз дереу инстанцияның поштасына айналады расталған байланыс — Web UI-де жеке «электрондық поштаны тіркеп, тексеру» қадамы жоқ, және лицензия ешқандай қолмен қадамсыз жеткізіледі.

[!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 жүктейді — жүздеген МБ)

Іздеу мен браузер tty-сіз де орнатылады: пайдалы жүктеме бандлден алынады, ол үшін интернетке қосылу қажет емес. Екеуін де орнату бөгемейді — пайдалы жүктеме болмаса немесе Python нұсқасы қолдау таппаса, қызмет жай ғана бапталмаған күйде қалады, ал орнату жалғаса береді. Энбедерді келесі арқылы да қосуға болады AIHUMMER_WITH_EMBEDDER=1; онысыз есте сақтау лексикалық резервтік іздеумен жұмыс істейді. Пайдаланушы интерфейсінің тілі былай орнатылады AIHUMMER_LANG=ru|en (болмаса орнатушы tty-де сұрайды). PostgreSQL қосылымы tty-де сұралады; интерактивті емес орнатулар үшін орнатыңыз AIHUMMER_DATABASE_URL алдын ала. TTY-де орнатушы сонымен қатар сақтық көшірмеден қалпына келтіруді ұсынады.

# Gateway-ді эмбеддермен, браузерсіз орнату (іздеу әдепкі бойынша орнатылады)
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) күйінде, /healthz және /readyz сұраулары 200 қайтарады, ал бастапқы әкімші құпия сөзі алғашқы кіруге арналған /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); ол болмаса жауаптар келеді детерминистік емулятордан.
Кем дегенде бір арнаны қосыңыз (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 (rootless орнатуда — ~/.aihummer/etc/initial-admin-password.txt).
Орнатуды баптау: оқу Конфигурация.
Бастапқы жүгіруді бағытталған түрде қалайсыз ба? Пайдаланыңыз Жылдам бастау.