magic-wormhole: pemindahan fail selamat dengan kod sekali guna

18 Februari 2026 • 5 min read

Hai semua,

hari ini saya mahu kongsikan satu alat CLI kecil yang saya kerap gunakan bila berdepan situasi support dan incident: magic-wormhole. Ia menyelesaikan masalah yang jauh lebih kerap berlaku dalam syarikat biasa berbanding kisah “enterprise” yang nampak hebat: anda perlu hantar fail (atau folder) kepada seseorang segera, tetapi e-mel terlalu kecil, pautan cloud sensitif dari sudut polisi atau undang-undang, dan “buka port sekejap” memang bukan pilihan.

Jumaat, 16:47. Sebuah syarikat dengan lebih kurang 60 pekerja ada isu mendesak: fail server pusat perlahan, pengguna mengadu timeout, dan penyedia IT luar meminta support bundle yang mengandungi log serta sedikit export konfigurasi. Saiznya hampir 900 MB. E-mel menolak, SharePoint dilarang atas sebab pematuhan, dan menubuhkan FTP ad-hoc adalah mimpi ngeri yang anda tak mahu cipta pada tahun 2026.

Di sinilah magic-wormhole sangat berguna: tukar kod sekali guna, pindahkan fail disulitkan end-to-end, siap.

Apa itu magic-wormhole?

magic-wormhole ialah alat ringan untuk pemindahan ad-hoc antara dua komputer. Triknya ialah wormhole code (contohnya 7-coral-lion): kedua-dua pihak masukkan kod yang sama, dan itu memulakan sambungan disulitkan end-to-end.

Yang penting ialah apa yang magic-wormhole tidak perlukan:

tiada akaun
tiada portal log masuk
tiada “upload ke tempat lain dan kongsi pautan”
tiada peraturan firewall inbound

Kedua-dua pihak hanya perlukan wormhole dipasang dan akses internet keluar. Secara praktikal: jika HTTP(S) outbound berfungsi, magic-wormhole biasanya turut berfungsi.

Contoh kes sebenar dalam SMB

Kembali kepada Jumaat tadi. Aliran yang pragmatik biasanya begini:

Sediakan support bundle (log, export, beberapa screenshot).
Pilihan: kira hash supaya kemudian boleh pastikan pakej yang diterima adalah tepat sama.
Hantar bundle melalui magic-wormhole.
Kongsi kod melalui saluran kedua (telefon, chat berasingan, atau sebutkan kod).

Di pihak penghantar:

tar -czf support-bundle.tgz ./logs ./config-export
sha256sum support-bundle.tgz
wormhole send support-bundle.tgz

magic-wormhole akan paparkan kod. Penerima jalankan:

wormhole receive

Masukkan kod, muat turun berjalan, kemudian semak hash. Dalam dunia sebenar, gabungan “cepat” tetapi “tetap kemas” ini sangat bernilai untuk banyak syarikat kecil dan sederhana.

Cara saya gunakan dalam praktis

Hantar fail dari A ke B

Penghantar:

wormhole send /path/to/file.zip

Penerima:

wormhole receive

Fail akan disimpan dalam direktori semasa. Saya sering buat folder ringkas supaya ia tidak hilang antara Downloads dan Desktop:

mkdir -p ~/wormhole-recv && cd ~/wormhole-recv
wormhole receive

Hantar direktori

Jika perlu hantar satu folder penuh:

wormhole send --dir ./support-bundle/

Apa yang berlaku di sebalik tabir (ringkas dan tanpa marketing)

Di bawah hud, magic-wormhole melakukan tiga perkara yang kalau tidak, anda perlu bina sendiri: mencari peer, merunding kunci dengan selamat, dan memindahkan data dengan boleh dipercayai, walaupun NAT dan firewall menyusahkan.

