TgWitness / ডকুমেন্টেশন

কি পরীক্ষা করা হয়েছে →

তথ্যসূত্র / সেটআপ

Telegram · সংযোগ, প্রক্সি এবং ডেটা সুরক্ষা

প্রমাণীকরণ, স্বয়ংক্রিয় প্রক্সি পুল, আইপি মোড, ফ্যালব্যাক নীতি, বাহ্যিক অনুরোধ এবং গোপন সঞ্চয়।

টিজিউইটনেস / ডকুমেন্টেশন · নিয়োগ এবং পুনরুদ্ধার

নিয়োগ ও পুনরুদ্ধার

এই নথিটি TgWitness 0.9.3-এর আচরণ এবং এর সীমা বর্ণনা করে। প্রমাণীকরণ, উৎস অ্যাক্সেস, নেটওয়ার্ক সংযোগ এবং ক্যাপচার সম্পূর্ণতা পৃথক অবস্থা। সাইন-ইন ধাপ, ফাইল ফর্ম্যাট এবং একাধিক অ্যাকাউন্টের জন্য, অ্যাকাউন্ট এবং সেশন ফর্ম্যাট দিয়ে শুরু করুন। ইভেন্ট নীতি এবং পুনরায় শুরু করার আচরণের জন্য, সংগ্রহ কীভাবে কাজ করে তা দেখুন।

নির্দেশিত সংযোগ সেটআপ#

More tools → Account → Connection route-এ, প্রশাসক This account, An account group বা All accounts নির্বাচন করতে পারেন, তারপর একটি রুট নির্বাচন করতে পারেন। Review selection প্রভাবিত অ্যাকাউন্টগুলির তালিকা দেখায়। Prepare and check সংরক্ষিত রুট পরিবর্তন না করে প্রস্তাবিত রুটটি পরীক্ষা করে। Apply checked connection প্রিভিউ যাচাই করে, প্রয়োজন হলে পর্যবেক্ষণ স্থগিত করে, রুটটি সংরক্ষণ করে এবং পূর্বে চলমান পর্যবেক্ষণ পুনরায় শুরু করে। এটি পূর্বে নিষ্ক্রিয় কোনো অ্যাকাউন্টে কখনই সংগ্রহ শুরু করে না। ইতিহাস ডাউনলোডগুলো বিরতিতে থাকে এবং সেগুলো আলাদাভাবে পুনরায় শুরু করা যেতে পারে। স্যুইচ করার আগে সক্রিয় রপ্তানিগুলো বিরতি দিন।

গ্রুপ পরিবর্তনের সময় ডিফল্টভাবে অ্যাকাউন্টগুলো তাদের নিজস্ব রুটেই থাকে। শুধুমাত্র যখন প্রিভিউতে আপনার ইচ্ছিত পরিবর্তনগুলো তালিকাভুক্ত হয়, তখনই সেই অপশনটি মুছে ফেলুন। অ্যাপ্লিকেশন প্রতিটি অ্যাকাউন্টের ফলাফল রিপোর্ট করে; এটি ডাটাবেস জুড়ে সব-বা-কিছুই লেনদেন নয়। একটি ব্যর্থ সুইচ সেই অ্যাকাউন্টের পূর্ববর্তী সেটিংস পুনরুদ্ধার করে। পুনরায় শুরু করতে ব্যর্থ হলে তা স্পষ্টভাবে দেখানো হয়। প্রিভিউগুলো দশ মিনিটের পর মেয়াদোত্তীর্ণ হয় এবং সংযোগ সেটিংস বা গ্রুপ সদস্যপদে পরিবর্তন হলে নতুন করে যাচাই করতে হয়।

Apply পুনরায় ব্যবহার করে একটি সফল প্রিফ্লাইট ফলাফল ৯০ সেকেন্ড পর্যন্ত যখন এর রুট, মোড এবং নীতি অপরিবর্তিত থাকে। একটি ম্যানেজড টানেলের অবশ্যই একই চলমান প্রক্রিয়া থাকতে হবে। পুরনো ফলাফল, পরিবর্তিত টানেল প্রক্রিয়া এবং স্বয়ংক্রিয় MTProxy পুল রুটগুলো আবার যাচাই করা হয়। স্বাক্ষরিত অ্যাপ্লিকেশন রেকর্ডটি মূল যাচাইয়ের সময় ধরে রাখে এবং পুনরায় ব্যবহার ও এর বয়স রেকর্ড করে। প্রতিটি প্রিফ্লাইট তার অস্থায়ী অননুমোদিত ক্লায়েন্ট বন্ধ করে; কালেক্টর তার নিজস্ব অনুমোদিত সেশন ব্যবহার করে সংযোগ করে।

রুট TgWitness কী পরিচালনা করে
সরাসরি হোস্ট থেকে সংযোগ; একটি বাহ্যিক হোস্ট VPN সনাক্ত বা প্রয়োগ করা হয়নি।
ভিপিএন প্রতিটি অ্যাকাউন্টের জন্য একটি পূর্ণ-টানেল WireGuard প্রোফাইল, যা একটি স্থানীয় ইউজারস্পেস SOCKS5 প্রক্রিয়ায় পরিচালিত হয়। কোনো হোস্ট ইন্টারফেস বা ড্রাইভার ইনস্টল করা নেই।
আমার প্রক্সি SOCKS5, HTTP CONNECT অথবা MTProxy ক্রেডেনশিয়াল। একটি URL SOCKS5/HTTP ফিল্ডগুলো পূরণ করতে পারে। একাধিক অ্যাকাউন্ট নির্বাচন করলে এই প্রবেশকৃত প্রক্সি শেয়ার করা হবে।
পাবলিক MTProto বিদ্যমান পুল Telegram রুট বরাদ্দ করে। বাহ্যিক অনুরোধগুলি নিষ্ক্রিয় থাকবে যতক্ষণ না উন্নত সেটিংসে একটি পৃথক উপযুক্ত প্রক্সি কনফিগার করা হয়।
WARP প্রতিটি নির্বাচিত অ্যাকাউন্টের জন্য একটি পৃথক স্থানীয় টানেল, WARP নিবন্ধনসহ এবং সেই অ্যাকাউন্টের ভল্টে সংরক্ষিত একটি WireGuard প্রোফাইল।

