Skip to content

Feiabyte/nikvpn-codespace

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 

Repository files navigation

NikVPN Codespace - پروکسی رایگان VLESS+xHTTP با گیت‌هاب کداسپیس

NikVPN for Iran License: MIT

این ریپازیتوری به شما امکان می‌دهد در کمتر از ۵ دقیقه یک پروکسی VLESS با ترانسپورت xHTTP روی GitHub Codespaces راه‌اندازی کنید. کاملاً رایگان، بدون نیاز به سرور خارجی!


✨ ویژگی‌ها

  • 🆓 کاملاً رایگان - فقط با یک اکانت گیت‌هاب
  • 😍 **برای استفاده خارج از شبکه خانگی(بدون نیاز به باز بودن codespace ) ویدیو تکمیلی یوتوب رو ببینید
  • سرعت بالا - استفاده از Xray-core بهینه
  • 🔒 مقاوم در برابر فیلترینگ - پروتکل VLESS + xHTTP
  • 📱 پشتیبانی از همه کلاینت‌ها - v2rayNG، Nekobox، Streisand و...
  • 🔄 Keepalive خودکار - جلوگیری از خاموشی کداسپیس

📺 کانال‌های ما

پلتفرم لینک
یوتیوب https://youtube.com/@nikvpn4iran
تلگرام https://t.me/nikvpn_iran

💡 در کانال‌های ما عضو شوید تا از آموزش‌های جدید و ریپوهای به‌روز مطلع شوید.


🚀 نحوه استفاده (گام‌به‌گام)

مرحله ۱: فورک کردن ریپو

  1. وارد گیت‌هاب شوید و این ریپو را Fork کنید.
  2. یا اگر خودتان ریپو را ساخته‌اید، مستقیم استفاده کنید.

مرحله ۲: اجرا در Codespaces

  1. روی دکمه Code کلیک کنید.
  2. تب Codespaces را انتخاب کنید.
  3. روی Create codespace on main کلیک کنید.
  4. صبر کنید تا کانتینر ساخته شود (حدود ۲-۳ دقیقه).

مرحله ۳: دریافت لینک پروکسی

بعد از اتمام ساخت، در ترمینال یک لینک VLESS نمایش داده می‌شود. آن را کپی کنید.

مرحله ۴: تنظیم پورت (بسیار مهم)

  • در محیط Codespace، تب PORTS را باز کنید.
  • پورت 443 را پیدا کنید.
  • روی آن راست کلیک کرده و Visibility > Public را انتخاب کنید.

مرحله ۵: اتصال

لینک کپی‌شده را در اپلیکیشن پروکسی خود وارد کنید.


📖 راهنمای استفاده (Usage)

