عیب‌یابی

این صفحه مشکل‌ها را بر اساس چیزی که می‌بینید فهرست می‌کند، با محتمل‌ترین علت در ابتدا. دو بررسی جواب بیشتر پرسش‌ها را می‌دهد: لاگ، و کارت نود در نودها.

ovira status          # is the panel running, and at what address
ovira logs -f         # follow the panel log
ovira logs NAME       # the log of one inbound, for example udp1194

روی نود همین دستورها نود را نشان می‌دهند. دلیل رد شدن یک اتصال در لاگ پنل نوشته می‌شود. چرخهٔ عمر یک اتصال را ببینید.

پنل باز نمی‌شود

• آدرس مسیر مخفی را ندارد. پنل برای هر مسیری جز مسیری که نصب‌کننده چاپ کرده 404 می‌دهد. ovira status آدرس کامل را چاپ می‌کند.
• پورت بسته است. پورت پنل (۲۰۵۳ مگر پورت دیگری انتخاب کرده باشید) را در فایروال سرور و در فایروال سرویس‌دهنده باز کنید.
• صفحه با http:// باز شده در حالی که پنل HTTPS می‌دهد، یا برعکس. ovira status نشان می‌دهد HTTPS روشن است یا نه.
• سرویس اجرا نمی‌شود. systemctl status ovira را بزنید، بعد journalctl -u ovira -n 50.

آدرس، رمز یا برنامهٔ احراز هویت را گم کرده‌ام

ovira status                              # the address
ovira password admin                      # a new password for the account "admin"
ovira admin reset-2fa -username admin     # remove two-factor sign-in from an account

نود در حالت «در دسترس نیست» می‌ماند

• پنل نمی‌تواند به پورت نود برسد. TCP ‏۶۲۰۶۰ (یا پورتی که انتخاب کرده‌اید) باید روی نود و در فایروال سرویس‌دهندهٔ آن باز باشد.
• نود با --panel-ip نصب شده و پنل از آدرس دیگری وصل می‌شود. با آدرس درست دوباره نصب کنید، یا allowFrom را در /etc/ovira-node/node.json ویرایش کنید و نود را دوباره راه بیندازید.
• نود دوباره نصب شده و کلیدش عوض شده. ovira key را روی نود بزنید و کلید جدید را در ویرایش نود در پنل بگذارید.
• سرویس نود متوقف است. روی نود systemctl status ovira-node را بزنید.
• نسخهٔ نود و پنل ناسازگارند. کارت همین را می‌گوید. نود را به‌روز کنید، یا نصب‌کنندهٔ نود را دوباره اجرا کنید.

پیام کارت و زمان آخرین ارتباط می‌گویند این وضعیت چقدر طول کشیده. نود و پنلش را ببینید.

نصب نود ناموفق است

• پورت ۶۲۰۶۰ اشغال است، مثلاً با نود پنل دیگری. با --port 62070 نصب کنید و هنگام اتصال نود همان پورت را بدهید.
• توزیع پشتیبانی نمی‌شود. اویرا اوبونتو 22.04 یا جدیدتر را پشتیبانی می‌کند.
• OpenSSL قدیمی‌تر از ۳ نصب است. اسکریپت‌ها OpenSSL نسخهٔ ۳ یا بالاتر می‌خواهند.
• سرور systemd یا دسترسی root ندارد. هر دو لازم‌اند.
• لاگ این تلاش در /var/log/ovira-install.log است.

اینباند وصل یا اجرا نمی‌شود

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

• پورت روی آن نود با اینباند یا برنامهٔ دیگری اشغال است. پورت دیگری بگذارید.
• شبکهٔ تونل با اینباند دیگر یا مسیری روی نود (WireGuard، Docker، VPN دیگر) هم‌پوشانی دارد. شبکهٔ دیگری بگذارید.
• OpenConnect روی همین سرور نصب نیست. اول روی کارتش نصب OpenConnect را بزنید.
• نود برای آن پروتکل قدیمی است. OpenConnect نسخهٔ ۰٫۶٫۰ و WireGuard نسخهٔ ۰٫۷٫۰ می‌خواهد. نود را از به‌روزرسانی به‌روز کنید.
• نود TUN در دسترس نیست نشان می‌دهد. TUN را نزد سرویس‌دهنده فعال کنید، یا از نود دیگری استفاده کنید.
• نود در دسترس نیست. اول آن را درست کنید.

کاربر نمی‌تواند وصل شود

در لاگ پنل دنبال connection denied بگردید. دلیل را نام می‌برد.

دلیل در لاگ	علت و راه‌حل
unknown client	چنین نامی وجود ندارد؛ معمولاً غلط تایپی یا کاربر حذف‌شده.
wrong password	رمز اشتباه است. رمز VPN کاربر در صفحهٔ اوست.
certificate was replaced	گواهی کاربر عوض شده، مثلاً بعد از تغییر نام. پروفایل تازه را بفرستید.
username does not match certificate	در اینباند گواهی و رمز، نام کاربری باید با نام کاربر یکی باشد.
account disabled	کاربر خاموش شده، یا نمایندهٔ او.
account expired	تاریخ پایان گذشته. تمدید کنید.
traffic quota used up	حجم تمام شده. صفر یا بیشترش کنید.
not allowed on this server	گروه‌های کاربر این اینباند را شامل نمی‌شوند.
license client limit exceeded	تعداد کاربران فعال پنل از حد پلن بیشتر است. لایسنس را ببینید.
device limit reached	کاربر همین الان به اندازهٔ مجاز اتصال دارد. یکی را در اتصال‌ها قطع کنید، یا سقف را بالا ببرید.

