AiHummer
Кыргызча
КирүүЖеке кабинет
v1.2.x
{ }Swagger

Pocket Agent плагини

v1.2.x · жаңыланды 2026-07-05

Pocket Agent - бул кыска өмүрдүү, TTL-билети менен алыстан кирүүгө арналган курал. Бул операторго белгиленген тапшырманы аткаруу үчүн максаттуу машинага жетүүгө мүмкүндүк берет, жана коопсуздук модели максаттуу машина эч качан порт ачышы же кирген байланышка ишениши керек эмес кылып иштелип чыккан.

[!WARNING] Pocket Agent - бул мобилдик жардамчы тиркеме эмес. Аты кичинекейге тиешелүү талап боюнча алыстан кирүүчү агент, телефон клиент эмес. Клиенттик тиркеме үчүн караңыз Мобилдик жана десктоп колдонмо плагини.

Ал жергиликтүү хостто иштейт жана шлюз менен байланышат aihummer.service.v1 келим-шарт.

Фактылар

Дала Баалоо
Версия 0.1.2
Порт 8814
Иштөө учуру идуучуга туюк

Бул эмне

Белгилүү бир максатта инфраструктурасыз алыс жерде чектелген аракетти жүргүзүүнүн жолу. Кирүү буйруктарын угуп туруучу демондун ордуна, модель билеттерге негизделген жана чыгууга гана арналган:

  1. Бир оператор билет берет — кыска мөөнөттүү (TTL чектелген) грант үчүн тактикалык тапшырма.
  2. Бул максат кол коюлган бутстрапты иштетет билетті текшерген адам.
  3. Мақсат андан кийин кирет чыгуу сурамжылоо цикли, жумуш издөө үчүн кол сунуп жана жыйынтыктарды маалымдаңыз.

Белгинин TTL мөөнөтү бүтөр менен кирүү мүмкүнчүлүгү жоголот. Эч нерсе туруктуу түрдө укпай калбайт.

Коопсуздук модели

[!NOTE] Pocket Agentтин негизги максаты ыңгайлуулук эмес, коопсуздук абалы болуп саналат. Жүзөгө ашыруудан мурун түшүнүңүз:

  • Кыскача мөөнөттүү билеттер (TTL). Кирүү убакыт менен чектелген; мөөнөтү өткөн билет эч нерсени бербейт.
  • Кол коюлган бутстрап. Максат кол менен кол коюлганды текшергенден кийин гана улантат билеттерге байланган bootstrap.
  • Чыгуу сурамжылоого гана. Максат бардык байланыштарды баштайт. Бар кирүүчү сокет жок чабуул кылуу жана тартпаңыз канал.
  • Рөхсәт берилген тизмеси. Максаттар жана аракеттер уруксат берилген тизмеге ылайык чектелген.
  • Аудит. Иш-аракет карап чыгуу үчүн жаздырылат.

Чыгып кирүүчү угуучу жана push жок болгондуктан, максаттагы кол салуу бетинин аянты минималдуу: кол салуучу Pocket Agent аркылуу максатка туташуу мүмкүнчүлүгүнө ээ эмес, жана билет мөөнөтү бүткөндө кирүү автоматтык түрдө токтойт.

Аны кантип колдонуу керек

Оператор белгилүү бир тапшырма үчүн билет чыгарат; максаты аны кол коюлган bootstrap жана чыгуу суроо цикли аркылуу алат, уруксат берилген ишти аткарат жана кайра отчет берет. Ар бир кадам билет TTL менен чектелет жана аудит журналында жазылып турат.

operator issues TTL ticket ─▶ target verifies signed bootstrap ─▶ target polls outbound ─▶ allowlisted work ─▶ audit

Орнотуу

Админ UI аркылуу маркетплейстен Pocket Agent программасын бир чыкылдатуу менен орнотуңуз. Хостту-туруктуу деплойер плагинди жүктөп, орнотуу баскычын иштетет, изоляцияланган systemd бирдигин түзөт жана аны даяр деп белгилөөнүн алдында ден соолукка күтөт — караңыз Орнотуу жана жаңыртуулар. Контейнерлер катышпайт.

Коопсуздук жана чектөөлөр

  • TTL-билети менен гана кирүү — убакыт менен чектелген, туруктуу алыстатылган сессия эмес.
  • Чыкпай турган гана — максатта киргизүүчү сокет жок, push каналы жок.
  • Сырсөз менен коштолгон рўксаттама + кол коюлган баштапкы жүктөө + аудит ким эмне кыла аларын күчүнө киргизип, жазып коюу ал.
  • Кошумча колдонмо эмес — бул оператор башкаруусундагы алыстан кирүү, телефон эмес кардар.
  • Ийгиликтүү төрөлгөн — системддин астында иштейт, контейнерде эмес.

Келерки кайда