> ## Documentation Index
> Fetch the complete documentation index at: https://www.sip.tg/llms.txt
> Use this file to discover all available pages before exploring further.

# Worker және Storage модульдері

export const bot = {
  ACTIVATE_TARIFF_PLAN: "Активировать подписку",
  ADDRESS: "Адрес",
  ADDRESS_PORT: "Адрес:порт",
  ADMIN_ASSIGN: "Назначить администратора",
  APPLY: "Применить",
  ARBITRARY_CHECK: "Обработка сообщений",
  AUTORENEW: "Автопродление",
  AUTOREPLY: "Автоответ",
  BACK: "Назад",
  BACK_TO_PAYMENT: "Вернуться к оплате",
  BALANCE_TRANSFER: "Перевести",
  BILLING: "Реквизиты",
  BTN_CHARGE_REDIRECT: "Подтвердить списание",
  BTN_EMPTY_BOT: "Inline бот",
  BTN_TARIFF_NEW: "Подключить",
  CALLBACK_CHECK: "Callback",
  CALLBACK_SWITCH_OFF: "Отключить режим Callback",
  CALLBACK_SWITCH_ON: "Включить режим Callback",
  CALLER_NAME: "Имя звонящего",
  CALLER_PHONE: "Номер звонящего",
  CANCEL: "Отмена",
  COMMENT: "Комментарий",
  CONFIGURE_ACCOUNT_ALLOW_EVERYBODY: "Разрешить звонки ото всех пользователей",
  CONFIGURE_ACCOUNT_ALLOW_P2P: "Разрешить P2P звонки ото всех",
  CONFIGURE_ACCOUNT_DISALLOW_GROUPS: "Запретить добавление в группы",
  CONFIGURE_ACCOUNT_OFF_OTHER_SESSIONS_CALLS: "Отключить звонки на других устройствах",
  COUNTRY: "Страна",
  DELETE: "Удалить",
  DESCRIPTION: "Описание",
  DIAL_RULES: "Правила набора",
  DOC_BTN_PROVIDE: "Предоставить документацию",
  DOMAIN: "Домен",
  DTMF_METHODS: "DTMF методы",
  FIELD_VALUE: "Поле:Значение",
  FORMATS: "Аудио кодеки",
  FW_ADD: "Добавить номер телефона",
  FW_ADD_OTHER: "Другой номер",
  FW_ADD_SELF: "Номер Telegram",
  FW_ANTISPAM: "Анти-спам",
  FW_BACK: "Назад",
  FW_BONUS_PROGRAM: "Реферальная программа",
  FW_CANCEL: "Отмена",
  FW_DELETE: "Удалить",
  FW_NAME: "Имя",
  FW_NO: "Нет",
  FW_PHONE_FORWARDING: "Напомнить номер",
  FW_RECORDER_CHAT: "Чат для записей",
  FW_RECORDER_CHECKBOX: "Запись звонков",
  FW_SELECT_COUNTRY: "Выбрать страну (регион)",
  FW_SHARE_PHONE: "Отправить номер телефона",
  FW_TELL_FRIENDS: "Рассказать друзьям",
  FW_YES: "Да",
  GATEWAY_IN_RESET: "Сбросить пароль",
  GATEWAY_IN_SHOW: "Показать аккаунт",
  GATEWAY_OUT_NUMBER: "Номер на АТС",
  GENERATE_NEW: "Сгенерировать новый",
  GIVE_ACCESS: "Предоставить доступ",
  GIVE_PHONE_NUMBER: "Предоставить номер телефона",
  HELP: "Помощь",
  INLINE_QUERY: "Inline запрос",
  INVOICE_BANK_IGNORE_CURRENT_RATE: "Игнорировать курс валюты",
  KEYPAD_IN: "DTMF вх.",
  KEYPAD_OUT: "DTMF исх.",
  KEYS_GET: "Получить ключи",
  KEYS_RESET: "Сбросить ключи",
  LEARN_ABOUT: "Узнать о SIP.TG",
  LINES: "Линии",
  LINES_CHECK: "Линии",
  LOGIN: "Логин",
  MANUAL: "Вручную",
  MODE_GATEWAY: "Режим Шлюз",
  MODE_SOFTPHONE: "Режим Софтфон",
  NAME: "Имя",
  NEW: "Новый",
  NEW_IN: "🆕 PBX→SIP․TG",
  NEW_IP: "🆕 IP⇿IP",
  NEW_OUT: "🆕 SIP․TG→PBX",
  NO: "Нет",
  PARALLEL_DECLINE: "Отклонить",
  PARALLEL_END: "Завершить",
  PARALLEL_SWITCH: "Переключить",
  PARALLEL_TRANSFER: "Перевести",
  PASSWORD: "Пароль",
  PAYER: "Плательщик",
  PAYSYSTEM_BTN_VERIFY: "Указать страну проживания",
  PAYSYSTEM_DOCS_PROVIDE: "Предоставить документы",
  PAYSYSTEM_METHOD: "Способ оплаты",
  PAY_TARIFF: "Оплатить",
  PROLONG: "Продлить",
  PROMO_BUTTON_EMPTY: "Код скидки",
  RECONNECT: "🔄 Переподключить",
  RECORDER_ACTIVATE: "🔴 Начать запись",
  RECORDER_ACTIVATE_FAILED: "⚠️ Начать запись",
  RECORDER_CHAT: "Чат для записей",
  RECORDER_CHECKBOX: "Запись звонков",
  RECORDER_DEACTIVATE: "🟥 Остановить запись",
  RECORDER_DEACTIVATE_RECONNECTING: "⌛ Остановить запись",
  RECORDER_LOCKED: "🔒 Запись ограничена",
  REDIAL: "Перезвонить",
  REDIAL_CHECK: "Перезвонить",
  REGISTRAR: "Прокси",
  REPEAT: "Повторить",
  SELECT_BOT: "Выбрать бота",
  SELECT_CHANNEL: "Выбрать канал",
  SELECT_CHAT: "Выбрать чат",
  SELECT_USER: "Выбрать пользователя",
  SERVER_FROM_TEMPLATE: "Шаблоны настроек",
  SESSION_BILLER_CHECK: "Использовать общую подписку",
  SESSION_CONFIGURE_ACCOUNT: "Настроить аккаунт Telegram",
  SESSION_LOGIN: "Подключить",
  SESSION_LOGOUT: "Отключить",
  SETTINGS: "Настройки",
  START_CALLING: "Перейти к звонкам",
  SUPPORT: "Поддержка",
  SWITCH_OFF: "Отключить",
  SWITCH_ON: "Включить",
  TAKE: "Получить",
  TARIFF_ACTIVATE_CHANGE_USER: "Изменить заказчика",
  TARIFF_ACTIVATE_USER: "Активировать заказчику",
  TARIFF_ACTIVATE_YOURSELF: "Активировать себе",
  TAX_ADDRESS: "Адрес",
  TAX_BUSINESS: "Бизнес",
  TAX_NAME: "Покупатель",
  TAX_NUMBER: "Налоговый номер",
  TERMINATE_SESSION: "Завершить сессию",
  TERMS_AGREE: "Соглашаюсь с Правилами и Условиями",
  TG_STORAGE_OFFICIAL: "✅ Хранилище сессий SIP․TG",
  TRANSFER: "Передать",
  TRANSFER_BACK: "Передать обратно",
  TRUSTED_IPS: "Доверенные IP",
  UNLINK: "Отвязать",
  USER: "Пользователь",
  VERIFY_ROUTE_BAD: "👎 Нет, это спам",
  VERIFY_ROUTE_GOOD: "👍 Да, всё хорошо",
  VERIFY_ROUTE_RECOVER: "Восстановить входящие звонки",
  WORKER_AUTO: "Автоматически",
  YES: "Да"
};

