رفع مشکل فکس در Issabel 5 + اسکریپت آماده | Fix Fax Issabel5

آخرین ویرایش اردیبهشت ۱۷, ۱۴۰۵ حامد کوه فلاح

خلاصه سریع

اگر فکس در Issabel 5 کار نمی‌کند، مشکل از نسخه قدیمی iaxmodem است.
✔ با نصب نسخه ۱.۳.۴ + اصلاح permissionها، مشکل فکس ایزابل Issabel کاملاً حل می‌شود.
✔ در این مقاله، یک اسکریپت آماده قرار داده‌ام که با یک دستور، همه‌چیز را اصلاح می‌کند.

مقدمه

یکی از محبوب‌ترین و در عین حال قدرتمندترین پلتفرم‌های متن‌باز در حوزه VoIP است که بر پایه Asterisk 18 توسعه داده شده و امکانات گسترده‌ای برای پیاده‌سازی سیستم‌های تلفنی سازمانی، کال‌سنتر و سرویس‌های ارتباطی فراهم می‌کند. با این حال، مثل بسیاری از پروژه‌های Open Source، در برخی نسخه‌ها با چالش‌هایی مواجه می‌شویم—یکی از مهم‌ترین آن‌ها، مشکل فکس در Issabel 5 است که بسیاری از متخصصین VoIP را درگیر کرده است.

در مجموعه VoipIran، ما علاوه بر ارائه آموزش‌های تخصصی VoIP، پروژه‌های کدباز متعددی برای توسعه و بهبود عملکرد Issabel و Asterisk منتشر کرده‌ایم؛ از ماژول‌های سفارشی گرفته تا ابزارهای مانیتورینگ و اتوماسیون. مشکلی که در این مقاله بررسی می‌کنیم، یکی از مواردی است که در پروژه‌های واقعی و محیط‌های عملیاتی با آن مواجه شدیم و پس از تست‌های متعدد، به یک راه‌حل پایدار و قابل اتکا رسیدیم که در ادامه به صورت کامل در اختیار شما قرار می‌دهم.

 مشکل فکس در Issabel 5 چیست؟

در ساختار فکس:
• Asterisk 18 → مدیریت تماس
• iaxmodem → شبیه‌سازی مودم
• HylaFAX → مدیریت فکس

📌 Issue اصلی:

نسخه پیش‌فرض iaxmodem (1.3.0) با Asterisk 18 سازگار نیست و باعث اختلال در پردازش فکس می‌شود.

⸻

علائم رایج این مشکل

اگر یکی از این موارد را دارید:
• فکس دریافت می‌شود ولی PDF ساخته نمی‌شود
• فایل TIFF وجود دارد اما در لیست فکس نیست
• faxstat وضعیت Ready نشان نمی‌دهد
• فکس قطع می‌شود یا ناقص است

شما دقیقاً درگیر همین باگ هستید

تحلیل فنی (EEAT Boost)

این مشکل به ۳ دلیل اصلی رخ می‌دهد:

۱️⃣ ناسازگاری نسخه iaxmodem

نسخه ۱.۳.۰:
• دارای bug در timing
• ناسازگار با IAX2 در Asterisk 18

⸻

۲️⃣ عدم پردازش صحیح eventها در HylaFAX

باعث می‌شود:
• TIFF تولید شود
• ولی PDF ساخته نشود

⸻

۳️⃣ مشکل permission در Issabel 5

به صورت پیش‌فرض:
• fax.db writable نیست
• اسکریپت‌های فکس اجرا نمی‌شوند

⸻

راه‌حل قطعی (Best Practice)

✔ آپدیت iaxmodem به ۱.۳.۴
✔ اصلاح مسیر اجرایی
✔ اصلاح permissionها
✔ restart سرویس‌ها

⸻

اسکریپت نهایی رفع مشکل (Copy & Run)

️

ing{variant="standard" id="77194"}
#!/bin/bash

echo "========================================"
echo " VOIPIRAN Fax Fix Script"
echo " Hamed Kouhfallah"
echo " https://voipiran.io"
echo "========================================"

if [ "$EUID" -ne 0 ]; then
  echo "Run as root"
  exit 1
fi

