Официалтәи аплагинқәа/Pocket Agent аплагин
Pocket Agent аплагин
v1.0.x · ирҿыцуп 2026-06-26


Pocket Agent — ихысхымԥоу, TTL-тикеттә ихароу адашьаратә инструментра. Уи
аоператор инаҭоиҵоит ацельтә машьына анааира иаҟәымҭроу аус нагӡаразы, абас
ишьақәгылоу ашәарҭадаратә модельла ацель апорт аартра ма иаҩнагалоу аиԥшьара
адыргәартә хымԥашамкәа.
[!WARNING]
Pocket Agent — уи акәым амобиль-аккомпани аппликациа. Ахьӡ иарбоит маҷу,
иҭахызар-аамҭазтәи ихароу адашьаратә агент, ателефон клиент акәымкәа. Аклиент
аппликациа азы шәахәаԥш Амобиль & адесктоп аппликациа
аплагин.
Уи ауеит host-native ҳасабла насгьы агейтуан иацәажәоит акантракт ала.
Афактқәа
| Аҵакыра |
Аҵакы |
| Аверсиа |
0.1.0 |
| Апорт |
8814 |
| Аруантайм |
host-native |
Иарбану иара
Аиаҟәымҭроу аусура ацельтә машьына аҟны иналагатә амҩа, убри ацель аҟны
изхымԥо аинфраструктура ада. Иаҩнагалоу адҵарақәа иазыԥшу демон аҟынтә, амодель
тикет-зныҟәало насгьы ианацло-заҵәык:
- Аоператор тикет иҭнаҵоит — иҷыдоу аус азы ихысхымԥоу (TTL-ала иаҟәымҭроу)
анашьҭра.
- Ацель иналаргоит аиашаратә бутстрап уи тикет иарҳәоу.
- Ацель нас иналеиԥхьаӡоит ианацло-полл-цикл аҟны, аус аагара насгьы алҵшәақәа
рыҩра рзы анеира.
Тикет иTTL аанажәлартә ала, адашьара ыӡуеит. Иаԥхысхуу акакгьы изыԥшуа ыҟамзааит.
Ашәарҭадаратә модель
[!NOTE]
Pocket Agent ихадоу аус — иара ашәарҭадаратә позициа, аманшәалара акәымкәа.
Идеплоиратәаанӡа уи еилышәкаа:
- Ихысхымԥоу атикетқәа (TTL). Адашьара аамҭала иаҟәымҭроуп; иаԥхысхуу тикет
акакгьы инаҭоиҵом.
- Аиашаратә бутстрап. Ацель инеилагалоит тикет иадҳәалоу аиашаратә бутстрап
анаигәаҭо ашьҭахь заҵәык.
- Ианацло-полл-цикл заҵәык. Ацель аиԥшьарақәа зегьы налагоит. Иҟаӡам
иаҩнагалоу сокет ахысразы насгьы иҟаӡам апуш канал.
- Аллоулист. Ацельқәеи ахымԥадарақәеи иаҟәынҭроу аллоулистла.
- Аудит. Аусура иануп агәаҭаразы.
Иаҩнагалоу аизыԥшу ыҟамзаргьы апушгьы ыҟамзар, ацель аҟны ажәашьахатәы аган маҷуп:
ажәашьахаҩы ацель ахь Pocket Agent ала диадҳәалаӡом, насгьы адашьара
автоматикла ыӡуеит тикет аанажәлоит.
Ишахархәоу
Аоператор иҷыдоу аус азы тикет иҭнаҵоит; ацель уи иаазкуеит аиашаратә бутстрапи
ианацло-полл-циклеи рыла, иаллоулистоу аус нанагӡоит, насгьы анеиҭеиҩуеит. Ашьаҿа
зегьы иаҟәынҭроуп тикет иTTL ала насгьы иануп аудит-цәаҳәаҟны.
operator issues TTL ticket ─▶ target verifies signed bootstrap ─▶ target polls outbound ─▶ allowlisted work ─▶ audit
Адҵара
Pocket Agent ишәдыргалар ҟалоит ныҟәакрак ала амаркетплейс аҟнытә админ-UI аҟны.
Host-native адеплоер аплагин ддаунлоуд ҟанаҵоит, иinstall-ашьаҿа ауеит, иеиҿкааны
аизолировоу systemd-аакьа аартуеит, насгьы агәабзиара иазыԥшуеит уи иманшәалоуп
ҳәа аҵаҩраанӡа — шәахәаԥш Адҵара & арҿыцрақәа.
Аконтеинерқәа ралахәра ыҟаӡам.
Ашәарҭадареи аҳәаақәеи
- TTL-тикеттә адашьара заҵәык — аамҭала иаҟәынҭроуп, изыԥшу ихароу асессиа акәымкәа.
- Ианацло-заҵәык — иаҩнагалоу сокет ыҟаӡам, ацель аҟны апуш-канал ыҟаӡам.
- Аллоулист + аиашаратә бутстрап + аудит иркьахуеит изусзо иарбану, насгьы
иануп.
- Акәым аккомпани аппликациа — ари аоператор изныҟәало ихароу адашьара,
ателефон клиент акәымкәа.
- Host-native — ауеит systemd аҵаҟа, аконтеинер аҩныҵҟа акәымкәа.
Анаҩсыҟатәи
<p class="doc-plugin-logo"><img class="th-on-dark" src="/pl/pocket-dark.svg" alt="" width="60" height="60" /><img class="th-on-light" src="/pl/pocket-light.svg" alt="" width="60" height="60" /></p>
**Pocket Agent — ихысхымԥоу, TTL-тикеттә ихароу адашьаратә инструментра.** Уи
аоператор инаҭоиҵоит ацельтә машьына анааира иаҟәымҭроу аус нагӡаразы, абас
ишьақәгылоу ашәарҭадаратә модельла ацель апорт аартра ма иаҩнагалоу аиԥшьара
адыргәартә хымԥашамкәа.
> [!WARNING]
> Pocket Agent — уи **акәым амобиль-аккомпани аппликациа.** Ахьӡ иарбоит маҷу,
> иҭахызар-аамҭазтәи ихароу адашьаратә агент, ателефон клиент акәымкәа. Аклиент
> аппликациа азы шәахәаԥш [Амобиль & адесктоп аппликациа](/en/v1.0/plugins/ios-mobile)
> аплагин.
Уи ауеит host-native ҳасабла насгьы агейтуан иацәажәоит акантракт ала.
## Афактқәа
| Аҵакыра | Аҵакы |
|---|---|
| Аверсиа | 0.1.0 |
| Апорт | 8814 |
| Аруантайм | host-native |
## Иарбану иара
Аиаҟәымҭроу аусура ацельтә машьына аҟны иналагатә амҩа, убри ацель аҟны
изхымԥо аинфраструктура ада. Иаҩнагалоу адҵарақәа иазыԥшу демон аҟынтә, амодель
**тикет-зныҟәало насгьы ианацло-заҵәык**:
1. **Аоператор тикет иҭнаҵоит** — иҷыдоу аус азы ихысхымԥоу (TTL-ала иаҟәымҭроу)
анашьҭра.
2. **Ацель иналаргоит аиашаратә бутстрап** уи тикет иарҳәоу.
3. Ацель нас иналеиԥхьаӡоит **ианацло-полл-цикл** аҟны, аус аагара насгьы алҵшәақәа
рыҩра рзы анеира.
Тикет иTTL аанажәлартә ала, адашьара ыӡуеит. Иаԥхысхуу акакгьы изыԥшуа ыҟамзааит.
## Ашәарҭадаратә модель
> [!NOTE]
> Pocket Agent ихадоу аус — иара ашәарҭадаратә позициа, аманшәалара акәымкәа.
> Идеплоиратәаанӡа уи еилышәкаа:
>
> - **Ихысхымԥоу атикетқәа (TTL).** Адашьара аамҭала иаҟәымҭроуп; иаԥхысхуу тикет
> акакгьы инаҭоиҵом.
> - **Аиашаратә бутстрап.** Ацель инеилагалоит тикет иадҳәалоу аиашаратә бутстрап
> анаигәаҭо ашьҭахь заҵәык.
> - **Ианацло-полл-цикл заҵәык.** Ацель аиԥшьарақәа зегьы налагоит. Иҟаӡам
> **иаҩнагалоу сокет** ахысразы насгьы иҟаӡам **апуш** канал.
> - **Аллоулист.** Ацельқәеи ахымԥадарақәеи иаҟәынҭроу аллоулистла.
> - **Аудит.** Аусура иануп агәаҭаразы.
Иаҩнагалоу аизыԥшу ыҟамзаргьы апушгьы ыҟамзар, ацель аҟны ажәашьахатәы аган маҷуп:
ажәашьахаҩы ацель *ахь* Pocket Agent ала диадҳәалаӡом, насгьы адашьара
автоматикла ыӡуеит тикет аанажәлоит.
## Ишахархәоу
Аоператор иҷыдоу аус азы тикет иҭнаҵоит; ацель уи иаазкуеит аиашаратә бутстрапи
ианацло-полл-циклеи рыла, иаллоулистоу аус нанагӡоит, насгьы анеиҭеиҩуеит. Ашьаҿа
зегьы иаҟәынҭроуп тикет иTTL ала насгьы иануп аудит-цәаҳәаҟны.
```text
operator issues TTL ticket ─▶ target verifies signed bootstrap ─▶ target polls outbound ─▶ allowlisted work ─▶ audit
```
## Адҵара
Pocket Agent ишәдыргалар ҟалоит ныҟәакрак ала амаркетплейс аҟнытә админ-UI аҟны.
Host-native адеплоер аплагин ддаунлоуд ҟанаҵоит, иinstall-ашьаҿа ауеит, иеиҿкааны
аизолировоу systemd-аакьа аартуеит, насгьы агәабзиара иазыԥшуеит уи иманшәалоуп
ҳәа аҵаҩраанӡа — шәахәаԥш [Адҵара & арҿыцрақәа](/en/v1.0/marketplace/install-updates).
Аконтеинерқәа ралахәра ыҟаӡам.
## Ашәарҭадареи аҳәаақәеи
- **TTL-тикеттә адашьара заҵәык** — аамҭала иаҟәынҭроуп, изыԥшу ихароу асессиа акәымкәа.
- **Ианацло-заҵәык** — иаҩнагалоу сокет ыҟаӡам, ацель аҟны апуш-канал ыҟаӡам.
- **Аллоулист + аиашаратә бутстрап + аудит** иркьахуеит изусзо иарбану, насгьы
иануп.
- **Акәым аккомпани аппликациа** — ари аоператор изныҟәало ихароу адашьара,
ателефон клиент акәымкәа.
- **Host-native** — ауеит systemd аҵаҟа, аконтеинер аҩныҵҟа акәымкәа.
## Анаҩсыҟатәи
- [Адҵара & арҿыцрақәа](/en/v1.0/marketplace/install-updates)
- [Амаркетплейс ахцәажәареи аҩаӡарақәеи](/en/v1.0/marketplace/overview-tiers)
- Амобиль клиент: [iOS / амобиль ахьаԥс](/en/v1.0/plugins/ios-mobile)