SIP.TG платформасы **өзіңіздің** серверлік модульдеріңізді іске қосу мүмкіндігін ұсынады:

* **Worker** — дауыстық деректерді өңдеу/түрлендіру үшін жауап береді (SIP ↔ Telegram).
* **Сессиялар қоймасы** (Storage) — Telegram аккаунттарына қол жеткізу кілттері мен деректерін сақтайды.

Бұл модульдерді Docker-контейнерінде өзіңіздің сервереңізде орналастыруға болады, бөлінген IP-мекенжаймен және қол жетімділігіне кепілдік беріледі. Төменде бұл қалай жұмыс істейтіні және реттеу үшін қандай қадамдар қажет екені сипатталған.

<a id="worker" />

## Worker-серверлер

<Info>
  Worker нақты уақыт режимінде SIP-тен Telegram форматына және кері аудио ағындарын өңдейді және түрлендіреді.
</Info>

<a id="worker-what-for" />

### Worker-серверлері не үшін қажет

* **Өнімділік кепілдігі**: сіз өзіңіз жабдықты таңдайсыз, қажетті жүктемеге бейімдейсіз.
* **Ең аз кідіріс**: RTT азайту үшін Worker-ді АТС-ке барынша жақын орналастыра аласыз.
* **Құпиялылық**: дауыс ағындары SIP.TG-нің жалпыға қолжетімді серверлеріне берілмейді — сіз аудио деректерді өзіңіз өңдейсіз.
* **Жеке желілерге қол жеткізу**: қажет болса, Worker жергілікті (шектеулі) желіде жұмыс істей алады және АТС-тен тікелей SIP-трафикті алады.