echo "[1] Installing dependencies..."
dnf -y groupinstall "Development Tools"
dnf -y install libtiff-devel libjpeg-turbo-devel ncurses-devel curl

echo "[2] Download iaxmodem..."
cd /usr/src || exit
curl -L -o iaxmodem-1.3.4.tar.gz 
https://sourceforge.net/projects/iaxmodem/files/iaxmodem/iaxmodem-1.3.4.tar.gz/download

echo "[3] Build..."
tar xzf iaxmodem-1.3.4.tar.gz
cd iaxmodem-1.3.4 || exit
./build static

echo "[4] Replace binary..."
cp /usr/sbin/iaxmodem /usr/sbin/iaxmodem.bak
cp iaxmodem /usr/local/sbin/iaxmodem
chmod 755 /usr/local/sbin/iaxmodem

echo "[5] Fix init..."
sed -i 's|/usr/sbin/iaxmodem|/usr/local/sbin/iaxmodem|g' /etc/rc.d/init.d/iaxmodem

echo "[6] Fix permissions..."
chown asterisk:asterisk /var/www/db/fax.db
chmod 666 /var/www/db/fax.db

chown -R root:root /var/spool/hylafax/bin
chmod -R 755 /var/spool/hylafax/bin

echo "[7] Restart services..."
systemctl daemon-reload
systemctl restart hylafax
systemctl restart iaxmodem

echo "[8] Checking status..."
stat -s

echo “DONE - VOIPIRAN”

نحوه اجر

chmod +x fix-fax.sh
./fix-fax.sh

تست نهایی (Validation)

faxstat -s

خروجی صحیح

ttyIAX1 Ready

سوالات متداول (FAQ Schema Ready)

• چرا فکس در Issabel 5 کار نمی‌کند؟
  به دلیل استفاده از نسخه قدیمی iaxmodem که با Asterisk 18 سازگار نیست.
  ⸻
• آیا بدون تغییر iaxmodem مشکل حل می‌شود؟
  خیر، این مشکل ریشه‌ای است و باید نسخه iaxmodem آپدیت شود.
  ⸻
• اگر TIFF ساخته شود ولی PDF نه؟
  مشکل از permission یا event processing در HylaFAX است.
  ⸻
• این روش در محیط production امن است؟
  بله، روی چندین سرور تست شده و کاملاً پایدار است.
  ⸻

جمع‌بندی نهایی

مشکل: • iaxmodem قدیمی
راه‌حل: • آپدیت به ۱.۳.۴ + اصلاح permission
نتیجه: • فکس پایدار و بدون خطا

سخن نهایی

مشکل فکس در Issabel 5 شاید در نگاه اول پیچیده به نظر برسد، اما همان‌طور که دیدید، با یک تحلیل دقیق و اجرای چند مرحله مشخص—یا حتی ساده‌تر، با اجرای یک اسکریپت—می‌توان آن را به‌صورت کامل و پایدار برطرف کرد. این دقیقاً همان رویکردی است که ما در پروژه‌های واقعی VoIP دنبال می‌کنیم: حل مسئله به ساده‌ترین، سریع‌ترین و قابل اتکاترین شکل ممکن.
در VoipIran، تمرکز ما فقط روی آموزش تئوری نیست؛ بلکه انتقال تجربه‌های واقعی از پروژه‌های پیاده‌سازی‌شده در حوزه Asterisk، Issabel، VoIP و AI Voice Agents است. ما دوره‌های تخصصی از سطح پایه تا پیشرفته ارائه می‌دهیم—از راه‌اندازی ساده سیستم تلفنی گرفته تا توسعه ماژول‌های هوشمند، تحلیل تماس‌ها و پیاده‌سازی سناریوهای پیچیده در مراکز تماس. همچنین مجموعه‌ای از پروژه‌های کدباز رایگان را منتشر کرده‌ایم که می‌توانید مستقیماً در سیستم‌های خود استفاده کنید و توسعه دهید.
اگر می‌خواهید به یک سطح حرفه‌ای در دنیای VoIP برسید یا پروژه‌های واقعی و درآمدزا اجرا کنید، پیشنهاد می‌کنم حتماً به سایت voipiran.ioسر بزنید و از آموزش‌ها و ابزارهای ارائه‌شده استفاده کنید.