এই পৃষ্ঠার কিছু অংশ এখনও ইংরেজিতে রয়েছে: অনুবাদ করার পর মূল ইংরেজি সংস্করণটি পরিবর্তিত হয়েছে।
তথ্যসূত্র / সংগ্রহ করুন
Telegram · ওয়ার্কফ্লো এবং অপারেশনসমূহ
প্যানেলের দৈনন্দিন পরিচালনা: মোড, পর্যবেক্ষণ বিভাগ, প্যারামিটার, বিজ্ঞপ্তি, রপ্তানি, ব্যাকআপ এবং ধারণক্ষমতা।
টিজিউইটনেস / ডকুমেন্টেশন · নিয়োগ এবং পুনরুদ্ধার
আপনার প্রথম সংযোগের জন্য, অ্যাকাউন্ট এবং সেশন ফরম্যাট ব্যবহার করুন। সংরক্ষিত সংস্করণ, ইভেন্ট নীতি এবং ফাঁক সম্পর্কে ব্যাখ্যার জন্য, সংগ্রহ কীভাবে কাজ করে দেখুন। এই গাইডে দৈনন্দিন পরিচালনা এবং পুনরুদ্ধার অন্তর্ভুক্ত রয়েছে।
একটি পরিচালিত ইনস্টলেশনে থাকে START-HERE.html এবং START-HERE.txt এর লঞ্চারের পাশে, ইনস্টলেশন পথ অনুযায়ী তৈরি করা রিপোজিটরি লিঙ্ক এবং কমান্ডসহ। tgwitness guide --print SSH-এ চালান, অথবা tgwitness paths ব্যবহার করে প্রকৃত ডেটা ডিরেক্টরি খুঁজে বের করুন। একটি রুট systemd ইনস্টলেশন /var/lib/tgwitness-…-এর অধীনে ব্যক্তিগত অবস্থা সংরক্ষণ করে; /opt/tgwitness প্রোগ্রামটিকে ধারণ করে।
একটি পরিচালিত অস্থায়ী Cloudflare টানেলের জন্য, tgwitness tunnel off পাবলিক
অ্যাক্সেস বন্ধ করে, যখন স্থানীয় প্যানেল এবং সংগ্রহ চলতেই থাকে। tgwitness tunnel on
এটি সক্ষম করে; tgwitness tunnel restart একটি নতুন টানেল সংযোগ তৈরি করে। এর বর্তমান ঠিকানা দেখতে
tgwitness open ব্যবহার করুন। একটি স্পষ্ট বন্ধ সেটিংস সার্ভিস রিস্টার্টের পরও টিকে থাকে। tgwitness stop প্যানেল এবং সংগ্রহ উভয়ই বন্ধ করে।
এই পৃষ্ঠায়
অপারেটর কর্মপ্রবাহ#
ডায়াগ্রাম টেক্সট হিসেবে
- স্টোরেজ এবং কী সুরক্ষা নির্বাচন করুন → টোকেন দিয়ে প্যানেলটি খুলুন
- টোকেন দিয়ে প্যানেলটি খুলুন → একটি ওয়ার্কস্পেস নির্বাচন করুন
- একটি ওয়ার্কস্পেস নির্বাচন করুন → সরাসরি বা প্রক্সি রুট কনফিগার করুন
- সরাসরি বা প্রক্সি রুট কনফিগার করুন → ফোন নম্বর লিখুন অথবা ফাইল/কিউআর নির্বাচন করুন
- ফোন নম্বর লিখুন অথবা ফাইল/কিউআর নির্বাচন করুন → অ্যাকাউন্টের পরিচয় যাচাই করুন এবং প্রবেশযোগ্য গ্রুপগুলো নির্বাচন করুন
- অ্যাকাউন্টের পরিচয় যাচাই করুন এবং প্রবেশযোগ্য গ্রুপগুলো নির্বাচন করুন → ইভেন্ট এবং সংযুক্তি নীতি সংরক্ষণ করুন, তারপর পর্যবেক্ষণ শুরু করুন
- ইভেন্ট এবং সংযুক্তি নীতি সংরক্ষণ করুন, তারপর পর্যবেক্ষণ শুরু করুন → ত্রুটি, অ্যাক্সেস, সারিবদ্ধতা এবং ডিস্ক মনিটর করুন
- ত্রুটি, অ্যাক্সেস, সারিবদ্ধতা এবং ডিস্ক মনিটর করুন → স্বতন্ত্র চেকপয়েন্ট বজায় রাখুন
- স্বতন্ত্র চেকপয়েন্ট বজায় রাখুন → উপাদান রপ্তানি ও যাচাই করুন
অনুমতি, পরিবহন সংযোগ, একটি গ্রুপে অ্যাক্সেস এবং ডেলিভারির পরিপূর্ণতা—এসব ভিন্ন বৈশিষ্ট্য। সবুজ সংযোগ স্থিতি মানে এই নয় যে সব ইভেন্ট ধরা হয়েছে।
মূল চাবি শেয়ার না করেই কাজ শেয়ার করুন#
অধিক টুল খুলুন → পর্যালোচক বা বিশ্লেষককে তাদের নিজস্ব টোকেন দেওয়ার জন্য অ্যাক্সেস দিন। তারা যে অ্যাকাউন্ট এবং চ্যাট খুলতে পারবে তা নির্বাচন করুন, তারপর দেখার, রপ্তানি বা অপারেশনাল ক্রিয়া অনুমোদন করুন। সংগ্রহ শুরু/বন্ধ করা অপারেটরকে পুরো ওয়ার্কস্পেস অ্যাক্সেসের প্রয়োজন; একজন পর্যালোচককে একটি একক চ্যাটে সীমাবদ্ধ রাখা যেতে পারে। সেশন সীমা, মেয়াদোত্তীর্ণ এবং আইপি নিয়ম টেলিগ্রাম অ্যাকাউন্ট অনুমোদন থেকে আলাদা। অ্যাক্সেস এবং অনুমতি দেখুন।
সংযোগ শেষ করতে Open সেশন ব্যবহার করুন অথবা সমস্ত সেশন শেষ করতে অ্যাক্সেস প্রত্যাহার করুন। প্রশাসক কনসোল বিভিন্ন ওয়ার্কস্পেস জুড়ে চলমান প্রক্রিয়ার কার্যক্রম একত্রিত করে। সেশন বন্ধ করার ফলে সংগ্রহ চলতে থাকে।
রuntime মোডসমূহ#
| মোড | ক্রিয়া | আচরণ |
|---|---|---|
| ডেমো | scripts\Demo.cmd অথবা --demo |
কৃত্রিম ডেটা; বাস্তব অ্যাকাউন্ট সংযোগ অক্ষম |
| পর্যবেক্ষণ | পর্যবেক্ষণ শুরু করুন | নির্বাচিত উৎসের জন্য আপডেটগুলি রেকর্ড করুন। |
| ইতিহাসের সংক্ষিপ্ত চিত্র | চ্যাট → চ্যাট অ্যাকশন → ইতিহাস লোড করুন | বর্তমান বার্তাগুলি সর্বোচ্চ ৫০০টি; অতীতের সমস্ত পরিবর্তনের পুনর্গঠন নেই |
| বিরতি | পর্যবেক্ষণ বিরতি দিন | ডেটা এবং সারিতে থাকা কাজগুলো সংরক্ষণ করে সংগ্রহ বন্ধ করুন। |
| পর্যালোচনা/হ্যান্ডওভার | রপ্তানি | ZIP, JSONL/CSV/HTML, চেকপয়েন্ট, রসিদ প্রক্রিয়াকরণ এবং টাইমস্ট্যাম্প অনুরোধ |
| অনেকগুলো অ্যাকাউন্ট | ওয়ার্কস্পেস বা উপরের + বোতাম | একটি প্রক্রিয়ায় অসংখ্য পৃথক কর্মস্থান |
স্থানীয় ডেমো অ্যাক্সেস স্বয়ংক্রিয়ভাবে খুলে যায়, ম্যানুয়ালি টোকেন প্রবেশ করানোর প্রয়োজন নেই। এটি একটি প্রক্রিয়া-কালীন সক্ষমতা ব্যবহার করে, যা শুধুমাত্র একটি বিচ্ছিন্ন সিন্থেটিক ডেমোতে সরাসরি লুপব্যাক অ্যাক্সেসের জন্য বৈধ; প্রধান প্যানেলের টোকেন প্রকাশ করা হয় না। বাস্তব ওয়ার্কস্পেস এবং দূরবর্তী বা প্রক্সি করা ডেমো অ্যাক্সেস টোকেন প্রমাণীকরণ বজায় রাখে। ডেমো প্রবেশের ফলে টেলিগ্রামে কোনো অনুমোদন প্রদান করা হয় না।
মনিটরিং বিভাগসমূহ#