বর্তমান-রুট চেক একটি নতুন, অপ্রমাণিত টেলিগ্রাম ট্রান্সপোর্ট ব্যবহার করে, অ্যাকাউন্টের সেশন নয়। এটি রুটের মাধ্যমে অ্যাকাউন্টের ডেটা সেন্টারে একটি ট্রান্সপোর্ট সংযোগ খুলে এবং একটি অপ্রমাণিত MTProto রাউন্ড ট্রিপ করে (req_pq_multi); এটি কোনো অনুমোদন কী তৈরি করে না এবং কোনো অ্যাকাউন্ট ব্যবহার করে না। রিপোর্টকৃত ল্যাটেন্সি হলো সংযোগের সময় এবং রাউন্ড ট্রিপের সময়ের যোগফল, এবং চেক উভয় অংশই আলাদাভাবে রেকর্ড করে। HTTP-সক্ষম রুটগুলির জন্য এটি অনুরোধ করে Cloudflare সেই রুটের HTTPS ট্রেস করে এবং এর রিপোর্টকৃত এক্সিট আইপি, দেশ, WARP অবস্থা এবং চেকের সময় প্রদর্শন করে। ট্রেস WARP সক্রিয় রিপোর্ট না করলে WARP প্রস্তুতি ব্যর্থ হয়। এই প্রিফ্লাইট চেকগুলো রুটের সংযোগযোগ্যতা এবং পর্যবেক্ষিত এক্সিট রিপোর্ট করে। আর্কাইভের অধিগ্রহণ এবং যাচাইকরণ ফলাফলের মাধ্যমে ধারণকৃত রেকর্ড পর্যালোচনা করুন। শুধুমাত্র চলমান স্থানীয় প্রক্রিয়া সফল এক্সিট চেক হিসেবে গণ্য হয় না।

প্যানেলটি শেষ পাঁচটি চেকের চলমান গড় রাখে। একটি রুট ধীর হয় যখন গড় ৫ সেকেন্ড ছাড়িয়ে যায় বা ধারাবাহিকভাবে তিনটি চেক গড়ের চেয়ে বেশি সময় নেয়, এবং ধারাবাহিকভাবে দুটি চেক ব্যর্থ হলে তা অনুপলব্ধ হয়ে যায়; network.slow_route এবং network.route_recovered পরিবর্তনগুলি রেকর্ড করে। একটি ধীর WARP রুটের জন্য, Re-roll WARP অ্যাকাউন্টের টানেলটি অন্যান্য Cloudflare WARP এন্ডপয়েন্টের বিরুদ্ধে পুনরায় শুরু করে, সবচেয়ে দ্রুতটিকে রাখে এবং রেকর্ড করে network.warp_rerolled সময়সহ; নতুন WARP পরিচয় একটি নতুন WARP ডিভাইস নিবন্ধন করে এবং এটিকে তখনই রাখে যখন এটি দ্রুত হয়। স্থানীয় প্রক্সি ঠিকানা, টেলিগ্রাম অ্যাকাউন্ট এবং এর সেশন একই থাকে; টেলিগ্রাম সংযোগগুলি পুনরায় চালু করা টানেলের মাধ্যমে পুনরায় সংযুক্ত হয়। একটি ধীর WARP রুট সর্বোচ্চ প্রতি ৩০ মিনিটে একবার স্বয়ংক্রিয়ভাবে পুনরায় রোল করা হয়; যখন তা সাহায্য করে না, তখন পরবর্তী রোলগুলি অপারেটরের জন্য অপেক্ষা করে।

পোর্টেবল WARP এবং WireGuard#

এটি একটি অফিশিয়াল নয় এমন WARP ইন্টিগ্রেশন, যা wgcf 2.3.1 এবং wireproxy 1.1.3 ব্যবহার করে। প্রশাসক প্রথম ডাউনলোড বা WARP নিবন্ধনের আগে সেটআপ স্পষ্টভাবে গ্রহণ করেন। সেটআপ সংযোগগুলো সরাসরি GitHub এবং Cloudflare-এ যায় এবং মেশিনের IP প্রকাশ করে। সাধারণ অ্যাকাউন্ট ট্র্যাফিক অ্যাপ্লিকেশন পর্যন্ত তার বিদ্যমান রুট বজায় রাখে। Cloudflare এক্সিট ঠিকানা এবং দেশ নির্বাচন করে; পৃথক টানেলগুলো একটি এক্সিট ঠিকানা ভাগ করতে পারে। দেশ নির্বাচন, পর্যায়ক্রমিক IP রোটেশন এবং হোস্ট-ব্যাপী VPN কিল সুইচ এই ফিচারে প্রদান করা হয় না।

সমর্থিত হেল্পার ডাউনলোড: লিনাক্স এবং ম্যাকওএস x86-64/ARM64, এবং উইন্ডোজ x86-64। আর্টিফ্যাক্টগুলো পর্যালোচিত সোর্সে অন্তর্ভুক্ত SHA-256 হ্যাশের বিরুদ্ধে যাচাই করা হয়, এবং ক্যাশকৃত এক্সিকিউটেবলগুলো লঞ্চের আগে আবার যাচাই করা হয়। কোনও হেল্পার PATH-এ যোগ করা হয় না, সিস্টেম সার্ভিস হিসেবে ইনস্টল করা হয় না, বা কোনো পাবলিক লিসেনার দেওয়া হয় না। সমস্ত ফাইল ওয়ার্কস্পেসের portable-routes/ ডিরেক্টরি এবং এনক্রিপ্টেড ভল্ট এন্ট্রির অধীনে থাকে। লুপব্যাক SOCKS5 লিসেনার স্বাধীনভাবে তৈরি করা ক্রেডেনশিয়াল প্রয়োজন।

