# Telegram · Sambungan, proksi dan perlindungan data

Canonical page: https://phishdestroy.io/tgwitness/ms/docs/reference/connection/

Pengesahan, kolam proksi automatik, mod IP, dasar sandaran, permintaan luaran dan penyimpanan rahsia.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ms/llms.txt)

Pengesahan, kolam proksi automatik, mod IP, dasar sandaran, permintaan luaran dan penyimpanan rahsia.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penyebaran dan pemulihan](https://phishdestroy.io/tgwitness/ms/docs/reference/deployment/)

![Penyebaran & pemulihan](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

Dokumen ini menerangkan tingkah laku dan had TgWitness 0.9.3. Pengesahan, akses sumber, sambungan rangkaian dan kelengkapan tangkapan adalah keadaan yang berasingan. Untuk langkah log masuk, format fail, dan akaun berbilang, mulakan dengan [akaun dan format sesi](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/). Untuk dasar acara dan tingkah laku permulaan semula, lihat [bagaimana pengumpulan berfungsi](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/).

## Pengesanan sambungan berpandu

Di **Alat lanjut → Akaun → Laluan sambungan**, pentadbir boleh memilih **Akaun ini**, **Kumpulan akaun** atau **Semua akaun**, kemudian pilih laluan. **Semakan pilihan** menyenaraikan akaun yang terjejas. **Sediakan dan semak** menguji laluan yang dicadangkan tanpa menukar yang disimpan. **Terapkan sambungan yang disemak** mengesahkan pratonton, menghentikan pemerhatian jika perlu, menyimpan laluan dan meneruskan pemerhatian yang sedang dijalankan. Ia tidak pernah memulakan pengumpulan dalam akaun yang sebelum ini tidak aktif. Muat turun sejarah kekal tertangguh dan boleh disambung secara berasingan. Hentikan eksport aktif sebelum beralih.

Perubahan kumpulan mengekalkan akaun dengan laluan mereka sendiri secara lalai. Nyahpilih pilihan itu hanya apabila pratonton menyenaraikan perubahan yang anda niatkan. Aplikasi melaporkan keputusan setiap akaun; ia bukan transaksi serba atau tiada serba merentas pangkalan data. Peralihan yang gagal memulihkan tetapan akaun tersebut sebelum ini. Kegagalan untuk menyambung semula dipaparkan secara eksplisit. Pratonton akan tamat selepas sepuluh minit dan sebarang perubahan pada tetapan sambungan atau keahlian kumpulan memerlukan semakan semula.

Apply menggunakan semula keputusan preflight yang berjaya sehingga 90 saat apabila laluan, mod dan dasar tidak berubah. Terowong yang diurus mesti masih mempunyai proses yang sama sedang berjalan. Keputusan yang lebih lama, proses terowong yang berubah dan laluan kolam MTProxy automatik akan diperiksa semula. Rekod aplikasi yang disahkan mengekalkan masa pemeriksaan asal dan merekodkan penggunaan semula serta umurnya. Setiap preflight menutup klien sementara yang tidak disahkan; pengumpul menyambung menggunakan sesi bertauliahnya sendiri.

| Rute | Apa yang diuruskan oleh TgWitness |
| --- | --- |
| Langsung | Sambungan daripada hos; VPN hos luaran tidak dikesan atau dikuatkuasakan. |
| VPN | Satu profil WireGuard terowong penuh bagi setiap akaun, dijalankan oleh proses ruang pengguna tempatan SOCKS5. Tiada antara muka hos atau pemacu dipasang. |
| Proksi saya | SOCKS5, HTTP CONNECT atau kelayakan MTProxy. URL boleh mengisi medan SOCKS5/HTTP. Memilih beberapa akaun berkongsi proksi yang dimasukkan ini. |
| MTProto Awam | Kolam sedia ada menetapkan laluanTelegram. Permintaan luaran dilumpuhkan sehingga proksi berasingan yang sesuai dikonfigurasikan dalam tetapan lanjutan. |
| WARP | Terowong tempatan berasingan untuk setiap akaun terpilih, dengan pendaftaran WARP dan profil WireGuard disimpan dalam peti besi akaun tersebut. |

Semakan laluan semasa menggunakan pengangkutan Telegram baharu yang tidak disahkan, bukan sesi akaun. Ia membuka sambungan pengangkutan melalui laluan ke pusat data akaun dan membuat satu perjalanan pergi-balik MTProto yang tidak disahkan (`req_pq_multi`); ia tidak mencipta kunci kebenaran dan tidak menggunakan sebarang akaun. Latensi yang dilaporkan ialah masa sambungan ditambah perjalanan pergi-balik, dan pemeriksaan merekodkan kedua-dua bahagian secara berasingan. Untuk laluan yang menyokong HTTP ia juga meminta jejak HTTPS Cloudflare melalui laluan tersebut dan memaparkan IP keluar, negara, status WARP dan masa semakan yang dilaporkan. Persiapan WARP gagal melainkan jejak melaporkan WARP aktif. Semakan pra-penerbangan ini melaporkan kebolehhubungan laluan dan keluar yang diperhatikan. Semak rekod yang dirakam melalui hasil pemerolehan dan pengesahan arkib. Proses tempatan yang sedang berjalan sahaja tidak dianggap sebagai semakan keluar yang berjaya.

Panel mengekalkan purata bergerak bagi lima pemeriksaan terakhir. Sesebuah laluan dianggap **perlahan** apabila purata melebihi 5 saat atau tiga pemeriksaan berturut-turut melebihi had itu, dan **tidak tersedia** selepas dua pemeriksaan gagal berturut-turut; `network.slow_route` dan `network.route_recovered` merekod perubahan. Untuk laluan WARP yang perlahan, **Re-roll WARP** memulakan semula terowong akaun terhadap hujung WARP Cloudflare lain, mengekalkan yang terpantas dan merekod `network.warp_rerolled` dengan masa sebelum dan selepas; **Identiti WARP baharu** mendaftar peranti WARP baharu dan mengekalkannya hanya apabila ia lebih pantas. Alamat proksi tempatan, akaun Telegram dan sesinya kekal sama; sambungan Telegram disambung semula melalui terowong yang dihidupkan semula. Laluan WARP yang perlahan di-re-roll secara automatik paling banyak sekali setiap 30 minit; apabila itu tidak membantu, re-roll selanjutnya menunggu pengendali.

### WARP mudah alih dan WireGuard

Ini adalah integrasi WARP tidak rasmi **** menggunakan [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) dan [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3). Pentadbir secara eksplisit menerima tetapan sebelum muat turun pertama atau pendaftaran WARP. Sambungan tetapan tersebut pergi terus ke GitHub dan Cloudflare dan mendedahkan IP mesin. Trafik akaun biasa mengekalkan laluan sedia ada sehingga aplikasi. Cloudflare memilih alamat keluar dan negara; terowong berasingan boleh berkongsi alamat keluar. Pilihan negara, putaran IP berkala dan suis pembunuh VPN untuk seluruh hos tidak disediakan oleh ciri ini.

Muat turun pembantu yang disokong: Linux dan macOS x86-64/ARM64, dan Windows x86-64. Artifak disemak menentang hasSHA-256yang disertakan dalam sumber yang disemak, dan eksekutabel yang disimpan dalam cache disemak semula sebelum pelancaran. Tiada pembantu yang ditambah ke PATH, dipasang sebagai perkhidmatan sistem, atau diberikan pendengar awam. Semua fail terletak di bawah direktori `portable-routes/` ruang kerja dan entri peti simpanan yang disulitkan. Pendengar loopback SOCKS5 memerlukan kelayakan yang dijana secara berasingan.

Profil peribadi dan kelayakan akaun WARP disulitkan dengan peti kerja sedia ada. Semasa dijalankan, pembantu memerlukan konfigurasi teks biasa untuk pemilik sahaja; ia dialih keluar semasa pemberhentian biasa. Kegagalan hos boleh meninggalkan fail ini dalam folder data untuk pemilik sahaja. Ini tidak menyulitkan cakera atau melindungi daripada pentadbirnya. Pengawas menutup terowong jika paip induk panel hilang. Terowong yang gagal tidak akan membolehkan peralihan balik terus. Mula semula panel memulihkan terowong yang dipilih; permulaan yang gagal mencuba semula dengan kelewatan terhad. **Hentikan terowong** juga menangguhkan pemerhatian dan mengekalkan keadaan terhenti. **Mulakan terowong** memulakan terowong; sambung semula pemerhatian secara berasingan apabila siap.

Profil WireGuard yang dimuat naik mesti mengandungi satu Antara muka dan satu Rakan Sebaya, laluan IPv4 dan IPv6 penuh, dan tiada cangkuk, termasuk, penggantian persekitaran atau pendengar tambahan. Alamat hujung awam diselesaikan dan dikunci sebelum permulaan. Gunakan VPN luaran atau gerbang SOCKS5 untuk OpenVPN/IPsec dan hujung peribadi.

## Kaedah pengesahan

**ID API dan hash API mengenal pasti aplikasi; ia tidak menggantikan log masuk akaun.** Ia adalah pilihan dalam TgWitness. Keutamaan: sepasang yang dimasukkan dalam borang, kemudian satu daripada JSON akaun yang diimport, kemudian sepasang yang disimpan dalam ruang kerja, kemudian kolam terbina dalam sebanyak 50 pasangan Telegram Desktop (2040) dihantar dengan keterangan klien Telegram Desktop yang sepadan. Pasangan anda sendiri daripada Alat Pembangunan API di [my.telegram.org](https://my.telegram.org) boleh digunakan dengan semua akaun anda; setiap akaun masih mempunyai kebenaran tersendiri.

| Kaedah | Keperluan | TgWitness sokongan |
| --- | --- | --- |
| Telefon, kod, 2FA pilihan | Akses akaun; pasangan API pilihan | Log masuk panel |
| Kunci Auth HEX + ID DC | Kunci penuh 512-karakter dan DC 1–5 | Tab **Kunci Auth** Langsung; ID Pengguna pilihan disemak sebelum kebenaran disimpan |
| Telethon StringSession | Rentetan sesi yang sah | Log masuk panel |
| Telethon SQLite `.session` | Salinan tertutup dan konsisten | Import panel langsung skema 7/8; CLI luar talian pilihan |
| Pyrogram SQLite `.session` | Sesi pengguna pengeluaran ditutup | Import panel langsung skema 2/3 |
| Telegram Desktop TData ZIP | Satu akaun moden; kod laluan tempatan jika dilindungi | Penukaran dalam memori dengan pemeriksaan checksum/penyahsulit |
| JSON Akaun | Medan API/sesi/kunci yang disokong | Metadata sahaja mengisi kelayakan API; log masuk sesi/kunci atau telefon/QR masih diperlukan |
| Log masuk QR | Pengesahan daripada aplikasi Telegram yang dibenarkan | Penghasilan QR tempatan, tamat tempoh/cubaan semula, 2FA pilihan |
| TDLib / Pyrogram StringSession | Format khusus perpustakaan lain | Tidak disokong |
| Token bot | Sebuah bot dengan model akses/kemas kini tersendiri | Tidak digunakan oleh pengumpul ini |

Telegram memilih penghantaran kod, termasuk sama ada untuk menghantar SMS. Hah API tidak dapat membaiki sesi yang dibatalkan atau menggantikan kata laluan 2FA yang terlupa. TgWitness tidak menyimpan kod log masuk atau kata laluan Telegram 2FA ke cakera.

Untuk sumber peribadi, akaun mesti sudah mempunyai akses. Nama pengguna kumpulan tidak diperlukan. Import proksi atau sesi tidak memberikan hak keahlian atau pentadbir. Tetapan sembang menentukan sama ada ahli dapat melihat sejarah sebelum mereka menyertai.

## Import fail sesi Telethon

Telethon SQLite, Pyrogram SQLite, dan Telegram Desktop TData menggunakan format yang berbeza. Panel mengesan dan menukar struktur yang disokong; menamakan semula fail bukanlah penukaran. Pilih satu sesi dan JSON pengiringnya di bawah **Fail**, tekan **Semak fail**, kemudian **Sambungkan akaun**. Sehingga empat fail yang sepadan dan jumlah 8 MiB diterima. Lihat [had format](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/) untuk butiran TData/JSON. Tiada pemulihan kod laluan. Log masuk Telefon/2FA atau QR mewujudkan kebenaran berasingan.

Laluan baris perintah pilihan hanya untuk Telethon kekal tersedia:

1. Hentikan klien yang menggunakan sesi asal dan buat salinan yang konsisten. Konverter menolak fail dengan WAL/jurnal yang belum selesai. Tutup klien asal dengan betul dan bukannya memadam fail tersebut untuk memintas pemeriksaan.
2. Dari persekitaran TgWitness, jalankan:

```
python -m tgwitness.sessions account.session --out account.tgwitness-session
```

1. Di bawah **Tambah akaun → Fail**, muat naik hasil atau tampal rentetannya, dan teruskan.
2. Semak ID akaun numerik yang dipaparkan, pilih sumber dan mulakan pemerhatian.

**Fail yang ditukar adalah rahsia akses akaun yang tidak disulitkan.** Simpannya dalam simpanan terlindung dan jangan sekali-kali komit atau hantar ke perkhidmatan penukaran pihak ketiga. TgWitness menyimpan sesi yang dibenarkan dalam peti besi yang disulitkannya. Menyalin sesi tidak mencipta kebenaran berasingan: jangan jalankan klien serentak dengan kunci kebenaran klon dan menganggap penghantaran kemas kini secara berasingan.

Pemindahan penukaran memindahkan kebenaran, bukan mesej asal, cache entiti atau penuding kemas kini tahan lama. Ia tidak membaiki pemulihan kemas kini merentasi permulaan semula proses.

## MTProto, Telethon dan proksi

MTProto ialah protokol Telegram. Telethon ialah pustaka klien Python yang digunakan oleh TgWitness. MTProxy ialah proksi pengangkutan Telegram; SOCKS5 dan HTTP CONNECT menyediakan terowong umum. Tiada satu pun menggantikan pengesahan akaun.

Simpan laluan untuk setiap ruang kerja di **Alat lain → Akaun → Tetapan → Tetapan sambungan → Ubah laluan sambungan** sebelum log masuk. Ruang kerja baru secara lalai menggunakan **Automatic MTProxy · senarai awam** dengan **Sembunyikan alamat**. Ruang kerja sedia ada yang secara eksplisit menggunakan Direct mengekalkan mod yang membenarkannya.

Fail dibaca melalui sambungan berasingan daripada yang membaca mesej, seperti yang dilakukan oleh aplikasi rasmi. Di pusat data akaun itu sendiri, mereka menggunakan semula kunci kebenaran akaun dengan sesi MTProto baru; untuk pusat data lain, satu kunci akan dicipta dan diberi kebenaran semasa akaun disambungkan dan disimpan hanya dalam memori. Setiap sambungan fail menggunakan laluan yang sama seperti akaun. Bilangan sambungan per pusat data dihadkan oleh **Parameter → Prestasi → Sambungan fail per pusat data Telegram**; 0 membaca fail hanya melalui sambungan utama akaun. Sebanyak lima sambungan Telegram boleh diwujudkan serentak bagi semua akaun dalam satu pemasangan.

## Mod IP

Rute memilih sambungan. Mod IP, **perlindungan IP** dalam bahagian Akaun panel, menentukan bila alamat pelayan mungkin terdedah. Kawalan ini tidak memasang VPN atau merute semua trafik mesin.

| Mod | Telegram | Permintaan luaran |
| --- | --- | --- |
| Sembunyikan alamat (`hide`) | Gunakan proksi; tunggu jika tiada yang berfungsi. Tiada pelan sandaran langsung. | Perlukan SOCKS5/HTTP; menolak permintaan tanpa proksi yang sesuai. |
| Langsung sebagai pilihan terakhir (`fallback`) | MTProxy automatik mungkin menggunakan Direct selepas kelewatan yang ditetapkan, kemudian kembali ke proksi yang berfungsi. | Utamakan proksi luaran yang dikonfigurasikan atau laluan SOCKS5/HTTP akaun; jika tidak, Direct dibenarkan. |
| Pelayan di sebalik terowong atau VPN (`tunnel`) | Laluan terus dan pelan B imbangan automatik segera dibenarkan. | Direct dibenarkan apabila tiada proksi yang sesuai dikonfigurasikan. |

Mod terowong atau VPN menganggap anda mengurus rangkaian tersebut secara berasingan. Tanpa terowong yang berfungsi, destinasi boleh melihat alamat pelayan itu sendiri. Pilih mod mengikut rangkaian sebenar anda, bukan nama pilihan.

### Pilih laluan

| Rute | Tetapan | Batas |
| --- | --- | --- |
| MTProxy automatik | Senarai terbina dalam atau katalog pengendali | Menjaga laluan Telegram yang berfungsi; sandaran langsung bergantung pada mod IP |
| Langsung | Mod terowong atau VPN | Telethon menggunakan laluan rangkaian hos |
| SOCKS5 | Host, port, nama pengguna/kata laluan pilihan | python-socks, DNS destinasi jauh diaktifkan |
| HTTP CONNECT | Host, port, nama pengguna/kata laluan pilihan | HTTP CONNECT biasa; TLS ke proksi itu sendiri tidak dilaksanakan |
| MTProxy | Host, port, rahsia | Pengangkutan Telethon Eksperimental; 32 digit heksadesimal atau `dd` + 32 digit heksadesimal |

Rahsia Fake TLS `ee` ditolak. Normalisasi Telethon 1.45 boleh menyingkirkan awalan dan domain, tetapi ia tidak melaksanakan Fake TLS. Tampal `tg://proxy?server=…&port=…&secret=…` atau `https://t.me/proxy?server=…&port=…&secret=…` dan pilih **Isi medan daripada pautan**. Ini mengesahkan dan mengisi medan tanpa menyambung atau menyimpan; semak dan simpan laluan secara berasingan. Medan manual kekal tersedia. Lihat [pautan proksi Telegram](https://core.telegram.org/api/links#proxy-links).

### Proksi awam yang disediakan oleh pemasangan anda

Senarai terbina dalam menggabungkan tujuh sumber: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto), [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro), [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector), [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector), [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST), [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) dan [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list). Snapshot yang disertakan mengandungi fakta hujung, atribusi sumber dan tarikh muat turun. Senarai adalah input; pemeriksaan kesalinghubungan di bawah menentukan proksi mana yang digunakan.

**MTProxy automatik** menyemak kesalinghubungan penghantaran Telegram, mengekalkan proksi yang berfungsi dan beralih ke proksi lain apabila ia gagal. Ruang kerja memilih proksi berbeza apabila terdapat cukup entri yang berfungsi; proksi boleh berkongsi alamat keluar. Proksi yang gagal berehat sebelum cubaan seterusnya. Jika tiada yang berfungsi, mod IP menentukan sama ada pengumpulan perlu menunggu atau boleh menggunakan sambungan terus. Menukar proksi tidak menukar akaun atau memadam jurnalnya. Pilihan dan perubahan laluan direkodkan dalam jurnal yang disahkan.

Semasa laluan automatik diaktifkan, senarai dikemas kini setiap jam dan pemeriksaan pengangkutan dijalankan setiap sepuluh minit secara lalai. Jeda ini boleh diubah suai. **Mengemas kini senarai awam** memerlukan penyegaran; melihat senarai sahaja tidak mengubah laluan manual yang disimpan.

**Lalu lintas Telegram dan permintaan HTTPS menggunakan laluan yang berbeza.** Muat turun senarai menggunakan sambungan HTTPS berasingan dan laluan permintaan luaran yang disediakan. `TGWITNESS_PROXY_FEED_PROXY` secara eksplisit menimpa laluan itu dengan proksi HTTP/SOCKS5; kedua-dua varian Compose pengumpul meneruskannya. Kolam latar belakang mengikuti ruang kerja utama. Tiada sesi Telegram, kelayakan API, token panel atau token bot dihantar kepada penyedia feed. Nama penyedia, tarikh snapshot dan laluan muat turun muncul di bawah Bahagian **'Where the list comes from**'.

MTProxy hanya membawa trafik Telegram. Operasi HTTP ruang kerja seperti cap masa, pemberitahuan, salinan luar tapak dan semakan sumber menggunakan proksi SOCKS5/HTTP berasingan apabila dikonfigurasikan, kemudian laluan SOCKS5/HTTP akaun. Tanpa kedua-duanya, Hide the address menolak permintaan; mod lain membenarkan Direct. Permintaan luaran boleh dilumpuhkan. Proksi muat turun suapan yang dikonfigurasikan secara eksplisit kekal sebagai override pengendali berasingan. Perkhidmatan saksi bebas mengekalkan laluan tersendiri.

Untuk perkhidmatan peribadi yang diuruskan oleh pengendali, tetapan persekitaran pelayan sedia ada `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1` membenarkan destinasi peribadi dan mengekalkan penyelesaian nama hos di pihak proksi. Ia tidak boleh diaktifkan dari panel. Mod hanya awam menolak destinasi `.onion` sebelum membuat pertanyaan kepada penyelesai awam; perkhidmatan bawang Tor memerlukan tetapan destinasi peribadi yang jelas tersebut dan proksi yang sesuai. Tingkah laku DNS ini terpakai kepada operasi HTTP luaran, bukan pengangkutan Telegram. Cloudflare mendokumenkan [hujung titik akhir DNS JSON](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/).

****Parameter kolam automatik****

Di bawah **Alat Lain → Parameter → MTProxy Automatik**, konfigurasi ambang kegagalan, masa rehat, pusilan yang dirancang, perkongsian proksi dan kelewatan fallback yang dibenarkan.

| Kawal | Lalai |
| --- | --- |
| Putus sambungan sebelum penggantian | 3 dalam 10 minit |
| Proksi yang dicuba bagi setiap percubaan sambungan | 3 |
| Rehat pertama / maksimum selepas kegagalan | 10 minit / 6 jam |
| Putaran yang dirancang | Dilumpuhkan; hidupkan pada kegagalan |
| Akaun per proksi | 0: utamakan entri berasingan, kongsi apabila perlu. Tetapkan 1 untuk menunggu entri eksklusif. |
| Kelewatan sebelum fallback langsung yang dibenarkan | 10minit; Sembunyikan alamat masih menolak Direct |
| Semakan semula suapan / semakan pengangkutan | 60/10minit; nilai ruang kerja utama terpakai kepada kolam kongsi |

Proksi yang berbeza boleh berkongsi alamat keluar. Had Telegram terpakai pada setiap laluan.

Untuk menggantikan senarai awam dengan katalog pengendali anda sendiri, konfigurasi penggantian di bawah. Ia menyahaktifkan langganan luaran sepenuhnya, termasuk apabila tatasusunan `proxies`-nya kosong.

Salin [katalog kosong](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example) ke `proxy-config/proxies.json` dan tambahkan titik akhir awam yang anda sediakan:

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

Nilai contoh mesti diganti. Sehingga 32 entri berbeza diterima. Penyenaraian terautentikasi memaparkan label/hos/port tanpa rahsia kongsi; memilih satu menyimpan kelayakannya ke dalam peti besi ruang kerja. Ketersediaannya masih belum diuji sehingga ujian pengangkutan eksplisit. Katalog yang tersusun salah membolehkan konfigurasi manual.

Pelancaran asli: tetapkan `TGWITNESS_PROXY_CATALOG` ke laluan JSON tempatan. Docker:

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

Lapisan atas memasang `proxy-config` sebagai baca sahaja; fail mesti boleh dibaca oleh UID kontena 10001. Direktori itu dikecualikan daripada Git, konteks pembinaan Docker dan arkib sumber. Katalog ini mengkonfigurasi akaun pengumpul; [bot saksi](https://phishdestroy.io/tgwitness/ms/docs/reference/witness/) menggunakan laluan HTTP/SOCKS5 sendiri, bukan MTProxy.

Fallback langsung dikawal oleh mod IP di atas. Hentikan pemerhatian sebelum menukar laluan. Penyimpanan memutuskan sambungan klien lama dan membatalkan log masuk yang belum selesai; klien baru menggunakan laluan yang disimpan. Pengikatan jurnal/sesi akaun kekal. Tetapan menggantikan laluan sebelumnya: masukkan semula kelayakan proksi apabila menyuntingnya.

Kredensial disulitkan dalam `network.enc`. API tidak memulangkan nama pengguna, kata laluan atau rahsia. Rekod yang ditandatangani mengandungi jenis laluan dan sama ada kredensial wujud, tanpa memasukkan titik akhir dan rahsia. Pengendali boleh melihat titik akhir di panel. Medan rahsia dipadam selepas menyimpan, mengunci atau menukar ruang kerja.

**Uji sambungan Telegram**, juga tersedia sebelum log masuk, membuka dan menutup sambungan Telegram sementara tanpa kebenaran melalui laluan. Ia tidak menghubungi laman web semakan IP. Kejayaan mengesahkan sambungan pengangkutan, bukan akses kumpulan, penghantaran lengkap atauanonimiti.

Proksi terpakai pada sambungan klien Telegram, termasuk muat turun media DC Telegram. Pelayar, pip, SSH dan alat TSA yang dipanggil secara manual mempunyai laluan berasingan. Nama hos proksi boleh diselesaikan secara tempatan. `rdns` menjejaskan nama hos destinasi; Telegram sering menyediakan IP DC berangka.

SOCKS5 dan HTTP CONNECT biasa tidak menyulitkan kelayakan proksi atau terowong klien-ke-proksi itu sendiri. MTProto melindungi trafik Telegram secara berasingan. Gunakan saluran selamat yang sesuai ke proksi pada rangkaian yang tidak dipercayai. Kumpulan Peribadi ialah sembang awan yang dilindungi oleh MTProto semasa penghantaran; Sembang Rahsia hujung-ke-hujung adalah jenis sembang berasingan, yang direkodkan oleh [modul Sembang Rahsia](https://phishdestroy.io/tgwitness/ms/docs/reference/secret-chats/).

## Sulitan dan tandatangan

| Lapisan | Dipelaksanaan | Tanggungjawab pengendali |
| --- | --- | --- |
| Lalu lintas Telegram | Telethon MTProto | Kepercayaan platform, laluan dan ketersediaan |
| Panel web | Token pemegang, lalai gelung balik, had permintaan | Tunel HTTPS atau SSH untuk capaian jauh |
| Rahsia | Fernet untuk kelayakan API, sesi, kelayakan proksi dan kunci peribadi penandatangan | Lindungi kunci penyahsulitan dan hos yang sedang berjalan |
| Kunci peti | Kunci tempatan, atau kunci induk luaran untuk pemasangan baharu | Pisahkan storan terlindung dan sandaran kunci |
| Mesej dan lampiran | Penyimpanan aplikasi teks biasa | Cakera/jumlah yang disulitkan |
| ZIP/JSONL/CSV/HTML | Semakan integriti, tiada penyulitan kandungan | Melindungi salinan dan pemindahan yang dieksport |
| Asal usul dan masa | Jurnal berasingan, resit proses, alat RFC 3161 | Kunci dipercayai, titik pemeriksaan bebas/TSA dan prosedur pemeliharaan |

**Perlindungan storan** dalam Akaun memaparkan keadaan ini. Token panel adalah rahsia capaian, bukan kata laluan penyulitan. Ia memberi akses pentadbir; [token yang dikeluarkan](https://phishdestroy.io/tgwitness/ms/docs/reference/access/) boleh dihadkan kepada akaun dan sembang. Ruang kerja berkongsi proses hos dan bukan penyewa terasing.

BitLocker, LUKS, FileVault atau volum yang disulitkan yang diuruskan boleh melindungi storan di bawah model ancaman masing-masing. Pentadbir mesin yang sedang berjalan dan tidak dikunci masih boleh membaca data. Sertakan SQLite WAL/SHM, media, eksport sementara, swap, sandaran dan muat turun pelayar dalam perancangan storan. Isipadu Docker tidak disulitkan semata-mata kerana ia adalah isipadu.

## Kunci induk luaran

Untuk pemasangan **baharu**, letakkan kunci induk di luar direktori data. Ini tidak secara automatik memindahkan peti kunci tempatan sedia ada. Sediakan direktori kunci yang hanya boleh diakses oleh identiti perkhidmatan, kemudian jalankan:

```
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, menggunakan persekitaran projek yang dipasang:

```
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
```

Dalam Docker, pasang fail secara baca sahaja di luar `/data`, contohnya di `/run/secrets/tgwitness-master.key`, dan tetapkan pembolehubah persekitaran kepada laluan tersebut. UID perkhidmatan mesti dapat membacanya. Sampaikan laluan, bukan bait kunci, melalui fail persekitaran/konfigurasi.

Setiap ruang kerja menerima garam awam rawak dan kunci Fernet sendiri yang diperoleh melalui HKDF-SHA256. `vault.external.json` menyimpan metadata derivasi, bukan kunci utama. Kunci yang hilang/salah akan menyebabkan permulaan gagal tanpa menggantikannya secara senyap. Simpan kedua-dua metadata garam dan kunci utama untuk pemulihan.

Semua ruang kerja berpunca daripada kunci induk yang sama; komprominya menjejaskan keseluruhan pemasangan. Proses yang sedang berjalan boleh menyahsulitkan rahsia. Ini bukan HSM atau KDF kata laluan. Kata laluan sewenang-wenangnya tidak diterima sebagai ganti kunci rawak.

Simpan kunci sedia ada untuk pemasangan sedia ada sehingga migrasi yang disengajakan dilaksanakan dan disahkan. Memadam `vault.key` atau menggantikan kunci induk boleh memusnahkan akses kepada sesi/kunci penandatanganan. Simpan sandaran yang disulitkan dan kunci secara berasingan dan uji pemulihan dalam contoh terasing.
