راهنمای کامل دستیار هوش مصنوعی WhiteDNS و تنظیمات آن (نسخهٔ 0.12.0)
راهنمای جامع اتصال و راهاندازی دستیار هوش مصنوعی در پنل WhiteDNS با Gemini، OpenRouter، دیپسیک و مدل‌های محلی Ollama؛ تفسیر لاگ‌ها، عیب‌یابی خطاها و اعمال هوشمند تنظیمات.
دستیار هوش مصنوعی WhiteDNS به مدیر سرور کمک می‌کند گزارش‌های پنل را بررسی کند، دربارهٔ علت خطاها سؤال بپرسد و پیشنهادهای محدود برای اصلاح تنظیمات بگیرد. می‌توانید این کار را در همان صفحهٔ «لاگ‌ها و دستیار» انجام دهید؛ لازم نیست گزارش‌ها را دستی در یک چت دیگر کپی کنید.
این آموزش با رابط و رفتار پنل نسخهٔ 0.12.0 تطبیق داده شده است. قابلیت «دریافت مدل‌ها» در همین نسخه در دسترس است. دستیار، مدیر خودکار سرور نیست؛ تحلیل فقط هنگام ارسال پیام شما انجام می‌شود و چت به تنهایی تنظیمات را تغییر نمی‌دهد.
۱. دستیار چه کارهایی انجام می‌دهد؟
با کمک دستیار هوش مصنوعی می‌توانید:
- خطاهای اتصال، DNS، Soar، Cotten، MasterDNS و خود پنل را بهتر تفسیر کنید.
- تفاوت مشاهدهٔ ثبت‌شده با علت احتمالی را بررسی کنید.
- دربارهٔ محدودیت جریان، timeout، صف DNS و وضعیت منابع سؤال بپرسید.
- برای تنظیمات مجاز، پیشنهاد همراه دلیل و تفاوت مقدار قبلی و جدید بگیرید.
- پیشنهاد معتبر را پس از بررسی و تأیید اعمال کنید؛ امکان بازگردانی محدود زمانی هم وجود دارد.
دستیار امکان اجرای فرمان سیستم، خواندن فایل دلخواه، مرور اینترنت، تغییر حساب‌ها و رمزها، تعویض کلید یا لینک اشتراک، تنظیم فایروال، تغییر دامنه و تغییر سیاست ضدفلاد را ندارد. می‌تواند دربارهٔ گزارش ضدفلاد توضیح بدهد، اما تغییر آن را از ابزار دستیار اعمال نمی‌کند. داده‌ها مشاهدهٔ سمت سرور هستند؛ نبود خطا در گزارش، اتصال موفق تمام کاربران را اثبات نمی‌کند.
۲. پیش‌نیازها
برای شروع به این موارد نیاز دارید:
- دسترسی به پنل: دسترسی مدیریتی به پنل و ورود به صفحهٔ «لاگ‌ها و دستیار».
- کلید API یا مدل محلی: حساب و کلید API یک ارائه‌دهنده، یا سرویس مدل محلی که از قبل راهاندازی شده باشد.
- اتصال اینترنتی سرور: امکان اتصال خود سرور پنل به API انتخابی (باز شدن سایت سرویس روی گوشی یا لپ‌تاپ شما کافی نیست).
- مدل متنی سازگار: مدل متنی سازگار با قالب API انتخاب‌شده و دسترسی یا سهمیهٔ لازم برای استفاده از آن.
توجه: نصب پنل شامل اعتبار API یا سرویس مدل محلیِ از پیش نصب‌شده نیست. هزینه، سهمیه و دسترسی را در حساب ارائه‌دهنده بررسی کنید.
۳. راهاندازی سریع
- وارد بخش «لاگ‌ها و دستیار» شوید.
- در کارت «دستیار هوش مصنوعی»، بخش «اتصال به هوش مصنوعی» را باز کنید.
- «ارائه‌دهنده» را انتخاب کنید (پنل قالب API و آدرس پایهٔ پیشنهادی آن را در فرم قرار می‌دهد).
- «آدرس پایهٔ API» را با سرویس یا درگاه خود تطبیق دهید.
- «کلید API» همان سرویس را وارد کنید (برای سرویس محلیِ بدون احراز هویت، می‌تواند خالی بماند).
- دکمهٔ «دریافت مدل‌ها» را بزنید و در فیلد «مدل»، یک مدل متنی مناسب را انتخاب کنید.
- برای شروع، «حداکثر توکن پاسخ» را روی مقدار پیش‌فرض
4096نگه دارید. - اگر مدل با پاسخ ساختاریافته سازگار است، «درخواست پاسخ JSON از مدل» را روشن بگذارید.
- گزینهٔ «دستیار فعال باشد» را روشن کنید و «ذخیرهٔ اتصال» را بزنید.
- برای آزمایش اولیه، سؤال کوتاهی بپرسید (مثلاً: «وظیفهٔ تو در این پنل چیست؟»).
- مقصد نمایش‌داده‌شده را بخوانید، «ارسال به این ارائه‌دهنده و مقصد را تأیید می‌کنم» را بزنید و «ارسال و تحلیل» را انتخاب کنید.
ذخیرهٔ اتصال، فقط تنظیمات را ذخیره می‌کند و درخواستی به سرویس ارسال نمی‌کند. موفقیت ذخیره به معنی معتبر بودن کلید یا پاسخ دادن مدل نیست؛ دریافت مدل‌ها و ارسال یک سؤال، تست‌های مستقل هستند.
۴. معنی تمام گزینه‌های اتصال
| گزینه | کاربرد و روش استفاده |
|---|---|
| ارائه‌دهنده | سرویس یا درگاه مورد استفاده؛ نام مدل نیست. |
| قالب API | شکل ارتباط با سرویس: OpenAI compatible، Gemini native یا Anthropic Messages. باید با API مقصد سازگار باشد. |
| آدرس پایهٔ API | آدرس سرویس، بدون مسیر نهایی ارسال پیام. آدرس سایت چت معمولی یا صفحهٔ لاگین نیست. |
| مدل | مدل انتخاب‌شده از فهرست دریافتی. پنل بهترین مدل را خودکار تعیین نمی‌کند. |
| دریافت مدل‌ها | فهرست مدل‌ها را از همان سرویس دریافت می‌کند؛ مدل را نصب یا دانلود نمی‌کند. |
| ورود دستی مدل | برای درگاهی که فهرست مدل ندارد یا شناسهٔ مشخصی لازم دارد. |
| شناسهٔ مدل | با روشن شدن ورود دستی ظاهر می‌شود؛ شناسهٔ دقیق API را بنویسید، نه صرفاً نام تبلیغاتی مدل. |
| کلید API | اعتبارنامهٔ همان ارائه‌دهنده برای دسترسی به API. کلید را در سؤال یا گزارش عمومی ننویسید. |
| حذف کلید ذخیره‌شده | هنگام ذخیره، کلید قبلی را پاک می‌کند. برای خالی کردن واقعی کلید از این گزینه استفاده کنید. |
| حداکثر توکن پاسخ | سقف توکن خروجی درخواست؛ بازهٔ پنل 256 تا 16384 و پیش‌فرض 4096 است. |
| درخواست پاسخ JSON از مدل | در قالب‌های پشتیبانی‌شده، پاسخ ساختاریافته درخواست می‌کند تا پیشنهاد تغییر قابل پردازش باشد. |
| دستیار فعال باشد | اجازهٔ استفاده از چت را فعال می‌کند؛ تحلیل دوره‌ای یا ارسال خودکار گزارش را راه نمی‌اندازد. |
| ذخیرهٔ اتصال | تنظیمات را ذخیره می‌کند و گفت‌وگو و پیشنهادهای قبلی را از دسترس خارج می‌کند. |
۵. ارائه‌دهنده‌ها و آدرس پایه
جدول زیر پیش‌تنظیم‌های خود پنل است؛ همهٔ آدرس‌ها در صورت نیاز قابل ویرایش هستند:
| ارائه‌دهنده | قالب در پنل | آدرس پایهٔ پیش‌تنظیم |
|---|---|---|
| Google Gemini | Gemini native | https://generativelanguage.googleapis.com/v1beta |
| OpenRouter | OpenAI compatible | https://openrouter.ai/api/v1 |
| 9Router | OpenAI compatible | http://127.0.0.1:20128/v1 |
| DeepSeek | OpenAI compatible | https://api.deepseek.com |
| OpenAI | OpenAI compatible | https://api.openai.com/v1 |
| Anthropic / Claude | Anthropic Messages | https://api.anthropic.com/v1 |
| Groq | OpenAI compatible | https://api.groq.com/openai/v1 |
| Mistral | OpenAI compatible | https://api.mistral.ai/v1 |
| xAI / Grok | OpenAI compatible | https://api.x.ai/v1 |
| Together AI | OpenAI compatible | https://api.together.xyz/v1 |
| Fireworks AI | OpenAI compatible | https://api.fireworks.ai/inference/v1 |
| Ollama (local) | OpenAI compatible | http://127.0.0.1:11434/v1 |
| LM Studio (local) | OpenAI compatible | http://127.0.0.1:1234/v1 |
| Custom | یکی از سه قالب موجود | آدرس API اختصاصی شما |
در قالب OpenAI compatible، پنل /chat/completions را خودکار اضافه می‌کند. در Anthropic مسیر /messages اضافه می‌شود؛ بنابراین این مسیرها را در انتهای آدرس پایه تکرار نکنید.
۶. سه مثال عملی اتصال
مثال اول: Google Gemini
- از Google AI Studio کلید API بسازید (راهنمای ساخت کلید گوگل).
- در پنل، ارائه‌دهنده را Google Gemini بگذارید.
- قالب را Gemini native و آدرس پایه را
https://generativelanguage.googleapis.com/v1betaقرار دهید. - کلید را در «کلید API» وارد کنید.
- «دریافت مدل‌ها» را بزنید و مدلی متنی را انتخاب کنید که پروژهٔ شما برای استفاده از آن سهمیه دارد (مثلاً
gemini-2.5-flashیا مدل‌های در دسترس). - سقف پاسخ را تنظیم کنید (پیش‌فرض
4096است). - JSON را در صورت سازگاری روشن نگه دارید، دستیار را فعال و اتصال را ذخیره کنید.
مثال دوم: OpenRouter
- در OpenRouter کلید API خود را بسازید (راهنمای احراز هویت).
- ارائه‌دهنده را OpenRouter، قالب را OpenAI compatible و آدرس را
https://openrouter.ai/api/v1انتخاب کنید. - کلید OpenRouter را وارد و «دریافت مدل‌ها» را بزنید.
- یک مدل متنی سازگار با همین مسیر انتخاب کنید. اگر مدل انتخابی JSON نمی‌پذیرد، گزینهٔ آن را خاموش کنید.
- دستیار را فعال، اتصال را ذخیره و با سؤال کوتاه آزمایش کنید.
مثال سوم: مدل محلی با Ollama یا LM Studio
سرویس و مدل باید از قبل روی دستگاهی که پنل به آن دسترسی مجاز دارد، آماده باشند:
| گزینه | Ollama | LM Studio |
|---|---|---|
| ارائه‌دهنده | Ollama (local) | LM Studio (local) |
| قالب | OpenAI compatible | OpenAI compatible |
| آدرس پایهٔ نمونه | http://127.0.0.1:11434/v1 | http://127.0.0.1:1234/v1 |
| مدل | از «دریافت مدل‌ها» انتخاب شود | از «دریافت مدل‌ها» انتخاب شود |
| کلید | مطابق احراز هویت سرویس (معمولاً خالی) | مطابق احراز هویت سرویس (معمولاً خالی) |
آدرس 127.0.0.1 به همان محیط شبکهٔ سرور پنل اشاره دارد، نه به کامپیوتر مدیر. روشن بودن مدل روی لپ‌تاپ شما این آدرس را برای سرور VPS قابل استفاده نمی‌کند. مقصد بیرونی حتماً باید HTTPS داشته باشد (HTTP فقط برای loopback مجاز است).
۷. دریافت خودکار فهرست مدل‌ها
با زدن دکمهٔ «دریافت مدل‌ها» لازم نیست شناسه را دستی تایپ کنید. این دکمه با مقادیر فعلی فرم و حتی پیش از ذخیره کار می‌کند. این عملیات فهرست را از سرویس می‌گیرد و نام مدل‌ها را در انتخاب‌گر نشان می‌دهد، اما مدل را دانلود نمی‌کند یا سهمیه ایجاد نمی‌کند.
اگر دریافت ناموفق بود، آدرس، کلید، قالب و دسترسی سرور را بررسی کنید. در صورتی که درگاه فهرست مدل ندارد، «ورود دستی مدل» را روشن و شناسهٔ دقیق اعلام‌شده را وارد کنید.
۸. آماده کردن گزارش برای تحلیل
در کارت «گزارش سرویس» می‌توانید منبع، سطح، حساب، بازهٔ زمانی و عبارت جست‌وجو را انتخاب کنید:
- سؤال را با شرح نشانهٔ واقعی بنویسید (مثلاً قطع اتصال، کندی یا باز نشدن برنامه).
- زمان شروع مشکل، موتور مورد استفاده و نتیجهٔ آزمایش کاربر را توضیح دهید (بدون درج کلید، رمز یا لینک خصوصی).
- «پیوست گزارش پالایش‌شده و تنظیمات مرتبط» را روشن بگذارید.
- «پیش‌نمایش دادهٔ پیوست» را باز کنید و در صورت نیاز «به‌روزرسانی پیش‌نمایش» را بزنید.
- مقصد را بررسی کنید، ارسال را تأیید و «ارسال و تحلیل» را بزنید.
پیوست شامل حداکثر ۱۰۰ لاگ اخیر فیلترشده، وضعیت موتور، شمارنده‌ها، منابع میزبان و تنظیمات مرتبط است.
۹. نمونه سؤال‌های مفید
برای قطع اتصال:
کاربران Cotten از حدود ساعت ۲۱ قطع و وصل می‌شوند. با گزارش پیوست، مشاهدات را از حدس‌ها جدا کن و سه بررسی عملی پیشنهاد بده. اگر شواهد کافی نیست، بگو چه آزمایشی لازم است.
برای مشکل DNS:
خطاهای resolver زیاد شده‌اند. آیا گزارش بیشتر به مشکل DNS اشاره می‌کند یا کمبود ظرفیت؟ فقط براساس دادهٔ موجود نتیجه بگیر و اندازه‌گیری انجام‌نشده را فرض نکن.
برای سقف اتصال:
خطای server_stream_limit دیده می‌شود. اثر افزایش سقف بر منابع را توضیح بده و اگر داده کافی است، فقط کوچک‌ترین تغییر لازم را پیشنهاد بده.
برای تنظیم Soar:
اتصال Soar برقرار است ولی برخی کاربران ناپایداری دارند. تنظیمات فعلی و گزارش را بررسی کن؛ فقط گزینه‌های مرتبط را با دلیل و اثر جانبی پیشنهاد بده. تنظیمات Soar را به Cotten و MasterDNS تعمیم نده.
۱۰. بررسی و اعمال پیشنهاد تنظیمات
دستیار فقط می‌تواند برای این گزینه‌های مشخص پیشنهاد تغییر بسازد:
| دسته | محدودهٔ اختیار دستیار |
|---|---|
| Resolver | آدرس resolver عمومی معتبر |
| محدودهٔ جست‌وجو | ایران یا جهانی (این گزینه کشور IP خروجی سرور را عوض نمی‌کند). |
| سقف جریان سرور | محدودیت مشترک جریان‌های سرور |
| پروفایل Soar | روش ارتباط resolver، کشف مسیر، طول پرس‌وجو، اندازهٔ پاسخ، پنجره‌ها، بافرها و مهلت‌ها |
پیشنهاد تا ۱۰ دقیقه، فقط در همان نشست مدیر و برای یک بار اعمال معتبر است. در صورت نیاز تا ۱۰ دقیقه پس از اعمال، دکمهٔ «بازگردانی تغییر قبلی» در دسترس خواهد بود.
۱۱. خطاهای رایج و روش رسیدگی
| پیام یا وضعیت | معنی احتمالی و اقدام |
|---|---|
| دستیار غیرفعال است | مدل و اتصال را تنظیم کنید، «دستیار فعال باشد» را روشن و ذخیره کنید. |
| ابتدا یک مدل انتخاب کنید | فهرست را دریافت و مدل را انتخاب کنید، یا شناسهٔ معتبر را دستی وارد کنید. |
HTTP 400 | قالب، پارامترها، مدل یا درخواست JSON ممکن است ناسازگار باشد؛ در صورت ناسازگاری JSON آن را خاموش کنید. |
HTTP 401 | احراز هویت API مقصد را بررسی کنید (کلید API نامعتبر است یا منقضی شده). |
HTTP 402 | در برخی سرویس‌ها به اعتبار مالی یا پایان پرداخت مربوط است. |
HTTP 403 | دسترسی کلید، پروژه، مدل یا تحریم منطقه‌ای ارائه‌دهنده را بررسی کنید. |
HTTP 404 | آدرس پایه، شناسهٔ مدل یا مسیر API نادرست است. |
HTTP 429 | محدودیت نرخ (Rate limit) یا اتمام سهمیهٔ درخواست در دقیقه/روز ارائه‌دهنده. |
AI is busy | محدودیت همزمانی یا فاصلهٔ درخواست در خود پنل است؛ کمی صبر کنید. |
HTTP 409 | تنظیمات از زمان بررسی تغییر کرده یا پیشنهاد منقضی شده است؛ صفحه را تازه کنید. |
AI connection failed | دسترسی VPS، DNS و گواهی TLS را بررسی کنید (موفقیت مرورگر شما کافی نیست). |
| لغو درخواست یا timeout | پاسخ در مهلت ۱۰۰ ثانیه‌ای نرسیده است. سؤال کوتاه‌تر بپرسید یا مدل سریع‌تری انتخاب کنید. |
invalid diagnostic JSON | خروجی مدل ساختار مورد انتظار را رعایت نکرده؛ JSON را در فرم خاموش کنید. |
۱۲. حریم خصوصی، کلید و سابقهٔ گفتگو
- در پیوست خودکار، نام حساب، دامنهٔ اختصاصی، لینک ساب، کلیدهای تونل و ترافیک کاربران ارسال نمی‌شوند و شناسهٔ حساب مستعار می‌شود.
- کلید API روی سرور در فایل خصوصی
assistant.jsonنگهداری می‌شود و از API تنظیمات به مرورگر برنمی‌گردد. - پشتیبان پایگاه دادهٔ پنل شامل کلید AI نیست؛ پس از انتقال سرور، اتصال را مجدداً ثبت کنید.
- حداکثر شش نوبت سؤال‌وجواب اخیر در حافظهٔ موقت نگهداری می‌شود و سابقهٔ غیرفعال بیش از ۳۰ دقیقه باقی نمی‌ماند.
۱۳. چک‌لیست استفادهٔ درست
- آدرس API، قالب، مدل و کلید متعلق به یک سرویس سازگارند.
- دریافت مدل‌ها انجام شده یا شناسهٔ دستی دقیق است.
- پس از تغییر فرم، اتصال ذخیره شده است.
- پیش از ارسال، مقصد و دادهٔ پیوست بررسی شده‌اند.
- سؤال نشانه و شواهد دارد و اطلاعات محرمانه داخل آن نیست.
- هر پیشنهاد پیش از تأیید با مقدار قبلی و اثر جانبی مقایسه می‌شود.
- بعد از اعمال، وضعیت موتور و نتیجهٔ کاربر آزمایش می‌شود.