English | فارسی
یک ابزار خط فرمان (CLI) کوچک، نوشتهشده با زبان Rust، برای دریافت اطلاعات و تغییر تنظیمات مودم ZLT X28.
این پروژه برای نجات یک مودم شروع شد: مودم بعد از ورود به پنل روی صفحهٔ سفید گیر میکرد، پنل وب محدود بود و با حساب کاربری معمولی نمیشد فریمور را بهروزرسانی کرد. این ابزار مستقیم با API وب مودم (/cgi-bin/http.cgi) و سرور SSH آن صحبت میکند تا بتوانید این مشکلات را از ترمینال دور بزنید.
فقط روی مودمی استفاده کنید که مال خودتان است. بعضی از عملیات (اجرای دستور از طریق SSH، پچ تلنت، تغییر IMEI) کنترل کامل دستگاه را به شما میدهند و یک دستور اشتباه میتواند مودم را خراب (brick) کند.
| قابلیت | گزینه | روش ارتباط | وضعیت |
|---|---|---|---|
| نمایش وضعیت مودم | --show-status |
HTTP API | کار میکند |
| خواندن تنظیمات فایروال | --get-firewall |
HTTP API | کار میکند |
| ارسال دستور AT به مودم (مثلاً برای تنظیم IMEI) | --at-command |
HTTP API | کار میکند |
| اجرای دستور شل با دسترسی root | --ssh-exec |
SSH | کار میکند |
| آپلود فایل از کامپیوتر به مودم | --ssh-upload-file |
SSH | کار میکند |
| دانلود فایل از مودم | --ssh-download-file |
SSH | کار میکند |
| فعالکردن WAN (در بعضی دستگاهها مشکل صفحهٔ سفید بعد از ورود را حل میکند) | --enable-wan |
HTTP API | بخش مشکلات شناختهشده را ببینید |
| اعمال پچ تلنت (باز کردن شل تلنت روی مودم) | --apply-telnet-patch |
HTTP API | بخش مشکلات شناختهشده را ببینید |
تنظیم سطح فایروال (off، low، medium، high) |
--set-firewall |
HTTP API | بخش مشکلات شناختهشده را ببینید |
| غیرفعالکردن TR-069 (مدیریت از راه دور توسط اپراتور) | --disable-tr069 |
HTTP API | بخش مشکلات شناختهشده را ببینید |
| ریاستارت مودم | --reboot |
HTTP API | بخش مشکلات شناختهشده را ببینید |
نکتههای دیگر:
- ورود با نام کاربری و رمز عبور انجام میشود (رمز همراه با یک توکن که از مودم گرفته میشود با SHA-256 هش میشود). همچنین میتوانید با
--session-idاز یک نشست (session) موجود استفاده کنید. - گواهی HTTPS خودامضای مودم پذیرفته میشود.
- خروجی بهصورت یک شیء JSON در هر خط چاپ میشود، بنابراین استفاده از آن در اسکریپتها آسان است.
-
Rust نسخهٔ 1.85 یا جدیدتر (پروژه از Rust edition 2024 استفاده میکند). از https://rustup.rs نصب کنید.
-
ابزارهای کامپایل C،
pkg-configو فایلهای توسعهٔ OpenSSL. اینها برای ساخت کتابخانههایssh2وnative-tlsلازماند. روی Debian/Ubuntu:sudo apt install build-essential pkg-config libssl-dev
-
دسترسی شبکه به مودم. آدرس پیشفرض
192.168.70.1است.
git clone https://github.com/ehsanecc/modempatch.git
cd modempatch
cargo build --releaseفایل اجرایی در مسیر target/release/zlt_x28_patcher ساخته میشود.
zlt_x28_patcher [OPTIONS] (--username <USER> --password <PASS> | --session-id <ID>)
| گزینه | توضیح |
|---|---|
-H, --host <HOST> |
آدرس مودم. پیشفرض: 192.168.70.1 |
-u, --username <USER> |
نام کاربری (اگر --session-id ندهید، الزامی است) |
-p, --password <PASS> |
رمز عبور (اگر --session-id ندهید، الزامی است) |
--session-id <ID> |
استفاده از یک session ID موجود بهجای نام کاربری و رمز عبور (فقط برای HTTP API) |
در هر اجرا فقط یکی از این عملیات را میتوانید استفاده کنید.
| گزینه | توضیح |
|---|---|
--at-command <AT> |
ارسال دستور AT و چاپ نتیجه |
--enable-wan |
فعالکردن WAN |
--apply-telnet-patch |
فعالکردن WAN و اعمال پچ تلنت |
--set-firewall <off|low|medium|high> |
تنظیم حالت فایروال |
--get-firewall |
نمایش وضعیت فایروال |
--disable-tr069 |
غیرفعالکردن TR-069 |
--show-status |
نمایش وضعیت مودم |
--reboot |
ریاستارت مودم |
در هر اجرا فقط یکی از این عملیات را میتوانید استفاده کنید. SSH همیشه به --username و --password نیاز دارد.
| گزینه | توضیح |
|---|---|
--ssh-exec <CMD> |
اجرای یک دستور شل روی مودم (با دسترسی root) |
--ssh-upload-file <LOCAL:REMOTE> |
آپلود فایل محلی به یک مسیر روی مودم |
--ssh-download-file <REMOTE:LOCAL> |
دانلود فایل از مودم به یک مسیر محلی (اگر فایل محلی از قبل وجود داشته باشد خطا میدهد) |
برای دیدن همین فهرست در ترمینال، دستور zlt_x28_patcher --help را اجرا کنید.
# نمایش وضعیت مودم
zlt_x28_patcher -u admin -p admin --show-status
# استفاده از آدرس دیگر برای مودم
zlt_x28_patcher -H 192.168.1.1 -u admin -p admin --get-firewall
# استفاده از نشست قبلی بدون ورود دوباره
zlt_x28_patcher --session-id <SESSION_ID> --show-status
# ارسال دستور AT
zlt_x28_patcher -u admin -p admin --at-command 'AT+EGMR=1,7,"123456789012345"'
# اجرای دستور روی مودم از طریق SSH
zlt_x28_patcher -u admin -p admin --ssh-exec "uname -a"
# آپلود و دانلود فایل از طریق SSH
zlt_x28_patcher -u admin -p admin --ssh-upload-file ./myfile:/customer/myfile
zlt_x28_patcher -u admin -p admin --ssh-download-file /etc/passwd:./passwdدربارهٔ IMEI: تغییر IMEI دستگاه در بعضی کشورها محدود یا غیرقانونی است. قبل از استفاده از
AT+EGMRقوانین محلی خودتان را بررسی کنید.
هر نتیجه بهصورت یک خط JSON چاپ میشود، مثلاً:
{"token":"..."}
{"sessionId":"..."}
{"status":{ ... }}اگر ورود بهدرستی کار نمیکند یا پنل وب محدود است (این اتفاق برای نویسنده افتاد):
- نام کاربری و رمز عبورِ چاپشده روی بدنهٔ مودم (برچسب) را امتحان کنید. در مورد نویسنده، جفت
superadmin:superadminدسترسی محدود داشت و با تغییر به اطلاعات روی برچسب، بهروزرسانی فریمور ممکن شد. - جفتهای دیگری که ارزش امتحان دارند:
admin:admin،superadmin:superadmin،Admin:Conf،admin:root. - اگر بعد از ورود صفحهٔ سفید میبینید، در مورد نویسنده فعالکردن WAN کمک کرد.
این نسخهٔ 0.1.1 است و هنوز در حال تکمیل است. در کد فعلی:
- گزینههای
--enable-wan،--apply-telnet-patch،--set-firewall،--disable-tr069و--rebootدرخواست را میسازند ولی منتظر ارسال آن نمیمانند و توکن CSRF هم خالی ارسال میشود. بنابراین پیام «Done» تضمین نمیکند که مودم واقعاً تغییر کرده باشد. در کد ریاستارت هم یک کامنت از نویسنده هست که میگوید هنوز کار نمیکند. - در هر اجرا فقط یک عملیات HTTP و یک عملیات SSH ممکن است.
- پچکردن فریمور (آپلود اسکریپت
x28و فایلx28.tgz) برنامهریزی شده ولی هنوز پیادهسازی نشده است.
اگر میتوانید کمک کنید، لطفاً یک Issue یا Pull Request باز کنید.
این نرمافزار «همانطور که هست» و بدون هیچ ضمانتی ارائه میشود. مسئولیت کارهایی که با دستگاه خود انجام میدهید با خودتان است. نصب فریمور یا اجرای دستورات root میتواند به دستگاه آسیب دائمی بزند.
ساختهشده توسط احسان وارسته (۲۰۲۶)، بعد از چند روز تلاش برای زندهکردن یک مودم.