Worker және Storage модульдері
SIP.TG платформасы өзіңіздің серверлік модульдеріңізді іске қосу мүмкіндігін ұсынады:
- Worker — дауыстық деректерді өңдеу/түрлендіру үшін жауап береді (SIP ↔ Telegram).
- Сессиялар қоймасы (Storage) — Telegram аккаунттарына қол жеткізу кілттері мен деректерін сақтайды.
Бұл модульдерді Docker-контейнерінде өзіңіздің сервереңізде орналастыруға болады, бөлінген IP-мекенжаймен және қол жетімділігіне кепілдік беріледі. Төменде бұл қалай жұмыс істейтіні және реттеу үшін қандай қадамдар қажет екені сипатталған.
Worker-серверлер
Worker нақты уақыт режимінде SIP-тен Telegram форматына және кері аудио ағындарын өңдейді және түрлендіреді.
Worker-серверлері не үшін қажет
- Өнімділік кепілдігі: сіз өзіңіз жабдықты таңдайсыз, қажетті жүктемеге бейімдейсіз.
- Ең аз кідіріс: RTT азайту үшін Worker-ді АТС-ке барынша жақын орналастыра аласыз.
- Құпиялылық: дауыс ағындары SIP.TG-нің жалпыға қолжетімді серверлеріне берілмейді — сіз аудио деректерді өзіңіз өңдейсіз.
- Жеке желілерге қол жеткізу: қажет болса, Worker жергілікті (шектеулі) желіде жұмыс істей алады және АТС-тен тікелей SIP-трафикті алады.
Жүйелік талаптар (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.
Жеке Worker реттеу
Сертификаттарды алу
- @siptg_bot ботында
/workers
командасын орындаңыз және «Жаңа» түймесін басыңыз. - Сізге 2 файл жіберіледі: SIP.TG платформасымен қауіпсіз байланыс үшін жеке кілт және сертификат.
- Оларды сақтаңыз және үшінші тарапқа бермеңіз.
Серверді дайындау
- ОЖ жаңартуларын орнатыңыз (қажет болған жағдайда).
- Docker және Docker Compose орнатыңыз.
- Worker конфигурациясының үлгісін клондаңыз немесе жүктеп алыңыз (GitHub қараңыз).
- Боттан алынған сертификаттарды серверге көшіріңіз және Docker/Worker параметрлерінде оларға жолдарды көрсетіңіз.
- Қажет болса,
docker-compose.yml
файлындағы немесе тиісті конфигурацияларда параметрлерді өңдеңіз (SIP порты, RTP диапазоны және т.б.).
Worker іске қосу
-
Docker қызметін іске қосыңыз:
-
Worker контейнері сәтті іске қосылғанын және көрсетілген порттарды тыңдап тұрғанына көз жеткізіңіз.
-
Қателер пайда болған жағдайда контейнер логтарын тексеріңіз (
docker-compose logs
командасы).
Worker-ге қосылу
- @siptg_bot ботында
/workers
бөліміне қайтыңыз, құрылған Worker-ді таңдап, «Мекенжай» түймесін басыңыз. - Сервер қол жетімді сыртқы мекенжай мен портты енгізіңіз.
- SIP.TG байланысты тексеруі үшін «Қосу» түймесін басыңыз. Егер бәрі дұрыс болса, Worker «Онлайн» мәртебесіне өтеді.
Жалпыға қолжетімді немесе жеке режим
Worker қосылғаннан кейін көрсетуге болады:
- Жеке (белгіше «🔑») — Worker-ді тек иесі және әкімшілік жасалған Шлюз сессиялары пайдалана алады.
- Жалпыға қолжетімді (белгіше «🌐») — Worker барлық SIP.TG пайдаланушыларына қол жетімді болады.
Пайдаланушы Worker-леріне шектеулер
- PBX→SIP.TG типті қосылымдар пайдаланушы Worker-де әдепкі бойынша тыйым салынған.
- Worker 30 минуттан астам істен шыққан/қол жетімсіз болған жағдайда, платформа байланысты SIP аккаунттарын өшіре алады.
Telegram сессияларының қоймасы
Қойма (Storage) — Telegram-аккаунттарға кіру кілттері мен деректері сақталатын сервер. Онсыз Telegram сессиялары SIP.TG «бұлтында» сақталады, бірақ қаласаңыз, бәрін өзіңізде сақтай аласыз.
Өзіңіздің қойманың қандай артықшылықтары бар
- Толық бақылау: Telegram аккаунттарына қол жеткізудің құпиялылығы, барлық кілттер сіздің сервереңізде сақталады.
- Шектеусіз аккаунттар саны (жазылымыңызды ескере отырып) бір қоймада.
- Икемді реттеу: командалар мен оқиғаларға шектеу.
Жүйелік талаптар
- Docker CE / Docker Compose (Linux).
- SIP.TG-мен байланыс үшін бөлінген IP-мекенжай (немесе TCP порт пробросы).
- Модуль TDLib кітапханасын қолданады, сондықтан 1-2 ГБ RAM жеткілікті (бірақ Telegram аккаунттарының санына байланысты).
Жеке Қойманы реттеу
Сертификаттарды алу
- @siptg_bot ботында
/storage
командасын орындап, «Жаңа» түймесін басыңыз. - Бот жеке кілт пен сертификат жібереді. Оларды серверде сақтаңыз.
Серверді дайындау
- Docker / Docker Compose орнатыңыз және конфигурациялаңыз.
- Қойма конфигурациясының үлгісін клондаңыз (GitHub қараңыз).
- Сертификаттарды тиісті каталогтарға орналастырыңыз (
docker-compose.yml
көрсетілгендей). - Қажет болса, конфигурациялық файлдарды өңдеңіз (TCP порты, деректер базасы және т.б.).
Қойманы іске қосу
-
Конфигурация бар қалтада орындаңыз:
-
Қателер бар-жоғын тексеру үшін контейнер логтарын (
docker-compose logs
) тексеріңіз. -
Көрсетілген TCP портының сыртқы қол жетімді екеніне көз жеткізіңіз.
Қоймаға қосылу
- @siptg_bot ботындағы
/storage
бөліміне оралып, өз қоймаңызды таңдап, «Мекенжай» түймесін басыңыз. - SIP.TG платформасы қосыла алатын сыртқы мекенжай мен портты көрсетіңіз.
- Қол жетімділікті тексеру үшін «Қосу» түймесін басыңыз. Егер бәрі дұрыс болса, қойма Online режимінде болады.
Қойманы пайдалану
- Жаңа Telegram сессиясын жасау кезінде (
/gateway
режимінде) өзіңіздің Қойманы таңдаңыз. - Жасалған сессияны басқа қоймаға жылжыту мүмкін емес бірақ SIP қосылымдарын жоймай сессияны қайта жасауға болады.
Жиі қойылатын сұрақтар (FAQ)
Worker және Storage толыққанды жұмыс істеуі үшін SIP.TG платформасымен (менеджермен) тұрақты байланыс қажет. Сервер бұғаттаусыз интернетке қол жеткізе алатынына және порттар брандмауэрмен сүзілмейтіне көз жеткізіңіз.