رفع اشکال

پیش از هر کاری، sudo bash tools/healthcheck.sh را در /opt/abrdrive اجرا کنید و از اولین خط FAIL شروع کنید (بررسی سلامت). جدول‌های زیر مشکلات رایج را به ترتیب نشانه آورده‌اند.

بسیاری از راه‌حل‌ها از configure.sh استفاده می‌کنند. این برنامه همه‌ی تنظیمات اختیاری را پس از نصب تغییر می‌دهد: ایمیل، ورود با Google یا LinkedIn، دریافت از سرویس‌های ابری، ChatPDF، ایمیل مدیر و نشانی صفحه‌های حقوقی. همان پنجره‌های نصب‌کننده را دارد و تغییرات را فقط وقتی اعمال می‌کند که گزینه‌ی Apply را بزنید:

cd /opt/abrdrive
sudo bash configure.sh

اتصال به سرور

نشانه	علت	راه‌حل
هنگام تایپ رمز SSH هیچ چیزی نمایش داده نمی‌شود.	SSH عمداً رمز را نشان نمی‌دهد، حتی به شکل ستاره.	رمز را تایپ کنید و Enter بزنید. پس از سه تلاش اشتباه اتصال بسته می‌شود؛ دستور ssh را دوباره اجرا کنید.
پیام REMOTE HOST IDENTIFICATION HAS CHANGED	سیستم‌عامل سرور دوباره نصب شده و رایانه‌ی شما هنوز شناسه‌ی قبلی آن را به یاد دارد.	اگر سرور را خودتان دوباره نصب کرده‌اید، روی رایانه‌ی خودتان ssh-keygen -R SERVER_IP را اجرا کنید و دوباره وصل شوید. اگر سرور دوباره نصب نشده، وصل نشوید و موضوع را بررسی کنید.
درست پس از اجرای server-setup.sh اتصال SSH قطع شد و دیگر وصل نمی‌شود.	دیواره‌ی آتش روشن شده و پورت SSH شما در آن باز نیست.	از کنسول اضطراری پنل شرکت میزبانی (VNC یا Console) وارد شوید و sudo ufw allow PORT/tcp را اجرا کنید. SSH بلافاصله دوباره کار می‌کند.

DNS و گواهی HTTPS

نشانه	علت	راه‌حل
نصب‌کننده می‌گوید does not resolve yet	رکورد DNS وجود ندارد، به IP اشتباهی اشاره می‌کند یا هنوز ثبت نشده است.	رکورد را دقیقاً مثل فهرست نصب‌کننده بسازید یا اصلاح کنید، چند دقیقه صبر کنید و Check again را بزنید. می‌توانید ادامه هم بدهید و پس از درست شدن DNS، sudo bash install.sh را دوباره اجرا کنید.
صدور گواهی شکست خورد: certbot failed	یکی از رکوردها هنوز به این سرور نمی‌رسد، رکوردها پشت CDN هستند، یا رکورد AAAA (IPv6) به جای دیگری اشاره می‌کند.	هر شش رکورد را با getent hosts بررسی کنید، پروکسی CDN را خاموش کنید و رکوردهای AAAA نادرست را پاک کنید. سپس sudo bash install.sh را دوباره اجرا کنید.
مرورگر هنگام باز کردن برنامه هشدار گواهی می‌دهد.	گواهی HTTPS صادر نشده است، معمولاً چون DNS هنگام نصب آماده نبوده.	مثل ردیف بالا.
بررسی سلامت می‌گوید گواهی کمتر از ۳۰ روز اعتبار دارد.	تمدید خودکار گواهی کار نمی‌کند.	sudo systemctl enable --now certbot.timer و سپس sudo certbot renew --dry-run را اجرا کنید.

سرویس‌ها

نشانه	علت	راه‌حل
درست پس از نصب، به‌روزرسانی یا ریبوت، برنامه خطای 502 می‌دهد.	سرویس‌ها هنوز در حال راه‌اندازی‌اند. توزیع‌کننده‌ی بار عمداً ۶۰ ثانیه منتظر پایگاه داده می‌ماند.	یک دقیقه صبر کنید و صفحه را دوباره باز کنید. وضعیت سرویس‌ها را با cd /opt/abrdrive && docker compose ps ببینید؛ همه باید running باشند.
یک سرویس مدام از نو راه‌اندازی می‌شود.	معمولاً پایگاه داده آماده نبوده یا یک فایل تنظیمات خراب است.	گزارش سرویس را بخوانید: docker compose logs --tail 100 SERVICE_NAME. نام سرویس‌ها را خروجی docker compose ps نشان می‌دهد.
کلید یک سرویس اختیاری (مثلاً Google Drive) را عوض کرده‌اید اما برنامه هنوز آن را نمی‌شناسد.	تغییر در configure.sh اعمال نشده است.	configure.sh را دوباره باز کنید و پس از تغییر، Apply را بزنید. سرویس‌های مربوط دوباره ساخته می‌شوند.
بررسی سلامت می‌گوید no node registered in the balancer	گره‌ای در توزیع‌کننده‌ی بار ثبت نشده است، معمولاً روی سرور اصلی پیش از ثبت گره.	گره را با sudo bash configure.sh --add-node node-register.json ثبت کنید (افزودن سرور دوم).