ব্যক্তিগত প্রোফাইল এবং WARP অ্যাকাউন্টের শংসাপত্র বিদ্যমান ওয়ার্কস্পেস ভল্টে এনক্রিপ্ট করা হয়। চলমান অবস্থায়, হেল্পারকে শুধুমাত্র মালিকের প্লেনটেক্সট কনফিগারেশন প্রয়োজন; এটি স্বাভাবিক বন্ধের সময় মুছে ফেলা হয়। হোস্ট ক্র্যাশের ফলে এই ফাইলটি মালিক-শুধুমাত্র ডেটা ফোল্ডারে থেকে যেতে পারে। এটি ডিস্ক এনক্রিপ্ট করে না বা এর প্রশাসকের বিরুদ্ধে সুরক্ষা দেয় না। সুপারভাইজার টানেলটি বন্ধ করে যদি প্যানেলের প্যারেন্ট পাইপ অদৃশ্য হয়ে যায়। একটি ব্যর্থ টানেল কখনই সরাসরি ফ্যালব্যাক সক্ষম করে না। প্যানেল রিস্টার্ট নির্বাচিত টানেলটি পুনরুদ্ধার করে; ব্যর্থ স্টার্টগুলি একটি সীমিত বিলম্বের সাথে পুনরায় চেষ্টা করে। স্টপ টানেল এছাড়াও পর্যবেক্ষণকে বিরতি দেয় এবং বন্ধ থাকা অবস্থাটিকে বজায় রাখে। স্টার্ট টানেল টানেলটি শুরু করে; প্রস্তুত হলে পর্যবেক্ষণ আলাদাভাবে পুনরায় শুরু করুন।

আপলোডকৃত WireGuard প্রোফাইলে থাকতে হবে একটি ইন্টারফেস এবং একটি পিয়ার, সম্পূর্ণ IPv4 এবং IPv6 রুট, এবং কোনো হুক, ইনক্লুড, পরিবেশ প্রতিস্থাপন বা অতিরিক্ত লিসেনার থাকবে না। পাবলিক এন্ডপয়েন্ট ঠিকানাগুলো স্টার্টআপের আগে রিসলভ এবং পিন করা হয়। OpenVPN/IPsec এবং প্রাইভেট এন্ডপয়েন্টের জন্য একটি বাহ্যিক VPN বা SOCKS5 গেটওয়ে ব্যবহার করুন।

প্রমাণীকরণ পদ্ধতি#

API আইডি এবং API হ্যাশ একটি অ্যাপ্লিকেশন সনাক্ত করে; এগুলো অ্যাকাউন্ট লগিনের বিকল্প নয়। TgWitness-এ এগুলো ঐচ্ছিক। অগ্রাধিকার: ফর্মে প্রবেশ করানো একটি জোড়া, তারপর আমদানি করা অ্যাকাউন্ট JSON থেকে একটি, তারপর ওয়ার্কস্পেসে সংরক্ষিত জোড়া, তারপর 50-এর বিল্ট-ইন পুল public জোড়া, টেলিগ্রাম একটি প্রত্যাখ্যান করলে এলোমেলো ক্রমে চেষ্টা করা হয় এবং স্বয়ংক্রিয়ভাবে রোটেশন করা হয়। শুধুমাত্র টেলিগ্রাম ডেস্কটপ জোড়া (২০৪০) একটি মিলিত টেলিগ্রাম ডেস্কটপ ক্লায়েন্ট বিবরণ সহ পাঠানো হয়। my.telegram.org -এ API ডেভেলপমেন্ট টুলস থেকে আপনার নিজস্ব জোড়া আপনার সমস্ত অ্যাকাউন্টের সাথে ব্যবহার করা যেতে পারে; প্রতিটি অ্যাকাউন্টের নিজস্ব অনুমোদন থাকে।

পদ্ধতি প্রয়োজনীয়তা টিজিউইটনেস সাপোর্ট
ফোন, কোড, ঐচ্ছিক 2FA অ্যাকাউন্ট অ্যাক্সেস; API জোড়া ঐচ্ছিক প্যানেল লগইন
অথর কী হেক্স + DC আইডি পূর্ণ ৫১২-অক্ষরের কী এবং DC ১–৫ ডাইরেক্ট অথ কী ট্যাব; অনুমোদন সংরক্ষণের আগে ঐচ্ছিক ব্যবহারকারী আইডি যাচাই করা হয়
টেলিথন স্ট্রিংসেশন একটি বৈধ সেশন স্ট্রিং প্যানেল লগইন
টেলিথন SQLite .session বন্ধ, সামঞ্জস্যপূর্ণ অনুলিপি স্কিমা ৭/৮-এর সরাসরি প্যানেল আমদানি; ঐচ্ছিক অফলাইন CLI
পাইরোগ্রাম এসকিউএলআইটি .session বন্ধ উৎপাদন ব্যবহারকারী সেশন স্কিমা ২/৩-এর প্যানেল থেকে সরাসরি আমদানি
টেলিগ্রাম ডেস্কটপ TData ZIP একটি আধুনিক অ্যাকাউন্ট; সুরক্ষিত থাকলে স্থানীয় পাসকোড চেকসাম/ডিক্রিপশন যাচাইসহ ইন-মেমোরি রূপান্তর
অ্যাকাউন্ট JSON সমর্থিত API/সেশন/কী ক্ষেত্রসমূহ শুধুমাত্র মেটাডেটা API ক্রেডেনশিয়াল পূরণ করে; সেশন/কী বা ফোন/QR লগইন এখনও প্রয়োজন।
কিউআর লগইন অনুমোদিত টেলিগ্রাম অ্যাপ থেকে নিশ্চিতকরণ স্থানীয় QR জেনারেট, মেয়াদোত্তীর্ণ/পুনরায় চেষ্টা, ঐচ্ছিক 2FA
টিডিএলিব / পাইরোগ্রাম স্ট্রিংসেশন অন্যান্য গ্রন্থাগার-নির্দিষ্ট ফরম্যাট সমর্থনবিহীন
বট টোকেন নিজের অ্যাক্সেস/আপডেট মডেল সহ একটি বট এই সংগ্রাহক দ্বারা ব্যবহৃত হয়নি

টেলিগ্রাম কোড ডেলিভারি নির্বাচন করে, যার মধ্যে এসএমএস পাঠানো হবে কিনা তাও অন্তর্ভুক্ত। একটি API হ্যাশ বাতিলকৃত সেশন ঠিক করতে বা ভুলে যাওয়া 2FA পাসওয়ার্ড প্রতিস্থাপন করতে পারে না। TgWitness লগইন কোড বা টেলিগ্রাম 2FA পাসওয়ার্ড ডিস্কে সংরক্ষণ করে না।