🔗 دریافت و استفاده از لینک

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

  1. لینک را کامل کپی کنید (از vless:// تا آخر)
  2. آن را در اپلیکیشن پروکسی خود وارد کنید (بیشتر اپلیکیشن‌ها با کلیک روی دکمه + یا Import from clipboard لینک را تشخیص می‌دهند)

🔄 نمایش مجدد لینک

اگر به هر دلیلی لینک را گم کردید یا نیاز به کپی مجدد دارید، در ترمینال کداسپیس دستور زیر را اجرا کنید:

show-link.sh

📋 مشاهده لاگ‌های Xray

برای مشاهده لاگ‌های سرور و اطمینان از عملکرد صحیح، دستور زیر را در ترمینال وارد کنید:

tmux attach -t nikvpn

برای خروج از نمای لاگ (بدون توقف سرویس)، کلیدهای Ctrl+B و سپس D را بزنید.


⏰ تنظیم تایم‌اوت کداسپیس (برای جلوگیری از خاموشی)

GitHub Codespaces به طور پیش‌فرض بعد از 30 دقیقه عدم فعالیت، سرور را خاموش می‌کند.

روش ۱: تغییر تنظیمات از طریق گیت‌هاب

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

https://github.com/settings/codespaces

در بخش Default idle timeout گزینه مورد نظر را انتخاب کنید:

  • 15 minutes (پیش‌فرض)
  • 30 minutes
  • 60 minutes
  • 120 minutes
  • 240 minutes (بیشترین مقدار ممکن)

روی Save کلیک کنید.

⚠️ توجه: حداکثر تایم‌اوت قابل تنظیم 240 دقیقه (۴ ساعت) است.


روش ۲: روش پایدار و همیشگی (اجباری برای ماندگاری نامحدود)

با تجربه‌ای که داشتم، حتی بعد از تغییر تنظیمات تایم‌اوت، باز هم پنجره Keepalive ظاهر می‌شد و اتصال قطع می‌شد.

راه‌حلی که جواب داد و کداسپیس تا ۲۴۰ دقیقه روشن ماند:

tmux attach -t nikvpn

وقتی این دستور را اجرا می‌کنید:

  • وارد جلسه tmux می‌شوید که Xray در آن در حال اجراست.
  • تا زمانی که این جلسه متصل (attached) است، کداسپیس خاموش نمی‌شود.
  • می‌توانید پنجره ترمینال را باز بگذارید یا آن را minimize کنید.

برای خروج از جلسه tmux (بدون توقف سرویس):

  • کلیدهای Ctrl+B و سپس D را بزنید.

💡 نکته طلایی: اگر می‌خواهید کداسپیس برای مدت طولانی روشن بماند، کافی است یک ترمینال باز کنید، دستور بالا را اجرا کنید و ترمینال را باز بگذارید.


📱 کلاینت‌های سازگار (Supported Clients)

پروکسی NikVPN با اکثر کلاینت‌های محبوب که از پروتکل VLESS پشتیبانی می‌کنند، سازگار است:

پلتفرم کلاینت‌های پیشنهادی
اندروید v2rayNG، Nekobox، Hiddify
ویندوز v2rayN، Nekoray، Hiddify-Next
iOS Streisand، FoXray، V2Box
لینوکس Nekoray، Xray-core، Hiddify-Next

⚠️ توجه: در برخی کلاینت‌ها ممکن است نیاز باشد تنظیمات زیر را به صورت دستی اعمال کنید:

  • پروتکل: VLESS
  • ترانسپورت (Network): xHTTP
  • mode: packet-up
  • امنیت (Security): TLS
  • allowInsecure=1

🧼 گزینه‌های آی‌پی تمیز (Clean IP Options)

آی‌پی پیش‌فرض استفاده شده در لینک 94.130.50.12 است.

اگر این آی‌پی در شبکه شما مسدود یا با اختلال مواجه است، می‌توانید آن را با یکی از آی‌پی‌های زیر جایگزین کنید.

🔽 آی‌پی‌های جایگزین

آی‌پی وضعیت تقریبی
63.141.252.203 ✅ مناسب برای ایرانسل
50.7.5.83 ✅ مناسب برای همراه اول
94.130.50.12 ⭐ پیش‌فرض

📝 نحوه جایگزینی آی‌پی

لینک اصلی:

vless://UUID@94.130.50.12:443?encryption=...

نمونه تغییر آی‌پی:

vless://UUID@63.141.252.203:443?encryption=...

💡 نکته حرفه‌ای: اگر هیچکدام از آی‌پی‌ها کار نکرد، می‌توانید از ابزارهای پیدا کردن Clean IP کلودفلر استفاده کنید.


🆘 عیب‌یابی (Troubleshooting)

مشکل راه حل
اتصال برقرار نمی‌شود 1. پورت 443 باید Public باشد
2. آی‌پی Clean IP را تغییر دهید
3. allowInsecure را روی true یا 1 بگذارید
سرعت پایین است آی‌پی دیگری امتحان کنید یا Codespace را ری‌استارت کنید
لینک نمایش داده نمی‌شود دستور زیر را اجرا کنید:
show-link.sh
خطای UUID not found Codespace را حذف و دوباره بسازید
کداسپیس زود خاموش می‌شود دستور زیر را اجرا کنید:
tmux attach -t nikvpn

⚠️ نکات مهم

  • هر ماه ۶۰ ساعت استفاده رایگان دارید.
  • بعد از اتمام کار، Codespace را Stop کنید تا ساعاتتان هدر نرود.
  • اگر اتصال برقرار نشد، از allowInsecure=1 استفاده کنید.
  • در برخی کلاینت‌ها باید type را روی xhttp تنظیم کنید.
  • برای ماندگاری بیشتر کداسپیس، از tmux attach استفاده کنید.

🛠️ توسعه‌دهندگان

این پروژه از تکنولوژی‌های زیر استفاده می‌کند:

  • Xray-core
  • GitHub Codespaces
  • Docker

📂 ساختار پروژه

nikvpn-codespace/
├── .devcontainer/
│   ├── Dockerfile
│   ├── config.json
│   ├── devcontainer.json
│   ├── setup.sh
│   ├── show-link.sh
│   └── start.sh
├── LICENSE
└── README.md

🤝 حمایت

اگر این پروژه برایتان مفید بود:


NikVPN for IRAN – اینترنت آزاد برای همه 🇮🇷

About

Free VLESS proxy using GitHub Codespaces - NikVPN for Iran

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Shell 78.1%
  • Dockerfile 21.9%