ការដំណើរការម៉ាស៊ីនមេ

ការគ្រប់គ្រង និងការកំណត់

ទំព័រគ្រប់គ្រង ការបញ្ជូនលេខកូដចុះឈ្មោះ (SMS និងអ៊ីមែល) តម្លៃកំណត់របស់ម៉ាស៊ីនមេ ការបម្រុងទុក និងសុវត្ថិភាព — ឯកសារយោងសម្រាប់ប្រតិបត្តិករ។

ម៉ាស៊ីនមេមានទំព័រគ្រប់គ្រងដែលបើកដោយកម្មវិធីរុករក។ អ្នកអាចមើលស្ថានភាពម៉ាស៊ីនមេ កំណត់របៀបបញ្ជូនលេខកូដចុះឈ្មោះ និងចូលគណនី ហើយគ្រប់គ្រងអ្នកប្រើ និងបូត។ ឯកសារនេះជាឯកសារយោង ដែលប្រមូលទំព័រគ្រប់គ្រង និងតម្លៃកំណត់របស់ម៉ាស៊ីនមេ នៅកន្លែងតែមួយ។ បើអ្នកត្រូវដំឡើងជាមុនសិន សូមមើល ការដំឡើងម៉ាស៊ីនមេ។ ទំព័រគ្រប់គ្រងបង្ហាញជាភាសាកូរ៉េ ដូច្នេះឯកសារនេះដាក់ឈ្មោះភាសាកូរ៉េនៃផ្ទាំង ប៊ូតុង និងការកំណត់ ក្នុងវង់ក្រចក។

ការបើកទំព័រគ្រប់គ្រង

ទំព័រគ្រប់គ្រងគឺ /admin/ នៅលើច្រក HTTP សម្រាប់ការគ្រប់គ្រង (8080 ក្នុងរចនាសម្ព័ន្ធផលិតកម្ម) ហើយបើកតែនៅលើម៉ាស៊ីនមេខ្លួនឯង (127.0.0.1) ប៉ុណ្ណោះ។ ប្រតិបត្តិករចូលតាម SSH tunnel។

# នៅលើកុំព្យូទ័ររបស់ខ្ញុំ (ទុកឲ្យដំណើរការ)
ssh -N -L 8080:127.0.0.1:8080 <អ្នកប្រើ>@<ម៉ាស៊ីនមេ>
# កម្មវិធីរុករក៖ http://localhost:8080/admin/

# តូខឹន (នៅលើម៉ាស៊ីនមេ)
sudo cat /srv/pabal/pabal_server/data/admin-token

បញ្ចូលតូខឹន ហើយចុច បើក (열기)។ កម្មវិធីរុករកចងចាំតូខឹន ហើយអ្នកអាចលុបវាដោយ លុបតូខឹន (토큰 지우기) នៅជ្រុងខាងលើផ្នែកខាងស្តាំ។ បើចង់កំណត់តូខឹនដោយខ្លួនឯង សូមផ្តល់ TELEGRAM_ADMIN_TOKEN (16 តួឡើងទៅ) — ពេលនោះ ម៉ាស៊ីនមេនឹងមិនសរសេរឯកសារទេ។

អ្វីដែលបង្ហាញក្នុងផ្ទាំងនីមួយៗ

សកម្មភាពគ្រោះថ្នាក់ (ចាកចេញ ហាមឃាត់ បោះបង់លេខកូដ) ត្រូវចុចពីរដងទើបដំណើរការ។

លេខកូដចុះឈ្មោះ និងចូលគណនី

ពេលមនុស្សបញ្ចូលលេខទូរស័ព្ទក្នុងកម្មវិធី ម៉ាស៊ីនមេបង្កើតលេខកូដ ហើយផ្ញើវាតាមវិធីដែលបានជ្រើសក្នុងផ្ទាំងការកំណត់ (설정)។

