راهنمای نصب نیکا نتNika Net · Deployment guide · v0.1

این راهنما شما را از صفر تا اولین کاربر متصل همراهی می‌کند. سه روش نصب وجود دارد؛ اگر مبتدی هستید روش ۱ یا روش ۳ را انتخاب کنید.

پیش‌نیازها

چرا Cloudflare Worker؟سرور مبدأ ندارد، پلن رایگان روزانه ۱۰۰٬۰۰۰ درخواست می‌دهد، دامنه‌ی workers.dev رایگان و TLS خودکار است. همه‌ی داده‌ها در حساب خودتان می‌ماند.

روش ۱ · نصب یک‌کلیکی با Workers Builds Recommended

Cloudflare ریپو را در حساب گیت‌هاب شما فورک می‌کند، Worker و دیتابیس D1 را می‌سازد و با هر تغییر خودکار دیپلوی می‌کند.

Deploy to Cloudflare

  1. روی دکمه بالا بزنید و با حساب Cloudflare و GitHub وارد شوید.
  2. در صفحه‌ی تنظیمات، Build command را npm run build و Deploy command را npx wrangler deploy بگذارید.
  3. بخش D1 را تأیید کنید تا دیتابیس nika-net-db با بایندینگ DB ساخته شود.
  4. روی Create and deploy بزنید. بعد از ۱–۲ دقیقه آدرس Worker آماده است → به بعد از نصب بروید.

روش ۲ · دیپلوی دستی با Wrangler

مناسب توسعه‌دهنده‌ها. ترمینال را باز کنید:

# 1) نصب و ورود
npm install -g wrangler
wrangler login

# 2) دریافت پروژه
git clone https://github.com/azadipanell/Nika-Net.git
cd Nika-Net

# 3) ساخت دیتابیس D1
wrangler d1 create nika-net-db
#   ← database_id خروجی را در wrangler.toml قرار دهید

# 4) ساخت و دیپلوی
npm install
npm run build
npx wrangler deploy
wrangler.tomlمطمئن شوید main = "dist/_worker.js" است و در بخش [[d1_databases]] مقدار binding = "DB" و database_id شما درج شده باشد.

روش ۳ · فقط با داشبورد Cloudflare (بدون نصب چیزی)

  1. فایل dist/_worker.js را از Releases دانلود کنید (یا خودتان npm run build بزنید).
  2. در داشبورد Cloudflare: Workers & Pages → Create → Create Worker → یک نام بدهید → Deploy.
  3. Edit code → کل محتوای فایل را جایگزین کد پیش‌فرض کنید → Deploy.
  4. Workers & Pages → D1 → Create database با نام دلخواه بسازید.
  5. در Worker: Settings → Bindings → Add → D1 database؛ نام متغیر را دقیقاً DB بگذارید و دیتابیس را انتخاب کنید.
  6. (اختیاری) Settings → Variables → Add secret با نام NIKA_CLAIM_TOKEN تا فقط با توکن بتوان پنل را راه‌اندازی کرد.
  7. آدرس Worker را باز کنید — صفحه‌ی خوش‌آمد لینک پنل را نشان می‌دهد.

بعد از نصب

  1. روی لینک پنل در صفحه‌ی خوش‌آمد کلیک کنید.
  2. نام کاربری و رمز مدیر (حداقل ۶ کاراکتر) را تعیین کنید.
  3. به تنظیمات بروید:
    گزینهتوضیح
    دامنه‌هادامنه‌ی workers.dev خودکار هست؛ دامنه‌ی شخصی را در صورت اتصال اضافه کنید.
    Clean IPاگر IP تمیز دارید هر خط یکی؛ وگرنه خالی بگذارید تا از دامنه استفاده شود.
    پورت‌هاپیش‌فرض 443, 80. برای TLS فقط پورت‌های امن Cloudflare.
    مسیرهامسیر پنل و رله تصادفی‌اند؛ با یک کلیک قابل چرخش.
  4. در کاربران یک کاربر بسازید: نام، سهمیه حجم (GB)، تاریخ انقضا. لینک اشتراک + QR نمایش داده می‌شود.
  5. لینک را برای کاربر بفرستید. تمام ✓
نکته‌ی امنیتیلینک پنل را جایی عمومی نگذارید. بازدیدکنندگان بدون مسیر درست فقط صفحه‌ی استتار می‌بینند.

اتصال کلاینت‌ها

یک لینک اشتراک برای همه کافی است؛ فرمت به‌طور خودکار بر اساس کلاینت انتخاب می‌شود.

  • v2rayNG: منوی ⋮ → Add subscription → لینک را پیست کنید → Update.
  • Hiddify: + → Add from clipboard.
  • Clash Meta / NekoBox: پروفایل → URL → لینک اشتراک.
  • Streisand یا Hiddify: افزودن اشتراک با لینک.
  • Shadowrocket: + → Type: Subscribe → URL.
  • Sing-box: Profiles → New → Remote → لینک.
  • Hiddify Next، v2rayN، Clash Verge: افزودن اشتراک / پروفایل با لینک.
  • Clash Verge، Hiddify Next، sing-box CLI: پروفایل ریموت با لینک اشتراک.

خروجی‌های اختصاصی هم در دسترس‌اند: ?format=clash · ?format=singbox · ?format=base64

ربات تلگرام

ربات @NikaNettbot لانچر پنل است: پنل را مستقیم از تلگرام باز می‌کند تا نیازی به حفظ آدرس‌های تصادفی نباشد.

✈ اجرای ربات کانال اطلاع‌رسانی

عیب‌یابی

تنظیمات ذخیره نمی‌شود

بایندینگ D1 دقیقاً با نام DB ساخته شده باشد و Worker بعد از افزودن بایندینگ دوباره دیپلوی شده باشد.

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

در تنظیمات، حالت TLS و پورت‌ها را با دامنه هماهنگ کنید. برای workers.dev فقط TLS + پورت 443. اگر Clean IP وارد کرده‌اید، یک‌بار خالی کنید و تست بگیرید.

صفحه‌ی خوش‌آمد را از دست دادم و مسیر پنل را نمی‌دانم

wrangler d1 execute nika-net-db --command "SELECT value FROM kv WHERE key='panel_settings'"

فیلد panelPath مسیر پنل است. یا در داشبورد D1 → Console همین کوئری را اجرا کنید.

خطای 1101 / Worker threw exception

معمولاً بایندینگ D1 نیست یا فایل _worker.js ناقص پیست شده. لاگ را در Workers → Logs ببینید.

حجم مصرفی درست شمرده نمی‌شود

شمارش با کمی تأخیر (batch) انجام می‌شود؛ چند دقیقه صبر کنید. در پلن رایگان، محدودیت CPU-time نیز می‌تواند بر دقت اثر بگذارد.

به‌روزرسانی

تغییرات هر نسخه در CHANGELOG و کانال @shahyad_asr اعلام می‌شود.