ব্যক্তিগত উৎসের জন্য, অ্যাকাউন্টের ইতিমধ্যেই অ্যাক্সেস থাকতে হবে। গ্রুপ ব্যবহারকারীর নাম অপ্রয়োজনীয়। প্রক্সি বা সেশন আমদানি সদস্যপদ বা প্রশাসক অধিকার প্রদান করে না। চ্যাটের সেটিংস নির্ধারণ করে সদস্যরা তারা যোগদানের আগে থেকে ইতিহাস দেখতে পারবে কিনা।

টেলিথন সেশন ফাইল আমদানি করুন#

Telethon SQLite, Pyrogram SQLite, এবং Telegram Desktop TData বিভিন্ন ফরম্যাট ব্যবহার করে। প্যানেল সমর্থিত কাঠামোগুলো সনাক্ত করে এবং রূপান্তর করে; ফাইলের নাম পরিবর্তন করা রূপান্তর নয়। Files-এর অধীনে একটি সেশন এবং এর সঙ্গী JSON নির্বাচন করুন, Check files চাপুন, তারপর Connect account করুন। সর্বোচ্চ চারটি মিলিত ফাইল এবং মোট ৮ MiB গ্রহণ করা হয়। TData/JSON-এর বিবরণের জন্য ফরম্যাট সীমা দেখুন। পাসকোড পুনরুদ্ধারের কোনো ব্যবস্থা নেই। ফোন/2FA বা QR লগইন একটি পৃথক অনুমোদন তৈরি করে।

ঐচ্ছিক শুধুমাত্র টেলিথনের কমান্ড-লাইন পথটি এখনও উপলব্ধ রয়েছে:

  1. মূল সেশন ব্যবহার করে ক্লায়েন্টটি বন্ধ করুন এবং একটি সামঞ্জস্যপূর্ণ কপি তৈরি করুন। কনভার্টার অসম্পূর্ণ WAL/জার্নালযুক্ত ফাইলগুলো প্রত্যাখ্যান করে। চেক এড়ানোর জন্য সেই ফাইলগুলো মুছে ফেলার পরিবর্তে মূল ক্লায়েন্টটি সঠিকভাবে বন্ধ করুন।
  2. TgWitness পরিবেশ থেকে চালান:
python -m tgwitness.sessions account.session --out account.tgwitness-session
  1. অ্যাকাউন্ট যোগ করুন → ফাইলস-এ, ফলাফল লোড করুন অথবা এর স্ট্রিং পেস্ট করুন, এবং চালিয়ে যান।
  2. প্রদর্শিত সংখ্যাত্মক অ্যাকাউন্ট আইডি পরীক্ষা করুন, উৎসগুলো নির্বাচন করুন এবং পর্যবেক্ষণ শুরু করুন।

রূপান্তরিত ফাইলটি একটি এনক্রিপ্ট না করা অ্যাকাউন্ট-অ্যাক্সেস গোপনীয়তা। এটি সুরক্ষিত স্টোরেজে রাখুন এবং কখনই কমিট করবেন না বা কোনো তৃতীয় পক্ষের রূপান্তর সেবার কাছে পাঠাবেন না। TgWitness অনুমোদিত সেশনটি তার এনক্রিপ্টেড ভল্টে সংরক্ষণ করে। একটি সেশন কপি করলে আলাদা কোনো অনুমোদন তৈরি হয় না: ক্লোন করা auth কী ব্যবহার করে সমান্তরাল ক্লায়েন্ট চালাবেন না এবং স্বতন্ত্র আপডেট ডেলিভারি ধরে নেবেন না।

রূপান্তর অনুমোদন স্থানান্তর করে, মূল বার্তাগুলো নয়, এন্টিটি ক্যাশ বা একটি টেকসই আপডেট কার্সর। এটি প্রক্রিয়া পুনঃশুরুতে আপডেট পুনরুদ্ধার ঠিক করে না।

এমটিপ্রোটো, টেলিথন এবং প্রক্সি#

MTProto হল টেলিগ্রামের প্রোটোকল। Telethon হল Python ক্লায়েন্ট লাইব্রেরি যা TgWitness ব্যবহার করে। MTProxy হল একটি টেলিগ্রাম পরিবহন প্রক্সি; SOCKS5 এবং HTTP CONNECT সাধারণ টানেল প্রদান করে। কোনোটাই অ্যাকাউন্ট প্রামাণীকরণের বিকল্প নয়।

More tools → Account → Settings → Connection settings → Change connection route-এ সাইন ইন করার আগে প্রতিটি ওয়ার্কস্পেসের জন্য রুটটি সংরক্ষণ করুন। নতুন ওয়ার্কস্পেসগুলো ডিফল্টভাবে Automatic MTProxy · public lists with Hide the address ব্যবহার করে। যে ওয়ার্কস্পেসগুলো স্পষ্টভাবে Direct ব্যবহার করেছিল, সেগুলো সেই মোডটি ধরে রাখে যা এটিকে অনুমতি দেয়।

ফাইলগুলো বার্তা পড়ার সংযোগ থেকে আলাদা সংযোগের মাধ্যমে পড়া হয়, যেমনটি অফিসিয়াল অ্যাপগুলো করে। অ্যাকাউন্টের নিজস্ব ডেটা সেন্টারে তারা নতুন MTProto সেশনের সাথে অ্যাকাউন্টের অনুমোদন কী পুনর্ব্যবহার করে; অন্য কোনো ডেটা সেন্টারের জন্য অ্যাকাউন্ট সংযুক্ত থাকা অবস্থায় একটি কী তৈরি ও অনুমোদিত হয় এবং এটি শুধুমাত্র মেমরিতে রাখা হয়। প্রতিটি ফাইল সংযোগ অ্যাকাউন্টের মতো একই রুট ব্যবহার করে। প্রতি ডেটা সেন্টারে এগুলোর সংখ্যা সীমিত করা হয়েছে Parameters → Performance → প্রতি টেলিগ্রাম ডেটা সেন্টারে ফাইল সংযোগের সংখ্যা; 0 মানে ফাইলগুলো শুধুমাত্র অ্যাকাউন্টের প্রধান সংযোগের মাধ্যমে পড়া হয়। একটি ইনস্টলেশনের সমস্ত অ্যাকাউন্টে একসঙ্গে সর্বোচ্চ পাঁচটি টেলিগ্রাম সংযোগ স্থাপন করা হয়।