اگر لاگ اصلاً ردی نشان نمی‌دهد، اتصال به نود نرسیده است:

• پورت اینباند در یک فایروال بسته است، روی سرور یا نزد سرویس‌دهنده. برای UDP قانون UDP لازم است.
• پروفایل پورت یا آدرس قدیمی دارد. بعد از تغییر پورت، کاربران باید پروفایل را دوباره وارد کنند.
• رله به پورت و پروتکل اینباند عبور نمی‌دهد.
• اینباند متوقف است. اینباندها وضعیتش را نشان می‌دهد.
• نود در دسترس نیست. نودی که پنلش را ندارد ورود تازه نمی‌پذیرد.

کاربر وصل می‌شود ولی اینترنت ندارد

• NAT ترافیک کاربران به اینترنت روی اینباند خاموش است. روشنش کنید.
• فایروالی جلوی سرور ترافیک فوروارد‌شده را می‌بندد. روی سرورهایی که nftables فایروال را اداره می‌کند، اویرا قانون‌هایش را در جدول خودش نگه می‌دارد: nft list table ip ovira.
• فوروارد IPv4 خاموش است. sysctl net.ipv4.ip_forward باید ۱ چاپ کند.
• سرور مسیر پیش‌فرض IPv4 ندارد و NAT نمی‌تواند برقرار شود. لاگ پنل همین را می‌گوید.
• سرورهای DNS اینباند از شبکهٔ کاربر در دسترس نیستند. موارد دیگری را امتحان کنید.

دو دستگاه همدیگر را قطع می‌کنند

• در WireGuard هر دو دستگاه یک پیکربندی را وارد کرده‌اند. در صفحهٔ اشتراک به هر کدام دستگاه جدا بدهید.
• در OpenVPN کاربر به سقف دستگاهش رسیده. اتصال جدیدتر رد می‌شود، نه قدیمی‌تر.

مشکل‌های OpenConnect

• برنامهٔ سیسکو «untrusted server» می‌گوید. Block untrusted servers را در تنظیماتش خاموش کنید، یا به اینباند گواهی معتبر بدهید.
• مرورگر آدرس را باز می‌کند و «Restricted Content» یا یک رد ساده می‌بیند. این استتار است که کار می‌کند. آدرس کامل را با ?secret استفاده کنید.
• استتار (Camouflage) خاکستری است. روی دستگاه ocserv قدیمی‌تر از ۱٫۲٫۰ است.
• گواهی معتبر صادر نمی‌شود. نام باید به نود اشاره کند و TCP پورت ۸۰ روی نود باید آزاد و باز باشد، در فایروال سرویس‌دهنده هم. خطای اینباند می‌گوید کدام بخش ناموفق بوده. OpenConnect را ببینید.
• پورت اشغال است. OpenConnect به پورت TCP نیاز دارد، و وقتی DTLS روشن است به پورت UDP با همان شماره. اینباند OpenVPN روی TCP ‏۴۴۳ با آن تداخل دارد.
• رله ناهمخوانی نام گواهی نشان می‌دهد. از اثرانگشت گواهی استفاده کنید. رله‌ها و آدرس‌های اتصال را ببینید.

مشکل‌های WireGuard

• تبادل کلید نیست، یا وصل است ولی ترافیکی نیست. پورت UDP باید در فایروال سرویس‌دهنده باز باشد و رله، اگر هست، باید UDP را به آن عبور دهد.
• روی یک شبکه کار می‌کند ولی روی دیگری نه. شاید آن شبکه WireGuard را می‌بندد. یک اینباند امنزیا با برنامهٔ AmneziaVPN امتحان کنید.
• برنامهٔ WireGuard ساده به اینباند امنزیا وصل نمی‌شود، و برعکس.
• اینباند روی نود اجرا نمی‌شود. صفحهٔ نودها TUN در دسترس نیست نشان می‌دهد؛ TUN را فعال کنید یا نود دیگری بگیرید.

پنل گواهی HTTPS ندارد

Let's Encrypt هنگام صدور روی پورت ۸۰ یا ۴۴۳ به سرور وصل می‌شود. اگر برنامهٔ دیگری (nginx، Caddy، Xray) هر دو پورت را گرفته باشد صدور ناموفق است. یکی را در زمان صدور و تمدید آزاد کنید. دامنه باید به همین سرور اشاره کند و Let's Encrypt برای بعضی دامنه‌ها محدودیت نرخ دارد. HTTPS پنل را ببینید.

پنل می‌گوید تغییرها متوقف است

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

ترافیک اشتباه به نظر می‌رسد

• نودی که ضریب مصرفش ۱ نیست، بیشتر یا کمتر از آنچه روی کارت نود دیده می‌شود از حجم کاربر کم می‌کند. آن کارت مقدار واقعی را نشان می‌دهد. ترافیک، سهمیه و محدودیت‌ها را ببینید.
• نودی در دسترس نبوده و اتصالی در آن فاصله تمام شده. ترافیک فرایند VPN که در این مدت دوباره راه افتاده قابل بازیابی نیست.
• کاربری که صفر شدن خودکار دارد نیمه‌شب به وقت منطقهٔ زمانی سرور پنل صفر شده است.

صفحه‌های مرتبط

• خط فرمان: دستورهایی که بالا استفاده شد.
• فایل‌ها، سرویس‌ها و پورت‌ها: مسیرها، سرویس‌ها و پورت‌هایی که باید باز شوند.
• چرخهٔ عمر یک اتصال: چرا اتصالی رد یا قطع می‌شود.
• نود و پنلش: وقتی ارتباط قطع می‌شود چه می‌شود.