WIFIDUMP(1)   WIFIDUMP(1)

wifidump - رابطی برای ضبط فریم‌های Wi-Fi از یک میزبان دوردست از طریق SSH ارائه می‌دهد.

wifidump [ --help ] [ --version ] [ --extcap-interfaces ] [ --extcap-dlts ] [ --extcap-interface=<interface> ] [ --extcap-config ] [ --extcap-capture-filter=<capture filter> ] [ --capture ] [ --fifo=<path to file or pipe> ] [ --remote-host=<IP address> ] [ --remote-port=<TCP port> ] [ --remote-username=<username> ] [ --remote-password=<password> ] [ --sshkey=<public key path> ] [ --remote-interface=<interface> ] [ --remote-channel-frequency=<channel frequency> ] [ --remote-channel-width=<channel width> ]

wifidump --extcap-interfaces

wifidump --extcap-interface=<interface> --extcap-dlts

wifidump --extcap-interface=<interface> --extcap-config

wifidump --extcap-interface=<interface> --fifo=<path to file or pipe> --capture --remote-host=myremotehost --remote-port=22 --remote-username=user --remote-interface=eth2 --remote-channel-frequency=5180 --remote-channel-width=40

ابزار Wifidump یک ابزار extcap است که به شما امکان می‌دهد ترافیک Wi-Fi را از یک میزبان دوردست بر بستر یک اتصال SSH با استفاده از tcpdump ضبط کنید. پیش‌نیاز ضبط فریم‌های Wi-Fi این است که میزبان دوردست باید برنامه‌های باینری لازم برای مدیریت و قرار دادن رابط مورد نظر در حالت monitor را داشته باشد. این باینری‌ها شامل ip، iw و iwconfig هستند. همچنین، از آنجا که استفاده از حالت monitor و مدیریت رابط Wi-Fi نیازمند دسترسی‌های ریشه (root) است، سیستم باید به گونه‌ای پیکربندی شود که به کاربر مورد نظر اجازه دهد این باینری‌ها را با استفاده از sudo بدون وارد کردن گذرواژه اجرا کند.

معمولاً wifidump به‌طور مستقیم فراخوانی نمی‌شود؛ در عوض، می‌توان آن را از طریق رابط گرافیکی کاربر Wireshark یا خط فرمان آن پیکربندی کرد. دستور زیر Wireshark را اجرا کرده و ضبط را از میزبان remotehost آغاز می‌کند:

$ wireshark '-oextcap.wifidump.remotehost:remotehost' -i wifidump -k

برای کنترل صریح دستور ضبط از راه دور:

$ wireshark '-oextcap.wifidump.remotehost:remotehost' \
            '-oextcap.wifidump.remotechannelfrequency:5180' \
            '-oextcap.wifidump.remotechannelwidth:40' \
            -i wifidump -k

رابط‌های پشتیبانی‌شده:

1.wifidump

--help

چاپ آرگومان‌های برنامه.

--version

چاپ نسخه برنامه.

--extcap-interfaces

فهرست کردن رابط‌های موجود.

--extcap-interface=<interface>

استفاده از رابط‌های مشخص‌شده.

--extcap-dlts

فهرست کردن DLTهای رابط مشخص‌شده.

--extcap-config

فهرست کردن گزینه‌های پیکربندی رابط مشخص‌شده.

--capture

شروع ضبط از رابط مشخص‌شده و نوشتن داده‌های خام بسته‌ها در مکان مشخص‌شده توسط --fifo.

--fifo=<path to file or pipe>;

ذخیره بسته‌های ضبط‌شده در فایل یا ارسال آن‌ها از طریق pipe.

--remote-host=<remote host>;

نشانی میزبان دوردست برای ضبط.

--remote-port=<remote port>;

درگاه SSH میزبان دوردست.

--remote-username=<username>

نام کاربری برای احراز هویت ssh.

--remote-password=<password>

گذرواژه مورد استفاده (در صورتی که از ssh-agent و pubkey استفاده نشود). هشدار: گذرواژه‌ها به صورت متن خام (plaintext) ذخیره شده و برای تمام کاربران این سیستم قابل مشاهده هستند. توصیه می‌شود از فایل‌های کلید به همراه یک SSH agent استفاده شود.

--sshkey=<SSH private key path>;

مسیر کلید خصوصی برای احراز هویت.

--remote-interface=<remote interface>;

رابط شبکه دوردست برای ضبط از آن.

--remote-channel-frequency=<channel frequency>;

فرکانس کانال دوردست بر حسب مگاهرتز (MHz).

--remote-channel-width=<channel width>;

پهنای کانال دوردست بر حسب مگاهرتز (MHz).

--extcap-capture-filter=<capture filter>;