আইপি মোডসমূহ#

রুট সংযোগ নির্বাচন করে। প্যানেলের অ্যাকাউন্ট সেকশনের আইপি মোড, আইপি সুরক্ষা নির্ধারণ করে কখন সার্ভারের ঠিকানা প্রকাশ পেতে পারে। এই নিয়ন্ত্রণগুলো VPN ইনস্টল করে না বা সমস্ত মেশিন ট্র্যাফিক রাউট করে না।

মোড টেলিগ্রাম বাহ্যিক অনুরোধসমূহ
ঠিকানা লুকান (hide) প্রক্সি ব্যবহার করুন; যদি কোনোটিই কাজ না করে তবে অপেক্ষা করুন। সরাসরি কোনো বিকল্প নেই। SOCKS5/HTTP আবশ্যক; প্রযোজ্য প্রক্সি ছাড়া অনুরোধ প্রত্যাখ্যান করুন।
শেষ বিকল্প হিসেবে সরাসরি (fallback) স্বয়ংক্রিয় MTProxy কনফিগার করা বিলম্বের পর Direct ব্যবহার করতে পারে, তারপর একটি কার্যকর প্রক্সিতে ফিরে আসে। কনফিগার করা একটি বাহ্যিক প্রক্সি বা অ্যাকাউন্টের SOCKS5/HTTP রুট ব্যবহার করা অগ্রাধিকার; অন্যথায় Direct অনুমোদিত।
টানেল বা ভিপিএন-এর পিছনে সার্ভার (tunnel) সরাসরি পথ এবং তাৎক্ষণিক স্বয়ংক্রিয় পুল ব্যাকআপ অনুমোদিত। যখন কোনো প্রযোজ্য প্রক্সি কনফিগার করা না থাকে, তখন ডাইরেক্ট অনুমোদিত।

টানেল বা VPN মোড ধরে নেয় যে আপনি সেই নেটওয়ার্কটি আলাদাভাবে পরিচালনা করছেন। কার্যকর টানেল না থাকলে গন্তব্যগুলো সার্ভারের নিজস্ব ঠিকানা দেখতে পারবে। অপশনের নামের পরিবর্তে আপনার প্রকৃত নেটওয়ার্ক অনুযায়ী মোড নির্বাচন করুন।

একটি পথ বেছে নিন#

রুট সেটিংস সীমা
স্বয়ংক্রিয় MTProxy নির্মিত তালিকা বা অপারেটর ক্যাটালগ একটি কার্যকর টেলিগ্রাম রুট বজায় রাখে; সরাসরি ফ্যালব্যাক আইপি মোডের উপর নির্ভর করে।
সরাসরি টানেল বা ভিপিএন মোড টেলিথন হোস্টের নেটওয়ার্ক পথ ব্যবহার করে।
সক্স৫ হোস্ট, পোর্ট, ঐচ্ছিক ব্যবহারকারীর নাম/पासওয়ার্ড python-socks, রিমোট গন্তব্যে DNS সক্ষম
এইচটিটিপি কানেক্ট হোস্ট, পোর্ট, ঐচ্ছিক ব্যবহারকারীর নাম/पासওয়ার্ড সরল HTTP CONNECT; প্রক্সি নিজে TLS বাস্তবায়ন করা হয়নি।
এমটিপ্রক্সি হোস্ট, পোর্ট, গোপন পরীক্ষামূলক টেলিথন পরিবহন; ৩২টি হেক্সাডিসিমাল সংখ্যা বা dd + ৩২টি হেক্সাডিসিমাল সংখ্যা

Fake TLS ee সিক্রেটগুলো প্রত্যাখ্যাত। Telethon 1.45-এর নরমালাইজেশন প্রিফিক্স এবং ডোমেইন সরিয়ে দিতে পারে, কিন্তু এতে Fake TLS বাস্তবায়িত হয় না। tg://proxy?server=…&port=…&secret=… বা https://t.me/proxy?server=…&port=…&secret=… পেস্ট করুন এবং লিঙ্ক থেকে ফিল ফিল্ডস নির্বাচন করুন। এটি সংযোগ বা সংরক্ষণ না করেই ক্ষেত্রগুলো যাচাই ও পূরণ করে; রুটটি আলাদাভাবে পর্যালোচনা ও সংরক্ষণ করুন। ম্যানুয়াল ক্ষেত্রগুলোও উপলব্ধ থাকবে। টেলিগ্রাম প্রক্সি লিঙ্কগুলো দেখুন।

আপনার ইনস্টলেশন দ্বারা সরবরাহিত পাবলিক প্রক্সি#

বিল্ট-ইন তালিকাটি সাতটি উৎস একত্রিত করে: SoliSpirit/mtproto, zakky8/mtproto-proxy-pro, kort0881/telegram-proxy-collector, 3yed-61/MTP-Collector, Therealwh/MTPproxyLIST, KhodeJav/telegram-proxy-collector এবং tgmtproxy/telegram-mtproto-proxy-list. সংযুক্ত স্ন্যাপশটে এন্ডপয়েন্ট তথ্য, উৎস বরাদ্দ এবং ডাউনলোড তারিখ রয়েছে। তালিকাগুলো ইনপুট; নিচের সংযোগ যাচাইগুলো নির্ধারণ করে কোন প্রক্সিগুলো ব্যবহার করা হবে।

স্বয়ংক্রিয় MTProxy টেলিগ্রাম ট্রান্সপোর্ট সংযোগ পরীক্ষা করে, একটি কার্যকর প্রক্সি রাখে এবং এটি ব্যর্থ হলে অন্যটিতে স্যুইচ করে। যখন পর্যাপ্ত কার্যকর এন্ট্রি থাকে, তখন ওয়ার্কস্পেসগুলো ভিন্ন প্রক্সি পছন্দ করে; প্রক্সিগুলো একটি এক্সিট ঠিকানা ভাগ করতে পারে। ব্যর্থ প্রক্সিগুলো অন্য একটি প্রচেষ্টার আগে বিশ্রাম নেয়। যদি কোনোটিই কাজ না করে, তাহলে IP মোড নির্ধারণ করে যে সংগ্রহ কি অপেক্ষা করবে নাকি সরাসরি সংযোগ ব্যবহার করতে পারবে। প্রক্সি পরিবর্তন করলে অ্যাকাউন্ট পরিবর্তন হয় না বা এর জার্নাল মুছে যায় না। স্বাক্ষরিত জার্নালে রাউটের পছন্দ ও পরিবর্তনগুলি রেকর্ড করা হয়।

