তথ্যসূত্র / সেটআপ
Telegram · দ্রুত শুরু
TgWitness ইনস্টল ও চালু করার প্রতিটি উপায়: উইন্ডোজ প্যাকেজ, পাইথন, ডকার এবং সিন্থেটিক ডেমো, প্রাথমিক যাচাইসহ।
ইংরেজি · রাশিয়ান · ইউক্রেনীয় · স্প্যানিশ · পর্তুগিজ (ব্রাজিল) · তুরস্কী · আরবি · ফার্সি · উর্দু · হিন্দি · ইন্দোনেশীয় ভাষা · ভিয়েতনামী ভাষা · সরলীকৃত চীনা
TgWitness হল একটি স্বতন্ত্র অ্যাপ্লিকেশন যা আপনার অ্যাকাউন্টগুলো অ্যাক্সেস করতে পারা টেলিগ্রাম গ্রুপ এবং চ্যানেলগুলো পর্যবেক্ষণের জন্য। এটি নিজস্ব ডেটা ডিরেক্টরি সহ স্থানীয়ভাবে চলে।
প্রথমবার আসছেন? কোনো অ্যাকাউন্ট সংযুক্ত করার আগে ডেমোটি দেখুন। প্রক্সি, সাক্ষী, এক্সপোর্ট বা সার্ভার সেটআপের জন্য একটি গাইড নির্বাচন করুন। GitHub Actions capture (preview) একটি ক্যাপচার চালায় আপনার নিজস্ব GitHub ফর্ক-এ, স্থানীয় ইনস্টলেশনের পরিবর্তে।
ইনস্টল করুন এবং শুরু করুন#
গাইডেড ইনস্টলারটিতে নিজস্ব পাইথন অন্তর্ভুক্ত থাকে এবং ইনস্টল করার আগে প্যাকেজের হ্যাশ ও রিলিজ স্বাক্ষর যাচাই করে। এটি পুনরায় চালানো বিদ্যমান ইনস্টলেশন আপডেট করে।
লিনাক্স / ম্যাকওএস:
curl -fsSL https://get.destroy.tools/install.sh | bash
উইন্ডোজ (পাওয়ারশেল বা কমান্ড প্রম্পট):
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
উবুন্টু সার্ভারে ব্যাকগ্রাউন্ড সার্ভিস ইনস্টল করতে রুট হিসেবে চালান; ডেস্কটপে আপনার সাধারণ ব্যবহারকারী হিসেবে চালান। উবুন্টুতে ইনস্টলার প্যানেলের ঠিকানা এবং অ্যাক্সেস কী প্রিন্ট করে; macOS এবং উইন্ডোজে আপনার ব্রাউজারে লোকাল প্যানেল খুলে। নিচে 'টেলিগ্রাম সংযোগ' এ চালিয়ে যান। ইনস্টল, যাচাই এবং আপডেট সার্ভার অ্যাক্সেসের বিকল্প, স্ক্রিপ্ট চালানোর আগে যাচাইকরণ, আপডেট এবং অপসারণকে অন্তর্ভুক্ত করে।
অন্যান্য পদ্ধতি#
GitHub রিলিজ, সোর্স এবং Docker ইনস্টলার-এর বিকল্প। পোর্টেবল ডাউনলোড রিলিজ বিল্ড প্রকাশের পর উপলব্ধ হয়:
| আয়োজক | কিছুই ইনস্টল করা নেই | উৎস: পাইথন ৩.১১+ | ডকার: ইঞ্জিন/ডেস্কটপ কম্পোজ 2.20+ সহ |
|---|---|---|---|
| উইন্ডোজ | GitHub রিলিজ থেকে TgWitness-<version>-windows-amd64-portable.zip এক্সট্র্যাক্ট করুন, TgWitness.cmd-এ ডাবল-ক্লিক করুন। |
Start.cmd-এ ডাবল-ক্লিক করুন |
scripts\Docker.cmd-এ ডাবল-ক্লিক করুন |
| লিনাক্স / ম্যাকওএস | — | sh start.sh |
sh scripts/docker-start.sh |
সোর্স পদ্ধতির জন্য, বর্তমান main ডাউনলোড ও এক্সট্র্যাক্ট করুন অথবা রিপোজিটরিটি ক্লোন করুন:
git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness
উপযুক্ত কোনো Python খুঁজে না পাওয়া গেলে Start.cmd আপনার Windows ব্যবহারকারীর জন্য Python 3.12 ইনস্টল করার প্রস্তাব দেয় (winget, অথবা স্বাক্ষরিত python.org ইনস্টলারের মাধ্যমে)। Python না থাকলে start.sh আপনার Linux ডিস্ট্রিবিউশন বা macOS-এর জন্য সঠিক ইনস্টল কমান্ডটি প্রিন্ট করে। প্রথমবার সোর্স চালু করলে তা স্বয়ংক্রিয়ভাবে .venv তৈরি করে এবং ডিপেন্ডেন্সিগুলো ইনস্টল করে নেয়।
Docker অ্যাপ্লিকেশনটি বিল্ড করে এবং পটভূমিতে চালু করে; হোস্ট Python অপ্রয়োজনীয়। scripts\Docker.cmd এবং scripts/docker-start.sh প্যানেলের ঠিকানা এবং টোকেন প্রিন্ট করে যখন কন্টেইনারটি সুস্থ থাকে। প্রতিটি সমর্থিত হোস্টে সমতুল্য Docker কমান্ডগুলো হল:
docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt
http://127.0.0.1:8787 খুলুন। ডকার হেল্পার বা দ্বিতীয় ডকার কমান্ড দ্বারা প্রিন্ট করা টোকেন ব্যবহার করুন, অথবা পোর্টেবল বা সোর্স ইনস্টলেশনের জন্য data/live/panel-token.txt ফাইল থেকে পড়ুন। নিচে 'Connect Telegram'-এ চালিয়ে যান। নেটিভ এবং ডকার ইনস্টলেশন আলাদা স্টোরেজ ব্যবহার করে; ডকার চালু করলে বিদ্যমান নেটিভ জার্নাল আমদানি হয় না।
একটি সার্ভারের জন্য, ডিপ্লয়মেন্টে স্বয়ংক্রিয় HTTPS, রিস্টার্ট, প্রকাশিত ইমেজ, আপডেট এবং ব্যাকআপ অন্তর্ভুক্ত।
ইন্টারফেসটি অন্বেষণ করুন#
- পোর্টেবল প্যাকেজে Run TgWitness-Demo.cmd
চালান, Windows সোর্স ফোল্ডারে scripts\Demo.cmd
চালান, অথবা Linux/macOS-এ
sh start.sh --demoচালান। একটি সোর্স লঞ্চ প্রথমে.venvতৈরি করে এবং নির্ভরতা ইনস্টল করে। - http://127.0.0.1:8787 খুলুন।
- স্থানীয় ডেমো স্বয়ংক্রিয়ভাবে নমুনা জার্নাল খুলে। সরাসরি স্থানীয় অ্যাক্সেসের জন্য টোকেন কপি করার কোনো প্রয়োজন নেই।
ডেমো বার্তাগুলো কাল্পনিক। ডেমো মোড কোনো প্রকৃত টেলিগ্রাম অ্যাকাউন্টের সাথে সংযোগ করতে পারে না।
টেলিগ্রাম সংযোগ করুন#
[!WARNING] নিবেদিত অ্যাকাউন্ট ব্যবহার করুন। টেলিগ্রাম অনুরোধের পরিমাণ যা অতিরিক্ত বলে মনে করে, ক্লায়েন্ট যাই হোক না কেন, সেগুলো সীমিত বা স্থায়ীভাবে নিষিদ্ধ করতে পারে। ব্যক্তিগত বা মূল্যবান অ্যাকাউন্টের পরিবর্তে পর্যবেক্ষণের জন্য প্রস্তুত অ্যাকাউন্ট সংযুক্ত করুন, এবং একটি নিবেদিত অ্যাকাউন্টে একটি API আইডি/হ্যাশ তৈরি করুন।
- যদি নেটিভ ডেমো চলছে, তা বন্ধ করুন এবং Start.cmd অথবা
sh start.shচালান। অন্যথায়, উপরের লাইভ ইনস্টলেশন চালু রাখুন। - প্যানেল টোকেন ব্যবহার করে সাইন ইন করুন। প্রথম সেটআপে একটি নতুন ওয়ার্কস্পেস খুলবে। কেবল ডাউনলোড, চ্যাট অনুসরণ বা মামলার প্রমাণ নির্বাচন করুন।
- সংযোগ যাচাইকরণ পর্যালোচনা করুন। প্রয়োজনে আপনার নিজস্ব প্রক্সি কনফিগার করুন; সংযোগ সেটিংস সেটআপের পরও উপলব্ধ থাকবে।
- Connect Telegram-এ একটি ফোন নম্বর, একটি QR কোড, অ্যাকাউন্ট ফাইল (TData,
.session, StringSession, account JSON) অথবা একটি সম্পূর্ণ অনুমোদন কী। অনুরোধ করা হলে টেলিগ্রামের নিশ্চিতকরণ, কোড এবং দুই-ধাপের পাসওয়ার্ড সম্পূর্ণ করুন। - প্রদর্শিত অ্যাকাউন্টটি যাচাই করুন, চ্যাটগুলো নির্বাচন করুন এবং আপনার সেটিংস পর্যালোচনা করুন। চূড়ান্ত স্ক্রীন থেকে শেষ করুন। শুধুমাত্র ডাউনলোডের জন্য, 'স্টার্ট এক্সপোর্ট' একবারের এক্সপোর্ট শুরু করে এবং এর অগ্রগতি দেখানোর জন্য 'এক্সপোর্টস' খুলে; এটি ধারাবাহিক পর্যবেক্ষণ সক্ষম করে না।
সেটআপের পর, Chats → Choose নির্বাচিত চ্যাটগুলো পরিবর্তন করে। Settings কালেকশন এবং ফাইলগুলো নিয়ন্ত্রণ করে; More tools → Sources স্ট্যান্ডার্ড বা এক্সপার্ট স্তরে বিস্তারিত সোর্স তালিকা প্রদান করে। প্যানেল গাইড ছয়টি প্রধান বিভাগ এবং তাদের প্রাসঙ্গিক নিয়ন্ত্রণগুলো বর্ণনা করে।
API আইডি + হ্যাশ ঐচ্ছিক: ওয়ার্কস্পেস তার সংরক্ষিত বা আমদানি করা যুগল ব্যবহার করে, অথবা বিল্ট-ইন পুল থেকে একটি কার্যকরী যুগল। আপনার নিজস্ব অ্যাপ ব্যবহার করতে, একটি API ID:API Hash যুগল API আইডি-তে পেস্ট করুন। Auth কী-এর জন্য, সমস্ত 512 হেক্সাডেসিমাল অক্ষর পেস্ট করুন এবং সরবরাহিত DC ID নির্বাচন করুন। ব্যবহারকারী আইডি ঐচ্ছিক এবং প্রবেশ করালে তা যাচাই করা হয়।
API ক্রেডেনশিয়ালগুলো আপনার অ্যাপ্লিকেশন সনাক্ত করে; এগুলো নিজে থেকেই কোনো অ্যাকাউন্ট অনুমোদন করে না। ব্যক্তিগত গ্রুপের জন্য কোনো পাবলিক ব্যবহারকারীর নাম প্রয়োজন নেই, তবে আপনার অ্যাকাউন্টের অবশ্যই অ্যাক্সেস থাকতে হবে।
বিদ্যমান অ্যাকাউন্টের জন্য, অ্যাকাউন্ট এবং সেশন ফরম্যাট দেখুন: প্যানেল Telethon StringSession, Telethon/Pyrogram SQLite, একক-অ্যাকাউন্ট TData ZIP, এবং সমর্থিত অ্যাকাউন্ট JSON গ্রহণ করে। একটি সেশন এবং এর সঙ্গী JSON একসঙ্গে নির্বাচন করুন, 'Check files' চাপুন, তারপর 'Connect account' করুন। একই ঐচ্ছিক API সেটিংস সহ QR লগইনও উপলব্ধ। TDLib, বট সেশন এবং CSV/JSON অ্যাকাউন্ট ইনভেন্টরি সমর্থিত নয়।
একাধিক অ্যাকাউন্টের জন্য, হিসাবসমূহ → অ্যাকাউন্ট আমদানি করুন ব্যবহার করুন এবং সেগুলোর সমর্থিত সেশন ফাইল নির্বাচন করুন। সাথে থাকা JSON ফাইলগুলো বেসনেম (basename) অনুযায়ী যুক্ত হয়; আমদানি করা প্রতিটি অ্যাকাউন্ট নিজস্ব আলাদা ওয়ার্কস্পেস পায়। বাল্ক ইমপোর্ট এবং অ্যাকাউন্ট গ্রুপ দেখুন।
অন্য একটি অ্যাকাউন্ট যোগ করতে, অ্যাকাউন্ট সিলেক্টরের পাশে + চাপুন অথবা অ্যাকাউন্টস → অ্যাকাউন্ট যোগ করুন ব্যবহার করুন। ওয়ার্কস্পেসগুলির পৃথক সেশন, জার্নাল, কী, সোর্স এবং কুই থাকে। ভিউ পরিবর্তন করলে অন্যান্য কালেক্টরগুলি চলতেই থাকে। একই টেলিগ্রাম অ্যাকাউন্ট এই ইনস্টলেশনে দুটি ওয়ার্কস্পেস-এ বরাদ্দ করা যাবে না। ওয়ার্কস্পেসের কোনো নির্দিষ্ট সংখ্যা নেই; এগুলি একটি প্রসেস শেয়ার করে, তাই ধারণক্ষমতা মেশিনের উপর নির্ভর করে।
লাইভ প্যানেল টোকেন আপনার টেলিগ্রাম অনুমোদন এবং সংরক্ষিত সামগ্রীর অ্যাক্সেস সুরক্ষিত রাখে; এটি টেলিগ্রাম API ক্রেডেনশিয়াল থেকে আলাদা। শুধুমাত্র স্পষ্টভাবে শুরু করা এবং সরাসরি অ্যাক্সেস করা লোকাল ডেমো স্বয়ংক্রিয়ভাবে প্রবেশাধিকার পায়। রিমোট/প্রক্সিড ডেমো এখনও
data/demo/panel-token.txt ব্যবহার করে।
পর্যালোচনা এবং রপ্তানি#
- জার্নাল: উৎস এবং ইভেন্টের ধরন অনুযায়ী পর্যবেক্ষণ অনুসন্ধান ও ফিল্টার করুন।
- কোনো ইভেন্ট নির্বাচন করুন তার মূল রেকর্ড, তথ্যসূত্র এবং সংরক্ষিত সংস্করণগুলো পরিদর্শন করতে।
- সম্পাদনা বিবরণ উপলব্ধ আগে/পরে বিষয়বস্তু দেখায়। মুছে ফেলার বিবরণ শেষ ধারণকৃত বিষয়বস্তু দেখায়, যদি থাকে; একটি অজানা অভিনেতাই অজানা থাকে।
- রপ্তানি: স্বাক্ষরিত ZIP, JSONL, CSV এবং অফলাইন HTML।
- পূর্ণ চ্যাট এক্সপোর্ট (চ্যাটস → চ্যাট এক্সপোর্ট, অথবা এক্সপোর্টস → একটি চ্যাট ক্যাপচার বা এক্সপোর্ট): একটি চ্যাটের সম্পূর্ণ দৃশ্যমান ইতিহাস
chat.json(টেলিগ্রাম-এক্সপোর্ট স্টাইল) এবং একটি পাঠযোগ্যchat.htmlফাইলের স্বাক্ষরিত বান্ডিল হিসেবে ডাউনলোড করুন। ব্যক্তিগত চ্যাট তখনই কাজ করে যখন অ্যাকাউন্টের সদস্যতা থাকে। এটি একটি বর্তমান স্ন্যাপশট, মুছে ফেলা বা পূর্বে সম্পাদিত বার্তাগুলির পুনর্গঠন নয়। একটি কপি যাচাই করতেpython verify.py chat-export.zip --fingerprint TRUSTED_SHA256ব্যবহার করুন। - চেকপয়েন্ট সংরক্ষণ করুন: স্বাক্ষরিত জার্নাল সীমানা কালেক্টরের বাইরে রাখুন।
- স্বাক্ষরিত রান রসিদ ডাউনলোড করুন: সংগ্রহকারীর প্রোগ্রাম/সংস্করণ রেকর্ড সংরক্ষণ করুন।
- টাইমস্ট্যাম্প অনুরোধ প্রস্তুত করুন: একটি অফলাইন অনুরোধ প্রস্তুত করুন একটি টাইমস্ট্যাম্প কর্তৃপক্ষের জন্য; TIMESTAMP.md অনুসরণ করুন একটি প্রতিক্রিয়া পেতে এবং যাচাই করতে।
- জার্নাল যাচাই করুন: ইভেন্ট স্বাক্ষর এবং চেইন লিঙ্ক পরীক্ষা করুন। ZIP রপ্তানি মিডিয়াও পরীক্ষা করে।
সমর্থিত ব্রাউজারগুলো বড় এক্সপোর্টগুলো সরাসরি নির্বাচিত ফাইলে সংরক্ষণ করে। অন্যান্য ব্রাউজারগুলো সর্বোচ্চ 128 MiB বাফার করে। সার্ভার চলার সময়, স্ট্রিমিং CLI পুরো প্রতিক্রিয়া বাফার না করেই বড় ডাউনলোড সমর্থন করে:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
অন্য কোনো ওয়ার্কস্পেসের জন্য, এক্সপোর্টস → ওয়ার্কস্পেস আইডি (Exports → Workspace ID) ব্যবহার করে --profile ID যোগ করুন।
রিমোট সার্ভারের জন্য, --url https://your-server যোগ করুন। ডিফল্ট স্থানান্তর সীমা
5 GiB; --max-mib এটি পরিবর্তন করে। স্বাক্ষরিত ZIP সামগ্রীর ডিফল্টভাবে একটি পৃথক 4 GiB অব্যবহৃত যাচাই সীমা রয়েছে (More tools → Parameters এটি বাড়ায়; এমন আর্কাইভগুলি যাচাই করতে verify.py --max-gib N ব্যবহার করুন)। আর্কাইভটি যাচাই করতে একটি বিশ্বস্ত ভেরিফায়ারের কপি, একটি স্বাধীনভাবে সংরক্ষিত কী ফিঙ্গারপ্রিন্ট এবং প্রমাণের ন্যূনতমতার জন্য টাইমস্ট্যাম্প কর্তৃপক্ষের রুট সার্টিফিকেট (--tsa-ca) ব্যবহার করুন।
ইনস্টলেশন পরীক্ষা করুন#
python start.py --setup-only
python start.py --check
python start.py --check --json
--check স্থানীয় নির্ভরতা, সাইন-ইন সমর্থন, স্টোরেজ, কী কনফিগারেশন এবং লিসেনিং ঠিকানা পরীক্ষা করে। এটি কিছুই ইনস্টল করে না বা টেলিগ্রামের সাথে সংযোগ করে না। ব্যস্ত পোর্ট মানে অন্য একটি ইনস্ট্যান্স চলছে। অন্য কোনো --port ব্যবহার করুন অথবা প্রথমে এটি বন্ধ করুন।
লঞ্চারটি .venv-এ ইনস্টল হয়। সহায়ক python -m tgwitness... কমান্ডগুলো Windows-এ .venv\Scripts\python.exe এবং Linux/macOS-এ .venv/bin/python ব্যবহার করতে হবে, যদি না সেই পরিবেশ ইতিমধ্যেই সক্রিয় থাকে।
সেশন, সুরক্ষা এবং পরিচালনা#
একটি বন্ধ, সামঞ্জস্যপূর্ণ টেলিথন SQLite .session স্থানীয়ভাবে python -m tgwitness.sessions account.session --out account.tgwitness-session দিয়ে রূপান্তর করা যেতে পারে, তারপর More tools → Account → Files-এ লোড করা যেতে পারে। ডিরেক্ট ফাইল ইমপোর্ট এবং QR লগইনও উপলব্ধ। লগইন ফরম্যাট, SOCKS5, HTTP CONNECT, MTProxy এবং বাহ্যিক মাস্টার কী-এর জন্য
CONNECTION-SECURITY.md দেখুন।
পজ পর্যবেক্ষণ সংগ্রহ বন্ধ করে। লক শুধুমাত্র ব্রাউজার অ্যাক্সেস বন্ধ করে। ট্যাব বন্ধ করলে কালেক্টর প্রসেস চলতেই থাকে। প্রসেস বন্ধ করলে সংগ্রহ বিঘ্নিত হয়; একটি হিস্ট্রি স্ন্যাপশট সমস্ত মিস হওয়া সম্পাদনা বা মুছে ফেলা পুনর্গঠন করতে পারে না। ইভেন্ট পলিসি, অ্যাটাচমেন্ট কুই, অ্যাকাউন্ট আইসোলেশন, এবং রিস্টার্ট আচরণের জন্য সংগ্রহ কীভাবে কাজ করে তা দেখুন।
সেশন এবং গোপনীয়তাগুলি এনক্রিপ্ট করা হয়। বার্তার বিষয়বস্তু, মিডিয়া এবং এক্সপোর্টগুলির জন্য একটি এনক্রিপ্ট করা ডিস্ক বা ভলিউম প্রয়োজন। জার্নাল স্বাক্ষরগুলিকে একটি বিশ্বস্ত কী-র বিরুদ্ধে যাচাই করুন এবং চেকপয়েন্টগুলিকে আলাদাভাবে সংরক্ষণ করুন। নির্বাচিত সংগ্রহ মোডের জন্য ক্যাপচার রেকর্ড, বাহ্যিক সময় রসিদ এবং পরিবেশের প্রত্যয়নপত্র পর্যালোচনা করুন।
ব্যাকআপ/রিস্টোরের জন্য OPERATIONS.md, হোস্টিংয়ের জন্য DEPLOYMENT.md এবং সার্ভিস উদাহরণের জন্য deploy/ পড়ুন। ইনস্টলকৃত প্যানেলে /guide.html এ একটি অফলাইন সেটআপ গাইডও রয়েছে।
বাস্তব যাচাইকরণ এবং অবশিষ্ট সীমাবদ্ধতাগুলি VERIFICATION.md এবং READINESS.md-এ রেকর্ড করা হয়েছে।