عیب‌یابی

هر پیام، با توضیح

مرجع خطاها هر پیامی را که پنل، نصب‌کننده، update.sh و منوی w-ui ممکن است نشان دهند فهرست کرده، با معنی هر کدام و کاری که باید کرد.

از لاگ شروع کنید:

journalctl -u wui -n 200 --no-pager

بعد ببینید پنل درباره‌ی خودش چه می‌گوید: w-ui settings، بخش سیستم در نمای کلی، و تنظیمات ← موتور برای اینکه سقف‌ها اعمال می‌شوند یا نه.

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

• کدام آدرس؟ دستور w-ui settings آدرس Access URL را نشان می‌دهد. پورت و مسیر ممکن است با آنچه به یاد دارید فرق کند؛ مقدارهای صفحه‌ی تنظیمات بر متغیرهای محیطی مقدم‌اند.
• هشدار گواهی روی آدرس IP. برای خود آدرس IP گواهی شش‌روزه صادر می‌شود. اگر مرورگر ایراد می‌گیرد، گواهی منقضی شده و تمدیدش شکست می‌خورد. systemctl status wui-cert-renew.timer را اجرا کنید، بعد با w-ui ← 20 ← 3 گواهی را دستی تمدید کنید و خطا را بخوانید.
• پشت پراکسی، خطای 400 یا 502. پنل HTTPS ارائه می‌دهد. پراکسی را با proxy_ssl_server_name on به https://127.0.0.1:PORT وصل کنید، یا پنل را با --no-tls نصب کنید و TLS را در پراکسی تمام کنید. پراکسی معکوس را ببینید.

مشتری وصل نمی‌شود

• اینترفیس بالاست؟ کلید فعال در صفحه‌ی اینترفیس‌ها را ببینید، و روی سرور wg show یا awg show را اجرا کنید.
• پورت باز است؟ اول فایروال ارائه‌دهنده‌ی سرور را بررسی کنید، بعد w-ui ← 23. پروتکل‌های L2TP، PPTP و IKEv2 بیش از یک پورت لازم دارند و PPTP به GRE هم نیاز دارد؛ پورت‌ها و فایروال را ببینید.
• مشتری فعال است؟ دستگاه‌های مشتری‌ای که در هر وضعیتی جز فعال باشد از تونل‌ها برداشته می‌شوند. حجم را بیشتر کنید یا تاریخ انقضا را تمدید کنید.
• اندپوینت درست است؟ اندپوینت اینترفیس همان چیزی است که در کانفیگ‌ها نوشته می‌شود، و برای WireGuard و OpenVPN یک میزبان می‌تواند آن را عوض کند.
• اپ با حالت اینترفیس جور نیست. اینترفیس AmneziaWG اپ AmneziaWG لازم دارد و اینترفیس WireGuard ساده اپ WireGuard. حالت برای هر اینترفیس جداگانه تعیین می‌شود.
• کنار گذاشته شده؟ فایلی که هم‌زمان روی دستگاه‌هایی بیشتر از کاربران پلن استفاده شود، دو دقیقه کنار گذاشته می‌شود. لاگ می‌نویسد connection limit reached; device held off.
• دو دستگاه L2TP پشت یک آدرس. L2TP/IPsec نمی‌تواند هم‌زمان دو دستگاهی را ببرد که از یک آدرس عمومی به سرور می‌رسند؛ فقط یکی کار می‌کند. به این مشتری‌ها IKEv2، WireGuard یا OpenConnect بدهید. اینترفیس‌ها را ببینید.

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

• فوروارد کردن بسته‌ها. مقدار sysctl net.ipv4.ip_forward باید 1 باشد؛ نصب‌کننده آن را تنظیم می‌کند.
• اینترفیس خروجی. اینترفیس خروجی هر اینترفیس باید کارت شبکه‌ی عمومی سرور باشد؛ ip route get 1.1.1.1 نشان می‌دهد کدام است.
• خروجی پیش‌فرض از کار افتاده. وقتی قطع ترافیک وقتی خروجی پیش‌فرض از کار افتاده روشن است، تا وقتی هاپ بالای فهرست خروجی‌ها در دسترس نیست، ترافیک مشتری‌ها قطع است. هاپ را بررسی کنید، یا direct را به بالای فهرست ببرید.
• DNS. مشتری‌ها نام‌ها را از طریق دروازه‌ی تونل ترجمه می‌کنند؛ موتور ← DNS سرورهای بالادست را نشان می‌دهد.
• PPTP وصل می‌شود ولی چیزی رد نمی‌شود. GRE در مسیر بسته است، که معمولاً کار فایروال ارائه‌دهنده است.

سقف‌ها اعمال نمی‌شوند

اعلان زردی بالای همه‌ی صفحه‌ها، و محدودیت حجم در تنظیمات ← موتور، می‌گویند وقتی اعمال سقف حجم روی این سرور کار نمی‌کند. اگر کرنل nft_quota را نداشته باشد، سقف‌ها را پنل با یک دور تأخیر اعمال می‌کند، نه کرنل دقیقاً در همان بایت. روی کرنل استاندارد، modprobe nft_quota را اجرا کنید؛ روی کرنل سفارشی یا کانتینر، ماژول را بار کنید یا بسازید. موتور ← تولیدشده برنامه‌ای را که از کرنل خواسته شده اجرا کند نشان می‌دهد.

برنامه‌ی دیگری پورت 80 را گرفته و تمدید شکست می‌خورد

گزینه‌های w-ui ← 20 ← 1 یا 6 پورت دیگری برای شنونده‌ی ACME می‌پرسند؛ پورت 80 بیرونی را به آن فوروارد کنید. یا گواهی را از طریق وب‌سروری که از قبل روی سرور هست، با acme.sh --webroot، صادر کنید.

پنل را اشتباهی حذف کرده‌ام

فایل /root/wui-last-copy-<date>.tar.gz دیتابیس و کلیدها را دارد. پنل را دوباره نصب کنید و این فایل را مثل هر بکاپ دیگری بازگردانی کنید: نمای کلی ← بکاپ و بازگردانی ← انتخاب فایل، یا منوی w-ui backup و گزینه‌ی 2.

فقط اگر پنل موقع حذف نتوانسته باشد آرشیو خودش را بسازد، این فایل کپی ساده‌ای از /var/lib/wui و /etc/wui است. در آن صورت پنل را متوقف کنید، فایل را روی / باز کنید، chown -R wui:wui /var/lib/wui را اجرا کنید و پنل را راه بیندازید.

کمک گرفتن

یک issue باز کنید، با خروجی wui version، سیستم‌عامل، کرنل، پروتکل، و خط‌های مربوط از journalctl -u wui.