• ក្នុងវិធីអ៊ីមែល ការចុះឈ្មោះថ្មីអាចប្រើអាសយដ្ឋានណាក៏បាន ហើយអាសយដ្ឋាននោះក្លាយជាអ៊ីមែលចូលគណនី (로그인 이메일) របស់គណនី។ គណនីដែលមានស្រាប់ ទទួលបានតែតាមអ៊ីមែលចូលគណនីដែលបានចុះបញ្ជីប៉ុណ្ណោះ — នេះការពារកុំឲ្យនរណាម្នាក់ដាក់អាសយដ្ឋានរបស់ខ្លួន លើលេខរបស់អ្នកដទៃ ដើម្បីចូល។ គណនីដែលមានស្រាប់ ហើយគ្មានអ៊ីមែលចូលគណនី នឹងទទួលតាម SMS (បើបានកំណត់) ឬតាមទំព័រគ្រប់គ្រងជំនួសវិញ។ អ្នកអាចបញ្ចូលអ៊ីមែលចូលគណនីឲ្យពួកគេ នៅក្នុងផ្ទាំងអ្នកប្រើ (사용자)។
• ការផ្ញើកើតឡើងនៅខាងក្រោយ ដូច្នេះកម្មវិធីទៅអេក្រង់លេខកូដភ្លាមៗ។ លទ្ធផលនៃការផ្ញើ (ជោគជ័យ ឬបរាជ័យ និងមូលហេតុ) បង្ហាញក្នុងផ្ទាំងលេខកូដចុះឈ្មោះ។
• ការចុះឈ្មោះ (ការបញ្ចូលឈ្មោះ) អាចធ្វើបានលុះត្រាតែបញ្ចូលលេខកូដត្រឹមត្រូវរួច។ លេខកូដខុសត្រូវបានទទួលតែតាមចំនួនដងដែលអនុញ្ញាតប៉ុណ្ណោះ ហើយក្រោយពីនោះ ទោះលេខកូដត្រឹមត្រូវក៏ត្រូវបដិសេធដែរ។
• ការប្ដូរលេខរបស់គណនី (ការកំណត់ → លេខទូរស័ព្ទ ក្នុងកម្មវិធី) ត្រូវបានបិទតាមលំនាំដើម ហើយកម្មវិធីបង្ហាញកំហុស។ ពេលបើកអនុញ្ញាតការប្ដូរលេខ លេខកូដទៅកាន់លេខថ្មីតាម SMS តែប៉ុណ្ណោះ មិនថាវិធីផ្ញើណាក៏ដោយ (ផ្ទាំងលេខកូដចុះឈ្មោះមិនបង្ហាញវាទេ ទោះបីបើកការបង្ហាញលេខកូដក៏ដោយ — អ្នកដែលទទួលវាពីទីនោះ ប្រហែលជាមិនមែនជាម្ចាស់លេខនោះទេ) ដោយមានអត្ថបទផ្ទាល់ខ្លួន គឺអត្ថបទប្ដូរលេខក្នុងការកំណត់ SMS (번호 바꾸기 문구; លំនាំដើម [파발] 번호 바꾸기 확인 코드: {code})។ គម្លាតផ្ញើឡើងវិញ និងចំនួនអតិបរមាក្នុងមួយថ្ងៃ អនុវត្តលើទាំងលេខថ្មី និងគណនី។ លេខដែលត្រូវហាមឃាត់ ឬផ្អាក និងលេខដែលគណនីផ្សេងកំពុងប្រើ ត្រូវបដិសេធទាំងពេលសុំលេខកូដ និងម្ដងទៀតពេលផ្លាស់ទៅ។ លេខកូដត្រូវតែសម្រាប់គណនីនោះ និងលេខនោះប៉ុណ្ណោះ ហើយប្រើបានតែម្ដង។ លេខកូដចូលរបស់អ្នកផ្សេងដែលកំពុងរង់ចាំលេខនោះ នៅដដែល។ ក្រោយផ្លាស់ លេខចាស់លែងចូលគណនីនោះបានទៀតហើយ។

ការកំណត់ — ការចុះឈ្មោះ និងការចូលគណនី

ការកំណត់ — SMS

ក្នុងអត្ថបទសារ អ្នកអាចដាក់ {code} (លេខកូដ) និង {minutes} (រយៈពេលមានសុពលភាព)។ តម្លៃលំនាំដើម៖ [파발] 인증 코드: {code} (មានន័យថា «[Pabal] លេខកូដផ្ទៀងផ្ទាត់៖ {code}»)។ បន្ទាប់ពីរក្សាទុក សូមពិនិត្យដោយការផ្ញើសាកល្បង (테스트 발송)។