স্বয়ংক্রিয় রুটগুলি সক্রিয় থাকাকালীন, তালিকাগুলি প্রতি ঘণ্টায় রিফ্রেশ হয় এবং পরিবহন যাচাইকরণ ডিফল্টরূপে প্রতি দশ মিনিটে চলে। এই সময়সীমাগুলি কনফিগারযোগ্য। পাবলিক তালিকা আপডেট করার অনুরোধ একটি রিফ্রেশ আহ্বান করে; শুধুমাত্র তালিকা দেখা সংরক্ষিত ম্যানুয়াল রুট পরিবর্তন করে না।

টেলিগ্রাম ট্র্যাফিক এবং HTTPS অনুরোধগুলি ভিন্ন রুট ব্যবহার করে। তালিকা ডাউনলোডগুলি একটি পৃথক HTTPS সংযোগ এবং সরবরাহিত external-request রুট ব্যবহার করে। TGWITNESS_PROXY_FEED_PROXY স্পষ্টভাবে সেই রুটটিকে একটি HTTP/SOCKS5 প্রক্সি দিয়ে ওভাররাইড করে; উভয় collector Compose ভ্যারিয়েন্টই এটিকে ফরওয়ার্ড করে। ব্যাকগ্রাউন্ড পুল প্রধান ওয়ার্কস্পেস অনুসরণ করে। কোনও টেলিগ্রাম সেশন, API ক্রেডেনশিয়াল, প্যানেল টোকেন বা বট টোকেন ফিড প্রদানকারীদের কাছে পাঠানো হয় না। প্রদানকারীর নাম, স্ন্যাপশট তারিখ এবং ডাউনলোড রুট 'তালিকাটি কোথা থেকে এসেছে' শিরোনামের অধীনে প্রদর্শিত হয়।

MTProxy শুধুমাত্র টেলিগ্রাম ট্র্যাফিক বহন করে। ওয়ার্কস্পেসের HTTP অপারেশন যেমন টাইমস্ট্যাম্প, নোটিফিকেশন, অফ-সাইট কপি এবং সোর্স চেক কনফিগার করা থাকলে একটি পৃথক SOCKS5/HTTP প্রক্সি ব্যবহার করে, তারপর অ্যাকাউন্টের SOCKS5/HTTP রুট ব্যবহার করে। উভয়ই না থাকলে, Hide the address অনুরোধ প্রত্যাখ্যান করে; অন্য মোডগুলো Direct অনুমোদন করে। বাহ্যিক অনুরোধগুলো নিষ্ক্রিয় করা যেতে পারে। স্পষ্টভাবে কনফিগার করা ফিড-ডাউনলোড প্রক্সি আলাদা অপারেটর ওভাররাইড হিসেবে থাকে। স্বতন্ত্র সাক্ষী সেবা তার নিজস্ব পথ বজায় রাখে।

অপারেটর-পরিচালিত ব্যক্তিগত সেবার জন্য, বিদ্যমান সার্ভার পরিবেশ সেটিং TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1 ব্যক্তিগত গন্তব্য অনুমোদন করে এবং প্রক্সি-সাইড হোস্টনেম রেজোলিউশন বজায় রাখে। এটি প্যানেল থেকে সক্ষম করা যায় না। পাবলিক-অনলি মোড পাবলিক রিজলভারকে জিজ্ঞাসা করার আগে .onion গন্তব্য প্রত্যাখ্যান করে; Tor অনিয়ন সার্ভিসের জন্য সেই স্পষ্ট ব্যক্তিগত-গন্তব্য সেটিং এবং একটি উপযুক্ত প্রক্সি প্রয়োজন। এই DNS আচরণটি বাহ্যিক HTTP অপারেশনের ক্ষেত্রে প্রযোজ্য, টেলিগ্রামের ট্রান্সপোর্টে নয়। Cloudflare JSON DNS এন্ডপয়েন্টটি ডকুমেন্ট করে।

স্বয়ংক্রিয় পুল পরামিতিসমূহ

More tools → Parameters → Automatic MTProxy-এর অধীনে ব্যর্থতার সীমা, কুলডাউন, পরিকল্পিত রোটেশন, প্রক্সি শেয়ারিং এবং অনুমোদিত ফলব্যাক বিলম্ব কনফিগার করুন।

নিয়ন্ত্রণ ডিফল্ট
প্রতিস্থাপনের আগে বিচ্ছিন্নতা 3ের মধ্যে 10 মিনিট
প্রতি সংযোগ প্রচেষ্টায় প্রক্সি পরীক্ষা করা হয়েছে 3
ব্যর্থতার পর প্রথম / সর্বোচ্চ বিশ্রাম 10 মিনিট / 6 ঘণ্টা
পরিকল্পিত রোটেশন অক্ষম; ব্যর্থতার সময় সক্রিয় করুন
প্রতি প্রক্সির অ্যাকাউন্ট 0: পৃথক এন্ট্রি পছন্দ করুন, প্রয়োজনে শেয়ার করুন। 1-কে একচেটিয়া এন্ট্রির জন্য অপেক্ষায় সেট করুন।
অনুমোদিত সরাসরি বিকল্পে যাওয়ার আগে বিলম্ব 10 মিনিট; লুকান ঠিকানা এখনও সরাসরি অস্বীকার করে
ফিড রিফ্রেশ / পরিবহন যাচাই 60/10 মিনিট; প্রধান কর্মক্ষেত্রের মানগুলো ভাগ করা পুলে প্রযোজ্য

বিভিন্ন প্রক্সি একই এক্সিট ঠিকানা শেয়ার করতে পারে। টেলিগ্রামের সীমা প্রতিটি রুটে প্রযোজ্য।

