NimBridgeIR

ابزار ساده برای استفاده راحت‌تر از Ubuntu Server روی سرورهای داخل ایران

ساخته‌شده توسط nimaro11 dev

---

❤️ حمایت از پروژه

اگر NimBridgeIR برای شما مفید بود و دوست داشتید از توسعه و نگهداری آن حمایت کنید، می‌توانید از طریق آدرس‌های زیر دونیت کنید:

USDT TRC20: TZEkPk6pmxRPFsAXWe7jSqfmwFeEYcxRYq
USDT BEP20: 0x66F98e2980906503f0B4a5E9d14A5BfD7d2aB008
TON       : UQDN_FNnzZHr7qks6XRV1k9JKHFfPZ2frq_oymluJksa2MRe

راه ارتباطی: @nimaro11dev

---

NimBridgeIR چیست؟

NimBridgeIR یک ابزار ساده برای سرورهای Ubuntu داخل ایران است؛ مخصوصاً سرورهایی که دسترسی مستقیم یا پایدار به اینترنت بین‌الملل ندارند و در کارهای اولیه مثل آپدیت، نصب پکیج، دانلود فایل، نصب Docker یا Pull کردن Docker Imageها به مشکل می‌خورند.

هدف این برنامه این است که کارهای روزمره و ضروری سرور را برای کاربر ساده‌تر کند. کافی است یکی از روش‌های دسترسی پشتیبانی‌شده را در برنامه ثبت کنید؛ بعد از آن می‌توانید از منوی ساده برنامه برای انجام کارهای اصلی استفاده کنید.

نکته مهم: NimBridgeIR خودش Proxy یا VPN ارائه نمی‌کند. برای استفاده از برنامه باید یک Proxy یا کانفیگ فعال و قابل استفاده داشته باشید.

---

🔥 مناسب برای نصب پنل‌های مدیریت VPN

یکی از کاربردهای مهم NimBridgeIR، کمک به نصب ابزارهای مدیریت VPN روی سرورهایی است که به GitHub و منابع خارجی دسترسی مستقیم ندارند.

در نسخه v1.1.0 امکان نصب 3x-ui Sanaei از داخل منوی برنامه اضافه شده است.

• دریافت لیست نسخه‌های منتشرشده 3x-ui از GitHub
• نمایش ۱۵ نسخه آخر از جدید به قدیم
• امکان انتخاب نسخه دلخواه برای نصب
• اجرای installer رسمی 3x-ui از مسیر دسترسی NimBridgeIR
• مناسب برای سرورهایی که بدون Proxy به GitHub دسترسی ندارند

---

این ابزار برای چه کسانی مناسب است؟

• کسانی که سرور Ubuntu داخل ایران دارند.
• کسانی که روی سرورشان به GitHub، Docker Hub یا Repositoryهای خارجی دسترسی ندارند.
• کسانی که می‌خواهند بدون درگیر شدن با تنظیمات پیچیده، کارهای اولیه سرور را انجام دهند.
• کسانی که تازه با سرور لینوکسی کار می‌کنند و یک منوی ساده می‌خواهند.

---

NimBridgeIR چه کارهایی انجام می‌دهد؟

• دریافت و ذخیره اطلاعات HTTP Proxy, SOCKS Proxy, VLESS Link, VMess Link
• بررسی اتصال به منابع مهم
• آپدیت لیست پکیج‌های Ubuntu
• نصب پکیج‌های Ubuntu
• دانلود فایل از لینک مستقیم
• نصب Docker
• آماده‌سازی Docker برای دریافت Image
• Pull کردن Docker Image
• نصب 3x-ui Sanaei از طریق منوی داخلی
• فعال یا غیرفعال کردن تنظیمات برنامه
• حذف برنامه و پاک‌سازی تنظیمات در صورت نیاز

---

پیش‌نیاز مهم: Proxy یا کانفیگ دسترسی

در اولین اجرای برنامه، نوع دسترسی از شما پرسیده می‌شود.

1) HTTP proxy
2) SOCKS proxy
3) VLESS link
4) VMess link

برای HTTP و SOCKS، برنامه host، port و در صورت نیاز username/password را جداگانه می‌پرسد.

برای VLESS و VMess، لینک کامل کانفیگ را وارد می‌کنید.

برای SOCKS، VLESS و VMess، برنامه در پشت‌صحنه یک HTTP Bridge داخلی روی 127.0.0.1 می‌سازد تا ابزارهایی مثل apt، Docker، curl و wget بتوانند از آن استفاده کنند.

---

سیستم‌عامل‌های پیشنهادی

این نسخه برای Ubuntu Server طراحی شده است:

• Ubuntu Server 20.04
• Ubuntu Server 22.04
• Ubuntu Server 24.04

برای بهترین نتیجه، برنامه را روی سرور خام یا سروری که تنظیمات شبکه آن خیلی دستکاری نشده تست کنید.

