የተቀመጡ መተግበሪያዎች - TeamSpeak¶

Այս հոդվածում

• TeamSpeak. Հիմնական գործառույթները
• Տեղակայման հնարավորություններ
• Ինչպես սկսել TeamSpeak-ը որպես Managed App տեղակայելուց հետո
• Ինչպես սկսել TeamSpeak-ը Marketplace-ից տեղակայելուց հետո
• Ts3-Manager-ի թարմացում
• Սերվերի միացում
• Ադմինիստրատորի իրավունքների հաստատում
• Web Control Panel-ին մուտք գործելը
• TeamSpeak-ի պատվիրումը API-ի միջոցով

TeamSpeak. Հիմնական գործառույթները¶

• Բարձրորակ ձայնային չաթ: TeamSpeak-ը ապահովում է հստակ և պարզ ձայնային փոխանցում օգտվողների միջև, ինչը կարևոր է խաղի ընթացքում համակարգման համար:
• Կապուկների համակարգ: Օգտվողները կարող են ստեղծել անսահմանափակ քանակությամբ կապուկներ և դրանք կազմակերպել հիერարխիկ խմբերի մեջ՝ թույլ տալով առանձին կապուկներ տարբեր թիմերի, խաղերի կամ առաջադրանքների համար:
• Իրավունքների կառավարում: Սերվերի ադմինիստրատորները կարող են օգտվողներին նշանակել տարբեր իրավունքներ, ինչպիսիք են կապուկ ստեղծելու, անդամներին հեռացնելու (kick out) և այլն:
• 3D Sound Support: TeamSpeak-ը տեղադրում է յուրաքանչյուր օգտվողի ձայնը վիրտուալ սենյակում՝ հեշտացնելով նավարկումը խաղի ընթացքում:
• Voice Chat Recording: Ձայնային զրույցների գրառման հնարավորություն՝ հետագայում լսելու կամ տարածելու համար:
• Cross-Platform: Հասանելի է Windows, MacOS, Linux և շարժական սարքերի համար:

Տեղակայման հնարավորություններ¶

• Տեղադրված ծրագրակազմը՝
  • Docker հետևյալ կոնտեյներներով՝
    • TeamSpeak Server (mbentley/teamspeak:latest image)
      • Ports: 9987 (UDP), 10011, 30033, 41144 (TCP)
    • TeamSpeak Manager (joni1802/ts3-manager image)
      • Port: 8080
    • Nginx Let's Encrypt-ով (jonasal/nginx-certbot image)
  • Docker Compose Plugin

TeamSpeak սերվերի աշխատողականությունը ստուգելու համար՝

1. Ստուգեք կոնտեյների կարգավիճակը.

   docker ps | grep teamspeak
   

2. Դիտարկեք կոնտեյների լոգերը (logs).

   docker logs teamspeak
   

3. Ստուգեք պորտերի հասանելիությունը.

   netstat -tulpn | grep -E '9987|10011|30033|41144'
   

Ինչպես սկսել TeamSpeak-ը որպես Managed App տեղակայելուց հետո¶

TeamSpeak-ը որպես managed app տեղակայելուց հետո, դուք կարող եք գտնել հետևյալ տվյալները Managed App բաժնում:

• application link;
• login և password մուտք գործելու համար;
• տեղեկատվություն ծրագրակազմի օգտագործման և կառավարման վերաբերյալ:

Managed apps-ի հետ աշխատանքի մասին հավելյալ մանրամասների համար տեսեք հրահանգները:

Ինչպես սկսել TeamSpeak-ը Marketplace-ից տեղակայելուց հետո¶

Պատվերը գնելուց հետո դուք կստանաք ծանուցում՝ գրանցման ժամանակ նշված էլեկտրոնային հասցեին, որը հաստատում է, որ ձեր սերվերը պատրաստ է օգտագործման համար: Այս ծանուցումը կներառի VPS IP հասցեն և մուտքի տվյալները (login credentials) միացման համար: Մեր ընկերության հաճախորդները կառավարում են սարքավորումները server management panel-ի և API-ի միջոցով՝ Invapi:

Ծառայությունն օգտագործելը սկսելու համար ներբեռնեք TeamSpeak client ձեր տեղական սարքի վրա և տեղադրեք այն:

Ts3-Manager-ի թարմացում¶

