رفع مشکل
رایجترین مشکلهای نصب، اتصال، دادهها، اقدامها و بهروزرسانی و راهحل هر کدام.
پاسخ سؤالتان را پیدا نکردید؟ تیم پشتیبانی wardex در ساعات کاری کمکتان میکند.تماس با پشتیبانی
رایجترین مشکلهای نصب، اتصال، دادهها، اقدامها و بهروزرسانی و راهحل هر کدام.
بیشتر مشکلهای ایجنت یکی از چند علت رایج دارند. اول این سه دستور را روی سرور بزنید؛ معمولاً علت همینجا معلوم میشود:
sudo wardex-agent status
sudo systemctl status wardex-agent
sudo journalctl -u wardex-agent -n 50
| مشکل | علت معمول و راهحل |
|---|---|
TOKEN_INVALID هنگام نصب | توکن قبلاً استفاده شده یا یک ساعتش گذشته. در داشبورد افزودن سرور را دوباره بزنید تا دستور تازه بسازد |
SERVER_LIMIT یا SERVER_NOT_IN_PLAN | به سقف تعداد سرور پلن رسیدهاید یا پلن فعلی پایش سرور ندارد؛ پلنها را ببینید |
| «download failed» یا قطع شدن دانلود | سرور نمیتواند به wardex روی پورت ۴۴۳ وصل شود. فایروال خروجی را بررسی کنید: curl -I https://api.wardex.ir |
| «checksum mismatch» | فایل دانلودشده با نسخهی اصلی یکی نیست؛ چیزی نصب نشده. دوباره امتحان کنید؛ اگر تکرار شد، چیزی بین سرور و wardex فایل را عوض میکند |
| پنجرهی افزودن سرور مدام «منتظر اتصال» است | خروجی دستور نصب را ببینید؛ هر خطا همانجا توضیح داده شده |
| سرور در داشبورد «قطع» است | سرور خاموش است، اینترنتش قطع است یا سرویس wardex-agent متوقف شده: sudo systemctl restart wardex-agent |
CLOCK_SKEW در لاگ | ساعت سرور بیش از ۵ دقیقه خطا دارد و گزارشها پذیرفته نمیشوند: sudo timedatectl set-ntp true |
this agent was removed from wardex | سرور از داشبورد حذف شده؛ ایجنت عمداً متوقف شده. برای وصل کردن دوباره، از داشبورد دستور تازه بسازید |
اگر اتصال قطع شود، ایجنت گزارشها را تا یک روز روی دیسک نگه میدارد و بعد از وصل شدن میفرستد؛ تعدادشان در wardex-agent status آمده.
| مشکل | علت معمول و راهحل |
|---|---|
| نمودارها خالیاند | یکی دو دقیقه صبر کنید. اگر ماند، wardex-agent status را ببینید |
| بخشی در داشبورد چیزی نشان نمیدهد | ممکن است روی خود سرور خاموش باشد؛ در صفحهی تنظیمات سرور کنار آن بخش نوشته میشود «روی خود سرور خاموش شده» |
| ورودهای SSH ثبت نمیشوند | ایجنت لاگ ورود را پیدا نمیکند یا اجازهی خواندنش را ندارد. روی سیستمهایی که فقط journald دارند، کاربر wardex باید در گروه systemd-journal باشد |
| ترافیک وب نمایش داده نمیشود | لاگ دسترسی جای معمول نیست یا فرمتش combined نیست. مسیر را در accessLogs بنویسید؛ تنظیمات |
| کوئری کند نمایش داده نمیشود | لاگ کند دیتابیس روشن نیست؛ پایش منابع و سرویسها را ببینید |
| «بانک آسیبپذیریها در حال آماده شدن است» | چند دقیقه بعد خودکار بررسی میشود؛ نرمافزارهای آسیبپذیر |
| هشدار پردازهی مشکوک برای کاری که عمدی است | برنامه را در ignoreCommands بنویسید |
| فایلهای زیادی «تغییر کرد» گزارش میشوند | پوشههای کش یا آپلودهای پرتغییر را در مسیرهایی که نادیده گرفته شوند اضافه کنید |
| مشکل | علت معمول و راهحل |
|---|---|
| «سرویس اقدامها روی سرور اجرا نمیشود» | sudo systemctl status wardex-actuator؛ اگر خاموش است: sudo systemctl enable --now wardex-actuator |
NFT_MISSING | بستن IP به nftables نیاز دارد: sudo apt install nftables یا sudo dnf install nftables |
| کد Authenticator درست رد میشود | ساعت گوشی را روی تنظیم خودکار بگذارید و ساعت سرور را هم بررسی کنید: timedatectl |
| «تأیید از داشبورد یک ساعت قفل شد» | پنج کد اشتباه پشتسرهم وارد شده. یک ساعت صبر کنید یا همان کار را با دستور روی سرور انجام دهید |
| IP بسته نشد و «محافظتشده» است | IP خود سرور، نشست SSH باز، ورود موفق در ۳۰ روز گذشته یا فهرست neverBlock؛ از روی سرور با --force میشود بست |
| «فقط فایلهای داخل پوشهی سایت قرنطینه میشوند» | پوشهی سایت را در صفحهی تنظیمات سرور زیر پوشههای سایت اضافه کنید |
| دکمههای اقدام در داشبورد نیستند | تأیید از داشبورد هنوز برای حساب شما روشن نشده، یا Authenticator تنظیم نشده؛ همین کارها با دستور روی سرور انجام میشود (دستورهای روی سرور) |
| مشکل | علت معمول و راهحل |
|---|---|
| «the release signature is not valid» | فایلهایی که دانلود شدهاند امضای معتبر wardex ندارند و چیزی نصب نشده. این عمداً است؛ اگر تکرار شد، به پشتیبانی خبر دهید |
| «does not match the signed release» | فایل دانلودشده با نسخهی امضاشده یکی نیست؛ چیزی نصب نشده. دوباره امتحان کنید |
| «rolling out gradually» | نسخهی تازه مرحلهای پخش میشود و نوبت این سرور نرسیده. با sudo wardex-agent update همین الان دستی نصبش کنید |
| بعد از بهروزرسانی مشکلی پیش آمد | نسخهی قبلی در /usr/local/bin/wardex-agent.prev است: sudo cp /usr/local/bin/wardex-agent.prev /usr/local/bin/wardex-agent && sudo systemctl restart wardex-agent |