---

نصب برنامه

روش اول: نصب مستقیم از GitHub

اگر سرور به GitHub دسترسی دارد، دستور زیر را اجرا کنید:

curl -fsSL https://raw.githubusercontent.com/nimaro11dev/NimBridgeIR/v1.1.0/install.sh | sudo bash

بعد از نصب، برنامه را اجرا کنید:

sudo nimbridgeir

یا از دستور کوتاه‌تر استفاده کنید:

sudo nbi

روش دوم: نصب از فایل Release

اگر سرور هنوز دسترسی مناسب برای دانلود از اینترنت ندارد، فایل Release مناسب معماری سرور را دانلود و روی سرور آپلود کنید.

فایل‌های پیشنهادی:

NimBridgeIR-v1.1.0-linux-amd64.tar.gz
NimBridgeIR-v1.1.0-linux-arm64.tar.gz

روی سرورهای amd64:

tar -xzf NimBridgeIR-v1.1.0-linux-amd64.tar.gz
cd NimBridgeIR-v1.1.0-linux-amd64
sudo bash install.sh
sudo nimbridgeir

روی سرورهای arm64:

tar -xzf NimBridgeIR-v1.1.0-linux-arm64.tar.gz
cd NimBridgeIR-v1.1.0-linux-arm64
sudo bash install.sh
sudo nimbridgeir

---

اجرای اولیه

بعد از اولین اجرا:

sudo nimbridgeir

اگر تنظیمات دسترسی هنوز ثبت نشده باشد، برنامه همان ابتدا نوع دسترسی و اطلاعات لازم را از شما می‌پرسد. بعداً هر زمان خواستید، می‌توانید از مسیر زیر تنظیمات را تغییر دهید:

Settings > Reconfigure Access

---

منوی اصلی برنامه

1) Check Connection
2) Update Ubuntu Packages
3) Install Ubuntu Package
4) Docker Tools
5) Download File
6) VPN Panel Installers
7) Settings
0) Exit

1) Check Connection

وضعیت اتصال به چند منبع مهم را بررسی می‌کند؛ مثل HTTPS عمومی، Ubuntu Packages، GitHub و Docker Registry. اگر یکی از بخش‌ها Failed شد، معمولاً باید اطلاعات دسترسی را بررسی کنید یا Proxy/کانفیگ دیگری تست کنید.

2) Update Ubuntu Packages

برای به‌روزرسانی لیست پکیج‌های Ubuntu استفاده می‌شود. این گزینه کاربر را از اجرای دستی دستورهای پیچیده بی‌نیاز می‌کند.

3) Install Ubuntu Package

با این گزینه می‌توانید یک پکیج Ubuntu نصب کنید. مثال:

curl
nginx
unzip

4) Docker Tools

بخش مخصوص نصب Docker، تست دسترسی Docker و Pull کردن Imageها است.

5) Download File

برای دانلود فایل از لینک مستقیم استفاده می‌شود. برنامه از شما آدرس فایل و مسیر ذخیره‌سازی را می‌پرسد.

File URL: https://example.com/file.tar.gz
Save as: /root/file.tar.gz

6) VPN Panel Installers

برای نصب سیستم‌های مدیریت VPN از طریق مسیر دسترسی NimBridgeIR استفاده می‌شود.

در نسخه v1.1.0 گزینه زیر اضافه شده است:

3x-ui (Sanaei)

برنامه آخرین نسخه‌های منتشرشده 3x-ui را از GitHub دریافت می‌کند، ۱۵ نسخه آخر را نمایش می‌دهد و نسخه انتخابی کاربر را از طریق installer رسمی پروژه نصب می‌کند.

7) Settings

برای تغییر تنظیمات ذخیره‌شده، فعال یا غیرفعال کردن برنامه و حذف برنامه استفاده می‌شود.

---

منوی Docker Tools

1) Install Docker
2) Check Docker Access
3) Pull Docker Image
4) Enable/Disable Docker Access
0) Back

1) Install Docker

Docker و ابزارهای لازم آن را نصب می‌کند. اگر Docker از قبل نصب شده باشد، برنامه فقط تنظیمات دسترسی Docker را بررسی و آماده می‌کند.

2) Check Docker Access

بررسی می‌کند Docker بتواند از Docker Hub ایمیج دریافت کند یا نه. این گزینه برای تست از image سبک زیر استفاده می‌کند:

hello-world:latest

3) Pull Docker Image

از شما نام Image را می‌گیرد و آن را Pull می‌کند. مثال:

nginx:latest
postgres:17.6
remnawave/backend:2

4) Enable/Disable Docker Access

این گزینه هوشمند است. اگر Docker Access فعال باشد، گزینه برای غیرفعال‌سازی نمایش داده می‌شود. اگر غیرفعال باشد، گزینه برای فعال‌سازی نمایش داده می‌شود.