1. Ստեղծեք ընթացիկ կոնֆիգուրացիայի պահուստային պատճեն (backup)

   Պահպանեք տվյալները ընթացիկ կոնտեյների մասին: Անհրաժեշտության դեպքում վերականգնելու համար գործարկեք.

   docker inspect ts3-manager > /opt/ts3-manager-backup.json
   

   Ստուգեք տվյալները volume-ում.

   ls -l /opt/tsi-web
   

2. Կանգնեցրեք և հեռացրեք հին կոնտեյները

   Եթե ts3-manager կոնտեյները գոյություն ունի (նույնիսկ եթե docker ps-ը չի ցուցադրում այն), գործարկեք.

   docker stop ts3-manager
   

   docker rm ts3-manager
   

3. Վերջին Ts3-Manager v2.2.3 կոնտեյները գործարկեք

   docker run -d \
     --name ts3-manager \
     -p 8080:8080 \
     -v /opt/tsi-web:/app/data \
     -e PORT=8080 \
     -e JWT_SECRET=$(openssl rand -hex 32) \
     -e WHITELIST=teamspeak \
     --network bridge \
     --restart unless-stopped \
     joni1802/ts3-manager:v2.2.3
   

4. Ստուգեք գործարկումը

   Համոզվեք, որ կոնտեյները հաջողությամբ գործարկվել է.

   docker ps | grep ts3-manager
   

   docker logs ts3-manager
   

   Եթե թարմացումը հաջող էր, ապա՝
   • docker ps արդյունքում ts3-manager կոնտեյները պետք է լինի Up կարգավիճակում:
   • docker logs ts3-manager լոգերում պետք է հայտնվի հետևյալ նմանությամբ հաղորդագրություն.

     Server listening on http://127.0.0.1:8080
     

Սերվերի միացում¶

Սերվերին միանալու համար ձեզ անհրաժեշտ է՝

• Control panel-ում պատճենել Server IP Address-ը Network tab-ից — Server ID and IP Address.
• Կամընտիր - գրանցվել ձեր personal TeamSpeak account հաշվով: Սա կհեշտացնի սերվերի կառավարումը և կոնֆիգուրացիան:

• Կամընտիր - ավելացնել սերվերը ձեր personal TeamSpeak account հաշվին: Մուտքագրեք սերվերի IP հասցեն և պորտի համարը (9987), ինչպես նաև սերվերի անունը:

  

TeamSpeak client-ը ձեր տեղական սարքի վրա գործարկելուց հետո, մուտքագրեք սերվերի IP հասցեն ստորև նշված սկրինշոթում ցուցադրված դաշտում և սեղմեք Connect կոճակը.

Ադմինիստրատորի իրավունքների հաստատում¶

Administrator privileges-ը հաստատելու համար ձեզ անհրաժեշտ է միանալ սերվերին SSH-ի միջոցով և գործարկել հետևյալ հրամանը.

docker logs teamspeak | tail -n 50 | grep "password"

Այս հրամանի գործարկումը կցուցադրի հետևյալ կարևոր տվյալները՝

1. ServerQuery Admin Account-ի տվյալներ (հրամանների տողի միջոցով TeamSpeak 3 սերվերը վարելու համար):

   • Login: serveradmin;
   • Password (գեներացված համակարգի կողմից);
   • API key.

2. Privilege key (token)՝ վիրտուալ սերվերի վրա administrator privileges ստանալու համար:

Օրինակ ելքը կունենա այսպիսի տեսք.

Դուք պետք է պահպանեք այս տվյալները, քանի որ դրանք անհրաժեշտ կլինեն՝

• ServerQuery ինտերֆեյսին մուտք գործելու համար;
• Վիրտուալ սերվերի վրա administrator privileges ստանալու համար;
• Սերվերը API-ի միջոցով կառավարելու համար;
• TS3 Manager Web Interface-ի միջոցով սերվերի կառավարման համար:

Կարևոր է նշել, որ privilege key-ն կարող է օգտագործվել միայն մեկ անգครั้ง, իսկ ServerQuery գաղտնաբառը պետք է փոխվի առաջին մուտքից անմիջապես հետո:

TeamSpeak client-ում սեղմեք սերվերի անվան վրա և պատասխանեք "Yes" Is this your TeamSpeak server? հարցին.

Մուտքագրեք պատճենված key-ը.

