نصب و پیکربندی Happ در توزیعهای Linux
کلاینت دسکتاپ Happ روی Linux با هسته Xray کار میکند و یک proxy محلی برای سیستم و برنامهها فراهم میسازد. در ادامه، نصب از طریق AppImage یا بسته، اتصال لینک اشتراک از ربات Telegram و تنظیم اجرای خودکار را میبینید.
نحوه اتصال Happ VPN — Linux
اپلیکیشن را نصب کنید
Happ برای Linux را از منبع رسمی برای توزیع خود دانلود کنید.
کلید بگیرید
ربات Telegram را باز کنید و دسترسی را فعال کنید.
کلید را اضافه کنید
لینک اشتراک را به اپلیکیشن وارد کنید.
اتصال را روشن کنید
سروری انتخاب کنید و VPN را روشن کنید.
نصب Happ روی Linux: AppImage و .deb
نسخه دسکتاپ Happ در بخش Releases مخزن Happ-proxy در GitHub منتشر میشود. برای بیشتر توزیعها قالب همگانی AppImage راحتتر است — نیازی به نصب ندارد و از هر پوشهای اجرا میشود. برای خانواده Debian و Ubuntu بسته جداگانه .deb وجود دارد.
آخرین فایل مناسب معماری خود (معمولاً x86_64) را دانلود کنید و AppImage را اجرایی کنید، سپس اجرا نمایید: `chmod +x Happ-x86_64.AppImage` و `./Happ-x86_64.AppImage`. برای .deb از `sudo apt install ./happ_amd64.deb` استفاده کنید — مدیر بسته وابستگیها را خودش دریافت میکند.
اگر AppImage اجرا نشد، معمولاً کتابخانه FUSE کم است. آن را با دستور `sudo apt install libfuse2` (Debian/Ubuntu) یا معادلش برای توزیع خود نصب کنید. بهعنوان راهحل جایگزین میتوان AppImage را استخراج و مستقیم اجرا کرد: `./Happ-x86_64.AppImage --appimage-extract` و سپس `./squashfs-root/AppRun`.
وارد کردن اشتراک و پیکربندی
دسترسی به سرورها را ربات Telegram سرویس صادر میکند: آنجا کلید آزمایشی، پرداختشده یا رسمی را فعال کرده و لینک اشتراکی به شکل https://…/sub/… دریافت میکنید. این لینک شامل فهرست بهروز سرورها و پارامترهای Xray است — نیازی به وارد کردن دستی config نیست.
در برنامه، افزودن پیکربندی را باز کنید، لینک اشتراک را بچسبانید و ذخیره نمایید. Happ همه سرورهای در دسترس را در یک فهرست بارگذاری میکند و در ادامه آنها را از همین لینک بهروزرسانی میکند. اگر سرورها تغییر کنند یا موقعیتهای جدید اضافه شوند، کافی است روی بهروزرسانی اشتراک بزنید — نیازی به نصب مجدد نیست.
در صورت نیاز میتوان یک پیکربندی تکی هم افزود: رشته vless:// یا ss:// را از ربات کپی کرده و از طریق وارد کردن از کلیپبورد بچسبانید. همان کلید روی همه دستگاهها کار میکند، بنابراین اشتراک Linux با Windows و کلاینتهای موبایل یکسان است.
اجرای حالت proxy روی هسته Xray
پس از وارد کردن، سروری را از فهرست انتخاب کنید و اتصال را روشن نمایید. Happ یک proxy محلی (SOCKS و HTTP) روی هسته Xray بالا میآورد و ترافیک را از آن مسیریابی میکند. در حالت سیستمی، کلاینت proxy را در تنظیمات محیط کاری ثبت میکند، بنابراین browserها و بیشتر برنامهها بدون تنظیم اضافی از طریق تونل کار میکنند.
پورت محلی proxy را میتوان بهصورت دستی در تنظیمات برنامه مشخص کرد — این کار زمانی مفید است که بخواهید فقط یک برنامه مشخص را به Happ هدایت کنید. نشانی 127.0.0.1 و پورت تعیینشده را در تنظیمات proxy مرورگر یا در متغیرهای محیطی وارد کنید (برای مثال، `export https_proxy=http://127.0.0.1:PORT`) و بقیه ترافیک را مستقیم بگذارید.
برای تفکیک دقیق ترافیک، Happ مسیریابی بر اساس فهرستها و split tunneling دارد — اینکه کدام دامنهها و برنامهها از طریق proxy میروند و کدام از آن دور میزنند. بررسی دقیق قواعد و utility در بخشهای جداگانه سایت آورده شده تا نصب پایه با تنظیم ظریف مسیرها آمیخته نشود.
اجرای خودکار Happ هنگام راهاندازی سیستم
برای اینکه proxy بهصورت خودکار بالا بیاید، کلاینت را به فهرست اجرای خودکار محیط کاری اضافه کنید. فایل `~/.config/autostart/happ.desktop` را با خطوط `[Desktop Entry]`، `Type=Application`، `Exec=/مسیر/کامل/Happ-x86_64.AppImage` و `X-GNOME-Autostart-enabled=true` بسازید. GNOME، KDE و بیشتر محیطها آن را در ورود بعدی میگیرند.
برای نصب .deb، میانبر اجرای خودکار را میتوان مستقیم در تنظیمات برنامه یا از طریق منوی اجرای خودکار محیط شما فعال کرد — مسیر فایل اجرایی بهصورت خودکار جایگذاری میشود. پس از ورود، Happ در سینی سیستم جمع میشود و از آیکون کنار ساعت در دسترس است.
اگر Linux را بدون پوسته گرافیکی اجرا میکنید، اجرا را بهصورت یک سرویس کاربری systemd بسازید: unit را در `~/.config/systemd/user/` قرار دهید، مسیر AppImage را در `ExecStart` مشخص کنید و اجرای خودکار را با دستور `systemctl --user enable --now happ.service` فعال نمایید.
بررسی اتصال و عیبیابی
پس از اتصال، مطمئن شوید که ترافیک از طریق سرور میرود: هر سرویس تشخیص IP را باز کنید — نشانی و کشور باید با موقعیت انتخابشده مطابقت داشته باشد. اگر IP بدون تغییر ماند، مطمئن شوید که proxy سیستمی روشن است و برنامه پورت محلی درست را میخواند.
در صورت قطعی یا کندی سرعت، سرور را در فهرست اشتراک عوض کنید — موقعیتهای همجوار اغلب مسیری پایدارتر میدهند. سپس اشتراک را بهروزرسانی کنید تا پارامترهای بهروز Xray را بگیرید و اتصال را دوباره راهاندازی نمایید. گاهی firewall محلی مانع میشود: به Happ اجازه اتصالهای خروجی را در ufw یا firewalld بدهید.
اگر پس از بهروزرسانی کلاینت فهرست سرورها بارگذاری نشد، اعتبار کلید را در ربات Telegram و درستی لینک اشتراک را بررسی کنید. لاگهای اتصال در خود برنامه در دسترساند و کمک میکنند مشکل کلید را از مسدودسازی شبکه تشخیص دهید.
آماده اتصال هستید؟
کلید Happ VPN را در ربات Telegram دریافت کنید: ۳ روز رایگان، بدون کارت.
دریافت کلیدسؤالات متداول
چگونه Happ را روی Linux نصب کنم؟
آخرین نسخه را از بخش Releases مخزن Happ-proxy در GitHub دانلود کنید: AppImage برای هر توزیعی یا .deb برای Debian و Ubuntu. برای AppImage با دستور chmod +x آن را اجرایی کنید و اجرا نمایید، و .deb را با sudo apt install ./file.deb نصب کنید. سپس لینک اشتراک را از ربات Telegram اضافه کنید.
کلید و اشتراک برای Linux را از کجا بگیرم؟
کلید و لینک اشتراک را ربات Telegram سرویس صادر میکند — آنجا دسترسی آزمایشی، پرداختشده یا رسمی فعال میشود. لینک شامل فهرست سرورها و پارامترهای Xray است و باید یک بار در برنامه وارد شود. کلید برای همه دستگاهها یکسان است، بنابراین اشتراک Linux با Windows و کلاینتهای موبایل مشترک است.
AppImage اجرا نمیشود — چه کنم؟
بیشتر اوقات کتابخانه FUSE موجود نیست: آن را با دستور sudo apt install libfuse2 یا معادلش برای توزیع خود نصب کنید. بهعنوان راهحل جایگزین، ایمیج را با ./Happ-x86_64.AppImage --appimage-extract استخراج کرده و ./squashfs-root/AppRun را اجرا کنید. همچنین مطمئن شوید که فایل با chmod +x پرچم اجرا گرفته است.
چگونه اجرای خودکار Happ را در Linux تنظیم کنم؟
فایل ~/.config/autostart/happ.desktop را با یک ورودی Desktop Entry و مسیر AppImage در خط Exec بسازید — GNOME و KDE هنگام ورود آن را میگیرند. برای سرورهای بدون گرافیک، یک سرویس کاربری systemd در ~/.config/systemd/user/ بسازید و آن را با دستور systemctl --user enable --now happ.service فعال کنید.
چگونه فقط یک browser را از طریق Happ هدایت کنم؟
proxy محلی را در تنظیمات برنامه فعال کنید و نشانی 127.0.0.1 با پورت تعیینشده را به خاطر بسپارید. این proxy را در تنظیمات آن browser مشخص یا در متغیر محیطی https_proxy تعریف کنید — آنگاه فقط همان از تونل عبور میکند و بقیه ترافیک مستقیم میماند. برای مسیریابی بر اساس دامنه از split tunneling استفاده کنید.
اتصال برقرار است اما IP تغییر نمیکند — چرا؟
بررسی کنید که proxy سیستمی فعال باشد و برنامه به پورت محلی درست گوش دهد. سرور را در فهرست اشتراک عوض کرده و آن را بهروزرسانی کنید تا پارامترهای بهروز دریافت شود. اگر firewall محلی مانع میشود، به Happ اجازه اتصالهای خروجی را در ufw یا firewalld بدهید، سپس اتصال را دوباره راهاندازی کنید.