بهینهساز رایگان تصویر، وبسرویس REST و افزونهٔ وردپرس برای سبکتر کردن تصاویر وب
این مخزن فقط شامل بخش فرانتاند سایت seraf.ir است.
معرفی • امکانات • پیشنمایش • نحوهٔ کار • ساختار • API • وردپرس • پالت رنگی • اجرا
سراف سرویسی برای بهینهسازی تصاویر است. حجم عکسها را بدون افت محسوس کیفیت کم میکند، ابعادشان را مناسب وب میکند و آنها را به فرمتهای مدرن WebP و AVIF تبدیل میکند. همهٔ پردازشها روی سرورهای سراف انجام میشود.
سه راه برای استفاده وجود دارد:
| راه | برای چه کسی | هزینه |
|---|---|---|
| 🖼️ بهینهساز آنلاین صفحهٔ اصلی | همه، بدون ثبتنام — تا ۱۰ تصویر در هر نوبت | رایگان |
| ⚡ وبسرویس REST | برنامهنویسها؛ اتصال به هر سایت و هر زبان برنامهنویسی | از کیف پول یا پلن |
| 🧩 افزونهٔ وردپرس | صاحبان سایتهای وردپرسی؛ بهینهسازی خودکار کل کتابخانهٔ رسانه | از کیف پول یا پلن |
کاربر با شماره موبایل (کد پیامکی) یا نام کاربری و رمز ثبتنام میکند، کیف پولش را با درگاه بانکی شارژ میکند یا پلن ماهانه میخرد، یک توکن (کلید API) میسازد و با همان توکن از وبسرویس یا افزونه استفاده میکند.
|
|
|
|
پیشنمایش قبل/بعد با حجم و کیفیت |
امکانات سرویس |
معرفی API با نمونهکد |
تعرفههای زنده |
نمای موبایل
flowchart LR
A["🖼️ انتخاب یا رها کردن<br/>تا ۱۰ تصویر"] --> B["📤 ارسال یکییکی<br/>POST /api/v1/guest/optimize"]
B --> C["⚙️ پردازش روی سرور سراف<br/>Imagick"]
C --> D["📥 بازگشت فایل بهینه<br/>+ آمار در هدرها"]
D --> E["👁️ پیشنمایش قبل/بعد"]
E --> F["📦 دانلود تکی یا ZIP"]
C -. "حذف فوری فایلها" .-> G["🗑️"]
style A fill:#1a1240,stroke:#a855f7,color:#eef0fb
style B fill:#1a1240,stroke:#ff3d7f,color:#eef0fb
style C fill:#0d0f1c,stroke:#22d3ee,color:#eef0fb
style D fill:#1a1240,stroke:#ff3d7f,color:#eef0fb
style E fill:#1a1240,stroke:#a855f7,color:#eef0fb
style F fill:#0d2b22,stroke:#34d399,color:#eef0fb
style G fill:#07080f,stroke:#9aa1bd,color:#eef0fb
sequenceDiagram
autonumber
participant U as 👤 کاربر
participant P as 🧭 پنل سراف
participant W as 🧩 سایت کاربر / افزونه
participant S as ⚙️ سرور سراف
U->>P: ورود با موبایل یا رمز
U->>P: شارژ کیف پول / خرید پلن
U->>P: ساخت توکن (کلید API)
U->>W: وارد کردن توکن در افزونه یا کد
loop هر تصویر، یکییکی
W->>S: POST /api/v1/optimize (Bearer token)
S->>S: بررسی توکن، سهمیه و نرخ
S->>S: فشردهسازی / تبدیل
S-->>W: فایل بهینهشده (binary)
S->>S: حذف فوری فایلها از سرور
end
[!IMPORTANT] افزونهٔ وردپرس هیچ موتور فشردهسازیای ندارد. هر تصویر با توکن کاربر به سرور سراف فرستاده و همانجا پردازش میشود، و نتیجه به سایت کاربر برمیگردد. بدون توکن معتبر و اعتبار کافی هیچ پردازشی انجام نمیشود.
seraf.ir/
├── index.html ← صفحهٔ اصلی (لندینگ + بهینهساز گروهی)
├── static/
│ ├── home.css ← استایل صفحهٔ اصلی (تم تیره، RTL، واکنشگرا)
│ └── home.js ← ترجمه، تعرفهها، صف پردازش، پیشنمایش، سازندهٔ ZIP
├── panel/assets/
│ ├── app.css ← استایل پنل کاربری و مدیریت (روشن/تیره، RTL)
│ └── app.js ← تعاملهای پنل (کپی، تأیید، ورودی مبلغ، شمارش معکوس)
├── serviceworker.js ← پاککنندهٔ کش قدیمی تا همه صفحهٔ جدید را ببینند
├── .htaccess ← تغییر مسیر /editor و هدرهای کش (LiteSpeed/Apache)
└── docs/
├── API.txt ← مستندات کامل API (متنی)
├── api.html ← مستندات کامل API (گرافیکی)
└── screenshots/ ← تصاویر README
[!NOTE] بکاند (PHP، پایگاه داده، کیف پول، درگاه پرداخت، پیامک و قالبهای پنل) در این مخزن نیست. فایلهای این مخزن روی هاست در ریشهٔ
public_htmlقرار میگیرند و با مسیرهای/api/v1/*و/panel/*همان دامنه با بکاند ارتباط دارند.
| بخش | توضیح |
|---|---|
| صف پردازش | تصاویر بهمحض اضافه شدن در صف قرار میگیرند و یکییکی ارسال میشوند. تصویری که در پیشنمایش است همیشه اولویت دارد. |
| تلاش دوباره | در پاسخ 503 server_busy به اندازهٔ Retry-After صبر و دوباره ارسال میکند؛ قطعی شبکه هم تا سه بار تکرار میشود. |
| تنظیمات زنده | تغییر کیفیت، فرمت یا عرض (با تأخیر کوتاه برای کاهش درخواستها) تصویر فعلی را فوراً دوباره بهینه میکند. |
| سازندهٔ ZIP | یک نویسندهٔ ZIP کمحجم با CRC32، بدون کتابخانهٔ خارجی؛ چون تصاویر از قبل فشردهاند، در حالت Store ذخیره میشوند. |
| دوزبانه | ویژگی data-i18n روی عناصر، دیکشنری فارسی و تغییر dir؛ زبان در کوکی seraf_lang ذخیره و با پنل هماهنگ میشود. |
| حالت ورود | با GET /panel/me بررسی میکند کاربر وارد شده یا نه و دکمهٔ «ورود» را به «پنل کاربری» تبدیل میکند. |
|
آدرس پایه:
|
curl -X POST https://seraf.ir/api/v1/optimize \
-H "Authorization: Bearer $SERAF_KEY" \
-F "image=@photo.jpg" -F "format=webp" -F "quality=80"{
"ok": true,
"data": {
"status": "ok",
"input": { "format": "jpeg", "bytes": 482113 },
"output": { "format": "webp", "bytes": 98314, "width": 1600, "height": 1067 },
"saved_percent": 79.61,
"charged": 50,
"download_url": "https://seraf.ir/api/v1/download/…"
}
}📘 مستندات کامل: docs/api.html (گرافیکی) · docs/API.txt (متنی)
شامل همهٔ پارامترها، کدهای خطا، محدودیتها و نمونهکد cURL، PHP، Node.js و Python.
- در پنل سراف وارد شوید و افزونه را از بخش «افزونه وردپرس» دانلود کنید.
- در وردپرس از مسیر «افزونهها ← افزودن ← بارگذاری افزونه» آن را نصب و فعال کنید.
- در پنل سراف یک کلید API بسازید.
- در وردپرس به «رسانه ← بهینهساز سراف ← تنظیمات» بروید و کلید را وارد کنید.
- تصاویر جدید خودکار بهینه میشوند؛ کتابخانهٔ فعلی را با «بهینهسازی گروهی» پردازش کنید.
| ویژگی | توضیح |
|---|---|
| ⏱ پردازش آرام | یکییکی با مکث قابل تنظیم؛ هاست تحت فشار قرار نمیگیرد |
| 🔁 ادامهپذیر | تصاویر انجامشده هرگز دوباره هزینه ندارند |
| 💾 پشتیبان | نسخهٔ اصلی نگه داشته میشود و با یک کلیک برمیگردد |
| 🌐 WebP | ساخت نسخهٔ WebP و نمایش خودکار آن روی Apache و LiteSpeed |
| 👛 موجودی زنده | نمایش موجودی، سهمیه و میزان صرفهجویی در پیشخوان وردپرس |
| نقش | رنگ | متغیر CSS |
|---|---|---|
| پسزمینه |  #07080F |
--bg |
| سطح |  #0D0F1C |
--bg-2 |
| صورتی (اصلی) |  #FF3D7F |
--pink |
| بنفش |  #A855F7 |
گرادیان |
| فیروزهای |  #22D3EE |
--cyan |
| موفقیت |  #34D399 |
--green |
| متن |  #EEF0FB |
--text |
| متن کمرنگ |  #9AA1BD |
--muted |
گرادیان اصلی: linear-gradient(120deg, #ff3d7f 0%, #a855f7 50%, #22d3ee 100%)
صفحهٔ اصلی کاملاً ایستا است و با هر وبسرور سادهای اجرا میشود:
npx serve .یا:
python -m http.server 8080[!TIP] بهینهساز، تعرفهها و وضعیت ورود از مسیرهای
/api/v1/*و/panel/*همان دامنه استفاده میکنند. برای کارکرد کامل در محیط محلی، این دو مسیر را با یک پراکسی بهhttps://seraf.irهدایت کنید، یا فایلها را روی هاستی بگذارید که بکاند سراف روی آن نصب است.
| فایل مخزن | مسیر روی هاست |
|---|---|
index.html، serviceworker.js، .htaccess |
public_html/ |
static/ |
public_html/static/ |
panel/assets/ |
public_html/panel/assets/ |
- بهینهساز رایگان و حالت
binaryهیچ فایلی روی سرور نگه نمیدارند. - لینکهای دانلود حالت JSON یکبارمصرف هستند و حداکثر ۱۰ دقیقه اعتبار دارند.
- برای گزارش مصرف فقط نام فایل، حجم، فرمت و زمان ثبت میشود.
seraf.ir · پنل کاربری · مستندات API · ویرایشگر پیشرفته
ساختهشده با ❤️ برای وب سریعتر