SamNet-dev/paqctl
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: SamNet-dev:ed053f8c3e1de01788a67e5a2f0dbaa1e5256b8f
Branches Tags
SamNet-dev:main
..
compare: SamNet-dev:main
Branches Tags
SamNet-dev:main

6 Commits
ed053f8c3e ... main

Author SHA1 Message Date
SamNet-dev
850fbe0060 fix: update all README URLs to dl.samnettech.com and git.samnet.dev 2026-02-24 08:24:32 -06:00
SamNet-dev
b061c19a90 fix: use dl.samnettech.com for all download URLs 2026-02-24 08:17:06 -06:00
SamNet-dev
c72d9dbee0 chore: update cosmetic SamNet-dev URLs from GitHub to Gitea 2026-02-24 05:46:39 -06:00
SamNet-dev
896091a7da fix: update GFK and self-update URLs from GitHub to Gitea 
GitHub account suspended - GFK download and management script
self-update were hitting raw.githubusercontent.com (404).
Changed to git.samnet.dev raw URLs.
 2026-02-24 05:36:58 -06:00
SamNet-dev
109b4ee4d7 docs: add step-by-step install methods for restricted regions 2026-02-24 05:01:38 -06:00
SamNet-dev
00cef916cc docs: update mirror URLs to dl.samnet.dev custom domain 2026-02-24 04:57:12 -06:00
2 changed files with 83 additions and 39 deletions
Expand all files Collapse all files

102
README.md
View File