Langkah	Apa berlaku	Kenapa penting
1. Kod	Penghantar hasilkan kod sekali guna yang pendek.	Shared secret mudah untuk pemindahan ini.
2. Rendezvous	Kedua-dua klien sambung ke pelayan rendezvous (default: “mailbox” awam).	Peer bertemu tanpa port masuk.
3. PAKE	Kunci bersama diterbitkan daripada kod melalui SPAKE2 (PAKE).	Kunci E2E tanpa pengurusan kunci klasik.
4. Laluan data	Cuba sambungan terus; jika gagal, fallback ke relay/transit.	Berfungsi di belakang NAT dan rangkaian korporat biasa.
5. Pemindahan E2E	Data disulitkan dan dilindungi integritinya end-to-end.	Relay hanya nampak ciphertext.

Intinya: rendezvous/relay ialah infrastruktur, tetapi bukan tempat data anda berada dalam plaintext.

Keselamatan: kekuatan, had, dan beberapa peraturan

Apa yang saya suka tentang magic-wormhole ialah model keselamatannya agak jujur: ada end-to-end encryption, tetapi identiti tidak datang secara automatik.

Apa yang anda dapat

End-to-end encryption: kandungan dilindungi antara penghantar dan penerima, walaupun menggunakan relay.
Akses jangka pendek: kod direka untuk satu pemindahan, bukan kata laluan jangka panjang.
Permukaan serangan kecil: tiada server untuk di-hardening, tiada pengurusan pengguna, tiada UI web.

Apa yang perlu diberi perhatian

Kod ialah kata laluan. Sesiapa yang ada kod adalah “peer” anda. Jika kod masuk dalam tiket terbuka, itu masalah.
Tiada audit secara default. Bagi sesetengah organisasi itu bagus; bagi yang lain, itu deal-breaker. Jika anda perlukan DLP, kelulusan dan jejak audit, guna saluran rasmi.
Endpoint tetap realiti. Jika penghantar sudah compromised, dia boleh hantar apa sahaja. Jika penerima compromised, fail compromised selepas diterima.

Peraturan praktikal (yang betul-betul membantu)

Jangan kongsi kod dalam saluran yang sama dengan pautan tiket atau konteks fail. Ideal: telefon atau chat peribadi berasingan.
Anggap log boleh mengandungi token, hostname atau data peribadi. Hantar hanya yang perlu.
Untuk artifak kritikal: hantar hash melalui saluran berasingan dan sahkan selepas terima.

Pemasangan (ringkas dan realistik)

Dalam banyak sistem, ia hanya satu arahan melalui pengurus pakej:

Debian/Ubuntu: sudo apt install magic-wormhole
macOS: brew install magic-wormhole

Jika pakej distro sudah lama, pipx selalunya pilihan paling bersih:

pipx install magic-wormhole
pipx ensurepath

Dan jika anda tidak mahu Python langsung (server minimal, container, rescue environment): wormhole-william ialah port Go yang serasi sebagai single binary.

Automasi dan self-hosting

Untuk workflow yang terkawal, magic-wormhole boleh digunakan secara skrip:

CODE="5-alpaca-orbit"
wormhole send --code "$CODE" /path/to/db.dump

Penerima:

wormhole receive --code "$CODE" --accept-file

Ini memudahkan, tetapi bila anda hard-code kod, anda kembali kepada pengurusan credential. Jika automasi, lakukan dengan pengurusan secret yang baik dan jangka hayat yang pendek.

Jika anda mahu kawalan penuh ke atas rendezvous/relay, anda boleh halakan klien kepada infrastruktur sendiri, termasuk:

--relay-url untuk pelayan rendezvous anda
--transit-helper untuk transit relay anda

Kesimpulan

magic-wormhole bukan pengganti aliran pemindahan yang diurus dengan polisi. Tetapi sebagai alat harian, ia sangat bagus: cepat, kurang friksi, dan ada model keselamatan yang jelas.

Terutamanya dalam dunia SMB, bila masa dan tenaga terhad untuk proses kelulusan yang panjang setiap kali ada permintaan support, alat yang “cukup selamat dan boleh terus digunakan” selalunya tepat.

Sumber dan bacaan lanjut

Sehingga kali seterusnya, Joe