পাবলিক তালিকা আপনার নিজস্ব অপারেটর ক্যাটালগ দিয়ে প্রতিস্থাপন করতে, নিচের ওভাররাইড কনফিগার করুন। এটি বাহ্যিক সাবস্ক্রিপশন সম্পূর্ণরূপে নিষ্ক্রিয় করে, এমনকি যখন এর proxies অ্যারে খালি থাকে তখনও।

খালি ক্যাটালগটি proxy-config/proxies.json -এ কপি করুন এবং আপনার স্থাপিত পাবলিক এন্ডপয়েন্টগুলো যোগ করুন:

{"format": "tgwitness-proxy-catalog-v1", "proxies": [
  {"id": "project-eu", "label": "Project EU",
   "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}

উদাহরণ মানগুলো প্রতিস্থাপন করতে হবে। সর্বোচ্চ ৩২টি স্বতন্ত্র এন্ট্রি গ্রহণ করা হয়। প্রমাণিত তালিকাটি শেয়ার্ড সিক্রেট ছাড়া লেবেল/হোস্ট/পোর্ট ফেরত দেয়; একটি নির্বাচন করলে তার ক্রেডেনশিয়াল ওয়ার্কস্পেস ভল্টে সংরক্ষিত হয়। স্পষ্ট পরিবহন পরীক্ষার আগ পর্যন্ত উপলব্ধতা পরীক্ষিত হয়নি। একটি ভুল ফরম্যাটের ক্যাটালগ ম্যানুয়াল কনফিগারেশন প্রয়োজন করে।

নেটিভ লঞ্চ: স্থানীয় JSON পাথে TGWITNESS_PROXY_CATALOG সেট করুন। ডকার:

docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build

ওভারলে মাউন্ট proxy-config শুধুমাত্র পড়ার জন্য; ফাইলগুলো কন্টেইনার UID 10001 দ্বারা পড়ার যোগ্য হতে হবে। এই ডিরেক্টরি Git, Docker বিল্ড প্রসঙ্গ এবং সোর্স আর্কাইভ থেকে বাদ দেওয়া হয়েছে। এই ক্যাটালগ সংগ্রহকারী অ্যাকাউন্টগুলো কনফিগার করে; উইটনেস বট তার নিজস্ব HTTP/SOCKS5 রুট ব্যবহার করে, MTProxy নয়।

সরাসরি ফ্যালব্যাক উপরের আইপি মোড দ্বারা নিয়ন্ত্রিত হয়। কোনো রুট পরিবর্তন করার আগে পর্যবেক্ষণ বিরতি দিন। সেভ করলে পুরনো ক্লায়েন্টগুলো বিচ্ছিন্ন হয়ে যায় এবং অসম্পূর্ণ লগইন বাতিল হয়ে যায়; একটি নতুন ক্লায়েন্ট সেভ করা রুট ব্যবহার করে। অ্যাকাউন্টের জার্নাল/সেশন বাইন্ডিং বজায় থাকে। সেটিংস পূর্ববর্তী রুট প্রতিস্থাপন করে: এটি সম্পাদনা করার সময় প্রক্সি শংসাপত্র পুনরায় প্রবেশ করান।

network.enc-এ ক্রেডেনশিয়ালগুলো এনক্রিপ্ট করা হয়। API ব্যবহারকারীর নাম, পাসওয়ার্ড বা সিক্রেট ফেরত দেয় না। স্বাক্ষরিত রেকর্ডগুলোতে রুট টাইপ এবং ক্রেডেনশিয়াল উপস্থিত আছে কিনা তা থাকে, এন্ডপয়েন্ট এবং সিক্রেটগুলো বাদ দিয়ে। অপারেটর প্যানেলে এন্ডপয়েন্ট দেখতে পারে। সিক্রেট ফিল্ডগুলো সেভ, লক বা ওয়ার্কস্পেস পরিবর্তনের পর পরিষ্কার হয়ে যায়।

টেলিগ্রাম সংযোগ পরীক্ষা, লগইন করার আগেও উপলব্ধ, একটি অস্থায়ী অননুমোদিত টেলিগ্রাম সংযোগ পথের মাধ্যমে খোলে এবং বন্ধ করে। এটি কোনো আইপি-চেক ওয়েবসাইটের সাথে যোগাযোগ করে না। সফল হলে এটি পরিবহন সংযোগ স্থাপন করে, গ্রুপে প্রবেশাধিকার, সম্পূর্ণ ডেলিভারি বা অজ্ঞাতনামা নিশ্চিত করে না।

প্রক্সি টেলিগ্রাম ক্লায়েন্টের সংযোগগুলিতে প্রযোজ্য, যার মধ্যে টেলিগ্রাম DC মিডিয়া ডাউনলোডও রয়েছে। ব্রাউজার, pip, SSH এবং ম্যানুয়ালি চালিত TSA টুলগুলির আলাদা রুট রয়েছে। প্রক্সি হোস্টনেম স্থানীয়ভাবে রিসলভ করা যেতে পারে। rdns গন্তব্য হোস্টনেমকে প্রভাবিত করে; টেলিগ্রাম প্রায়ই সংখ্যামূলক DC IP সরবরাহ করে।

SOCKS5 এবং সাধারণ HTTP CONNECT নিজেই প্রক্সি ক্রেডেনশিয়াল বা ক্লায়েন্ট-থেকে-প্রক্সি টানেল এনক্রিপ্ট করে না। MTProto আলাদাভাবে টেলিগ্রাম ট্র্যাফিক সুরক্ষিত করে। অবিশ্বস্ত নেটওয়ার্কে প্রক্সির সাথে একটি উপযুক্ত নিরাপদ চ্যানেল ব্যবহার করুন। ব্যক্তিগত গ্রুপগুলো MTProto দ্বারা ট্রানজিটে সুরক্ষিত ক্লাউড চ্যাট; এন্ড-টু-এন্ড সিক্রেট চ্যাটগুলো একটি পৃথক চ্যাট ধরন, যা সিক্রেট চ্যাট মডিউল দ্বারা রেকর্ড করা হয়।

এনক্রিপশন এবং স্বাক্ষর#

স্তর বাস্তবায়িত অপারেটরের দায়িত্ব
টেলিগ্রাম ট্র্যাফিক টেলিথন এমটিপ্রোটো প্ল্যাটফর্মের বিশ্বাসযোগ্যতা, পথ এবং প্রাপ্যতা
ওয়েব প্যানেল বাহক টোকেন, লুপব্যাক ডিফল্ট, অনুরোধ সীমা দূরবর্তী অ্যাক্সেসের জন্য HTTPS বা SSH টানেল
গোপন কথা API শংসাপত্র, সেশন, প্রক্সি শংসাপত্র এবং স্বাক্ষর ব্যক্তিগত কী-এর জন্য ফারনেট ডিক্রিপশন কী এবং চলমান হোস্ট সুরক্ষিত রাখুন।
ভল্ট কী স্থানীয় কী, অথবা নতুন ইনস্টলেশনের জন্য বাহ্যিক মাস্টার কী সুরক্ষিত স্টোরেজ এবং কী ব্যাকআপ পৃথক করুন
বার্তা এবং সংযুক্তি সাধারণ পাঠ্য অ্যাপ্লিকেশন সংরক্ষণ এনক্রিপ্ট করা ডিস্ক/ভলিউম
জিআইপি/জসনএল/সিএসভি/এইচটিএমএল অখণ্ডতা যাচাই, কোনো বিষয়বস্তু এনক্রিপশন নেই রপ্তানি করা অনুলিপি এবং স্থানান্তরগুলি সুরক্ষিত করুন
উৎস এবং সময় স্বাক্ষরিত জার্নাল, প্রক্রিয়া রসিদ, RFC 3161 টুলস বিশ্বস্ত চাবি, স্বাধীন চেকপয়েন্ট/টিএসএ এবং হেফাজত প্রক্রিয়া

অ্যাকাউন্টে স্টোরেজ সুরক্ষা এই অবস্থাগুলো দেখায়। প্যানেল টোকেন একটি অ্যাক্সেস সিক্রেট, এনক্রিপশন পাসওয়ার্ড নয়। এটি প্রশাসককে অ্যাক্সেস দেয়; ইস্যুকৃত টোকেনগুলো অ্যাকাউন্ট এবং চ্যাটে সীমাবদ্ধ করা যেতে পারে। ওয়ার্কস্পেসগুলো হোস্ট প্রক্রিয়া শেয়ার করে এবং পৃথক ভাড়াটিয়া নয়।

BitLocker, LUKS, FileVault বা একটি পরিচালিত এনক্রিপ্ট করা ভলিউম তাদের নিজ নিজ হুমকি মডেলের অধীনে স্টোরেজ সুরক্ষিত রাখতে পারে। একটি আনলক করা চলমান মেশিনের প্রশাসক এখনও ডেটা পড়তে পারেন। স্টোরেজ পরিকল্পনায় SQLite WAL/SHM, মিডিয়া, অস্থায়ী এক্সপোর্ট, সোয়াপ, ব্যাকআপ এবং ব্রাউজার ডাউনলোড অন্তর্ভুক্ত করুন। একটি ডকার ভলিউম শুধুমাত্র ভলিউম হওয়ার কারণে এনক্রিপ্ট করা হয় না।

বাহ্যিক মাস্টার কী#

নতুন ইনস্টলেশনের জন্য, মাস্টার কীটি ডেটা ডিরেক্টরির বাইরে রাখুন। এটি স্বয়ংক্রিয়ভাবে বিদ্যমান লোকাল-কি ভল্টকে মাইগ্রেট করে না। শুধুমাত্র সার্ভিস আইডেনটিটির জন্য অ্যাক্সেসযোগ্য একটি কী ডিরেক্টরি প্রস্তুত করুন, তারপর চালান:

python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case

ইনস্টল করা প্রকল্প পরিবেশ ব্যবহার করে PowerShell:

python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case

Docker-এ, ফাইলটি /data-এর বাইরে শুধুমাত্র-পঠন (read-only) হিসেবে মাউন্ট করুন, উদাহরণস্বরূপ /run/secrets/tgwitness-master.key-এ, এবং পরিবেশ ভেরিয়েবল (environment variable) সেই পথে সেট করুন। সার্ভিস UID-কে এটি পড়ার অনুমতি থাকতে হবে। পরিবেশ/কনফিগারেশন ফাইলের মাধ্যমে পথটি পাস করুন, কী-এর বাইট নয়।

প্রতিটি ওয়ার্কস্পেস একটি এলোমেলো পাবলিক সল্ট এবং HKDF-SHA256-এর মাধ্যমে প্রাপ্ত নিজস্ব ফারনেট কী পায়।vault.external.json ডেরিভেশন মেটাডেটা সংরক্ষণ করে, মাস্টার কী নয়। কোনো কী অনুপস্থিত বা ভুল থাকলে, নীরবে প্রতিস্থাপন না করে স্টার্টআপ ব্যর্থ হয়। পুনরুদ্ধারের জন্য সল্ট মেটাডেটা এবং মাস্টার কী উভয়ই সংরক্ষণ করুন।

সমস্ত ওয়ার্কস্পেস একই মাস্টার কী থেকে উদ্ভূত; এর দুর্বলতা পুরো ইনস্টলেশনকে প্রভাবিত করে। চলমান প্রক্রিয়া গোপনীয়তা ডিক্রিপ্ট করতে পারে। এটি কোনো HSM বা পাসওয়ার্ড KDF নয়। এলোমেলো কী-এর পরিবর্তে ইচ্ছামত মানব পাসওয়ার্ড গ্রহণ করা হয় না।

যথাযথ মাইগ্রেশন বাস্তবায়ন ও যাচাই না হওয়া পর্যন্ত বিদ্যমান ইনস্টলেশনে বিদ্যমান কীটি রেখে দিন।vault.key মুছে ফেলা বা মাস্টার কী প্রতিস্থাপন সেশন/স্বাক্ষর কী-তে অ্যাক্সেস ধ্বংস করতে পারে। এনক্রিপ্ট করা ব্যাকআপ এবং কীগুলো আলাদাভাবে সংরক্ষণ করুন এবং একটি বিচ্ছিন্ন পরিবেশে পুনরুদ্ধার পরীক্ষা করুন।