Hoppscotch: بديل Postman مفتوح المصدر تشغّله على سيرفرك

الفريق كله بيختبر نفس الـ API، بس كل واحد عنده collection على جهازه، والـ tokens بتتبعت لبعض على الشات؟ لو ده شكل الشغل عندكم، فالمقال ده ليك. النهارده في سلسلة «Open Source» (الجزء ٢٦) هنتكلم عن Hoppscotch.

يعني إيه Hoppscotch؟

Hoppscotch منصة open source لتطوير واختبار الـ APIs، برخصة MIT، وآخر إصدار ليها 2026.9.0 نزل يوم 30 سبتمبر 2026، والمشروع لسه شغال ومش archived. الـ README بتاعها بيقدّمها كبديل لـ Postman و Insomnia، والميزة الكبيرة إنك تقدر تشغّل نسخة Community Edition على السيرفر بتاعك.

فيها إيه؟

• البروتوكولات: REST و GraphQL، وكمان WebSocket و Server-Sent Events و Socket.IO و MQTT
• التنظيم: Collections وفولدرات، و import من cURL، و code snippets لأكتر من 10 لغات
• الأتمتة: Pre-request scripts بـ JavaScript و environment variables
• الفرق: Teams و workspaces و role-based access
• الـ Auth: Basic و Bearer و OAuth 2.0 و OIDC/PKCE

تشغيلها self-hosted

الخطوات دي من الـ docs الرسمية لنسخة الـ Community Edition:

1. محتاج PostgreSQL شغال، وملف .env فيه DATABASE_URL و DATA_ENCRYPTION_KEY (لازم يكون 32 حرف) والـ URLs بتاعة التطبيق.
2. أسهل طريقة هي الـ AIO container (كل حاجة في container واحد):

docker pull hoppscotch/hoppscotch
docker run -p 3000:3000 -p 3100:3100 -p 3170:3170 --env-file .env --restart unless-stopped hoppscotch/hoppscotch

3. أول مرة، شغّل الـ migrations جوه الكونتينر:

pnpm exec prisma migrate deploy

4. افتح لوحة الأدمن على بورت 3100 وكمّل الإعداد، والتطبيق نفسه على بورت 3000.

خلي بالك

• القيم في ملف الـ .env تتكتب من غير علامات تنصيص، والـ docs بتنبّه على ده.
• لو هتشغّل الكونتينر كـ non-root، استخدم HOPP_ALTERNATE_PORT، لأن البورت 80 جوه الكونتينر محتاج صلاحيات root.
• الـ SSO مذكور في الـ README كميزة في نسخة الـ Enterprise، مش في الـ Community Edition، فحط ده في حسابك لو الشركة عندكم معتمدة على SSO.

رأيي

الـ collections بتاعة أي فريق غالبًا فيها tokens و secrets و URLs داخلية. وجود الحاجات دي على سيرفر انتو متحكمين فيه، بصلاحيات واضحة لكل واحد، أهون بكتير من إنها تلف على أجهزة الناس وعلى الشات. Hoppscotch مش هتحل مشكلة إدارة الـ secrets لوحدها، بس هتخلي الشغل المشترك على الـ APIs في مكان واحد معروف.

وانتو، بتستخدموا إيه لاختبار الـ APIs في الفريق؟

المصادر

• Hoppscotch على GitHub
• Docs: Install and build Community Edition