إطلاق مسار تحويل مستضاف ذاتيا

# إطلاق مسار تحويل مستضاف ذاتيا

انتقل بمسار تحويل من لا شيء إلى منشور على بنية تحتية يتحكم فيها المشغل، باستخدام [Autonnel](https://github.com/autonnel/autonnel) (Apache-2.0). هذه المهارة هي خطوة البناء؛ صمم مسار التحويل أولا باستخدام `sales-funnel-blueprint`، وتأكد من أن الاستضافة الذاتية هي الخيار الصحيح باستخدام `funnel-platform-picker` إذا كان ذلك لا يزال متاحا.

## الخطوة 1: اختر كيفية تشغيله

| المسار | التكلفة عند حجم منخفض | عبء العمليات | استخدمه ل | |---|---|---|---| | **Cloudflare Workers** | فعليا 0 دولار بالإضافة إلى Postgres | لا خوادم، لا ترقيع | **الافتراضي للإنتاج.** صفحات مسار التحويل هي في الغالب أصول ثابتة، يقدمها Workers مجانا وبدون قياس | | Docker | تكلفة خادم افتراضي خاص واحد (VPS) أو مضيف حاويات | خاصتك: ترقيات، نسخ احتياطية، وقت تشغيل | التقييم المحلي في دقيقتين، أو خادم تديره بالفعل وتريد البيانات عليه | | سحب المصدر (Node) | تكلفة خادم افتراضي خاص واحد (VPS) أو مضيف حاويات | خاصتك | تعديل Autonnel نفسه، أو تشغيل بناء Node مباشرة |

نوصي ب Workers ما لم يكن لدى المشغل سبب محدد لعدم استخدامه: نموذج التسعير يناسب مسارات التحويل بشكل شبه كامل، ويزيل فئة العمل بأكملها التي تجعل الناس يتجنبون الاستضافة الذاتية.

استخدم Docker للنظرة الأولى بغض النظر عن ذلك. إنها أسرع طريقة لرؤية المنتج، ولا شيء تبنيه محليا يضيع: نفس المخطط ونفس واجهة المستخدم الإدارية تدعم كلا المسارين.

## الخطوة 2أ: Cloudflare Workers (مسار الإنتاج شبه المجاني)

### لماذا التكلفة قريبة من الصفر

حركة مرور مسار التحويل هي في الغالب طلبات للصفحات والصور والبرامج النصية. على Workers، هذه هي طلبات الأصول الثابتة، وهي **مجانية وغير محدودة، وبدون تكلفة تخزين** - فقط الطلبات التي تستدعي Worker (الصفحات المعروضة من الخادم، الدفع، API) يتم محاسبتها. السطح الديناميكي لمسار التحويل صغير: نموذج الطلب، قبول البيع الإضافي، قائمة الانتظار بعد النشر.

حدود خطة Cloudflare المجانية المعتمدة (تم التحقق منها في 2026-08؛ تأكد من الأرقام الحالية قبل الاعتماد عليها):

| المورد | خطة Workers المجانية | |---|---| | طلبات الأصول الثابتة | مجانية وغير محدودة، لا توجد رسوم تخزين | | استدعاءات Worker | 100,000 طلب/يوم | | Hyperdrive (تجميع Postgres) | متاح في الخطة المجانية، 100,000 استعلام قاعدة بيانات/يوم | | Workers KV (ذاكرة تخزين مؤقت للصفحات) | 100,000 قراءة/يوم، **1,000 كتابة/يوم**، 1 جيجابايت تخزين | | Cron Triggers | مدعومة (المستودع يشحن معالج `scheduled`) |

**ما هو غير مجاني**: Postgres. يقوم Hyperdrive بتجميع الاتصالات بقاعدة بيانات توفرها أنت، لذلك لا يزال يتعين عليك توفير مزود Postgres. لدى المزودين المدارين طبقاتهم المجانية الخاصة بهم بحدودهم الخاصة، وهذا هو البند الوحيد الذي يجب التخطيط له.

**أول سقف ستصل إليه فعليا هو كتابات KV، وليس الطلبات.** 1,000 كتابة/يوم سخية لخدمة الصفحات وقليلة لنشرها، لأن النشر يبطل وينعش الإدخالات المخزنة مؤقتا. يمكن أن يستهلك يوم من التحرير المكثف هذا الحد بينما حركة المرور بعيدة كل البعد عن أي حد. إذا بدأ النشر بالفشل قبل حركة المرور، فهذا هو هذا الحد، وليس خطأ.

### النشر

يحتوي المستودع على مجموعة أدوات Workers بأكملها: مدخل Worker مع معالج `scheduled` ل cron (`src/cf-worker.ts`)، إنشاء `wrangler.toml`، توصيل ذاكرة التخزين المؤقت KV و Hyperdrive ل Postgres.

```bash npx wrangler login npx wrangler kv namespace create CACHE_KV # $DATABASE_URL is the operator's own Postgres connection string, exported in their # shell - do not write the credentials into this command or into wrangler.toml. npx wrangler hyperdrive create autonnel-db --connection-string="$DATABASE_URL" ```

يطبع كل أمر معرفا. ضعها في `.env` بجوار المشروع:

```bash CF_WORKER_NAME=my-funnels CF_KV_NAMESPACE_ID=<id from kv namespace create> CF_HYPERDRIVE_CONFIG_ID=<id from hyperdrive create> ```

ثم قم بتعيين الأسرار والنشر:

```bash npx wrangler secret put DATABASE_URL npx wrangler secret put AUTH_SESSION_SECRET # openssl rand -hex 32 npx wrangler secret put CREDENTIALS_ENCRYPTION_KEY # openssl rand -base64 32 npm run deploy:cf ```

يقوم `deploy:cf` بالبناء وإنشاء `wrangler.toml` من القالب أولا، لذلك لا توجد خطوة إنشاء منفصلة. يتم قراءة تعبيرات Cron من سجل cron الخاص بالتطبيق بدلا من كتابتها يدويا في التكوين - لا تقم بتحرير `wrangler.toml` الذي تم إنشاؤه يدويا، يتم الكتابة فوقه في كل بناء.

إذا كان متغير `CF_*` مفقودا، يفشل الإنشاء ويسمي المتغير. هذا هو السلوك المقصود؛ لا توجد قيم افتراضية صامتة لهذه المتغيرات.

طبق مخطط قاعدة البيانات مرة واحدة مقابل نفس Postgres قبل الزيارة الأولى، ثم افتح عنوان URL الخاص ب Worker وأكمل معالج `/setup` لإنشاء حساب المسؤول.

متاح أيضا: `npm run dev:cf` (خادم تطوير على وقت تشغيل Workers) و `npm run preview:cf` (معاينة محلية عبر `wrangler dev`). فضل هذه على `astro dev` العادي عندما يكون الهدف هو Workers، لأن وقت التشغيل يختلف.

### تشغيله بعد ذلك

تحتاج أوامر CLI أدناه إلى الوصول إلى قاعدة البيانات، وليس حاوية. من عملية سحب مع `DATABASE_URL` تشير إلى نفس Postgres:

```bash npx autonnel admin:create you@example.com 'a-strong-password' npx autonnel password:reset you@example.com ```