ការកំណត់ — អ៊ីមែល (SMTP)

អាសយដ្ឋានអ្នកផ្ញើ ត្រូវតែជាអាសយដ្ឋានដែលគណនី SMTP អាចផ្ញើបាន។ ក្នុងប្រធានបទ និងតួអ៊ីមែល ក៏អាចប្រើ {code} និង {minutes} បានដែរ។

ការគ្រប់គ្រងអ្នកប្រើ

• ចាកចេញពីគ្រប់ឧបករណ៍ (모든 기기 로그아웃)៖ ផ្តាច់ការចូលគណនីទាំងអស់ (auth key) នៃគណនីនោះ។ ប្រើសម្រាប់អ្នកប្រើដែលបាត់ឧបករណ៍។
• ហាមឃាត់លេខ (번호 차단)៖ លេខនោះមិនអាចទទួលលេខកូដបានទេ ហើយគណនីនៃលេខនោះ ត្រូវចាកចេញពីគ្រប់ឧបករណ៍ភ្លាមៗ។ វាដូចគ្នានឹងបញ្ជីហាមឃាត់លេខទូរស័ព្ទ (전화번호 차단) ក្នុងផ្ទាំងការកំណត់ (설정)។
• អ៊ីមែលចូលគណនី (로그인 이메일)៖ ចាំបាច់ ដើម្បីឲ្យគណនីដែលមានស្រាប់ អាចចូលតាមអ៊ីមែល ក្នុងវិធីអ៊ីមែល។
• លុបគណនី (계정 삭제)៖ សម្រាប់អ្នកប្រើដែលបានស្នើសុំឲ្យលុបគណនីរបស់ខ្លួន បន្ទាប់ពីបានបញ្ជាក់ថាជាម្ចាស់ពិតប្រាកដ។ វាលុបដូចគ្នាទាំងស្រុងនឹងការលុបគណនីក្នុងកម្មវិធី ហើយមិនអាចត្រឡប់វិញបានទេ។ វាដំណើរការតែបន្ទាប់ពីវាយ ID ឬលេខទូរស័ព្ទរបស់គណនីម្តងទៀត ហើយសរសេរកំណត់ចំណាំអំពីកន្លែងដែលសំណើមកពី និងរបៀបដែលបានបញ្ជាក់អត្តសញ្ញាណ។ កំណត់ចំណាំត្រូវរក្សាទុកជាមួយ ID និងកាលបរិច្ឆេទ (លេខទូរស័ព្ទ អាសយដ្ឋានអ៊ីមែល និងឈ្មោះ និងឈ្មោះអ្នកប្រើរបស់គណនីត្រូវដកចេញ)។ សម្រាប់សំណើតាមអ៊ីមែលដែលមិនមែនមកពីអ៊ីមែលចូលរបស់គណនី សូមប្រើការផ្ញើលេខកូដបញ្ជាក់តាម SMS ក្នុងផ្ទាំងដដែល ដើម្បីផ្ញើលេខកូដទៅលេខរបស់គណនីនោះ ហើយវាយបញ្ចូលលេខកូដដែលអ្នកស្នើផ្ញើត្រឡប់មកវិញតាមអ៊ីមែល ដើម្បីបញ្ជាក់។ មិនអាចលុបបូត និងគណនីរបស់ម៉ាស៊ីនមេខ្លួនឯងនៅទីនេះបានទេ។
• @BotFather ជាបូតដែលនៅក្នុងម៉ាស៊ីនមេ ដូច្នេះមិនអាចធ្វើឲ្យវាចាកចេញបានទេ។

ការគ្រប់គ្រងបូត

