6ea14e9c7c
- Add OpenWrt 23.05+ requirement to all README files - Expand privacy statement to clarify no telemetry/analytics and data only goes to router, provided URLs, and official package sources - Update smoke check command in CONTRIBUTING and all READMEs to include pytest: `python -m compileall -q src && pytest -q` - Minor formatting improvements
9.8 KiB
Re:Sputnik
English · Русский · فارسی · 中文
⚠️ این یک ترجمهٔ ماشینی است. نسخهٔ معتبر همان README انگلیسی است؛ از اصلاحات استقبال میشود.
اپلیکیشن دسکتاپ که Re:HomeProxy را روی روتر OpenWrt نصب و پیکربندی میکند — از طریق SSH، بدون نیاز به ترمینال یا LuCI.
شما آدرس و رمز عبور روتر را وارد میکنید؛ بقیهٔ کارها را اپلیکیشن در یک «جادوگر» گرافیکی انجام میدهد: بکاند پروکسی و یک هسته را نصب میکند، سرورهای شما را وارد میکند، مسیریابی و دور زدن DPI را تنظیم میکند و سپس امکان مدیریت Wi-Fi، عیبیابی و امنیت را فراهم میسازد.
Re:Sputnik هیچ هستهٔ پروکسیای را همراه خود ندارد — آنها را از منابع رسمی روی روتر نصب میکند و فقط از طریق SSH/RPC با روتر ارتباط میگیرد (
ubus call luci.homeproxy.*،uci، اسکریپتهای خودِ بسته). در اصل یک پلتفرم عمومی «نصب + پیکربندی نرمافزار روی OpenWrt» است؛ Re:HomeProxy تنها اولین دستورالعمل است.
دانلود
آخرین نسخه را از صفحهٔ Releases دریافت کنید — بدون نصبکننده. نیاز به روتری با OpenWrt 23.05 یا جدیدتر دارد.
- Windows —
Re-Sputnik-windows-x64.exe، دوبار کلیک کنید. - macOS (Apple Silicon) —
Re-Sputnik-macos-arm64.zip، از حالت فشرده خارج کنید وRe-Sputnik.appرا به Applications بکشید. - Linux —
Re-Sputnik-linux-x86_64.AppImage/-aarch64.AppImage،chmod +xو اجرا کنید.
نسخهها فعلاً امضا نشدهاند. SmartScreen ویندوز هشدار میدهد (More info → Run anyway). در macOS اجرای اولیه مسدود میشود — به System Settings → Privacy & Security بروید، تا بخش Security پایین بروید و کنار پیام Re-Sputnik روی Open Anyway بزنید (با Touch ID / گذرواژه تأیید کنید). فقط یکبار لازم است.
امکانات
- نصب — معماری روتر و مدیر بسته (opkg/apk) را تشخیص میدهد، Re:HomeProxy و یک هستهٔ پروکسی (hiddify-core یا sing-box-extended) را نصب میکند و میتواند بستهها را برای روترهای روی شبکههای محدود/کندشده از قبل روی رایانه دانلود کند.
- سرورها — وارد کردن اشتراکها (sing-box/Hiddify JSON و Xray/V2Ray JSON)، لینکهای اشتراکی
(VLESS/Reality، Hysteria2، Trojan، Shadowsocks…)،
vpn://و فایلهای.conf(WireGuard/AmneziaWG)؛ استخرهای سرعت URLTest. - مسیریابی — حالتهای آماده (روسیه / چین / ایران / جهانی) بر پایهٔ فهرستهای Re:filter و Russia Inside.
- دور زدن DPI — ByeDPI داخلی (۴۷ پیشتنظیم) و Zapret 2 (۳۶ پیشتنظیم)، بهعلاوه یک آزمونگر استراتژی که چند سایت را بهصورت موازی بررسی میکند و نشان میدهد چه چیزی واقعاً روی ISP شما کار میکند.
- مدیریت — عیبیابی (وضعیت هسته، DNS، مسیرها)، Wi-Fi / LAN / DHCP، رمزها و کلیدهای SSH، پشتیبانگیری و نگهداری، SQM / UPnP.
- زبانها — روسی، انگلیسی، فارسی، چینی. چند پروفایل ذخیرهشدهٔ روتر.
سه راه ورود
- ⚡ گامبهگام — جادوگری خطی که کاربر غیرفنی را در اینترنت، نصب، سرورها و بررسی راهنمایی میکند.
- ⚙ پیشرفته — پیمایش آزاد در بخشها (سرورها، قوانین، عیبیابی، Anti-DPI، هسته، امنیت…) برای مدیریت دستی.
- 📦 پیشنصب بستهها — دانلود روی رایانه و انتقال به روتر، برای نصب بدون اینترنت روی خودِ روتر.
هر حالت پیکربندی فعلی روتر را برمیدارد و از صفر شروع نمیکند.
معماری (کوتاه)
UI (customtkinter) صفحههای جادوگر و تنظیمات؛ روند نصب را پیش میبرند
engine/* منطق هر قابلیت (نصب، نودها، قوانین، ByeDPI، Zapret، عیبیابی…)
RouterClient (paramiko) تنها درِ ورود به روتر: اسکریپتهای داخلی، ubus، uci
Secrets (keyring) اعتبارنامههای روتر در جاکلیدی سیستمعامل
دستورها در هر اتصال یکییکی اجرا میشوند تا درخواستهای همزمان توسط سرویس SSH روتر قطع نشوند. نه تلهمتری و نه تحلیل آماری: اپلیکیشن فقط با روتری که به آن وصل شدهاید، هر URL اشتراک/بهروزرسانی که خودتان میدهید، و منابع رسمی بستهها (GitHub، OpenWrt) هنگام نصب نرمافزار ارتباط دارد. اعتبارنامهها هرگز دستگاه شما را ترک نمیکنند.
پشتهٔ فناوری
پایتون خالص + چند کتابخانه — بدون web/HTML/CSS/JS:
| لایه | کتابخانه |
|---|---|
| رابط کاربری | customtkinter (Tk) |
| ارتباط با روتر | paramiko (SSH) |
| اعتبارنامهها | keyring (جاکلیدی سیستمعامل) |
| آیکنها | Lucide/Phosphor (رابط) + Simple Icons (برندها)، تبدیل SVG→PNG هنگام ساخت |
توسعه
python -m venv .venv
. .venv/Scripts/activate # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
python -m re_sputnik
python -m compileall -q src && pytest -q
CI در هر push تستها را اجرا میکند (test.yml)؛ ساخت چندسکویی
بر اساس درخواست در build.yml است؛ انتشارهای دارای تگ (vX.Y.Z)
همهٔ سکوها را میسازند و از طریق release.yml در صفحهٔ Releases
منتشر میشوند. روند مشارکت در CONTRIBUTING.md آمده است (Developer Certificate
of Origin).
اطلاعیهٔ علائم تجاری
وابسته به یا تأییدشده توسط YouTube، Telegram، Discord، Meta یا Hiddify نیست. لوگوهای سرویسها علائم تجاری صاحبانشان هستند و فقط برای شناسایی سرویسها استفاده میشوند.
حمایت از پروژه
اگر Re:Sputnik برایتان مفید است، یک ⭐ کمک میکند — یا مستقیماً از توسعه حمایت کنید:
پرسشها و بهروزرسانیها — Telegram.
مجوز
Re:Sputnik نرمافزار آزاد تحت GNU General Public License v3.0 (GPLv3) است: میتوانید آن را
با این شرایط استفاده، مطالعه، تغییر و بهاشتراک بگذارید. متن کامل در LICENSE و اسناد
اشخاص ثالث در NOTICE است.
Re:Sputnik برنامهای جدا از Re:HomeProxy (آن هم تحت GPL) است: از طریق SSH/RPC با روتر ارتباط
میگیرد و سورس Re:HomeProxy را همراه یا لینک نمیکند. همهٔ وابستگیهای شخص ثالث تحت مجوزهای مجاز یا
copyleft ضعیف هستند (MIT/BSD/HPND/MPL-2.0؛ paramiko تحت LGPL-2.1) که با GPLv3 سازگارند. مشارکتها
تحت Developer Certificate of Origin پذیرفته میشوند — به CONTRIBUTING.md
مراجعه کنید.