More tools → Sources → Recording → Choose which changes to preserve-এ, নতুন বার্তা, সম্পাদনা, মোছার বিজ্ঞপ্তি, প্রতিক্রিয়া আপডেট এবং সদস্যতা ইভেন্ট পৃথকভাবে নির্বাচন করুন। ডিফল্ট সব বিভাগই রাখে। Messages, edits & deletions মূল প্রসঙ্গ রাখে অথচ পৃথক প্রতিক্রিয়া/সদস্য আপডেট নিষ্ক্রিয় করে। All visible activity সব পাঁচটিই পুনরুদ্ধার করে। Presets ফর্ম পরিবর্তন করে; প্রয়োগ করতে Save recording settings চাপুন।
সেভ করা নীতি সেই ওয়ার্কস্পেসে নির্বাচিত সকল উত্সে প্রযোজ্য। অন্যান্য ওয়ার্কস্পেস তাদের নিজস্ব সেটিংস বজায় রাখে। প্রতিটি প্রকৃত পরিবর্তন স্বাক্ষরিত আগে/পরে মান রেকর্ড করে; বর্তমান নীতি প্রক্রিয়া রসিদ এবং পর্যবেক্ষণ শুরু রেকর্ডেও অন্তর্ভুক্ত থাকে। একটি বিভাগ নিষ্ক্রিয় করলে পূর্বের পর্যবেক্ষণ মুছে যায় না। পুনরায় সক্রিয় করলে মিস হওয়া পরিবর্তনগুলো ফিরে আসে না। এই সংস্করণে গ্রুপ-ভিত্তিক ক্যাটাগরি ওভাররাইড নেই।
যখন পূর্ববর্তী বিষয়বস্তু গুরুত্বপূর্ণ, তখন নতুন বার্তা সক্রিয় রাখুন: মুছে ফেলার বিজ্ঞপ্তি কখনোই ধারণ করা হয়নি এমন টেক্সট পুনরুদ্ধার করতে পারে না। অপারেশনাল/কভারেজ রেকর্ড এবং অন্যান্য গ্রুপ সার্ভিস ইভেন্ট সবসময় সংরক্ষিত থাকে। স্পষ্ট ইতিহাসের স্ন্যাপশটগুলো লাইভ-শ্রেণী নির্বাচন থেকে পৃথক এবং এতে সার্ভিস মেসেজও থাকতে পারে। এই সুইচগুলো অন্যথায় ধারণকৃত টেলিগ্রাম অবজেক্টে এমবেডকৃত প্রতিক্রিয়া/সদস্য মেটাডেটা মুছে ফেলে না।
ইতিহাস স্ন্যাপশট বিরতিতে থাকা অবস্থায় সংযুক্তিগুলো সারিতে রাখতে পারে। সেগুলো প্রক্রিয়া করতে পর্যবেক্ষণ শুরু করুন। সারিতে রাখা মানে ডাউনলোড করা হয়েছে এমন নয়। অনুপলব্ধ মূল ফাইলটি নতুন সম্পাদিত সংস্করণ দিয়ে প্রতিস্থাপিত হয় না; ফলাফলগুলো আলাদাভাবে রেকর্ড করা হয়।
লক ব্রাউজার অ্যাক্সেস এবং গোপন ক্ষেত্রগুলো বন্ধ করে, কিন্তু কালেকশন চলমান রাখে। ট্যাব বন্ধ করলেও প্রক্রিয়াটি চলমান থাকে। পাইথন প্রক্রিয়া বা সার্ভিস বন্ধ করলে, ব্রাউজারের অবস্থা যাই হোক না কেন, কালেকশন বন্ধ হয়ে যায়।
একটি অতিরিক্ত কর্মক্ষেত্র তখনই মুছে ফেলা যাবে যখন এর জার্নাল এবং কেস বোর্ডের নোটসমূহ অন্তর্ভুক্ত করে স্বাক্ষরিত একটি ZIP বা ASiC-E কন্টেইনার সম্পূর্ণরূপে ডাউনলোড হয়ে যাবে। শুধুমাত্র আর্কাইভ প্রস্তুত করলেই হবে না: সেটআপ ইভেন্টের বাইরে কোনো রেকর্ড বা ডাউনলোডের পরে যোগ করা কোনো নোট থাকলে 'মুছে ফেলা' অপশনটি অনুপলব্ধ থাকবে।
যখন প্যানেলটি ফাইলটি নিজেই গ্রহণ করে, এটি প্রতিটি বাইট পাওয়ার পরেই রপ্তানি গণনা করে, এবং তারপর আকারটি POST /api/exports/{id}/received-এ রিপোর্ট করে; বিচ্ছিন্ন হয়ে যাওয়া ডাউনলোড গণনা করা হয় না। ব্রাউজার সেভ পিকার (ফাইল সিস্টেম অ্যাক্সেস) ব্যবহারের ক্ষেত্রে, প্যানেলটি ফাইলটি লেখা ও বন্ধ হওয়ার পর এটি রিপোর্ট করে। এটি ছাড়া, প্যানেলটি প্রাপ্ত ফাইলটি ব্রাউজারের ডাউনলোড তালিকায় হস্তান্তর করে এবং দেখতে পারে না যে ব্রাউজারটি এটি সংরক্ষণ করেছে কিনা, উদাহরণস্বরূপ যখন এর সেভ ডায়ালগ বাতিল করা হয়; তখন প্যানেলটি বলে যে ডাউনলোড শুরু হয়েছে, ফাইলটি সংরক্ষিত হয়েছে তা নয়। ব্রাউজার যখন নিজেই একটি ফাইল ডাউনলোড করে (প্যানেলের ব্রাউজার বাফারের চেয়ে বড় একটি এক্সপোর্ট) এবং অন্য কোনো HTTP ক্লায়েন্টের ডাউনলোড, তখন সেগুলো গণনা করা হয় যখন সার্ভার পুরো রেসপন্স পাঠিয়ে দেয়। অপারেটিং সিস্টেম এবং একটি রিভার্স প্রক্সি কয়েক মেগাবাইট রেসপন্স বাফার করে, তাই এই ডাউনলোডগুলোর ক্ষেত্রে সার্ভার শেষের দিকে কোনো বিঘ্ন দেখতে পায় না। প্যানেল যদি না জানায় যে ফাইলটি সংরক্ষিত হয়েছে, মুছে ফেলার আগে ডাউনলোড করা ফাইলটি পরীক্ষা করুন। একটি গ্রুপ এক্সপোর্ট প্রস্তুত হওয়ার সাথে সাথেই ডাউনলোড করলে তা তার অ্যাকাউন্টের জন্য গণনা করা হয়; 'প্রস্তুত এক্সপোর্ট' থেকে পুনরায় ডাউনলোড করলে তা গণনা করা হয় না।
মুছে ফেলার আগে, প্যানেল শেষবার ডাউনলোড করা স্বাক্ষরিত আর্কাইভের ফরম্যাট, আকার, প্রস্তুতি সময় এবং SHA-256 দেখায় এবং নিশ্চিত করতে বলে যে এই আর্কাইভটি ওয়ার্কস্পেসের বাইরে সংরক্ষিত আছে। সার্ভার
DELETE /api/profiles/{id} অনুরোধ প্রত্যাখ্যান করে যদি kept_copy সেই SHA-256-এ সেট না করা থাকে (অথবা ফিঙ্গারপ্রিন্ট রেকর্ড হওয়ার আগে ডাউনলোড করা আর্কাইভের ক্ষেত্রে confirmed সেট না থাকলে)।
অতিরিক্ত একটি ওয়ার্কস্পেস মুছে ফেলা তার কালেক্টরকে থামিয়ে দেয় এবং স্থানীয় ডেটা মুছে ফেলে। যদি কোনো লকড ফাইল বা ফাইলসিস্টেম ত্রুটি অপসারণে বাধা দেয়, প্যানেল ব্যর্থতার প্রতিবেদন দেখায় এবং ওয়ার্কস্পেসটিকে অনুপলব্ধ (DeletionPending) হিসেবে তালিকাভুক্ত রাখে। এর ফাইল ধারণকারী প্রোগ্রামগুলো বন্ধ করুন এবং মুছতে পুনরায় চেষ্টা করুন। TgWitness পুনরায় চালু করলে সেই ওয়ার্কস্পেস বন্ধ অবস্থায় থাকে এবং এর আংশিকভাবে মুছে ফেলা জার্নাল বা কী-গুলো পুনরায় তৈরি করে না। ডিরেক্টরি মুছে যাওয়ার পরই একটি সফল মুছে ফেলা রেকর্ড করা হয়; আলাদাভাবে রপ্তানি করা বা ব্যাকআপ নেওয়া কপিগুলো তাদের নিজস্ব সংরক্ষণ নীতি অনুযায়ী থাকে।
অবহিতকরণ#
সেটিংস → বিজ্ঞপ্তি এবং অফ-সাইট কপি → বিজ্ঞপ্তি গন্তব্য, অথবা আরও টুলস → অতিরিক্ত → বিজ্ঞপ্তি → কনফিগার করুন। TgWitness Apprise ব্যবহার করে Matrix, Telegram, Discord, Slack, ntfy, ইমেইল এবং অন্যান্য সমর্থিত সার্ভিসে অ্যালার্ট পাঠাতে। আপনি একটি ওয়ার্কস্পেসে একাধিক গন্তব্য যোগ করতে পারেন।
- প্রতি লাইনে একটি Apprise গন্তব্য URL লিখুন। আপনার সেবার জন্য সার্ভিস ক্যাটালগ এবং URL ফরম্যাট ব্যবহার করুন।
- নোটিফিকেশন পাঠান চালু করুন, তারপর সমস্যা সতর্কতা, পর্যবেক্ষিত চ্যাটে পরিবর্তন এবং একটি দৈনিক সারসংক্ষেপ নির্বাচন করুন। সারসংক্ষেপের সময় সার্ভারের সময় অনুসারে হবে।
- অ্যালার্টগুলিতে মুছে ফেলা ও সম্পাদিত বার্তাগুলোর সংরক্ষিত টেক্সট দেখতে চাইলে 'সংক্ষিপ্ত উদ্ধৃতি অন্তর্ভুক্ত করুন' চালু করুন।
- নোটিফিকেশন সংরক্ষণ করুন, তারপর ডেলিভারি পরীক্ষা করতে পরীক্ষা পাঠান।
আপনার নিজস্ব রিসিভারের জন্য, Apprise-এর JSON ওয়েবহুক ব্যবহার করুন।
উদাহরণস্বরূপ, jsons://notify.example.org/tgwitness HTTPS-এর মাধ্যমে সেই এন্ডপয়েন্টে JSON পাঠায়। এটি একটি কাল্পনিক উদাহরণ; এটিকে আপনার নিজস্ব গন্তব্য দিয়ে প্রতিস্থাপন করুন।
গন্তব্য এবং সেটিংস নির্বাচিত ওয়ার্কস্পেসের অন্তর্গত। পরিবর্তন বিজ্ঞপ্তিগুলি এর পর্যবেক্ষিত উত্সগুলিকে অন্তর্ভুক্ত করে, যার মধ্যে সদ্য যোগ করা চ্যাটগুলিও রয়েছে। শীর্ষ বারের ঘণ্টাটিও সাম্প্রতিক সমস্যা এবং চ্যাট পরিবর্তনগুলি তালিকাভুক্ত করে।
ডেমোতে, বিজ্ঞপ্তি নিয়ন্ত্রণগুলি দৃশ্যমান কিন্তু পাঠানো নিষ্ক্রিয়। একটি বাস্তব ওয়ার্কস্পেসে ডেলিভারি কনফিগার করুন। বিজ্ঞপ্তিগুলি সেই ওয়ার্কস্পেসের ডাইরেক্ট, SOCKS5 বা HTTP রুট ব্যবহার করে; MTProxy সেগুলি বহন করতে পারে না। SMTP-এর মতো নন-HTTP গন্তব্যের জন্য সরাসরি রুট প্রয়োজন।
প্যানেল বিন্যাস#