ایمیل

نشانه	علت	راه‌حل
کاربران تازه ایمیل تأیید حساب را دریافت نمی‌کنند.	ایمیل تنظیم نشده، یا نام سرور، نام کاربری یا رمز SMTP اشتباه است.	sudo bash configure.sh را اجرا کنید، Email را انتخاب کنید و تنظیمات درست را وارد کنید. برنامه آن‌ها را بدون فرستادن ایمیل آزمایش می‌کند و علت خطا را می‌گوید. پس از Apply، از کاربر بخواهید در صفحه‌ی ورود دوباره ایمیل تأیید را درخواست کند.
آزمون SMTP می‌گوید did not answer in time	سرور ایمیل پاسخ نمی‌دهد یا پورت ۵۸۷ از سمت سرور شما بسته است.	از شرکت میزبانی بپرسید که اتصال خروجی به پورت ۵۸۷ باز است یا نه. ابردرایو از پورت ۴۶۵ پشتیبانی نمی‌کند.
آزمون SMTP می‌گوید rejected the username or password	نام کاربری یا رمز اشتباه است.	نام کاربری و رمز را با configure.sh دوباره وارد کنید.

مجوز

نشانه	علت	راه‌حل
فایل مجوز پذیرفته نشد.	پیام کنار کادر علت را می‌گوید.	جدول پیام‌ها در نصب مجوز را ببینید.
وضعیت سخت‌افزار تغییر کرده است.	سرور به سخت‌افزار یا ماشین مجازی تازه‌ای منتقل شده یا سیستم‌عامل دوباره نصب شده است.	ظرف ۳۰ روز کد دستگاه تازه را برای فروشنده بفرستید و مجوز تازه را نصب کنید (تغییر سخت‌افزار).
یک گره در مدیریت > گره‌ها «خارج از مجوز» است و کاربر تازه نمی‌گیرد.	مجوز نصب‌شده نام این گره را ندارد.	مجوزی بگیرید که نام دقیق گره را، همان‌طور که در مدیریت > گره‌ها آمده، ببرد.
کاربر تازه هنگام اولین ورود پیام «ورود کامل نشد» می‌بیند.	مجوز هیچ‌یک از گره‌های ثبت‌شده را نام نمی‌برد.	مثل ردیف بالا.

به‌روزرسانی

نشانه	علت	راه‌حل
نصب‌کننده می‌گوید this update needs ..., installed is ...	بسته‌ی به‌روزرسانی برای نسخه‌ی دیگری ساخته شده است.	بسته‌ی کامل همان نسخه را بگیرید و نصب کنید.
پس از به‌روزرسانی چند سرویس مدام از نو راه‌اندازی می‌شوند و گزارششان دو تاریخ را نام می‌برد.	بسته پس از تاریخ «به‌روزرسانی تا» مجوز ساخته شده است.	با sudo bash configure.sh --rollback به نسخه‌ی قبلی برگردید، سپس مهلت را تمدید کنید (مهلت به‌روزرسانی).
پس از به‌روزرسانی، برنامه درست کار نمی‌کند.	مشکلی در نسخه‌ی تازه.	با sudo bash configure.sh --rollback به نسخه‌ی قبلی برگردید و موضوع را به پشتیبانی گزارش دهید.

گزارش مشکل به پشتیبانی

اگر مشکل حل نشد، خروجی این سه دستور را برای پشتیبانی بفرستید. SERVICE_NAME نام سرویسی است که خطا می‌دهد:

cd /opt/abrdrive
sudo bash tools/healthcheck.sh
docker compose ps
docker compose logs --tail 50 SERVICE_NAME

پیش از فرستادن، خروجی را یک بار بخوانید و اگر چیزی در آن هست که نباید بیرون برود، آن را پاک کنید.