---
title: ماژول انبلاک فایروال
description: Unblock یک سیستم مدیریت فایروال مبتنی بر وب است که به طور خاص برای ارائه دهندگان خدمات میزبانی وب طراحی شده است. این سیستم، تجزیه و تحلیل گزارش‌های فایروال و رفع انسداد IP را برای مدیران و مشتریان ساده می‌کند و تمرکز آن بر قابلیت استفاده برای کاربران غیرفنی است.
url: "https://negarnovin.com/docs/unblock-firewall-manager/"
updated: "2025-11-03"
category: تحقیق و توسعه / whmcs
---

# ماژول انبلاک فایروال

# ماژول آنبلاک فایروال برای WHMCS

**Unblock** یک سیستم مدیریت فایروال مبتنی بر وب است که به طور خاص برای ارائه دهندگان خدمات میزبانی وب طراحی شده است. این سیستم، تجزیه و تحلیل گزارش های فایروال و رفع انسداد IP را برای مدیران و مشتریان ساده می کند و تمرکز آن بر قابلیت استفاده برای کاربران غیرفنی است.

[سرور مجازی آمریکا](https://negarnovin.com/usaserver/)

## ✨ ویژگی ها

[https://github.com/AichaDigital/unblock#-features](https://github.com/AichaDigital/unblock#-features)

- **🔍 تحلیل IP** : تحلیل جامع لاگ های فایروال در سرویس های مختلف (CSF، DirectAdmin BFM، Exim، Dovecot، ModSecurity)
- **🚀 رفع انسداد با یک کلیک** : رفع انسداد خودکار IP با تشخیص هوشمند
- **👥 مدیریت چند کاربره** : پشتیبانی از مشتریان هاستینگ، نمایندگان فروش و دارندگان VPS
- **📧 اعلان های ایمیلی** : گزارش های دقیق برای کاربران و مدیران ارسال می شود
- **🔐 کاربران مجاز** : دسترسی به دامنه ها/سرورهای خاص را بدون دسترسی کامل به حساب کاربری، تفویض کنید
- **🔄 ادغام WHMCS** : همگام سازی خودکار اختیاری با WHMCS
- **🌍 پشتیبانی از چند پنل** : با cPanel و DirectAdmin کار می کند
- **📊 گزارش های دقیق** : گزارش های جامع فایروال به همراه توضیحات
- **🔒 امنیت در اولویت** : ثبت تمام اقدامات، اعتبارسنجی IP، مدیریت کلید SSH
- **🌐 بین المللی سازی** : پشتیبانی کامل از زبان های انگلیسی و اسپانیایی
- **⚡ حالت ساده** : رفع انسداد IP ناشناس برای محیط های میزبانی کاملاً متصل (بدون نیاز به احراز هویت)

## 📋 الزامات

[https://github.com/AichaDigital/unblock#-requirements](https://github.com/AichaDigital/unblock#-requirements)

- **پی اچ پی** : ۸.۳ یا بالاتر
- **لاراول** : ۱۲.x
- **پایگاه داده** : SQLite (توصیه می شود) یا MySQL ۸.۰+
- **وب سرور** : Nginx یا Apache
- **Node.js** : ۱۸+ (برای کامپایل asset)
- **دسترسی SSH** : به سرورهای مدیریت شده ای که CSF/DirectAdmin را اجرا می کنند

## 🚀 شروع سریع

[https://github.com/AichaDigital/unblock#-quick-start](https://github.com/AichaDigital/unblock#-quick-start)

### ۱. کلون و نصب

[https://github.com/AichaDigital/unblock#1-clone-and-install](https://github.com/AichaDigital/unblock#1-clone-and-install)

```
git clone https://github.com/AichaDigital/unblock.git
cd unblock
composer install
npm install && npm run build
```

### ۲. تنظیمات محیطی

[https://github.com/AichaDigital/unblock#2-environment-setup](https://github.com/AichaDigital/unblock#2-environment-setup)

```
cp .env.example .env
php artisan key:generate
```

### ۳. پیکربندی اطلاعات شرکت

[https://github.com/AichaDigital/unblock#3-configure-company-information](https://github.com/AichaDigital/unblock#3-configure-company-information)

`.env`جزئیات شرکت خود را ویرایش و پیکربندی کنید:

```
COMPANY_NAME="Your Hosting Company"
SUPPORT_EMAIL=support@yourcompany.com
SUPPORT_URL=https://support.yourcompany.com

# Legal URLs (Required for GDPR compliance)
LEGAL_PRIVACY_URL=https://yourcompany.com/privacy
LEGAL_TERMS_URL=https://yourcompany.com/terms
LEGAL_DATA_PROTECTION_URL=https://yourcompany.com/data-protection
```

### ۴. راه اندازی پایگاه داده

[https://github.com/AichaDigital/unblock#4-database-setup](https://github.com/AichaDigital/unblock#4-database-setup)

```
# For SQLite (recommended)
touch database/database.sqlite
php artisan migrate --seed

# For MySQL, configure DB_* variables in .env first
```

### ۵. ایجاد کاربر ادمین

[https://github.com/AichaDigital/unblock#5-create-admin-user](https://github.com/AichaDigital/unblock#5-create-admin-user)

```
# Interactive mode (recommended)
php artisan user:create --admin

# Non-interactive mode
php artisan user:create --admin 
 --email="admin@yourcompany.com" 
 --first-name="Admin" 
 --last-name="System" 
 --password="YourSecurePassword123!"

# Development mode (simple passwords allowed)
php artisan user:create --admin --no-secure
```

**نکته:** این دستور تمام فیلدهای سفارشی و اعتبارسنجی های خاص مدل کاربر ما را مدیریت می کند. از یا `user:create`استفاده نکنید زیرا ساختار جدول را در نظر نمی گیرند.`tinker``make:filament-user`

### ۶. شروع سرور توسعه

[https://github.com/AichaDigital/unblock#6-start-development-server](https://github.com/AichaDigital/unblock#6-start-development-server)

```
php artisan serve
```

مراجعه کنید `http://localhost:8000`و با اطلاعات کاربری ادمین خود وارد شوید.

## 📖 مستندات

[https://github.com/AichaDigital/unblock#-documentation](https://github.com/AichaDigital/unblock#-documentation)

### اضافه کردن سرورها (میزبان ها)

[https://github.com/AichaDigital/unblock#adding-servers-hosts](https://github.com/AichaDigital/unblock#adding-servers-hosts)

1. به پنل مدیریت → هاست بروید
2. جزئیات سرور خود را اضافه کنید:
   - **FQDN** : نام میزبان سرور
   - **آدرس آی پی** : آی پی سرور
   - **کاربر SSH** : معمولاً`root`
   - **نوع پنل** : `cpanel`یا`directadmin`
3. کلید SSH را آپلود کنید (به تنظیمات کلید SSH در زیر مراجعه کنید)

### تنظیم کلید SSH

[https://github.com/AichaDigital/unblock#ssh-key-setup](https://github.com/AichaDigital/unblock#ssh-key-setup)

برای امنیت، یک کلید SSH محدود ایجاد کنید که فقط بتواند دستورات خاص CSF را اجرا کند:

```
# On your Unblock server
ssh-keygen -t ed25519 -f ~/.ssh/unblock_csf -C "unblock-firewall"

# Copy public key to managed server
cat ~/.ssh/unblock_csf.pub
```

در سرور مدیریت شده، `~/.ssh/authorized_keys`با دستور زیر به [مقدار] محدودیت اضافه کنید:

```
command="/path/to/restricted-csf-wrapper.sh",no-port-forwarding,no-X11-forwarding,no-agent-forwarding ssh-ed25519 AAAA... unblock-firewall
```

برای دستورالعمل های دقیق و اسکریپت بسته بندی، به [docs/ssh-keys-setup.md](https://github.com/AichaDigital/unblock/blob/main/docs/ssh-keys-setup.md) مراجعه کنید .

### ادغام WHMCS (اختیاری)

[https://github.com/AichaDigital/unblock#whmcs-integration-optional](https://github.com/AichaDigital/unblock#whmcs-integration-optional)

برای همگام سازی کاربران و هاستینگ ها از WHMCS:

```
WHMCS_SYNC_ENABLED=true
WHMCS_API_URL=https://your-whmcs.com/includes/api.php
WHMCS_API_IDENTIFIER=your_api_identifier
WHMCS_API_SECRET=your_api_secret
```

برای تنظیمات کامل به [docs/whmcs-integration.md](https://github.com/AichaDigital/unblock/blob/main/docs/whmcs-integration.md) مراجعه کنید .

### کاربران مجاز

[https://github.com/AichaDigital/unblock#authorized-users](https://github.com/AichaDigital/unblock#authorized-users)

به مشتریان اجازه دهید بدون اشتراک گذاری حساب کاربری خود، به دامنه های خاص دسترسی بدهند:

1. مشتری کاربر مجاز را در داشبورد خود ایجاد می کند
2. دامنه (های) خاص یا سرور (های) خاصی را اختصاص دهید
3. کاربر مجاز، دسترسی ورود به سیستم OTP را دریافت می کند.
4. فقط می توان منابع اختصاص داده شده را مشاهده/مدیریت کرد

### حالت رفع انسداد ساده (بدون احراز هویت)

[https://github.com/AichaDigital/unblock#simple-unblock-mode-no-authentication](https://github.com/AichaDigital/unblock#simple-unblock-mode-no-authentication)

برای ارائه دهندگان خدمات میزبانی وب که روابط محکمی با مشتریان دارند، رفع انسداد IP ناشناس را فعال کنید:

```
# Enable simple mode
UNBLOCK_SIMPLE_MODE=true

# Configure throttling (requests per minute)
UNBLOCK_SIMPLE_THROTTLE_PER_MINUTE=3

# Block duration after exceeding rate limit (minutes)
UNBLOCK_SIMPLE_BLOCK_DURATION=15
```

**ویژگی ها:**

- بدون نیاز به احراز هویت
- کاربر موارد زیر را ارائه می دهد: آدرس IP، دامنه، ایمیل
- سیستم اعتبارسنجی می کند که IP مسدود شده است + دامنه در گزارش های سرور وجود دارد
- فقط در صورتی که هر دو شرط مطابقت داشته باشند، از حالت انسداد خارج می شود (از سوءاستفاده جلوگیری می کند)
- محدود کردن سرعت بسیار بالا (به طور پیش فرض ۳ درخواست در دقیقه)
- ثبت بی صدای اطلاعات برای مدیر در موارد غیر منطبق
- قابل دسترسی در:`/simple-unblock`

**مهم:**

- `php artisan db:seed --class=AnonymousUserSeeder`برای ایجاد کاربر ناشناس سیستم، دستور زیر را اجرا کنید:
- این کاربر ( `anonymous@system.internal`) برای همه گزارش های ناشناس استفاده می شود
- مدیر گزارش های دقیقی از تمام تلاش ها (موفق و ناموفق) دریافت می کند.
- کاربران فقط زمانی ایمیل های تأیید دریافت می کنند که IP واقعاً از حالت مسدود خارج شده باشد.

**مستندات:**

- **راهنمای کاربر** : [راهنمای کاربر حالت ساده](https://github.com/AichaDigital/unblock/blob/main/docs/SIMPLE_MODE_USER_GUIDE.md) - مستندات کاربر نهایی
- **راهنمای تست** : [راهنمای تست حالت ساده](https://github.com/AichaDigital/unblock/blob/main/docs/SIMPLE_MODE_TESTING_GUIDE.md) - تست با داده های واقعی
- **اسناد فنی** : `docs/internals/`برای جزئیات پیاده سازی مراجعه کنید

## 🔧 پیکربندی

[https://github.com/AichaDigital/unblock#-configuration](https://github.com/AichaDigital/unblock#-configuration)

### کارگران صف

[https://github.com/AichaDigital/unblock#queue-workers](https://github.com/AichaDigital/unblock#queue-workers)

برای محیط عملیاتی، صف های کاری را با استفاده از Supervisor پیکربندی کنید:

```
sudo cp supervisor-laravel-worker.conf /etc/supervisor/conf.d/unblock-worker.conf
# Edit paths in the file
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start unblock-worker:*
```

### وظایف برنامه ریزی شده

[https://github.com/AichaDigital/unblock#scheduled-tasks](https://github.com/AichaDigital/unblock#scheduled-tasks)

به crontab اضافه کنید:

```
* * * * * cd /path/to/unblock && php artisan schedule:run >> /dev/null 2>&1
```

## 🧪 آزمایش

[https://github.com/AichaDigital/unblock#-testing](https://github.com/AichaDigital/unblock#-testing)

مجموعه تست کامل را اجرا کنید:

```
composer test

# With coverage
composer test:coverage

# Parallel execution
php artisan test --parallel
```

## 🔒 امنیت

[https://github.com/AichaDigital/unblock#-security](https://github.com/AichaDigital/unblock#-security)

- **کلیدهای SSH** : از کلیدهای SSH اختصاصی و محدود برای عملیات فایروال استفاده کنید
- **اعتبارسنجی ورودی** : تمام IPها و دستورات اعتبارسنجی و پاکسازی می شوند.
- **ثبت وقایع** : تمام وقایع فایروال به همراه اطلاعات کاربر ثبت می شوند.
- **WHMCS** : ایجاد کاربر MySQL فقط خواندنی برای ادغام WHMCS
- **مهلت زمانی جلسه** : مهلت زمانی عدم فعالیت ۴ ساعته
- **احراز هویت OTP** : OTP مبتنی بر زمان برای دسترسی کلاینت

[برای بهترین شیوه های امنیتی به SECURITY.md](https://github.com/AichaDigital/unblock/blob/main/SECURITY.md) مراجعه کنید .

## 🌍 بین المللی شدن

[https://github.com/AichaDigital/unblock#-internationalization](https://github.com/AichaDigital/unblock#-internationalization)

آنبلاک از چندین زبان به صورت پیش فرض پشتیبانی می کند:

- **انگلیسی** (en)
- **اسپانیایی** (es)

برای افزودن زبان های بیشتر، `lang/en`کد زبان خود را کپی کرده و رشته ها را ترجمه کنید.

## 📝 مجوز

[https://github.com/AichaDigital/unblock#-license](https://github.com/AichaDigital/unblock#-license)

این پروژه تحت **مجوز عمومی عمومی GNU Affero نسخه ۳.۰ (AGPL-۳.۰)** منتشر شده است .

### این یعنی چی:

[https://github.com/AichaDigital/unblock#what-this-means](https://github.com/AichaDigital/unblock#what-this-means)

✅ **شما می توانید:**

- استفاده، مطالعه، اصلاح و توزیع رایگان این نرم افزار
- برای مقاصد تجاری از آن استفاده کنید
- انشعاب و ایجاد آثار مشتق شده

❌ **شما نمی توانید:**

- ایجاد محصولات متن باز بر اساس این کد
- آن را به عنوان یک SaaS/سرویس بدون اشتراک گذاری کد منبع خود اجرا کنید
- حذف اعلان های انتساب یا مجوز

📋 **شما باید:**

- مجوز AGPL-۳.۰ را در تمام نسخه ها نگه دارید
- کد منبع هرگونه تغییر را به اشتراک بگذارید
- نسبت دادن واضح به این پروژه را ارائه دهید
- اگر این را به عنوان یک سرویس شبکه اجرا می کنید، کد منبع خود را در دسترس کاربران قرار دهید.

**مجوز کامل: **[مجوز](https://github.com/AichaDigital/unblock/blob/main/LICENSE) | [انگلیسی](https://www.gnu.org/licenses/agpl-3.0.html) | [اسپانیایی](https://www.gnu.org/licenses/agpl-3.0.es.html)

این مجوز قوی کپی لفت تضمین می کند که نرم افزار، حتی زمانی که به عنوان یک سرویس وب استفاده می شود، رایگان و متن باز باقی بماند.

## 🤝 مشارکت

[https://github.com/AichaDigital/unblock#-contributing](https://github.com/AichaDigital/unblock#-contributing)

از مشارکت ها استقبال می شود! برای جزئیات بیشتر لطفاً به [CONTRIBUTING.md](https://github.com/AichaDigital/unblock/blob/main/CONTRIBUTING.md) مراجعه کنید .

## 💬 پشتیبانی

[https://github.com/AichaDigital/unblock#-support](https://github.com/AichaDigital/unblock#-support)

- **مستندات** : [مستندات کامل](https://github.com/AichaDigital/unblock/blob/main/docs)
- **مشکلات** : [مشکلات گیت هاب](https://github.com/AichaDigital/unblock/issues)
- **بحث ها** : [بحث های گیت هاب](https://github.com/AichaDigital/unblock/discussions)

## 🙏 تقدیر و تشکر

[https://github.com/AichaDigital/unblock#-acknowledgments](https://github.com/AichaDigital/unblock#-acknowledgments)

- ساخته شده با [لاراول ۱۲](https://laravel.com/)
- پنل مدیریت توسط [FilamentPHP 3](https://filamentphp.com/)
- آیکون های [Heroicons](https://heroicons.com/)
- تست با [Pest PHP](https://pestphp.com/)

## 📊 آمار پروژه

[https://github.com/AichaDigital/unblock#-project-stats](https://github.com/AichaDigital/unblock#-project-stats)

- **آزمون ها** : ۲۵۷ قبولی
- **پوشش** : ۸۵٪+
- **سطح PHPstan** : حداکثر
- **نسخه لاراول** : ۱۲.x
- **نسخه پی اچ پی** : ۸.۳+

---

ساخته شده نگارنوین ❤️ برای عموم

**فایل ماژول را از طریق زیر دانلود و دریافت کنید!**

  ماژول آنبلاک فایروال برای WHMCS✨ ویژگی ها📋 الزاماتخرید ماژول انبلاک فایروالقیمت ماژول انبلاک فایروالبهترین ماژول انبلاک فایروال