នៅក្នុងផ្ទាំងបូត (봇) អ្នកអាចមើលវិធីតភ្ជាប់របស់បូតនីមួយៗ — ថាវាភ្ជាប់តាម MTProto ឬអត់ ថាវាបានហៅ getUpdates តាម HTTP ក្នុងរយៈពេល 1 នាទីចុងក្រោយឬអត់ និងអាសយដ្ឋាន webhook ជាអ្វី ហើយកំពុងបរាជ័យឬអត់ (រួមទាំងមូលហេតុ)។ បើ update ដែលកំពុងរង់ចាំចេះតែកើនឡើង មានន័យថាកម្មវិធីបូតបានឈប់ ឬ webhook កំពុងបរាជ័យ។ ការលុបបូត និងការចេញតូខឹនថ្មី ធ្វើដោយអ្នកបង្កើតបូត នៅ @BotFather។

ផ្ទាំងសំឡេង

នេះជាកន្លែងដំណើរការបូតសំឡេង (បូតដែលពេលមនុស្សហៅមក ម៉ូដែលសំឡេង AI ជាអ្នកឆ្លើយ — បូតសំឡេង)។ ផ្ទាំងនេះបង្ហាញជានិច្ច ទោះបីម៉ាស៊ីនមេមិនទាន់បើកសំឡេងក៏ដោយ ហើយផ្នែកស្ថានភាពប្រាប់ថាខ្វះអ្វីខ្លះ។ របៀបបើក សូមមើល ការដំឡើងម៉ាស៊ីនមេ — បូតសំឡេង។ វាធ្វើឲ្យស្រស់រៀងរាល់ 5 វិនាទី។

ការអនុញ្ញាតគឺជាការពិនិត្យ។ ក្នុងរបៀប «តែបូតដែលបានអនុញ្ញាត» ការអនុញ្ញាតបូតមួយ មានន័យថាអនុញ្ញាតសេចក្តីណែនាំ ពាក្យស្វាគមន៍ និងឧបករណ៍បច្ចុប្បន្នរបស់វា (បើជារបៀបសំឡេងដើម គឺអាសយដ្ឋានសំឡេងដើម)។ បើម្ចាស់បូតផ្លាស់ប្តូរណាមួយក្នុងចំណោមទាំងនោះ តារាងបូតបង្ហាញ «សេចក្តីណែនាំ · ពាក្យស្វាគមន៍បានផ្លាស់ប្តូរ — ត្រូវពិនិត្យ ហើយអនុញ្ញាតម្តងទៀត ទើបទទួលការហៅ» (지시문·인사말이 바뀜 — 확인하고 다시 허용해야 전화를 받습니다) ហើយបូតនោះមិនទទួលការហៅទេ រហូតដល់អ្នកចុច ពិនិត្យ ហើយអនុញ្ញាតម្តងទៀត (확인하고 다시 허용)។ ចំពោះបូតដែលភាសាបូតមិនមែនជាភាសាកូរ៉េ ឬអង់គ្លេស វាដូចគ្នា សូម្បីតែក្នុងរបៀប «បូតទាំងអស់ដែលបង្កើតដោយ @BotFather» ក៏ដោយ — ព្រោះការពិនិត្យច្បាប់ស្វ័យប្រវត្តិពេលរក្សាទុក អានបានតែភាសាកូរ៉េ និងអង់គ្លេសប៉ុណ្ណោះ។ តារាងនៃបូតបែបនោះបង្ហាញ «បូតដែលមិនមែនជាភាសាកូរ៉េ ឬអង់គ្លេស (ការពិនិត្យច្បាប់ស្វ័យប្រវត្តិអានមិនបាន)៖ សូមអានសេចក្តីណែនាំ និងពាក្យស្វាគមន៍ — ត្រូវពិនិត្យ ហើយអនុញ្ញាតម្តងទៀត ទើបទទួលការហៅ» (한국어·영어가 아닌 봇 (자동 규칙 검사가 읽지 못함): 지시문·인사말을 읽어 주세요 — 확인하고 다시 허용해야 전화를 받습니다) ដូច្នេះសូមឲ្យអ្នកដែលអានភាសានោះបាន អានសេចក្តីណែនាំ និងពាក្យស្វាគមន៍ ហើយអនុញ្ញាត។