<a id="worker-requirements" />

### Жүйелік талаптар (Worker)

* Linux-серверде **Docker CE** және **Docker Compose** (мысалы, Ubuntu 22.04).
* SIP.TG-мен байланыс үшін бөлінген IP-мекенжай (немесе TCP порт пробросы).
* Болжалды өнімділік: 1 қоңырау ≈ AMD Ryzen 5 1400 бір ядросында 2.5% CPU, G.711 (A-law) пайдаланған кезде шамамен 1 МБ RAM.

<a id="worker-setup" />

### Жеке Worker реттеу

<Steps>
  <Step title="Сертификаттарды алу">
    1. [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) ботында `/workers` командасын орындаңыз және **{bot.NEW}** түймесін басыңыз.
    2. Сізге 2 файл жіберіледі: SIP.TG платформасымен қауіпсіз байланыс үшін жеке кілт және сертификат.
    3. Оларды сақтаңыз және үшінші тарапқа бермеңіз.
  </Step>

  <Step title="Серверді дайындау">
    1. ОЖ жаңартуларын орнатыңыз (қажет болған жағдайда).
    2. Docker және Docker Compose орнатыңыз.
    3. Worker конфигурациясының үлгісін клондаңыз немесе жүктеп алыңыз ([GitHub](https://github.com/siptg/worker) қараңыз).
    4. Боттан алынған сертификаттарды серверге көшіріңіз және Docker/Worker параметрлерінде оларға жолдарды көрсетіңіз.
    5. Қажет болса, `docker-compose.yml` файлындағы немесе тиісті конфигурацияларда параметрлерді өңдеңіз (SIP порты, RTP диапазоны және т.б.).
  </Step>

  <Step title="Worker іске қосу">
    1. Docker қызметін іске қосыңыз:

       ```bash theme={null}
       docker-compose up -d
       ```
    2. Worker контейнері сәтті іске қосылғанын және көрсетілген порттарды тыңдап тұрғанына көз жеткізіңіз.
    3. Қателер пайда болған жағдайда контейнер логтарын тексеріңіз (`docker-compose logs` командасы).
  </Step>

  <Step title="Worker-ге қосылу">
    1. [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) ботында `/workers` бөліміне қайтыңыз, құрылған Worker-ді таңдап, **{bot.ADDRESS}** түймесін басыңыз.
    2. Сервер қол жетімді сыртқы мекенжай мен портты енгізіңіз.
    3. SIP.TG байланысты тексеруі үшін **{bot.SWITCH_ON}** түймесін басыңыз. Егер бәрі дұрыс болса, Worker «Онлайн» мәртебесіне өтеді.
  </Step>
</Steps>

<a id="worker-mode" />

### Жалпыға қолжетімді немесе жеке режим

Worker қосылғаннан кейін көрсетуге болады:

* **Жеке** (белгіше 🔑) — Worker-ді тек иесі және әкімшілік жасалған Шлюз сессиялары пайдалана алады.
* **Жалпыға қолжетімді** (белгіше 🌐) — Worker барлық SIP.TG пайдаланушыларына қол жетімді болады.

<a id="worker-limitations" />

### Пайдаланушы Worker-леріне шектеулер

* **PBX→SIP.TG** типті қосылымдар пайдаланушы Worker-де әдепкі бойынша тыйым салынған.
* Worker 30 минуттан астам істен шыққан/қол жетімсіз болған жағдайда, платформа байланысты SIP аккаунттарын өшіре алады.

<a id="storage" />

## Telegram сессияларының қоймасы

<Info>
  Қойма (Storage) — Telegram-аккаунттарға кіру кілттері мен деректері сақталатын сервер. Онсыз Telegram сессиялары SIP.TG «бұлтында» сақталады, бірақ қаласаңыз, бәрін өзіңізде сақтай аласыз.
</Info>

<a id="storage-what-for" />

### Өзіңіздің қойманың қандай артықшылықтары бар

* **Толық бақылау**: Telegram аккаунттарына қол жеткізудің құпиялылығы, барлық кілттер сіздің сервереңізде сақталады.
* **Шектеусіз аккаунттар саны** (жазылымыңызды ескере отырып) бір қоймада.
* **Икемді реттеу**: командалар мен оқиғаларға шектеу.

<a id="storage-requirements" />

### Жүйелік талаптар

* Docker CE / Docker Compose (Linux).
* SIP.TG-мен байланыс үшін бөлінген IP-мекенжай (немесе TCP порт пробросы).
* Модуль TDLib кітапханасын қолданады, сондықтан 1-2 ГБ RAM жеткілікті (бірақ Telegram аккаунттарының санына байланысты).

<a id="storage-setup" />

### Жеке Қойманы реттеу

<Steps>
  <Step title="Сертификаттарды алу">
    1. [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) ботында `/storage` командасын орындап, **{bot.NEW}** түймесін басыңыз.
    2. Бот жеке кілт пен сертификат жібереді. Оларды серверде сақтаңыз.
  </Step>

  <Step title="Серверді дайындау">
    1. Docker / Docker Compose орнатыңыз және конфигурациялаңыз.
    2. Қойма конфигурациясының үлгісін клондаңыз ([GitHub](https://github.com/siptg/storage) қараңыз).
    3. Сертификаттарды тиісті каталогтарға орналастырыңыз (`docker-compose.yml` көрсетілгендей).
    4. Қажет болса, конфигурациялық файлдарды өңдеңіз (TCP порты, деректер базасы және т.б.).
  </Step>

  <Step title="Қойманы іске қосу">
    1. Конфигурация бар қалтада орындаңыз:

       ```bash theme={null}
       docker-compose up -d
       ```
    2. Қателер бар-жоғын тексеру үшін контейнер логтарын (`docker-compose logs`) тексеріңіз.
    3. Көрсетілген TCP портының сыртқы қол жетімді екеніне көз жеткізіңіз.
  </Step>

  <Step title="Қоймаға қосылу">
    1. [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) ботындағы `/storage` бөліміне оралып, өз қоймаңызды таңдап, **{bot.ADDRESS}** түймесін басыңыз.
    2. SIP.TG платформасы қосыла алатын сыртқы мекенжай мен портты көрсетіңіз.
    3. Қол жетімділікті тексеру үшін **{bot.SWITCH_ON}** түймесін басыңыз. Егер бәрі дұрыс болса, қойма Online режимінде болады.
  </Step>
</Steps>

<a id="storage-usage" />

### Қойманы пайдалану

* Жаңа Telegram сессиясын жасау кезінде (бот бөліміндегі `/gateway`) **өзіңіздің** Қойманы таңдаңыз.
* Жасалған сессияны басқа қоймаға **жылжыту мүмкін емес** бірақ SIP қосылымдарын жоймай сессияны қайта жасауға болады.

<a id="faq" />

## Жиі қойылатын сұрақтар (FAQ)

<AccordionGroup>
  <Accordion title="Егер менің Worker (немесе Storage) кенеттен қол жетімсіз болса не болады?">
    SIP.TG платформасы байланысты мезгілді түрде тексереді. Егер сервер 30 минуттан астам жауап бермесе, Worker/Storage «Өшірілген» мәртебесіне ауысады. Осы Worker арқылы жұмыс істейтін барлық SIP аккаунттары белсенді емес болады. Қойма — сұраныстарға қызмет көрсетуді тоқтатады. Сервердің қол жетімділігін қалпына келтіріп, модульді ботта қайтадан қосу арқылы жұмысты жалғастыруға болады.
  </Accordion>

  <Accordion title="Worker жеке Storage-сыз (немесе керісінше) қолдануға бола ма?">
    Иә. Бұл модульдер тәуелсіз. Telegram сессияларын SIP.TG бұлтында сақтай аласыз, бірақ SIP-ағындарды өз Worker-де өңдей аласыз. Немесе керісінше: жалпыға қолжетімді Worker-серверлерін пайдаланыңыз, бірақ сессияларды өзіңізде сақтаңыз.
  </Accordion>

  <Accordion title="Бұл модульдерге қызмет көрсету қаншалықты еңбекті қажет етеді?">
    Негізгі міндет — Docker контейнерлерін жұмыс жағдайында ұстау, жаңа нұсқалар шыққан сайын бағдарламалық жасақтаманы (Worker/Storage кескінін) жаңарту, желінің қол жетімділігін қадағалау. Егер сізде өзіңіздің DevOps маманы болмаса, SIP.TG жалпыға қолжетімді ресурстарын пайдалану оңайырақ.
  </Accordion>

  <Accordion title="Қауіпсіздік пен лицензиялау туралы не айтуға болады?">
    * SIP.TG платформасы мен сіздің модульдер арасындағы барлық байланыстар сертификаттар арқылы шифрленеді.
    * Әдетте Ubuntu негізіндегі Docker кескіндері қолданылады. Барлық қосымша тәуелділіктер алдын ала орнатылған.
    * Лицензия және пайдалану шарттарын GitHub репозиторийлерінен қараңыз.
  </Accordion>

  <Accordion title="Басқа пайдаланушыларға өз Worker-ме қол жеткізуді қалай ұсына аламын?">
    Worker режимін «Жалпыға қолжетімді» етіп өзгертіңіз. Сонда кез келген SIP.TG пайдаланушысы өзіне сіздің Worker-ді тағайындай алады. Сондай-ақ, Worker-ді «Жеке» күйінде қалдырып, оны боттағы кейбір SIP-аккаунттарыңызбен ғана пайдалана аласыз.
  </Accordion>
</AccordionGroup>

<Warning>
  Worker және Storage толыққанды жұмыс істеуі үшін SIP.TG платформасымен (менеджермен) тұрақты байланыс қажет. Сервер бұғаттаусыз интернетке қол жеткізе алатынына және порттар брандмауэрмен сүзілмейтіне көз жеткізіңіз.
</Warning>