জার্নালে পর্যবেক্ষণ, অনুসন্ধান এবং ফিল্টার দেখানো হয়। একটি সম্পাদনা ধরা পড়া সংস্করণগুলো খুলে; একটি মুছে ফেলা, যদি উপলব্ধ থাকে, পূর্ববর্তী বিষয়বস্তু খুলে। অজানা তথ্যসূত্র স্পষ্টভাবেই থাকে। ওভারভিউ-এর অধীনে গণনাগুলো উপলব্ধ; অধিগ্রহণের বিবরণ স্থানীয় গাইডে থাকে।
একটি সম্পাদিত বার্তা খুলে লেখার মধ্যে পরিবর্তন বা পাশাপাশি বিকল্পের মাধ্যমে এর সংস্করণগুলো তুলনা করুন; মূল ডেটা সংরক্ষিত ফিল্ডগুলো দেখায়। লুকানো লিঙ্ক এবং বট বাটনের পরিবর্তনগুলো আলাদাভাবে প্রদর্শিত হয়। সংরক্ষিত ছবি, অডিও বা ভিডিও পরীক্ষা করতে অ্যাটাচমেন্ট প্রিভিউ খুলুন; ডাউনলোড বাটনটি সংরক্ষিত আসল ফাইলটি পাওয়ার ব্যবস্থা রাখে।
রেকর্ড আসার সাথে সাথে Live জার্নাল এবং চ্যাট আপডেট করে। পর্যালোচনা করার সময় এটি পজ (pause) করে রাখুন, অথবা প্রস্তুত হলে নতুন-ইভেন্ট বাটনটি ব্যবহার করুন; তথ্য সংগ্রহ চলতেই থাকে। Ctrl/Cmd+K প্যানেল অ্যাকশন খুঁজে বের করে এবং জার্নালে অনুসন্ধান চালায়।
অতিরিক্ত টুল → সোর্সেস পর্যবেক্ষণ ক্ষেত্র (নির্বাচিত চ্যাট, একটি টেলিগ্রাম ফোল্ডার বা পুরো অ্যাকাউন্ট), প্রতিটি ধরনের অ্যাক্সেসযোগ্য চ্যাট, অগ্রাধিক্যের তারকাযুক্ত নির্বাচিত সোর্স, সংযুক্তি এবং পুনঃপরীক্ষা সেটিংস এবং ইতিহাসের স্ন্যাপশট ধারণ করে। ব্যক্তিগত সোর্স ডায়ালগ/আইডি দ্বারা নির্বাচিত হয়, কোনো পাবলিক লিঙ্ক ছাড়াই। অ্যাক্সেস স্ট্যাটাস সর্বশেষ চেক বর্ণনা করে, স্থায়ী অনুমতি নয়।
সোর্স ফিল্টার করুন, সেগুলোর চেকবক্স নির্বাচন করুন, তারপর একসাথে সেগুলো সক্রিয়, পজ বা অগ্রাধিকার হিসেবে চিহ্নিত করুন। উপলব্ধ চ্যাটের তালিকায়, নির্বাচিতগুলো যোগ করুন আপনার নির্বাচিত আইটেমগুলো ব্যবহার করে; মিলে যাওয়া সব ফল যোগ করুন বর্তমান অনুসন্ধান এবং টাইপ ফিল্টার ব্যবহার করে।
চ্যাট → মানুষ তালিকায় সংরক্ষিত বার্তা সহ সবাইকে দেখায়; চ্যাটের জন্য যদি মানুষ প্রোফাইল চালু করা থাকে, তাহলে একবার ক্লিক করলেই সেই ব্যক্তির প্রোফাইল খুলে যাবে, যেখানে জার্নাল রেকর্ডের লিঙ্কগুলো থাকবে।
অতিরিক্ত টুল → এক্সট্রা → স্বাধীন সাক্ষী রিড-অনলি সাক্ষী টোকেন তৈরি করে, দেখায় প্রতিটি সাক্ষী সর্বশেষ কখন যাচাই করেছে এবং একটি (স্বাধীন সাক্ষী) চালানোর জন্য কমান্ড ও বিকল্প প্রদান করে।
অতিরিক্ত টুল → প্যারামিটারগুলো ওয়ার্কস্পেসের প্রতিটি সীমা এবং গতি ধারণ করে যা অন্য কোনো পৃষ্ঠায় নেই:
কতগুলো ডায়ালগ পড়া হয়েছে, চ্যাট তালিকা কত ঘনঘন পুনরায় পড়া হয়েছে, হার্টবিট এবং চেকপয়েন্ট
ইন্টারভাল, স্টার্টআপ বাফার, পুনঃচেকগুলো কীভাবে তাদের অনুরোধ ছড়িয়ে দেয় (প্রথম বিলম্ব, প্রতি
pass, চ্যাটের মধ্যে বিরতি, পুনরুদ্ধারকৃত এবং পুনরায় অনুরোধকৃত বার্তা, ডিস্ক রিজার্ভ, ডাউনলোডের টাইমআউট এবং পুনরায় চেষ্টা, মানুষ যে প্রোফাইলগুলো অনুসন্ধান করে (আপনার নিজস্ব নিয়মিত এক্সপ্রেশনসহ), বিজ্ঞাপনের আকার এবং গতি, স্ন্যাপশট, ZIP এবং ব্রাউজার-ডাউনলোডের সীমা, এবং টেলিগ্রাম ক্লায়েন্টের টাইমআউট এবং পুনরায় চেষ্টা। প্রতিটি ফিল্ড তার পরিসীমা এবং ডিফল্ট দেখায়; পরিবর্তিত ফিল্ডগুলো চিহ্নিত করা হয় এবং এক এক করে বা সব একসঙ্গে পুনরুদ্ধার করা যেতে পারে। প্রতিটি পরিবর্তন parameters.changed হিসেবে রেকর্ড হয়, যার আগে ও পরে মানগুলো উল্লেখ থাকে, এবং পর্যবেক্ষণ শুরু রেকর্ডগুলো কার্যকর মানগুলো নামকরণ করে। মানগুলো তাদের পরবর্তী ব্যবহার থেকে প্রযোজ্য হয়; ক্লায়েন্ট টাইমআউট এবং পুনঃচেষ্টা পরবর্তী সংযোগ থেকে কার্যকর হয়। পুনঃপরীক্ষার সময়কাল, সংযুক্তি ধরন ও আকার, প্রমাণ এবং অফ-সাইট কপি সময়কাল তাদের নিজস্ব পৃষ্ঠায় থাকে এবং শুধুমাত্র পূর্বনির্ধারিত মান নয়, তাদের পরিসরের যেকোনো মান গ্রহণ করতে পারে।
টপ বারে থাকা ঘণ্টাধ্বনিটি পর্যবেক্ষিত চ্যাটগুলিতে সাম্প্রতিক সমস্যা ও পরিবর্তনগুলি তালিকাভুক্ত করে; অপঠিত চ্যাটগুলি পড়া হিসেবে চিহ্নিত না হওয়া পর্যন্ত গণনা করা হয়। পরিবর্তনগুলি প্রতিটি চ্যাট ও ঘণ্টা অনুযায়ী গোষ্ঠীবদ্ধ করা হয় ("১২টি মুছে ফেলা হয়েছে, ১টি সম্পাদিত, ০টি পাওয়া যায়নি"), এবং সাইন-আউট বা ডিস্ক পূর্ণ হওয়ার মতো সমস্যাগুলি চ্যাটগুলো যতই ব্যস্ত থাকুক না কেন তালিকায় থেকে যায়।
অতিরিক্ত টুল → অ্যাকাউন্ট ফোন-নম্বর ফিল্ড থেকে শুরু হয়। চালিয়ে গেলে সরাসরি কোড এন্ট্রিতে নিয়ে যায়, শুধুমাত্র API ক্রেডেনশিয়াল অনুপস্থিত থাকলে তা চায়। QR এবং ফাইল ইমপোর্ট বিকল্প ট্যাব। সংরক্ষিত API ক্রেডেনশিয়াল শুধুমাত্র নিজস্ব ওয়ার্কস্পেসের মধ্যে পুনরায় ব্যবহার করা হয়। এন্ট্রি স্ক্রিনে কোনো সাইডবার, পরিসংখ্যান বা সেটআপ অনুচ্ছেদ নেই। সেটিংস আইকন API, প্রক্সি, স্টোরেজ এবং অতিরিক্ত-অ্যাকাউন্ট নিয়ন্ত্রণগুলি খুলে। একটি নতুন ওয়ার্কস্পেস প্রথম সেটআপ খুলে; সাইন-ইন করার পর, সংরক্ষিত উৎস এবং রেকর্ড সহ একটি ওয়ার্কস্পেস Chats খুলে। রুট পরিবর্তন করতে বিরতি দেওয়া পর্যবেক্ষণ প্রয়োজন এবং এটি অসম্পূর্ণ লগইন বাতিল করে। একটি বিদ্যমান জার্নালকে নীরবে অন্য টেলিগ্রাম অ্যাকাউন্টে পুনরায় বাইন্ড করা যাবে না।
এক্সপোর্ট জার্নালের অখণ্ডতা যাচাই করে এবং বহনযোগ্য ফাইল তৈরি করে। এর ওয়ার্কস্পেস আইডি ডাউনলোড CLI-তে পাস করা যেতে পারে। প্রতিটি এক্সপোর্ট একটি সম্পূর্ণ জার্নাল প্রিফিক্স পিন করে; পরবর্তী ইভেন্টগুলো পরবর্তী এক্সপোর্টে প্রবেশ করে। সার্চ ফিল্টার প্যাকেজের স্কোপ পরিবর্তন করে না। স্বাক্ষর এবং কভারেজ সম্পর্কিত বিস্তারিত তথ্য যাচাইকরণ এবং প্রমাণ অধীনে রয়েছে।
প্যানেলটি Collector health-এর অধীনে কালেক্টর স্টেট, সারিতে থাকা/ব্যর্থ মিডিয়া, সবচেয়ে পুরনো পেন্ডিং মিডিয়া, ফ্রি ডিস্ক, অনুরোধ বিরতি এবং এমন সোর্সগুলি দেখায় যেগুলির অ্যাক্সেস নিশ্চিত নয়। এই বিবরণগুলি প্রথমে ভাঁজ করা থাকে এবং Account-এ লুকানো থাকে। একটি সেটআপ কার্ড পরবর্তী ধাপ দেখায়: একটি অ্যাকাউন্ট সংযুক্ত করুন, সোর্স নির্বাচন করুন, অথবা পর্যবেক্ষণ শুরু করুন। অ্যাকাউন্ট তালিকা লোড-সময়ের একটি স্ন্যাপশট; নির্বাচিত ওয়ার্কস্পেস নিয়মিতভাবে রিফ্রেশ হয়। এটি মাল্টি-প্রসেস SLA মনিটর নয়।
UI উৎস কনটেন্টের জন্য স্থানীয় অ্যাসেট এবং টেক্সট রেন্ডারিং ব্যবহার করে। Chromium-এ ডেস্কটপ এবং সরু লেআউট পরীক্ষা করা হয়েছে।
নিয়োগ পরিবেশসমূহ#
| পরিবেশ | ইনস্টলেশন | যাচাইকরণ অবস্থা |
|---|---|---|
| উইন্ডোজ পিসি/সার্ভার | Python 3.11+, scripts\Setup.cmd/Start.cmd, ব্যক্তিগত ডেটা ডিরেক্টরি | Windows/Python 3.12-এ স্থানীয়ভাবে যাচাই করা হয়েছে |
| লিনাক্স সার্ভার/ভিপিএস | পাইথন ভেনভ, নিবেদিত সার্ভিস ইউজার, HTTPS/SSH | কোড, CI এবং systemd উদাহরণ প্রদান করা হয়েছে; এই হোস্টে কার্যকর করা হয়নি। |
| ম্যাকওএস | পাইথন ভার্চুয়াল এনভায়রনমেন্ট, ফোরগ্রাউন্ড প্রসেস বা ব্যবহারকারী এজেন্ট | প্রদানকৃত launchd উদাহরণ; পৃথক ইনস্টলেশন যাচাই প্রয়োজন |
| ডকার/কম্পোজ | স্থায়ী ভলিউম, একটি কর্মী | সংজ্ঞা এবং CI রানটাইম চেক প্রদান করা হয়েছে; স্থানীয়ভাবে ডকার অনুপলব্ধ |
| ফোন ব্রাউজার | চলমান সার্ভারে সুরক্ষিত প্যানেলে সংযোগ করুন | সংকুচিত ক্রোমিয়াম লেআউট পরীক্ষা করা হয়েছে; কালেক্টর iOS/Android-এ কাজ করে না। |
পোর্টেবিলিটি মানে কোনো বাধ্যতামূলক ক্লাউড সার্ভিস বা ফ্রন্টএন্ড বিল্ড নেই। প্রতিটি টার্গেটে এখনও সামঞ্জস্যপূর্ণ পাইথন/ক্রিপ্টো নির্ভরতা, স্থানীয় ডিস্ক এবং নেটওয়ার্ক অ্যাক্সেস প্রয়োজন। DEPLOYMENT.md এবং সার্ভিস টেমপ্লেটগুলো দেখুন।
ওয়ার্কস্পেসগুলো CPU, মেমরি এবং একটি ইভেন্ট লুপ শেয়ার করে। প্রক্রিয়া বিচ্ছিন্নতার জন্য পৃথক ইনস্ট্যান্স, পোর্ট, ডেটা ডিরেক্টরি এবং অ্যাকাউন্ট অনুমোদন ব্যবহার করুন। পৃথক ইনস্ট্যান্সগুলোর মধ্যে কোনো একীভূত প্যানেল নেই। একই ডাটাবেসের সাথে একাধিক ওয়ার্কারকে কখনোই সংযুক্ত করবেন না।
স্টার্টআপ চেক এবং রপ্তানি#
প্রস্তুত পরিবেশ শুরু করার আগে python start.py --check চালান। মেশিন-রিডেবল চেকের জন্য --json যোগ করুন অথবা ইচ্ছিত --data-dir, --host এবং --port পাস করুন।
কমান্ডটি টেলিগ্রাম লগইন বা জার্নাল তৈরি না করেই পূর্বশর্তগুলো পরীক্ষা করে।
জার্নাল যাচাইকরণ অ্যাপ্লিকেশন শুরু হওয়ার সময় চলে, এবং ক্যাপচার প্রস্তুতি প্যানেলে প্রদর্শিত হয়।
ব্যস্ত একটি পোর্ট কেবল একটি বিদ্যমান ইনস্ট্যান্স হতে পারে।
ফাইল সিস্টেম অ্যাক্সেস API সমর্থনকারী ব্রাউজারগুলো লেখার যোগ্য স্ট্রিমের মাধ্যমে এক্সপোর্ট সংরক্ষণ করে। অন্যান্য ব্রাউজারগুলো সর্বোচ্চ 128 MiB বাফার করে। বৃহত্তর এক্সপোর্ট বা ফাইল স্ট্রিমিং-হীন ব্রাউজারের জন্য স্ট্রিমিং CLI ব্যবহার করুন:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
সাব-ওয়ার্কস্পেসের জন্য এক্সপোর্ট থেকে --profile ID
যোগ করুন। রিমোট অ্যাক্সেসের জন্য --url https://server
ব্যবহার করুন। প্লেন HTTP শুধুমাত্র লুপব্যাক গন্তব্যের জন্য গ্রহণযোগ্য। টোকেনটি একটি ফাইল থেকে পড়ে হেডারে পাঠানো হয়, প্রিন্ট করা হয় না বা URL-এ রাখা হয় না। রিডাইরেক্ট প্রত্যাখ্যাত। বিদ্যমান গন্তব্যগুলি ওভাররাইট করা হয় না। ব্যর্থ স্থানান্তরগুলো তাদের অস্থায়ী পার্ট ফাইল মুছে ফেলে। রিপোর্টকৃত SHA-256 একটি স্থানান্তর চেকসাম; স্বাক্ষরিত ZIP ফাইলটি বিশ্বাসযোগ্য ফিঙ্গারপ্রিন্ট/চেকপয়েন্ট ব্যবহার করে আলাদাভাবে যাচাই করুন।
ব্যাকআপ, পুনরুদ্ধার এবং বিঘ্ন#
- পর্যবেক্ষণ বিরতি দিন এবং প্রক্রিয়াটি পরিচ্ছন্নভাবে বন্ধ করুন।
- সমস্ত ডেটা ডিরেক্টরি কপি করুন: ডাটাবেস, WAL/SHM (যদি থাকে), মিডিয়া,
credentials.enc,signing.enc,network.enc, ভল্ট কী/মেটাডেটা, টোকেন, চেকপয়েন্ট এবং প্রতিটিprofiles/ডিরেক্টরি। - বাহ্যিক-কী মোডের জন্য, মাস্টার কী আলাদাভাবে সংরক্ষণ করুন এবং প্রতিটি
vault.external.jsonবজায় রাখুন। নতুন কী তৈরি করলে পুরনো গোপনীয়তা পুনরুদ্ধার করা যাবে না। - গন্তব্য থামিয়ে থাকা অবস্থায় পুনরুদ্ধার করুন; মূল কী কনফিগার করুন, অ্যাক্সেস সীমিত করুন, এবং পুনরায় শুরু করার আগে অখণ্ডতা যাচাই করুন।
- ডাউনটাইম এবং যাচাইকরণ ফলাফল রেকর্ড করুন। ডাউনটাইম একটি রেকর্ডকৃত ফাঁক হিসেবে থাকে; একটি ইতিহাসের স্ন্যাপশট এর পরের অবস্থা যোগ করে।
Evidence ZIPs exclude sessions/private keys and are not full service backups.
tgwitness backup FOLDER makes the same copy while the panel keeps running and leaves out the
search index, which rebuilds itself; see Updates and backups.
Four things are protected differently:
| কি | সুরক্ষা |
|---|---|
| ক্লিপবোর্ডে অনুলিপি করার জন্য ফাইলগুলো পাসওয়ার্ড ছাড়াই (ডিফল্ট) রপ্তানি করুন। | স্বাক্ষরিত, তাই পরিবর্তন সনাক্তযোগ্য; এক্সপোর্ট এনক্রিপ্ট করতে একটি পাসওয়ার্ড সেট করুন |
| পাসওয়ার্ড দিয়ে ফাইল রপ্তানি করুন | যদি আপনি একটি পাসওয়ার্ড সেট করেন, তাহলে প্রস্তুত এক্সপোর্ট অপরিবর্তিত অবস্থায় একটি WinZip AES-256 ZIP ফাইলে সংরক্ষিত হয়, যা 7-Zip এবং WinRAR খুলতে পারে; পাসওয়ার্ড সংরক্ষণ করা হয় না (প্রমাণ সংরক্ষণ)। |
| জার্নাল ডাটাবেস এবং ডিস্কে সংরক্ষিত সংযুক্তিগুলি | এনক্রিপ্ট করা ডিস্ক বা ভলিউম এবং ফোল্ডার অনুমতি |
| টেলিগ্রাম সেশন এবং স্বাক্ষর কী | ডেটা ডিরেক্টরিতে এনক্রিপ্ট করা হয়েছে (credentials.enc, signing.enc, network.enc) |
পূর্ণ-সেবা ব্যাকআপ হল উপরে বর্ণিত স্টপড ডেটা ডিরেক্টরি, কোনো এক্সপোর্ট নয়। উভয়ের জন্য সুরক্ষিত স্টোরেজ এবং একটি সুচিন্তিত স্থানান্তর প্রক্রিয়া ব্যবহার করুন। অস্থায়ী সার্ভার এক্সপোর্টগুলো প্রতিটি ওয়ার্কস্পেসের
temporary-exports/-এ থাকে; সম্পন্ন রেসপন্সগুলো পরিষ্কার করে ফেলা হয়, এবং সেই ওয়ার্কস্পেসের ইনস্ট্যান্স লক ধরে রাখার সময় পরবর্তী স্টার্টআপে বিঘ্নিত এক্সপোর্ট ফাইলগুলো মুছে ফেলা হয়।
সংযোগ পুনরুদ্ধারের ইভেন্টের পর, কালেক্টর সংরক্ষিত আপডেট অবস্থানের থেকে মিসড আপডেট অনুরোধ করে। পার্সিস্টেন্ট মিডিয়া জব এবং টেলিগ্রাম আপডেট অবস্থান রিস্টার্টের পরও টিকে থাকে; প্রমাণ ফরম্যাট দেখুন।
ক্ষমতা এবং ধরে রাখা#
ডিফল্ট সীমা, সবই পরিবর্তনযোগ্য More tools → Parameters-এ: প্রথম 1,000টি ডায়ালগ, প্রতি স্ন্যাপশটে 500টি বার্তা, 4 GiB অব্যবহৃত স্বাক্ষরিত ZIP সামগ্রী (বড় আর্কাইভের জন্য verify.py --max-gib N প্রয়োজন) এবং একটি 128 MiB ব্রাউজার ফ্যালব্যাক। সংযুক্তিগুলি More tools → Sources → Recording → Attachments-এ প্রতি ধরনের জন্য 1–2,000 MiB নেয়। ডাউনলোড CLI ডিফল্টভাবে 5 GiB স্থানান্তরিত করে। উপলব্ধ ডিস্ক একটি নিম্ন সীমা হতে পারে। জার্নাল, মিডিয়া, WAL, অস্থায়ী এক্সপোর্ট এবং ব্যাকআপের জন্য স্থান সংরক্ষণ করুন।
এক্সপোর্টগুলো Compose-এর 512 MiB /tmp-এর পরিবর্তে ডেটা ভলিউম ব্যবহার করে।
শুধুমাত্র গ্রুপ গণনার পরিবর্তে প্রতি সেকেন্ডে ইভেন্ট, ক্যু এর বয়স, মিডিয়া বাইট এবং ডিস্ক ল্যাটেন্সি পরিমাপ করুন। লাইভ ডেলিভারি চলমান কালেক্টরে পরিমাপ করা হয়। স্বয়ংক্রিয়ভাবে রিটেনশন ডিলিটিশন নেই। জার্নাল টেইল অপসারণ করলে এর সংরক্ষিত চেকপয়েন্টগুলোর সাথে সম্পর্ক অকার্যকর হয়ে যায়।
অগ্রাধিকার পুনঃযাচাই ইতিমধ্যে আছে: তারকাচিহ্নিত উৎসগুলো ডিফল্টভাবে প্রতি 15 মিনিটে এবং বাকিগুলো প্রতি 6 ঘণ্টায় পুনরায় যাচাই করা হয় (দেখুন পুনঃযাচাইয়ের স্তর)। পাসওয়ার্ড-সুরক্ষিত রপ্তানি উপরে বর্ণিত অনুযায়ী কাজ করে। সীমিত অ্যাক্সেস অ্যাক্সেস ও অনুমতি-তে নথিভুক্ত। দেখুন READINESS.md, LIVE_ACCEPTANCE.md এবং VERIFICATION.md।