• មួយថ្ងៃត្រូវបានគិតតាមតំបន់ម៉ោងរបស់ម៉ាស៊ីនមេ (TELEGRAM_VOICE_TIME_ZONE, លំនាំដើម Asia/Seoul)។ ពេលទទួលការហៅ ម៉ាស៊ីនមេកំណត់រយៈពេលអតិបរមាក្នុងពេលវេលាដែលនៅសល់នៃថ្ងៃនោះ ហើយបម្រុងវាទុកក្នុងដែនកំណត់ទាំងអស់ ហើយពេលបញ្ចប់ វាគិតតែវិនាទីពិតប្រាកដតាមនាឡិការបស់ម៉ាស៊ីនមេប៉ុណ្ណោះ។ ការហៅដែលទទួលដោយសោផ្ទាល់ខ្លួនរបស់ម្ចាស់បូត ប្រើតែដែនកំណត់របស់អ្នកហៅប៉ុណ្ណោះ។
• ម្ចាស់បូតអាចកំណត់រយៈពេលនៃការហៅមួយ (លំនាំដើម 300 វិនាទី) និងចំនួនការហៅក្នុងពេលតែមួយរបស់បូតខ្លួន បានតែក្នុងដែនកំណត់ទាំងនេះប៉ុណ្ណោះ។
• រាល់សកម្មភាព (កុងតាក់បិទបន្ទាន់ ការបើកជាសាធារណៈ ការអនុញ្ញាត ការផ្អាក ការផ្តាច់ ដែនកំណត់ …) ត្រូវបានកត់ត្រាក្នុងកំណត់ត្រាសកម្មភាពនៃផ្ទាំងលេខកូដចុះឈ្មោះ (가입 코드) ជា 음성: … (មានន័យថា «សំឡេង៖ …»)។
• តួលេខគុណភាពនៃការហៅជាសំឡេង (ពេលវេលារហូតដល់សំឡេងដំបូង ពេលវេលារហូតដល់ឈប់ពេលត្រូវបានកាត់សម្តី ពេលឆ្លើយរបស់ឧបករណ៍ ជាដើម) មិនមាននៅក្នុងផ្ទាំងនេះទេ មានតែនៅ /metrics នៃច្រកគ្រប់គ្រងប៉ុណ្ណោះ (ឈ្មោះដែលចាប់ផ្តើមដោយ voice. ក្នុង JSON និងដោយ voice_ ក្នុងទម្រង់ Prometheus /metrics?format=prometheus)។ គ្មានព័ត៌មានអំពីមនុស្ស បូត ឬពាក្យសម្តីទេ មានតែចំនួនសរុប។

អ្នកក៏អាចធ្វើការងារដដែលតាម API គ្រប់គ្រងបានដែរ (ទាំងអស់ត្រូវការ Authorization: Bearer <តូខឹន>)៖ GET /admin/api/voice, GET /admin/api/voice/bots/<id> និងប្រើ POST សម្រាប់ voice/kill {"on": true}, voice/launch {"launched": true, "confirm": "…"}, voice/transcripts {"allowed": true, "confirm": "…"}, voice/testers·voice/testers/remove {"userId": …}, voice/gate {"botGate": "ALLOWLIST"}, voice/bots/allow·voice/bots/disallow {"botId": …}, voice/bots/<id>/suspend {"reason": "…"}·…/lift·…/name-exempt, voice/calls/<id>/end ហើយដែនកំណត់ប្រើ /admin/api/settings/voice។ ការហៅពីបូត៖ voice/outbound {"on": true, "confirm": "…"}, voice/outbound/settings {"countries": […], "limits": {…}}, GET /admin/api/voice/outbound/bots/<id>, voice/outbound/bots/allow {"botId": …, "expect": "<outboundReviewHash>"}·voice/outbound/bots/disallow, voice/outbound/bots/<id>/lift។

អថេរបរិស្ថាន

ម៉ាស៊ីនមេអានឯកសារកំណត់ (server-config.json) រួចសរសេរជាន់ដោយអថេរបរិស្ថាន។ ដោយសារឯកសារ compose ផលិតកម្មកំណត់តម្លៃខាងក្រោមឲ្យរួចហើយ ជាធម្មតាអ្នកគ្រាន់តែកែ .env ប៉ុណ្ណោះ។

អថេរបរិស្ថាន — បូតសំឡេង