Administrator privileges-ը հաստատելուց հետո դուք կարող եք ստեղծել նոր keys: Դա անելու համար՝

• Բացեք context menu-ն՝ սերվերի պատկերակի վրա աջ սեղմելով TeamSpeak-ի գլխավոր պատուհանում.
• Սերվերի settings-ում, գնացեք Show Privilege Keys tab:

• Սեղմեք Create կոճակը նոր privilege key գեներացնելու համար.

• Կբացվի պատուհան, որտեղ կարող եք ընտրել այն խումբը (group), որի համար ստեղծվում է key-ը: Հասանելի են հետևյալ տարբերակները՝

  • Server Admin: Խումբ՝ առավելագույն իրավունքներով, որն ունի լրիվ ադմինիստրատիվ վերահսկողություն սերվերի նկարով:
  • Normal: Խումբ՝ սահմանափակ իրավունքներով, նախատեսված սովորական օգտվողների համար:
  • Guest: Խումբ՝ նվազագույն իրավունքներով՝ հյուրային մուտքի համար:

• Ընտրեք այն խումբը, որի համար պետք է ստեղծեք privilege key.

• Description դաշտում մուտքագրեք ստեղծվող key-ի նպատակի մասին հակիրճ բացատրություն:
• Բացատրությունը մուտքագրելուց հետո սեղմեք Create կոճակը.

Նոր privilege key-ը կգեներացվի և կհայտնվի keys-ի ցանկում:

Դուք կարող եք օգտագործել ստեղծված key-ը՝ այս TeamSpeak սերվերի վրա օգտվողներին կամ ադմինիստրատորներին համապատասխան իրավունքներ տալու համար:

Web Control Panel-ին մուտք գործելը¶

