Compare commits

..

7 Commits

Author SHA1 Message Date
SamNet-dev
f6f57ab7b5 docs: add notice to visit GitHub for latest updates and issues 2026-02-25 10:45:55 -06:00
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 87 additions and 39 deletions

106
README.md
View File

@@ -7,15 +7,17 @@
|_| |_|
```
[![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)
[![Server](https://img.shields.io/badge/server-Linux-lightgrey.svg)](https://github.com/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)
[![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://git.samnet.dev/SamNet-dev/paqctl)
**Bypass firewall restrictions and access the free internet**
[نسخه فارسی](#نسخه-فارسی)
> **Note:** Please visit the [GitHub repository](https://github.com/SamNet-dev/paqctl) for the latest updates. If you have an issue, please open an issue there.
---
## What is this?
@@ -131,18 +133,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):**
```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
- 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`)
**2. Install paqctl on the Iran server (client role):**
```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
- 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
@@ -237,12 +239,34 @@ paqctl will add SOCKS5 on the next available port and append it automatically.
Run this on your VPS (requires root):
```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
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.
@@ -284,7 +308,7 @@ The simplest way to get started - just download, double-click, and connect!
### 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"**
3. Extract the ZIP file anywhere (e.g., Desktop)
4. Open the `windows` folder inside
@@ -333,12 +357,12 @@ For more control, use the interactive PowerShell menu.
**Option A: One-liner (downloads and runs automatically)**
```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**
```powershell
git clone https://github.com/SamNet-dev/paqctl.git
git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl\windows
.\paqet-client.ps1
```
@@ -653,7 +677,7 @@ brew install python@3.11
#### Step 2: Clone the Repository
```bash
git clone https://github.com/SamNet-dev/paqctl.git
git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl/gfk/client
```
@@ -821,7 +845,7 @@ sudo apt install python3 python3-pip # Debian/Ubuntu
pip3 install scapy aioquic
# 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
# Create parameters.py (same as macOS section above)
@@ -1149,7 +1173,7 @@ This tool is for legitimate privacy and access needs. Laws vary by country. Use
## Contributing
Issues and pull requests are welcome at:
https://github.com/SamNet-dev/paqctl
https://git.samnet.dev/SamNet-dev/paqctl
---
@@ -1174,6 +1198,8 @@ AGPL-3.0 License - See [LICENSE](LICENSE) file.
# نسخه فارسی
> **توجه:** برای دریافت آخرین به‌روزرسانی‌ها به [مخزن گیتهاب](https://github.com/SamNet-dev/paqctl) مراجعه کنید. اگر مشکلی دارید، لطفاً در آنجا یک issue باز کنید.
## این چیست؟
پاکت‌کنترل یک ابزار مدیریت پروکسی برای دور زدن فایروال است. این ابزار به شما کمک می‌کند تا به سروری خارج از شبکه‌های محدود (مثل پشت فایروال بزرگ) متصل شوید و آزادانه به اینترنت دسترسی داشته باشید.
@@ -1259,18 +1285,18 @@ AGPL-3.0 License - See [LICENSE](LICENSE) file.
**۱. نصب paqctl روی سرور خارج (نقش server):**
```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** را انتخاب کنید
- مپینگ پورت: `14000:443` (که `443` پورت اینباند پنل شماست)
- paqctl تشخیص می‌دهد Xray در حال اجراست و SOCKS5 را در کنار پنل اضافه می‌کند (مثلاً `14001:10443`)
**۲. نصب paqctl روی سرور ایران (نقش client):**
```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** را انتخاب کنید
- **دقیقاً همان** مپینگ‌هایی که در خروجی سرور نمایش داده شد را استفاده کنید (مثلاً `14000:443,14001:10443`)
- همان کد احراز هویت سرور را استفاده کنید
@@ -1365,12 +1391,34 @@ paqctl به صورت خودکار SOCKS5 را روی پورت آزاد بعدی
این دستور را روی VPS خود اجرا کنید (نیاز به root دارد):
```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
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 +1458,7 @@ sudo paqctl info
### مرحله ۱: دانلود
1. بروید به: https://github.com/SamNet-dev/paqctl
1. بروید به: https://git.samnet.dev/SamNet-dev/paqctl
2. روی دکمه سبز **"Code"** کلیک کنید → **"Download ZIP"**
3. فایل ZIP را در هر جایی استخراج کنید (مثلاً دسکتاپ)
4. وارد پوشه `windows` شوید
@@ -1459,12 +1507,12 @@ sudo paqctl info
**گزینه A: یک خطی (خودکار دانلود و اجرا می‌کند)**
```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: اول دانلود، بعد اجرا**
```powershell
git clone https://github.com/SamNet-dev/paqctl.git
git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl\windows
.\paqet-client.ps1
```
@@ -1754,7 +1802,7 @@ brew install python@3.11
#### مرحله ۲: کلون مخزن
```bash
git clone https://github.com/SamNet-dev/paqctl.git
git clone https://git.samnet.dev/SamNet-dev/paqctl.git
cd paqctl/gfk/client
```
@@ -1846,7 +1894,7 @@ sudo apt install python3 python3-pip # Debian/Ubuntu
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
# ایجاد parameters.py (مشابه بخش macOS)
@@ -2153,7 +2201,7 @@ sudo paqctl logs # مشاهده لاگ‌ها
## مشارکت
مشکلات و pull request در گیت‌هاب:
https://github.com/SamNet-dev/paqctl
https://git.samnet.dev/SamNet-dev/paqctl
---

View File

@@ -12,7 +12,7 @@
# ║ * Auto-start on boot via systemd/OpenRC/SysVinit ║
# ║ * Easy management via CLI or interactive menu ║
# ║ ║
# ║ Paqet: https://github.com/SamNet-dev/paqctl ║
# ║ Paqet: https://git.samnet.dev/SamNet-dev/paqctl ║
# ╚═══════════════════════════════════════════════════════════════════╝
#
# Usage:
@@ -42,7 +42,7 @@ INSTALL_DIR="${INSTALL_DIR:-/opt/paqctl}"
BACKUP_DIR="$INSTALL_DIR/backups"
GFK_REPO="SamNet-dev/paqctl"
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"
MICROSOCKS_REPO="rofl0r/microsocks"
BACKEND="${BACKEND:-paqet}"
@@ -2223,7 +2223,7 @@ create_management_script() {
#!/bin/bash
#
# paqctl - Paqet Manager
# https://github.com/SamNet-dev/paqctl
# https://git.samnet.dev/SamNet-dev/paqctl
#
VERSION="1.0.0"
@@ -2239,7 +2239,7 @@ PAQET_REPO="hanselime/paqet"
PAQET_API_URL="https://api.github.com/repos/${PAQET_REPO}/releases/latest"
GFK_REPO="SamNet-dev/paqctl"
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"
MICROSOCKS_REPO="rofl0r/microsocks"
@@ -4356,7 +4356,7 @@ rollback_paqet() {
}
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
tmp_script=$(mktemp "/tmp/paqctl-update-XXXXXXXX.sh")
@@ -6515,7 +6515,7 @@ show_help() {
echo " version Show version info"
echo " help Show this help"
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 ""
}
@@ -6537,7 +6537,7 @@ show_version() {
fi
fi
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 ""
}
@@ -6712,7 +6712,7 @@ show_info_menu() {
echo " destination on the open internet."
echo ""
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 ""
read -n 1 -s -r -p " Press any key..." < /dev/tty || true
redraw=true
@@ -6865,7 +6865,7 @@ show_info_menu() {
echo -e " ${CYAN}── Paqet ──${NC}"
echo ""
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}Language:${NC} Go"
echo -e " ${BOLD}Contact:${NC} Signal @hanselime.11"
@@ -6886,7 +6886,7 @@ show_info_menu() {
echo -e " ${CYAN}── paqctl Management Tool ──${NC}"
echo ""
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 ""
echo " paqctl provides one-click installation, configuration,"