ក្នុងផលិតកម្ម ឯកសារបន្ថែម deploy/docker-compose.voice.yml កំណត់ផ្នែកខ្លះនៃអថេរទាំងនេះពីតម្លៃក្នុង .env — តំណ ការបញ្ជូនបន្ត តំបន់ម៉ោង ដែនកំណត់ អ្នកសាកល្បង និង build អប្បបរមា ហើយអថេរដែលនៅសល់ត្រូវបន្ថែមតាមមុខងារនីមួយៗ ក្រោយការពិនិត្យដាច់ដោយឡែក (ការដំឡើងម៉ាស៊ីនមេ — បូតសំឡេង)។ ការកំណត់ VOICE_* របស់ gateway (pabal-voice) មាននៅក្នុង voice/README.md នៃឃ្លាំងកូដ។

ឯកសារទិន្នន័យ

កំណត់ចំណាំសុវត្ថិភាព

• កុំបើកច្រកគ្រប់គ្រងទៅអ៊ីនធឺណិតដោយផ្ទាល់។ Caddy ក្នុងរចនាសម្ព័ន្ធផលិតកម្ម រារាំងផ្លូវគ្រប់គ្រង ដូចជា /admin, /health, /metrics ដោយ 404។
• សំណើទិន្នន័យគ្រប់គ្រងទាំងអស់ ត្រូវការ Authorization: Bearer <តូខឹន> ហើយទំព័រនៃគេហទំព័រផ្សេងមិនអាចអានវាបានទេ។
• តម្លៃសម្ងាត់ SMS និង SMTP មានតែនៅក្នុង operations.json ហើយអេក្រង់ និង API ប្រាប់ត្រឹមតែ «បានរក្សាទុក» (저장됨) ប៉ុណ្ណោះ។ បើទុកប្រអប់តម្លៃសម្ងាត់ទទេ ហើយរក្សាទុក តម្លៃចាស់នៅដដែល។
• តូខឹន និងតម្លៃសម្ងាត់ មិនត្រូវបានកត់ក្នុង log ទេ ហើយលេខទូរស័ព្ទក្នុង log ត្រូវបានលាក់មួយផ្នែក។ អាសយដ្ឋាន Bot API (ដែលមានតូខឹន) ក៏មិនត្រូវបានកត់ក្នុង log ដែរ។
• តូខឹនឧបករណ៍នៃការជូនដំណឹង push ត្រូវបានកត់ក្នុង log ត្រឹមជា fingerprint ប៉ុណ្ណោះ ហើយខ្លឹមសារឯកសារសោ Firebase និងខ្លឹមសារការជូនដំណឹង មិនត្រូវបានកត់ក្នុង log ទេ។
• ដោយសារ auth key ស្ថិតនៅក្នុង DB អ្នកណាដែលអាចចូល DB បាន អាចឌិគ្រីបចរាចរណ៍របស់អ្នកប្រើបាន។ សូមការពារ DB និងការបម្រុងទុក ឲ្យបានដូចសោ RSA ដែរ។

ដែនកំណត់

• លេខកូដដែលកំពុងរង់ចាំ និងកំណត់ត្រាថ្មីៗ ស្ថិតនៅក្នុងអង្គចងចាំ ដូច្នេះវានឹងបាត់ពេលម៉ាស៊ីនមេចាប់ផ្តើមឡើងវិញ (គ្រាន់តែស្នើម្តងទៀតពីកម្មវិធី)។
• ការផ្ញើពិតប្រាកដរបស់អ្នកផ្តល់សេវា SMS ត្រូវតែពិនិត្យជាមួយគណនីរបស់អ្នកផ្តល់សេវានីមួយៗ។ ម៉ាស៊ីនមេបង្កើតសំណើតាមឯកសាររបស់អ្នកផ្តល់សេវានីមួយៗ។
• អ្វីដែលមិនទាន់មាន៖ ការលុបបូតដោយបង្ខំ ការមើលសារ ការមើល log ក្រាហ្វ និងស្ថិតិការជូនដំណឹង push (push ត្រូវពិនិត្យតាម log របស់ម៉ាស៊ីនមេ)។