Skip to content

Latest commit

 

History

History
161 lines (110 loc) · 9.73 KB

README.fa.md

File metadata and controls

161 lines (110 loc) · 9.73 KB

ZLT X28 Patcher (modempatch)

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 است.

ساخت (Build)

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)

عملیات 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

در هر اجرا فقط یکی از این عملیات را می‌توانید استفاده کنید. 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":{ ... }}

نکته‌هایی دربارهٔ ورود (Login)

اگر ورود به‌درستی کار نمی‌کند یا پنل وب محدود است (این اتفاق برای نویسنده افتاد):

  • نام کاربری و رمز عبورِ چاپ‌شده روی بدنهٔ مودم (برچسب) را امتحان کنید. در مورد نویسنده، جفت 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 می‌تواند به دستگاه آسیب دائمی بزند.

نویسنده

ساخته‌شده توسط احسان وارسته (۲۰۲۶)، بعد از چند روز تلاش برای زنده‌کردن یک مودم.