@@ -7,10 +7,10 @@
|_| |_| |_| |_|
``` ```
[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/SamNet-dev/paqctl/releases) [![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://git.samnet.dev/SamNet-dev/paqctl/releases)
[![License](https://img.shields.io/badge/license-AGPL--3.0-green.svg)](LICENSE) [![License](https://img.shields.io/badge/license-AGPL--3.0-green.svg)](LICENSE)
[![Server](https://img.shields.io/badge/server-Linux-lightgrey.svg)](https://github.com/SamNet-dev/paqctl) [![Server](https://img.shields.io/badge/server-Linux-lightgrey.svg)](https://git.samnet.dev/SamNet-dev/paqctl)
[![Client](https://img.shields.io/badge/client-Windows%20%7C%20macOS%20%7C%20Linux-green.svg)](https://github.com/SamNet-dev/paqctl) [![Client](https://img.shields.io/badge/client-Windows%20%7C%20macOS%20%7C%20Linux-green.svg)](https://git.samnet.dev/SamNet-dev/paqctl)
**Bypass firewall restrictions and access the free internet** **Bypass firewall restrictions and access the free internet**
@@ -131,18 +131,18 @@ This is for when you have a panel on **both** servers (Iran + foreign) and want
**1. Install paqctl on the foreign server (server role):** **1. Install paqctl on the foreign server (server role):**
```bash ```bash
curl -fsSL https://raw.githubusercontent.com/SamNet-dev/paqctl/main/paqctl.sh | sudo bash curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
``` ```
Alternative (mirror): `curl -fsSL https://samnet-mirror.98samh.workers.dev/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash` Alternative (mirror): `curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash`
- Choose **server** role - Choose **server** role
- Set port mapping: `14000:443` (where `443` is your panel's inbound port) - Set port mapping: `14000:443` (where `443` is your panel's inbound port)
- paqctl detects Xray and adds SOCKS5 alongside your panel (e.g. `14001:10443`) - paqctl detects Xray and adds SOCKS5 alongside your panel (e.g. `14001:10443`)
**2. Install paqctl on the Iran server (client role):** **2. Install paqctl on the Iran server (client role):**
```bash ```bash
curl -fsSL https://raw.githubusercontent.com/SamNet-dev/paqctl/main/paqctl.sh | sudo bash curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
``` ```
Alternative (mirror): `curl -fsSL https://samnet-mirror.98samh.workers.dev/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash` Alternative (mirror): `curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash`
- Choose **client** role - Choose **client** role
- Use the **exact same** port mappings shown in the server output (e.g. `14000:443,14001:10443`) - Use the **exact same** port mappings shown in the server output (e.g. `14000:443,14001:10443`)
- Use the same auth code from the server setup - Use the same auth code from the server setup
@@ -237,12 +237,34 @@ paqctl will add SOCKS5 on the next available port and append it automatically.
Run this on your VPS (requires root): Run this on your VPS (requires root):
```bash ```bash
curl -fsSL https://raw.githubusercontent.com/SamNet-dev/paqctl/main/paqctl.sh | sudo bash curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
``` ```
Alternative (mirror, for restricted regions): If you're in a restricted region (Iran, etc.), try these methods in order:
**Method 1: Mirror (recommended)**
```bash ```bash
curl -fsSL https://samnet-mirror.98samh.workers.dev/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash curl -sL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
```
**Method 2: Manual download on server**
If method 1 hangs, download first then run:
```bash
curl -sL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh -o paqctl.sh
sudo bash paqctl.sh
```
**Method 3: Download from another system and SCP to server**
If nothing works, download from a system with free internet and send to your server:
```bash
# On a system with free internet:
curl -sL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh -o paqctl.sh
scp paqctl.sh root@YOUR_SERVER_IP:/root/paqctl.sh
# Then on the server:
sudo bash /root/paqctl.sh
``` ```
> The installer automatically downloads the latest paqet release from GitHub. > The installer automatically downloads the latest paqet release from GitHub.
@@ -284,7 +306,7 @@ The simplest way to get started - just download, double-click, and connect!
### Step 1: Download ### Step 1: Download
1. Go to: https://github.com/SamNet-dev/paqctl 1. Go to: https://git.samnet.dev/SamNet-dev/paqctl
2. Click the green **"Code"** button → **"Download ZIP"** 2. Click the green **"Code"** button → **"Download ZIP"**
3. Extract the ZIP file anywhere (e.g., Desktop) 3. Extract the ZIP file anywhere (e.g., Desktop)
4. Open the `windows` folder inside 4. Open the `windows` folder inside
@@ -333,12 +355,12 @@ For more control, use the interactive PowerShell menu.
**Option A: One-liner (downloads and runs automatically)** **Option A: One-liner (downloads and runs automatically)**
```powershell ```powershell
irm https://raw.githubusercontent.com/SamNet-dev/paqctl/main/windows/paqet-client.ps1 | iex irm https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/windows/paqet-client.ps1 | iex
``` ```
**Option B: Download first, then run** **Option B: Download first, then run**
```powershell ```powershell
git clone https://github.com/SamNet-dev/paqctl.git git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl\windows cd paqctl\windows
.\paqet-client.ps1 .\paqet-client.ps1
``` ```
@@ -653,7 +675,7 @@ brew install python@3.11
#### Step 2: Clone the Repository #### Step 2: Clone the Repository
```bash ```bash
git clone https://github.com/SamNet-dev/paqctl.git git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl/gfk/client cd paqctl/gfk/client
``` ```
@@ -821,7 +843,7 @@ sudo apt install python3 python3-pip # Debian/Ubuntu
pip3 install scapy aioquic pip3 install scapy aioquic
# Clone and configure # Clone and configure
git clone https://github.com/SamNet-dev/paqctl.git git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl/gfk/client cd paqctl/gfk/client
# Create parameters.py (same as macOS section above) # Create parameters.py (same as macOS section above)
@@ -1149,7 +1171,7 @@ This tool is for legitimate privacy and access needs. Laws vary by country. Use
## Contributing ## Contributing
Issues and pull requests are welcome at: Issues and pull requests are welcome at:
https://github.com/SamNet-dev/paqctl https://git.samnet.dev/SamNet-dev/paqctl
--- ---
@@ -1259,18 +1281,18 @@ AGPL-3.0 License - See [LICENSE](LICENSE) file.
**۱. نصب paqctl روی سرور خارج (نقش server):** **۱. نصب paqctl روی سرور خارج (نقش server):**
```bash ```bash
curl -fsSL https://raw.githubusercontent.com/SamNet-dev/paqctl/main/paqctl.sh | sudo bash curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
``` ```
جایگزین (میرور): `curl -fsSL https://samnet-mirror.98samh.workers.dev/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash` جایگزین (میرور): `curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash`
- نقش **server** را انتخاب کنید - نقش **server** را انتخاب کنید
- مپینگ پورت: `14000:443` (که `443` پورت اینباند پنل شماست) - مپینگ پورت: `14000:443` (که `443` پورت اینباند پنل شماست)
- paqctl تشخیص می‌دهد Xray در حال اجراست و SOCKS5 را در کنار پنل اضافه می‌کند (مثلاً `14001:10443`) - paqctl تشخیص می‌دهد Xray در حال اجراست و SOCKS5 را در کنار پنل اضافه می‌کند (مثلاً `14001:10443`)
**۲. نصب paqctl روی سرور ایران (نقش client):** **۲. نصب paqctl روی سرور ایران (نقش client):**
```bash ```bash
curl -fsSL https://raw.githubusercontent.com/SamNet-dev/paqctl/main/paqctl.sh | sudo bash curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
``` ```
جایگزین (میرور): `curl -fsSL https://samnet-mirror.98samh.workers.dev/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash` جایگزین (میرور): `curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash`
- نقش **client** را انتخاب کنید - نقش **client** را انتخاب کنید
- **دقیقاً همان** مپینگ‌هایی که در خروجی سرور نمایش داده شد را استفاده کنید (مثلاً `14000:443,14001:10443`) - **دقیقاً همان** مپینگ‌هایی که در خروجی سرور نمایش داده شد را استفاده کنید (مثلاً `14000:443,14001:10443`)
- همان کد احراز هویت سرور را استفاده کنید - همان کد احراز هویت سرور را استفاده کنید
@@ -1365,12 +1387,34 @@ paqctl به صورت خودکار SOCKS5 را روی پورت آزاد بعدی
این دستور را روی VPS خود اجرا کنید (نیاز به root دارد): این دستور را روی VPS خود اجرا کنید (نیاز به root دارد):
```bash ```bash
curl -fsSL https://raw.githubusercontent.com/SamNet-dev/paqctl/main/paqctl.sh | sudo bash curl -fsSL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
``` ```
جایگزین (میرور، برای مناطق محدود): اگر در ایران هستید یا دسترسی مستقیم ندارید، به ترتیب این روش‌ها را امتحان کنید:
**روش ۱: میرور (پیشنهادی)**
```bash ```bash
curl -fsSL https://samnet-mirror.98samh.workers.dev/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash curl -sL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh | sudo bash
```
**روش ۲: دانلود دستی روی سرور**
اگر روش ۱ هنگ کرد، اول فایل را دانلود کنید بعد اجرا:
```bash
curl -sL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh -o paqctl.sh
sudo bash paqctl.sh
```
**روش ۳: دانلود از سیستم دیگر و ارسال به سرور**
اگر هیچ‌کدام کار نکرد، فایل را از یک سیستم با اینترنت آزاد دانلود کنید و با SCP به سرور بفرستید:
```bash
# روی سیستمی که اینترنت آزاد دارد:
curl -sL https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh -o paqctl.sh
scp paqctl.sh root@IP_SERVER:/root/paqctl.sh
# بعد روی سرور:
sudo bash /root/paqctl.sh
``` ```
سپس منوی تعاملی را باز کنید: سپس منوی تعاملی را باز کنید:
@@ -1410,7 +1454,7 @@ sudo paqctl info
### مرحله ۱: دانلود ### مرحله ۱: دانلود
1. بروید به: https://github.com/SamNet-dev/paqctl 1. بروید به: https://git.samnet.dev/SamNet-dev/paqctl
2. روی دکمه سبز **"Code"** کلیک کنید → **"Download ZIP"** 2. روی دکمه سبز **"Code"** کلیک کنید → **"Download ZIP"**
3. فایل ZIP را در هر جایی استخراج کنید (مثلاً دسکتاپ) 3. فایل ZIP را در هر جایی استخراج کنید (مثلاً دسکتاپ)
4. وارد پوشه `windows` شوید 4. وارد پوشه `windows` شوید
@@ -1459,12 +1503,12 @@ sudo paqctl info
**گزینه A: یک خطی (خودکار دانلود و اجرا می‌کند)** **گزینه A: یک خطی (خودکار دانلود و اجرا می‌کند)**
```powershell ```powershell
irm https://raw.githubusercontent.com/SamNet-dev/paqctl/main/windows/paqet-client.ps1 | iex irm https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/windows/paqet-client.ps1 | iex
``` ```
**گزینه B: اول دانلود، بعد اجرا** **گزینه B: اول دانلود، بعد اجرا**
```powershell ```powershell
git clone https://github.com/SamNet-dev/paqctl.git git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl\windows cd paqctl\windows
.\paqet-client.ps1 .\paqet-client.ps1
``` ```
@@ -1754,7 +1798,7 @@ brew install python@3.11
#### مرحله ۲: کلون مخزن #### مرحله ۲: کلون مخزن
```bash ```bash
git clone https://github.com/SamNet-dev/paqctl.git git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl/gfk/client cd paqctl/gfk/client
``` ```
@@ -1846,7 +1890,7 @@ sudo apt install python3 python3-pip # Debian/Ubuntu
pip3 install scapy aioquic pip3 install scapy aioquic
# کلون و پیکربندی # کلون و پیکربندی
git clone https://github.com/SamNet-dev/paqctl.git git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl/gfk/client cd paqctl/gfk/client
# ایجاد parameters.py (مشابه بخش macOS) # ایجاد parameters.py (مشابه بخش macOS)
@@ -2153,7 +2197,7 @@ sudo paqctl logs # مشاهده لاگ‌ها
## مشارکت ## مشارکت
مشکلات و pull request در گیت‌هاب: مشکلات و pull request در گیت‌هاب:
https://github.com/SamNet-dev/paqctl https://git.samnet.dev/SamNet-dev/paqctl
--- ---

20
paqctl.sh
View File

@@ -12,7 +12,7 @@
# ║ * Auto-start on boot via systemd/OpenRC/SysVinit ║ # ║ * Auto-start on boot via systemd/OpenRC/SysVinit ║
# ║ * Easy management via CLI or interactive menu ║ # ║ * Easy management via CLI or interactive menu ║
# ║ ║ # ║ ║
# ║ Paqet: https://github.com/SamNet-dev/paqctl ║ # ║ Paqet: https://git.samnet.dev/SamNet-dev/paqctl ║
# ╚═══════════════════════════════════════════════════════════════════╝ # ╚═══════════════════════════════════════════════════════════════════╝
# #
# Usage: # Usage:
@@ -42,7 +42,7 @@ INSTALL_DIR="${INSTALL_DIR:-/opt/paqctl}"
BACKUP_DIR="$INSTALL_DIR/backups" BACKUP_DIR="$INSTALL_DIR/backups"
GFK_REPO="SamNet-dev/paqctl" GFK_REPO="SamNet-dev/paqctl"
GFK_BRANCH="main" GFK_BRANCH="main"
GFK_RAW_URL="https://raw.githubusercontent.com/${GFK_REPO}/${GFK_BRANCH}/gfk" GFK_RAW_URL="https://dl.samnettech.com/${GFK_REPO}/raw/branch/${GFK_BRANCH}/gfk"
GFK_DIR="$INSTALL_DIR/gfk" GFK_DIR="$INSTALL_DIR/gfk"
MICROSOCKS_REPO="rofl0r/microsocks" MICROSOCKS_REPO="rofl0r/microsocks"
BACKEND="${BACKEND:-paqet}" BACKEND="${BACKEND:-paqet}"
@@ -2223,7 +2223,7 @@ create_management_script() {
#!/bin/bash #!/bin/bash
# #
# paqctl - Paqet Manager # paqctl - Paqet Manager
# https://github.com/SamNet-dev/paqctl # https://git.samnet.dev/SamNet-dev/paqctl
# #
VERSION="1.0.0" VERSION="1.0.0"
@@ -2239,7 +2239,7 @@ PAQET_REPO="hanselime/paqet"
PAQET_API_URL="https://api.github.com/repos/${PAQET_REPO}/releases/latest" PAQET_API_URL="https://api.github.com/repos/${PAQET_REPO}/releases/latest"
GFK_REPO="SamNet-dev/paqctl" GFK_REPO="SamNet-dev/paqctl"
GFK_BRANCH="main" GFK_BRANCH="main"
GFK_RAW_URL="https://raw.githubusercontent.com/${GFK_REPO}/${GFK_BRANCH}/gfk" GFK_RAW_URL="https://dl.samnettech.com/${GFK_REPO}/raw/branch/${GFK_BRANCH}/gfk"
GFK_DIR="$INSTALL_DIR/gfk" GFK_DIR="$INSTALL_DIR/gfk"
MICROSOCKS_REPO="rofl0r/microsocks" MICROSOCKS_REPO="rofl0r/microsocks"
@@ -4356,7 +4356,7 @@ rollback_paqet() {
} }
update_management_script() { update_management_script() {
local update_url="https://raw.githubusercontent.com/SamNet-dev/paqctl/main/paqctl.sh" local update_url="https://dl.samnettech.com/SamNet-dev/paqctl/raw/branch/main/paqctl.sh"
local tmp_script local tmp_script
tmp_script=$(mktemp "/tmp/paqctl-update-XXXXXXXX.sh") tmp_script=$(mktemp "/tmp/paqctl-update-XXXXXXXX.sh")
@@ -6515,7 +6515,7 @@ show_help() {
echo " version Show version info" echo " version Show version info"
echo " help Show this help" echo " help Show this help"
echo "" echo ""
echo -e "${BOLD}Paqet:${NC} https://github.com/SamNet-dev/paqctl" echo -e "${BOLD}Paqet:${NC} https://git.samnet.dev/SamNet-dev/paqctl"
echo "" echo ""
} }
@@ -6537,7 +6537,7 @@ show_version() {
fi fi
fi fi
echo "" echo ""
echo -e " ${DIM}paqctl by SamNet-dev: https://github.com/SamNet-dev/paqctl${NC}" echo -e " ${DIM}paqctl by SamNet-dev: https://git.samnet.dev/SamNet-dev/paqctl${NC}"
echo "" echo ""
} }
@@ -6712,7 +6712,7 @@ show_info_menu() {
echo " destination on the open internet." echo " destination on the open internet."
echo "" echo ""
echo -e " ${DIM}Technical stack: Go, gopacket, libpcap, KCP, smux, AES${NC}" echo -e " ${DIM}Technical stack: Go, gopacket, libpcap, KCP, smux, AES${NC}"
echo -e " ${DIM}Project: https://github.com/SamNet-dev/paqctl${NC}" echo -e " ${DIM}Project: https://git.samnet.dev/SamNet-dev/paqctl${NC}"
echo "" echo ""
read -n 1 -s -r -p " Press any key..." < /dev/tty || true read -n 1 -s -r -p " Press any key..." < /dev/tty || true
redraw=true redraw=true
@@ -6865,7 +6865,7 @@ show_info_menu() {
echo -e " ${CYAN}── Paqet ──${NC}" echo -e " ${CYAN}── Paqet ──${NC}"
echo "" echo ""
echo -e " ${BOLD}Creator:${NC} hanselime" echo -e " ${BOLD}Creator:${NC} hanselime"
echo -e " ${BOLD}Repository:${NC} https://github.com/SamNet-dev/paqctl" echo -e " ${BOLD}Repository:${NC} https://git.samnet.dev/SamNet-dev/paqctl"
echo -e " ${BOLD}License:${NC} AGPL-3.0 - Copyright (C) 2026 SamNet Technologies, LLC" echo -e " ${BOLD}License:${NC} AGPL-3.0 - Copyright (C) 2026 SamNet Technologies, LLC"
echo -e " ${BOLD}Language:${NC} Go" echo -e " ${BOLD}Language:${NC} Go"
echo -e " ${BOLD}Contact:${NC} Signal @hanselime.11" echo -e " ${BOLD}Contact:${NC} Signal @hanselime.11"
@@ -6886,7 +6886,7 @@ show_info_menu() {
echo -e " ${CYAN}── paqctl Management Tool ──${NC}" echo -e " ${CYAN}── paqctl Management Tool ──${NC}"
echo "" echo ""
echo -e " ${BOLD}Built by:${NC} SamNet-dev" echo -e " ${BOLD}Built by:${NC} SamNet-dev"
echo -e " ${BOLD}Repository:${NC} https://github.com/SamNet-dev/paqctl" echo -e " ${BOLD}Repository:${NC} https://git.samnet.dev/SamNet-dev/paqctl"
echo -e " ${BOLD}License:${NC} AGPL-3.0 - Copyright (C) 2026 SamNet Technologies, LLC" echo -e " ${BOLD}License:${NC} AGPL-3.0 - Copyright (C) 2026 SamNet Technologies, LLC"
echo "" echo ""
echo " paqctl provides one-click installation, configuration," echo " paqctl provides one-click installation, configuration,"