CLI Havola
aihummer bu buyruq qatori vositasi xostga oid mahalliy o‘rnatishni boshqaradi: u shlyuzni ishga tushiradi va yangilaydi (o‘rnatish o‘zi sizning hisob portalidagi shaxsiy o‘rnatish havolasi orqali amalga oshiriladi), shlyuz systemd xizmatini boshqaradi, diagnostika ishga tushiradi, zaxira nusxalarini boshqaradi, boshqaruv platformasi sozlamalarini o‘qiydi va yozadi, hamda litsenziyalarni imzolaydi. Bu sahifa har bir buyruqni ro‘yxatlaydi.
Buyruqlar
| Buyruq | Nimani qiladi |
|---|---|
up / install |
Gateway systemd xizmatini ishga tushiring (systemctl start). Hech narsa o‘rnatilmaydi — o‘rnatish shaxsiy havolangizdagi o‘rnatish skripti orqali amalga oshiriladi. |
update [--check] |
Eng so‘nggi versiyaga yangilash (imzoni tasdiqlash + ikkilik faylni almashtirish + qayta ishga tushirish); --check faqat yangilanish mavjudligini xabar beradi. |
restart |
Shlyuz xizmatini qayta ishga tushiring (systemctl restart). |
stop |
Shlyuz xizmatini to’xtating (systemctl stop). |
logs [unit] [--no-follow] |
Bir systemd birligining jurnalini kuzatish (journalctl -u); standarti bo‘yicha gateway birlikga o‘tadi. --no-follow jurnalning oxirini chop etadi va chiqadi; usiz buyruq kuzatishda davom etadi. |
status |
O‘rnatishning umumiy ko‘rinishi, xizmatlar holati va shlyuz tayyorligi (/readyz). Komponentlar bo‘limi ixtiyoriy sidecar yunitlarining (qidiruv, brauzer, nutqdan-matnga, matndan-nutqqa, video) holatini xabar qiladi; systemctl mavjud bo‘lmasa, «o‘rnatilmagan» o‘rniga holat noma’lumligini halol aytadi. |
doctor |
Uch xulosali diagnostika: hammasi yaxshi, ogohlantirishlar bilan ishlayapti (N) yoki muammolar topildi. Node.js va ro‘yxatdan o‘tish materiali tekshiruvlari — ogohlantirishlar, xatolar emas. |
backup [dir] |
pg_dump PostgreSQL davlat maydoni faylga; agar ko‘rsatilmasa, standart katalog ishlatiladi. |
restore <file> |
PostgreSQL ni yaratilgan zahira fayldan tiklash backup. |
uninstall [flags] |
O‘rnatishni olib tashlang (quyidagi bayroqlarga qarang). Root talab qilinadi — uni bilan ishga tushiring sudo. |
set-password / admin-password |
Mahalliy administrator parolini o‘rnatish/yaratish ([--login admin] [--password X]). |
settings {set|get|list} |
Ma’lumotlar bazasida boshqaruv-plani sozlamalarini o’qish/yozish — bu Settings-katalog tugmalari CLI orqali qanday sozlanishini ko’rsatadi gateway.env. |
license {keygen|sign|show <token>} |
Litsenziyalarni boshqarish: kalit yaratish, imzolash, berilgan tokenni dekodlash va tekshirish. |
loadtest |
Shlyuzga yuk sinovini o’tkazing. |
plugin {init|validate|keygen|package|sign|publish} |
Plugin SDK: maydonga qo‘yish, tasdiqlash, kalitlar, paketlash, imzolash va nashr qilish. |
version |
Versiyani chop et. |
help |
Yordamni ko’rsat. |
uninstall bayroqlar
| Bayroq | Ta’sir |
|---|---|
--purge |
Shuningdek, ma’lumotlarni o’chiring (to’liq o’chirish). |
--yes |
Tasdiqlash so‘rovini o‘tkazib yuboring. |
--no-backup |
O’chirishdan oldin zaxira nusxasini olmang. |
--backup-dir <dir> |
Dasturni o‘rnatishni olib tashlashdan oldingi zahirani ushbu papkaga yozing. |
Foydalanish misollari
O‘rnatish va ishga tushirish
O‘rnatish shaxsiy hisob portalingizdagi shaxsiy o‘rnatish havolasi orqali amalga oshiriladi (qarang O’rnatish); undan keyin CLI ishga tushadi va xizmatni tekshiradi:
sudo aihummer up
aihummer status
Yangilash
# Only check whether a newer release exists
aihummer update --check
# Apply the update
sudo aihummer update
Xizmatni nazorat qilish va jurnallar
Buyruqlar yagona gateway systemd birligida ishlaydi (AIHUMMER_SERVICE, standart aihummer-gateway); logs har qanday systemd birlik nomini qabul qiladi.
sudo aihummer restart
aihummer logs # the gateway unit's journal (default; follows)
aihummer logs --no-follow # print the tail of the journal and exit
aihummer logs aihummer-stt # another systemd unit's journal
sudo aihummer stop
Diagnostika
aihummer doctor
Zaxira qilish va tiklash
backup boshqaradi pg_dump PostgreSQL davlat tekisligini faylga; restore o’sha dump faylni oladi.
aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql
[!TIP] Postgres haqiqat manbai, lekin sizning
AIHUMMER_MASTER_KEYva dog‘ papkani alohida zaxiralash kerak — asosiy kalitsiz, shifrlangan holda sirlash tiklanmaydi.
Admin parolini o‘rnatish
Buyruq qabul qiladi [--login admin] [--password X] va ehtiyojlari AIHUMMER_DATABASE_URL — odatda shundan olinadi gateway.env o‘rnatish foydalanuvchisi sifatida yoki orqali ishga tushirilganda sudo.
sudo aihummer set-password --login admin
Nazorat tekisligi sozlamalari
settings bazada sozlamalar-katalog tugmalarini to‘g‘ridan-to‘g‘ri o‘qiydi va yozadi — xuddi veb admin UI (Boshqaruv → Sozlamalar) tahrir qiladigan do‘kon. Katalog tugmalari CLI orqali shunday sozlanadi: gateway.env qiymatlar ularning uchun inobatga olinmaydi.
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list
settings list faqat foydalanuvchiga ko‘rsatiladigan katalog kalitlarini ko‘rsatadi (tizim va ichki kalitlar yashirilgan); har bir kalit manbasi bilan belgilangan — [db] siz belgilagan qiymatlar uchun, [unset] aks holda katalog sukut bo‘yicha.
Litsenziyalar
license show talab qiladi <token> bahs va AIHUMMER_LICENSE_PUBKEY o’zgaruvchi: u dekodlaydi va tekshiradi berilgan token — bu instansiyaning joriy litsenziyasini ko‘rsatmaydi.
aihummer license keygen # generate a signing key
aihummer license sign # sign a license
aihummer license show <token> # decode + verify a token
Yuklash testi
aihummer loadtest
Plaginlar
aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz
To‘liq SDK uchun va portaldan umumiy katalogga («Mening plaginlarim») nashr qilish uchun qarang Plagin SDK va Pluginni nashr qilish.
[!WARNING]
uninstallroot talab qiladi: ishga tushirishsudo aihummer uninstall. Vasudo aihummer uninstall --purge --yesma’lumotlarni o’chiradi va o’tkazib yuboradi tasdiqlash so‘rovi — avvalo tasdiqlangan zaxira nusxangiz borligiga ishonch hosil qiling.
Atrof-muhit
O’zgaruvchilar aihummer o‘zi vosita o‘qiydi:
| O’zgaruvchi | Maqsad |
|---|---|
AIHUMMER_SERVICE |
Shlyuz systemd birligi nomi (standart) aihummer-gateway) — maqsad up/restart/stop/logs. |
AIHUMMER_GATEWAY_URL |
Gateway URL uchun status/doctor/loadtest (standart http://127.0.0.1:8780). |
AIHUMMER_DATABASE_URL |
Postgres DSN — talab qilinadi backup/restore/set-password/settings. |
AIHUMMER_LANG |
CLI chiqishi va yordam tili: ru (standart) yoki en. |
Ko‘pgina buyruqlar root keraksystemctl) — ularni ishlating bilan sudo.
Keyingi qayerga
- Instansiyani sozlash: Atrof-muhit o’zgaruvchilari.
- Agent qaysi vositalardan foydalanishi mumkinligini aniqlang: Asboblar katalogi.