📦 Paqet Client Runner

## 🇮🇷 توضیحات (فارسی)

این پروژه یک برنامه‌ی اجرایی است که به‌صورت خودکار ابزار Paqet را برای کلاینت اجرا و مدیریت می‌کند.

فایل اجرایی این برنامه با نام:

• paqet_client (در لینوکس)
• Paqet.Client.exe (در ویندوز)

در بخش Release این مخزن قرار داده می‌شود و کاربران تنها کافی است آن را دانلود کنند.

---

📥 نحوه دریافت فایل‌ها

1️⃣ دانلود فایل اجرایی

• از بخش Releases همین مخزن
• متناسب با سیستم‌عامل خود (Windows / Linux)

2️⃣ دانلود فایل اجرایی paqet

کاربران باید فایل اجرایی paqet متناسب با سیستم‌عامل خود را از مخزن اصلی دریافت کنند:

🔗 https://github.com/hanselime/paqet

پس از دانلود:

• فایل اجرایی paqet_linux_amd64 یا paqet_windows_amd64.exe
• باید در همان پوشه‌یpacket_client یا Paqet.Client.exe کپی شود

📁 ساختار پوشه:

Paqet.Client/
├─ paqet_client        (یا Paqet.Client.exe)
├─ paqet_linux_amd64   (یا paqet_windows_amd64.exe)
├─ config.yaml         (اختیاری)

---

⚙️ پیش‌نیازها

• سیستم‌عامل Windows یا Linux
• دسترسی اجرای فایل‌ها
• باز بودن پورت‌های مورد نیاز (پیش‌فرض 9999 و 1080)

این پروژه خودِ Paqet را شامل نمی‌شود و وابسته به آن است.

---

🛠️ فایل تنظیمات (config.yaml)

نمونه فایل:

interface: "eth0"            #نام کارت شبکه متصل به اینترنت
remoteIp: "192.168.1.10"     # آی‌پی سرور
remotePort: 9999             # پورت سرور (پیش‌فرض: 9999)
proxyPort: 1080              # پورت پراکسی داخلی (پیش‌فرض: 1080)
shareProxy: false            # اشتراک‌گذاری پراکسی در شبکه
encryptionKey: "my-secret"   # کلید رمزنگاری ارتباط

توضیح تنظیمات

کلید	توضیح
interface	نام کارت شبکه
remoteIp	آدرس IP سرور
remotePort	پورت سرور
proxyPort	پورت پراکسی محلی
shareProxy	اشتراک پراکسی در شبکه
encryptionKey	کلید رمزنگاری (مطابق با سرور)

---

▶️ نحوه اجرا

ویندوز

Paqet.Client.exe

لینوکس

chmod +x paqet_client
./paqet_client

در صورت نبود فایل `config.yaml`، برنامه اطلاعات را هنگام اجرا از کاربر دریافت می‌کند.

---

🔐 نکات امنیتی

• از کلید رمزنگاری قوی استفاده کنید
• در صورت فعال‌سازی shareProxy، به امنیت شبکه توجه کنید
• فایل تنظیمات را در اختیار افراد غیرمجاز قرار ندهید

---

---

🇬🇧 Description (English)

This project is a client-side runner that automatically executes and manages Paqet for end users.

The executable file is named:

• paqet_client (Linux)
• Paqet.Client.exe (Windows)

It is provided in the Releases section of this repository.

---

📥 Download Instructions

1️⃣ Download Application

• From the Releases section of this repository
• Choose the correct version for your OS (Windows / Linux)

2️⃣ Download paqet executable

Users must download the paqet executable matching their OS from the official repository:

🔗 https://github.com/hanselime/paqet

After downloading:

• Copy paqet_linux_amd64 or paqet_windows_amd64.exe
• Into the same directory as paqet_client Paqet.Client

📁 Directory structure:

Paqet.Client/
├─ paqet_client        (or Paqet.Client.exe)
├─ paqet_linux_amd64   (or paqet_windows_amd64.exe)
├─ config.yaml         (optional)

---

⚙️ Requirements

• Windows or Linux
• Execution permissions
• Required ports open (default: 9999, 1080)

This project does NOT include Paqet itself and depends on it.

---

🛠️ Configuration file (config.yaml)

Example:

interface: "eth0"
remoteIp: "192.168.1.10"
remotePort: 9999
proxyPort: 1080
shareProxy: false
encryptionKey: "my-secret"

Configuration options

Key	Description
interface	Network Interface Name
remoteIp	Paqet server IP
remotePort	Server port
proxyPort	Local proxy port
shareProxy	Share proxy on the network
encryptionKey	Encryption key (Same with server)

---

▶️ How to Run

Windows

Paqet.Client.exe

Linux

chmod +x paqet_Client
./paqet_client

If config.yaml is not present, the application will prompt the user for input.

---

🔐 Security Notes

• Use strong encryption keys
• Be cautious when enabling proxy sharing
• Protect your configuration file