این گزینه Docker را حذف نمی‌کند؛ فقط تنظیمات دسترسی Docker را فعال یا غیرفعال می‌کند.

---

منوی Settings

1) Show Current Status
2) Reconfigure Access
3) Enable/Disable NimBridgeIR
4) Auto Restore on Disable
5) Reset Saved Proxy Settings
6) Uninstall NimBridgeIR
0) Back

1) Show Current Status

وضعیت فعلی برنامه را نشان می‌دهد؛ مثل فعال بودن برنامه، نوع دسترسی ذخیره‌شده، آماده بودن ابزارهای لازم، نصب بودن Docker، فعال بودن Docker Access و وضعیت Auto Restore.

2) Reconfigure Access

اگر Proxy یا کانفیگ شما عوض شد یا اطلاعات را اشتباه وارد کردید، از این گزینه استفاده کنید.

3) Enable/Disable NimBridgeIR

این گزینه هوشمند است. اگر NimBridgeIR فعال باشد، گزینه برای غیرفعال‌سازی نمایش داده می‌شود. اگر غیرفعال باشد، گزینه برای فعال‌سازی نمایش داده می‌شود.

با Disable کردن، برنامه حذف نمی‌شود؛ فقط تنظیمات فعال آن غیرفعال می‌شود.

4) Auto Restore on Disable

مشخص می‌کند وقتی NimBridgeIR را غیرفعال می‌کنید، تنظیمات مرتبط به حالت قبلی برگردانده شود یا نه. پیشنهاد معمول این است که این گزینه فعال باشد.

5) Reset Saved Proxy Settings

اطلاعات دسترسی ذخیره‌شده را پاک می‌کند. این گزینه Docker را حذف نمی‌کند و تنظیمات Docker را تغییر نمی‌دهد.

6) Uninstall NimBridgeIR

برنامه را از سرور حذف می‌کند. در زمان حذف، برنامه از شما می‌پرسد که آیا تنظیمات مرتبط برگردانده شوند و آیا فایل‌های تنظیمات، لاگ‌ها و بکاپ‌ها هم حذف شوند یا نه.

---

مسیرهای نصب و تنظیمات

دستور اصلی:

/usr/local/bin/nimbridgeir

دستور کوتاه:

/usr/local/bin/nbi

تنظیمات برنامه:

/etc/nimbridgeir/config.env
/etc/nimbridgeir/engine.conf
/etc/nimbridgeir/sing-box.json

فایل‌های وضعیت و بکاپ:

/var/lib/nimbridgeir/

لاگ برنامه:

/var/log/nimbridgeir.log

---

حذف دستی برنامه

اگر خواستید برنامه را دستی حذف کنید:

sudo bash /usr/local/lib/nimbridgeir/uninstall.sh

حذف کامل همراه با تنظیمات، لاگ‌ها و بکاپ‌ها:

sudo bash /usr/local/lib/nimbridgeir/uninstall.sh --purge

حذف بدون برگرداندن تنظیمات Docker/system:

sudo bash /usr/local/lib/nimbridgeir/uninstall.sh --no-restore

---

نکات مهم

• این پروژه مخصوص سرورهای Ubuntu داخل ایران است که دسترسی مستقیم یا پایدار به اینترنت بین‌الملل ندارند.
• برای استفاده از NimBridgeIR باید یک Proxy یا کانفیگ فعال داشته باشید.
• اگر Proxy یا کانفیگ واردشده قطع باشد، کند باشد یا به Docker Hub، GitHub و Repositoryهای خارجی دسترسی مناسب نداشته باشد، بعضی گزینه‌ها ممکن است با خطا روبه‌رو شوند.
• برای ورودی‌های SOCKS، VLESS و VMess، برنامه از sing-box برای ساخت HTTP Bridge داخلی استفاده می‌کند.
• پکیج‌های Release شامل sing-box هستند و installer آنلاین هم در صورت نیاز تلاش می‌کند sing-box را دانلود کند.
• برای اجرای برنامه معمولاً باید از sudo استفاده کنید.

---

ارتباط و حمایت

برای ارتباط، گزارش مشکل یا دنبال کردن بروزرسانی‌ها: @nimaro11dev

اگر این ابزار برای شما مفید بود، حمایت مالی شما باعث ادامه توسعه و نگهداری بهتر پروژه می‌شود:

USDT TRC20: TZEkPk6pmxRPFsAXWe7jSqfmwFeEYcxRYq
USDT BEP20: 0x66F98e2980906503f0B4a5E9d14A5BfD7d2aB008
TON: UQDN_FNnzZHr7qks6XRV1k9JKHFfPZ2frq_oymluJksa2MRe

---

NimBridgeIR — ساده‌تر کردن کار با Ubuntu Server برای سرورهای داخل ایران