فیلتر ضبط. این فیلتر متناظر با مقداری است که از طریق گزینه tshark -f ارائه می‌شود، و همچنین فیلد Capture Filter در کنار فهرست رابط‌ها در واسط کاربری Wireshark.

برای مشاهده آرگومان‌های برنامه:

wifidump --help

برای مشاهده نسخه برنامه:

wifidump --version

برای مشاهده رابط‌ها:

wifidump --extcap-interfaces

تنها از یک رابط (wifidump) پشتیبانی می‌شود.

خروجی نمونه

interface {value=wifidump}{display=Wi-Fi remote capture}

برای مشاهده DLTهای رابط:

wifidump --extcap-interface=wifidump --extcap-dlts

خروجی نمونه

dlt {number=147}{name=wifidump}{display=Remote capture dependent DLT}

برای مشاهده گزینه‌های پیکربندی رابط:

wifidump --extcap-interface=wifidump --extcap-config

خروجی نمونه

arg {number=0}{call=--remote-host}{display=Remote SSH server address}{type=string}
    {tooltip=The remote SSH host. It can be both an IP address or a hostname}{required=true}{group=Server}
arg {number=1}{call=--remote-port}{display=Remote SSH server port}{type=unsigned}
    {tooltip=The remote SSH host port (1-65535)}{range=1,65535}{group=Server}
arg {number=2}{call=--remote-username}{display=Remote SSH server username}{type=string}
    {tooltip=The remote SSH username. If not provided, the current user will be used}{group=Authentication}
arg {number=3}{call=--remote-password}{display=Remote SSH server password}{type=password}
    {tooltip=The SSH password, used when other methods (SSH agent or key files) are unavailable.}{group=Authentication}
arg {number=4}{call=--sshkey}{display=Path to SSH private key}{type=fileselect}
    {tooltip=The path on the local filesystem of the private ssh key}{mustexist=true}{group=Authentication}
arg {number=5}{call=--sshkey-passphrase}{display=SSH key passphrase}{type=password}
    {tooltip=Passphrase to unlock the SSH private key}{group=Authentication}
arg {number=6}{call=--remote-interface}{display=Remote interface}{type=string}
    {tooltip=The remote network interface used to capture}{default=auto}{group=Capture}
arg {number=7}{call=--remote-channel-frequency}{display=Remote channel}{type=selector}
    {tooltip=The remote channel used to capture}{group=Capture}
arg {number=8}{call=--remote-channel-width}{display=Remote channel width}{type=selector}
    {tooltip=The remote channel width used to capture}{group=Capture}
arg {number=9}{call=--remote-filter}{display=Remote capture filter}{type=string}
    {tooltip=The remote capture filter}{group=Capture}
arg {number=10}{call=--remote-count}{display=Packets to capture}{type=unsigned}
    {tooltip=The number of remote packets to capture.}{group=Capture}
arg {number=11}{call=--log-level}{display=Set the log level}{type=selector}
    {tooltip=Set the log level}{required=false}{group=Debug}
arg {number=12}{call=--log-file}{display=Use a file for logging}{type=fileselect}
    {tooltip=Set a file where log messages are written}{required=false}{group=Debug}

برای ضبط:

wifidump --extcap-interface=wifidump --fifo=/tmp/wifidump.pcap --capture --remote-host 192.168.1.10 --remote-username user --remote-channel-frequency 5180 --remote-channel-width 40

نکته

برای توقف ضبط، از CTRL+C، دستور kill یا خاتمه دادن به برنامه استفاده کنید.

فایل اجرایی wifidump را می‌توان برای پشتیبانی از چندین نمونه تغییر نام داد. برای مثال اگر بخواهیم wifidump دو بار در wireshark نمایش داده شود (مثلاً برای مدیریت چندین نمایه)، می‌توانیم wifidump را به wifidump-host1 و wifidump-host2 کپی کنیم. هر فایل اجرایی، نام رابطی هم‌نام با نام فایل اجرایی خود نشان خواهد داد. فایل‌های اجرایی که نام آن‌ها "wifidump" نباشد، در بخش توضیحات رابط با عنوان "custom version" نمایش داده خواهند شد..SH "همچنین ببینید (SEE ALSO)"

wireshark(1), tshark(1), extcap(4), tcpdump(1)

Wifidump بخشی از توزیع Wireshark است. آخرین نسخهٔ Wireshark را می‌توان در این نشانی یافت: https://www.wireshark.org.

نسخه‌های HTML صفحات راهنمای پروژهٔ Wireshark در این نشانی در دسترس است: https://www.wireshark.org/docs/man-pages.

نویسنده اصلی
Adrian Granados <adrian[AT]intuitibits.com>

2026-09-03