• Server: Սերվերի IP հասցեն կամ սերվերի Domain անունը (առանց https://-ի): Դուք կարող եք պատճենել հասցեն control panel-ից Network tab-ում - Server IP Address;
• Port: 10011;
• Name: serveradmin;
• Password: Սերվերի ադմինիստրատորի գաղտնաբառը, որը ստացել եք նախկինում նշված եղանակով:

Հաջոց ավտենտիֆիկացիայից հետո դուք կունենաք հասանելիություն հետևյլ գործառույթներին՝

• Սերվերների ցանկ. Այս կենտրոնական կառավարման տարրը ցուցադրում է համակարգում գրանցված բոլոր TeamSpeak 3 սերվերները: Ադմինիստրատորները կարող են տեսնել ընդհանուր տեղեկատվություն յուրաքանչյուր սերվերի մասին, ներառյալ դրա աշխատանքային կարգավիճակը, միացված օգտվողների քանակը, uptime-ը և օգտագործված պորտերը: Հիմնական սերվերի կառավարումը իրականացվում է այս ինտերֆեյսով՝ start, stop, restart և հիմնական պարամետրերի կոնֆիգուրացիա:
• Սերվերի դիտարկիչ. Ինտերակտիվ գործիք սերվերի իրական ժամանակում վիզուալ մոնիթորինգի համար: Այն ցուցադրում է սերվերի channel-ների ծառե նման կառուցվածքը՝ ցույց տալով բոլոր միացված օգտվողներին և նրանց գործունեությունը: Հնարավորություն է տալ դարձել օգտվողների շարժումները channel-ներում, վերահսկել ձայնային ակտիվությունը և արձագնահանել տարբեր իրավիճակներին:
• Chat. Ներկառուցված ակնթարտես հաղորդագրությունների համակարգ, որը հեշտացնում է հաղորդակցությունը ադմինիստրատորների և սերվերի օգտվողների միջև: Աջակցում է թե՛ անձնական, թե՛ խմբային չաթերին, թույլ է տալիս փոխանակել ֆայլերը և օգտագործել տեքստային ձևաչափում (formatting): Այն պահպանում է չաթի պատմությունը հետագա վերլուծության համար:
• File Browser. Այս գործիքը կառավարում է TeamSpeak 3 սերվերի ֆայլային համակարգը: Մուտք գործեք վերբեռնված ֆայլեր, օգտվողների ավատարներ և այլ մեդիա ֆայլեր: Ադմինիստրատորները կարող են կառավարել սերվերի բովանդակությունը, վերահսկել սկավառակի տարածքի օգտագործումը և սահմանել ֆայլերի հասանելիության թույտվությունները:
• Server Log. Լոգավորման համակարգ, որը գրառում է սերվերի վրա տեղի ունեցող բոլոր իրադարձությունները: Այն գրառում է տեղեկատվություն օգտվողների միացումների, կոնֆիգուրացիայի փոփոխությունների, համակարգային իրադարձությունների և սխալների մասին: Կարևոր գործիք է խնդիրների հայտնաբերման և սերվերի անվտանգության մոնիթորինգի համար.
• Backup/Restore. Այս համապլական գործիքը ապահովում է տվյալների անվտանգությունը սերվերի վրա: Հնարավորություն է տալիս ստեղծել բոլոր կարգավորումների, տվյալների բազաների և օգտվողների տվյալների պահուստային պատճեններ (backups): Ներառում է ավտոմատ պահուստավորման և տվյալների վերականգնման գործառույթներ ձախողումների դեպքում:
• Server Query. Հզոր գործիք՝ սերվերի հետ անմիջական փոփոխակցության համար հրամանային ինտերֆեյսի միջոցով. Հնարավորություն է տալիս իրականացնել բարդ կառավարման գործողություններ՝ օգտագործելով հատուկ հրամաններ, ստանում է մանրամասն տեղեկատվություն սերվերի կարգավիճակի մասին և թույլ է տալիս կարգավորել պարամետրերը:
• Privilege Keys. Հասանելիության բացառիկ բանալիների կառավարման համակարգ: Այս ինտերֆեյսը ստեղծում և բաշխում է հատուկ key-ներ, որոնք օգտվողներին տալիս են սերվերի վրա որոշակի իրավունքներ և լիազորություններ:
• API Keys. Բաժին՝ ծրագրային փոփոխակցության համար նախատեսված key-ների կառավարման համար API-ի միջոցով: Հնարավորություն է տալիս ստեղծել և կոնֆիգուրացնել հասանելիության բանալիներ՝ TeamSpeak 3-ը արտաքին հավելվածներով և ծառայություններով ինտեգրելու համար:
• Ban List. Օգտվողների արգելքների կառավարման գործիք: Պարունակում է տեղեկատվություն արգելված օգտվողների, պատճառների և արգելքի տևողության մասին: Արդյունավետորեն վերահսկում է անցանկալի օգտվողների հասանելիությունը սերվեր:
• Complaints List. Օգտվողների բողոքների մշակման համակարգ: Ադմինիստրատորները կարող են տեսնել ներկայացված բողոքները, հետևել դրանց կարգավիճակին և ձեռնարկել անհրաժեշտ քայլեր հակամարտությունները լուծելու համար:
• List All Clients. Բոլոր այն օգտվողների ամբողջական ցանկը, որոնք երբևէ միացել են սերվերին: Ներառում է մանրամասն տեղեկատվություն յուրաքանչյուր client-ի մասին, ներառյալ միացման պատմությունը, օգտագործված նիկնեյմերը և տեխնիկական տվյալները:
• Server Groups. Օգտվողների խմբերի կառավարման գործիք սերվերի մակարդակում: Հնարավորություն է տալիս ստեղծել և կոնֆիգուրացնել տարբեր խմբեր՝ հատուկ իրավունքներով, ինչը պարզեցնում է մեծ թվով օգտվողների ադմինիստրացիան:
• Channel Groups. Խմբերի կառավարման համակարգ channel-ների մակարդակում: Հնարավորություն է տալիս կարգավորել հատուկ իրավունքներ օգտվողների համար՝ որոշակի channel-ներում կամ նրանց խմբերում.
• Permissions. Թույլտվությունների կարգավորման համապլական համակարգ: Հնարավորություն է տալիս մանրাকրկիտ կարգավորել մուտքի թույլտվությունները տարբեր օգտվողների խմբերի համար՝ սահմանելով նրանց հնարավորությունները սերվերում, channel-ներում և այլ օգտվողների հետ փոխհարաբերությունների ժամանակ.
• Logout. Ադմինիստրատորի սեզիայի անվտանգ ավարտելու գործառույթը: Ելքից հետո բոլոր ակտիվ միացումները ճիշտ փակվում են, և կարգավորումներում կատարված բոլոր փոփոխությունները պահպանվում են.

TeamSpeak-ի պատվիրումը API-ի միջոցով¶

Այս ծրագրակազմը API-ի միջոցով տեղադրելու համար հետևեք այս հրահանգներին.