A compact home server and connected network equipment, editorial illustration
الدليل العملي

BTCPay Server: استلم مدفوعات Bitcoin من دون وسيط

BTCPay Server برنامج مجاني تستضيفه بنفسك للفواتير، وصندوق الدفع في المتجر، والاشتراكات، والدفع عبر الإنترنت، وتصل مدفوعاته مباشرة إلى محفظتك. أين تشغّله، وكيف تربط محفظة بأمان، و Lightning، والإضافات، والمبالغ المستردة، والحفاظ على أمان الخادم.

ابدأ القراءة
11 دقائق للقراءةالعربية
وضع القراءة

ما هو BTCPay Server

BTCPay Server برنامج مجاني لقبول Bitcoin، سواء كنت نشاطًا تجاريًا أو جمعية خيرية أو عاملًا مستقلًا. ينشئ الفواتير وصفحات الدفع، ويشغّل شاشة نقطة بيع لمنضدة المتجر، ويتصل بالمتاجر الإلكترونية. تصل المدفوعات مباشرة إلى محفظتك. وبعبارة دليل المستخدم الخاص به، فإنه "does not hold funds as a payment intermediary" (لا يحتفظ بالأموال بصفته وسيط دفع).

هو مفتوح المصدر بترخيص MIT وأنت من يشغّله. يقول المشروع إنه ليس شركة، و BTCPay Server Foundation التي تدعمه منظمة غير ربحية تموّلها التبرعات. لا يتقاضى BTCPay شيئًا. تقول أسئلته الشائعة: "We do not charge you anything. However, to run it, you should host it." (لا نتقاضى منك شيئًا. لكن لتشغيله، عليك أن تستضيفه.) تكاليفك هي الخادم ورسوم الشبكة العادية.

جرى التحقق من هذا الدليل مقارنةً بالإصدار 2.4.7، الصادر في 29 أكتوبر 2026. كان إصدارًا أمنيًا أصلح 85 مشكلة مكتشفة، ويوصي المشروع بشدة بالتحديث، خاصة على الخوادم التي يتشاركها عدة تجار.

إن كنت تريد فقط أن تتلقى دفعة بين حين وآخر، فالمحفظة العادية تكفي. BTCPay مخصص لمن يحتاج إلى فواتير مرتبطة بالطلبات، وصندوق دفع، ومبالغ مستردة، وسجلات.

BTCPay Server ↗ · إصدار BTCPay Server 2.4.7 ↗

أين تشغّله

يحتاج BTCPay إلى عقدة Bitcoin وجهاز يبقى متصلًا بالإنترنت. هناك ثلاثة مسارات شائعة.

  • خادم تستأجره. يستخدم التثبيت الرسمي Docker على خادم مستأجر، مع اسم نطاق خاص بك للحصول على عنوان ويب آمن. تضع إرشادات المشروع نفسه الحد الأدنى المطلق عند 4 GB من الذاكرة، ونواتَي معالج، و 50 GB من تخزين SSD مع عقدة مقلّمة (pruned)، بتكلفة تبلغ عادة نحو $20 شهريًا أو أقل. تقدّم LunaNode إعدادًا بنقرة واحدة بنحو $10 شهريًا.
  • عقدتك المنزلية. BTCPay تطبيق على Umbrel و Start9. يقول مجتمع BTCPay إنه لا يستطيع تقديم الدعم لهذه الإعدادات. يحذّر Umbrel من أن المتاجر الإلكترونية مثل Shopify أو WordPress لا تستطيع الوصول إلى خادم منزلي ما لم تُعدّ DNS ديناميكيًا.
  • خادم شخص آخر. يشغّل بعض الناس BTCPay ويسمحون لآخرين بفتح متاجر عليه. اطّلع على التحذيرات أدناه قبل أن تستخدم واحدًا منها.

تستغرق مزامنة عقدة Bitcoin أول مرة ما بين يوم وخمسة أيام. بمجرد أن يعمل الخادم، أنشئ حسابك. أول حساب يُسجَّل يصبح مسؤول الخادم. إن سبقك إلى ذلك شخص آخر، فالوثائق تقول أن تبدأ من جديد بخادم جديد.

BTCPay: خيارات النشر ↗ · نشر BTCPay عبر Docker ↗

استخدام خادم شخص آخر

المضيف الخارجي رخيص وسريع، ووثائق BTCPay صريحة بشأن المقابل. فأنت تثق بمالك الخادم.

  • لا يحتاج المضيف أبدًا إلى مفتاحك الخاص. تقول الوثائق إنه إن طلب مضيف مفتاحًا أو أنشأه لك، فـ "be sure it's a scam" (تأكد أنها عملية احتيال).
  • اربط محفظة تملكها بالفعل، عبر مفتاحها العام، ولا تستخدم أبدًا محفظة ساخنة. ومع ذلك قد يشغّل مضيف غير أمين برنامجًا معدّلًا يستبدل مفتاحك بمفتاحه، فتذهب الدفعات المستقبلية إليه. تحقق بانتظام من أن الدفعات تصل إلى محفظتك أنت.
  • يستطيع المضيف رؤية طريقة استخدامك لمتجرك. افتراضيًا، لا تستطيع المتاجر على خادم مشترك استخدام عقدة Lightning الخاصة بالخادم أو إنشاء محافظ ساخنة.

تقترح الوثائق المضيفين الخارجيين للتجربة والتعلم، لا للمدفوعات الكبيرة أو المتكررة.

BTCPay: الاستضافة لدى طرف ثالث ↗

أنشئ متجرًا

  1. اختر Create account وسجّل.
  2. في Create your first store، أدخل Name، و Default currency لأسعارك، و Preferred Price Source، وهو مصدر سعر الصرف الذي يستخدمه BTCPay لتحويلها. المصدر المقترح مناسب للبداية. اختر Create Store.
  3. تعرض لوحة التحكم ما تبقّى: Set up a wallet، و Set up a Lightning node إن أردت.

اربط محفظة

اختر Set up a wallet. يقدّم BTCPay مسارين.

Connect an existing wallet هو الأكثر أمانًا. لا يحصل BTCPay إلا على المفتاح العام لمحفظتك، الذي يتيح له إنشاء عنوان جديد لكل فاتورة دون أن يستطيع الإنفاق. تصوغ الأسئلة الشائعة للمشروع ذلك هكذا: "Even if your server gets hacked, your funds from the on-chain transactions are always safe." (حتى لو اختُرق خادمك، تبقى أموالك من المعاملات على السلسلة آمنة دائمًا.) خيارات الاستيراد هي:

  • Connect hardware wallet، باستخدام تطبيق Vault من BTCPay على حاسوبك والجهاز موصول به.
  • Import wallet file، وهو ملف مُصدَّر من محفظة مثل Sparrow.
  • Enter extended public key، تلصقه يدويًا.
  • Scan wallet QR code، الذي يدرجه BTCPay لـ BlueWallet و Passport وغيرهما.
  • Enter wallet seed، وعليه علامة Not recommended. لا تكتب كلمات الاسترداد في خادم أبدًا.

Create a new wallet ينشئ المفاتيح على الخادم. Hot wallet تُبقي المفتاح الخاص هناك، فيستطيع BTCPay الإنفاق نيابة عنك، للمبالغ المستردة والدفعات الصادرة، لكن يستطيع ذلك أيضًا أي شخص لديه صلاحية المسؤول على الخادم. نصيحة BTCPay نفسه هي "regularly withdraw funds to a different wallet" (اسحب الأموال بانتظام إلى محفظة أخرى). أما Watch-only wallet فتعرض لك كلمات الاسترداد مرة واحدة وتمحو المفتاح الخاص من الخادم.

عندما يطلب BTCPay نوع العنوان، يناسب Segwit (Recommended) معظم المتاجر.

Create your first store

Create a store to begin accepting payments.

NameCorner Shop
Default currencyUSD
Preferred Price SourceRecommendation (Kraken) ▾

The recommended price source gets chosen based on the default currency.

Create Store
1 / 4
رسم توضيحي لإنشاء متجر وربط محفظة، مأخوذ من صياغة BTCPay Server نفسه في الإصدار 2.4.7. ليس لقطة شاشة. التخطيط والألوان مبسّطة. اسم المتجر ومصدر السعر أمثلة.

حد الفجوة (gap limit). يبحث تطبيق محفظتك مسبقًا في عدد ثابت من العناوين غير المستخدمة، عادة 20. كل فاتورة تستخدم عنوانًا جديدًا، لذا بعد 20 فاتورة غير مدفوعة متتالية قد تتوقف محفظتك عن رؤية الدفعات الجديدة، رغم أن BTCPay يسجّلها. إن كان في محفظتك إعداد لحد الفجوة، فارفعه. الدفعات لا تضيع، بل تبقى مخفية فقط حتى تبحث المحفظة أبعد.

الأسئلة الشائعة لـ BTCPay: المحافظ وحد الفجوة ↗ · BTCPay Vault ↗

Lightning

Lightning اختياري ومعطّل افتراضيًا. في Connect to a Lightning node يوجد خياران.

  • Use internal node يشغّل عقدة Lightning على خادم BTCPay نفسه. إنها محفظة ساخنة على جهاز يمكن الوصول إليه من الإنترنت. تحذّر وثائق BTCPay: "Do not use more than you can afford to lose." (لا تستخدم أكثر مما تتحمل خسارته.) كلمات الاسترداد الخاصة بها تعيد الجزء الموجود على السلسلة فقط، والقنوات تحتاج إلى نسخة احتياطية خاصة بها.
  • Use custom node يتصل بعقدة Lightning تشغّلها في مكان آخر. يدعم BTCPay كلًّا من LND و Core Lightning و Phoenixd و Eclair. اتصالات LNDhub تحتاج الآن إلى إضافة.

يمكنك أيضًا استلام مدفوعات Lightning من دون عقدة خاصة بك، عبر الإضافات. نتناولها أدناه.

BTCPay: خيارات Lightning ↗

  • الفواتير (Invoices). Payments، ثم Invoices، ثم Create Invoice، لمبلغ لمرة واحدة بعملتك.
  • نقطة البيع (Point of Sale). صندوق دفع لمتجر أو كشك، مثلًا على شكل قائمة منتجات، أو قائمة منتجات مع سلة، أو لوحة أرقام لكتابة مبلغ.
  • الطلبات (Requests). طلب الدفع صفحة ترسلها إلى عميل. إن سمحت بذلك، يمكن دفعه على أجزاء، وكل دفعة تستخدم سعر الصرف في وقتها.
  • التمويل الجماعي (Crowdfund). صفحة لجمع التبرعات على طريقة Kickstarter، تُدفع مباشرة إلى محفظتك.
  • زر الدفع (Pay Button). زر لموقع ويب. يحذّر BTCPay من أنه "should only be used for tips and donations" (ينبغي أن يُستخدم للإكراميات والتبرعات فقط)، لأن المشتري يستطيع تغيير تفاصيل الطلب التي يرسلها الزر.
  • الاشتراكات (Subscriptions). خطط متكررة تُفوتر شهريًا أو كل ربع سنة أو سنويًا أو مرة واحدة مدى الحياة. لا يوجد في Bitcoin خصم مباشر، لذا إما أن يدفع العملاء فاتورة كل فترة بعد تذكير، أو يشحنوا رصيدًا دائنًا تُسحب منه التجديدات.
  • عنوان Lightning (Lightning Address). بعد تفعيل Lightning، يمكن أن يكون للمتجر عناوين بصيغة name@yourserver، يستطيع أي شخص الدفع إليها من محفظة Lightning.
  • الدفعات المسحوبة (Pull Payments). عكس الفاتورة. تحدد مبلغًا وترسل رابطًا، ويطالب به الشخص إلى عنوان يختاره. يستخدمها BTCPay للمبالغ المستردة، وتناسب أيضًا الدفعات للموظفين أو المساهمين.
  • الدفع عبر NFC (Pay by NFC). يمكن لصفحة الدفع قبول نقرة من بطاقة Lightning لا تلامسية، مثل Boltcard.

انتظر حتى تُظهر الفاتورة Settled قبل أن تسلّم البضاعة. العميل الذي يدفع من منصة تداول يرسل أحيانًا مبلغًا أقل قليلًا، لأن المنصة تقتطع رسوم السحب الخاصة بها. عندها يعلّم BTCPay الفاتورة على أنها مدفوعة جزئيًا.

دليل مستخدم BTCPay ↗ · BTCPay: Shopify V2 ↗

المتاجر الإلكترونية والإضافات

المتاجر الإلكترونية. يتصل BTCPay بمعظم برامج المتاجر. يستخدم WooCommerce إضافة WordPress تُثبَّت على موقعك. ويستخدم Shopify الإصدار 2 من تكامل BTCPay، الذي يعمل على خادم BTCPay الخاص بك ويحتاج إلى حساب Shopify Partner. الإصدار الأصلي متوقف. تغطي وثائق BTCPay أيضًا Magento و PrestaShop و Odoo و Wix و Ghost و Zapier وغيرها، وهناك واجهة API لأنظمتك الخاصة.

الإضافات (Plugins) تضيف ميزات إلى الخادم نفسه. أدرج Plugin Directory، الموجود تحت قائمة Plugins في أعلى اليمين، 57 إضافة للإصدار 2.4.7. بعض الإضافات المفيدة:

  • Lightning من دون عقدتك الخاصة. Strike و Blink تستلمان في حساب لدى هاتين الشركتين، وهما تحتفظان بالمال نيابة عنك. Breez و Flint تشغّلان محفظة Lightning خفيفة داخل BTCPay، لكنهما تحتفظان بكلمات الاسترداد الخاصة بها على الخادم، حيث يستطيع مشغّل الخادم الوصول إليها. كما تحتفظ Flint بالرصيد على Spark، وهي شبكة منفصلة تقول وثائقها نفسها إن المال ليس في حفظك المنفرد. Arkade و Bark تستخدمان Ark، وهي طريقة أحدث لإجراء الدفعات خارج سلسلة الكتل، وهما برنامجان في مرحلة مبكرة.
  • عقدتك الخاصة. إضافة LSPS-1 تشتري قناة واردة من مزوّد خدمة Lightning، لتتمكن العقدة الجديدة من الاستلام فورًا.
  • Nostr. إضافة Nostr تمنح المتجر عنوان Nostr، وتقبل zaps، ويمكنها الاستلام في محفظة تربطها عبر Nostr Wallet Connect، مثل Alby Hub.
  • التقسيم والتحويل إلى نقد. Prism تقسّم كل دفعة بين عدة وجهات، مثلًا الشركاء أو محفظة ادخار. و Bringin تحوّل حصة مما تستلمه إلى حساب باليورو لدى Bringin.
  • السماح للعملاء بالدفع بعملات أخرى. SideShift و FixedFloat و Trocador تضيف منصة تبادل إلى صفحة الدفع. يدفع العميل بعملة أخرى وتستلم أنت Bitcoin. كل منصة تبادل طرف ثالث له شروطه الخاصة.
  • بيع التذاكر والبيع الحضوري. TicketTailor و Satoshi Tickets تبيعان تذاكر الفعاليات. Boltcards Extension تبرمج بطاقات لا تلامسية تحمل رصيد Lightning. و BTC Map تضيف متجرك إلى خريطة الأماكن التي تقبل Bitcoin.
  • عملات أخرى. توجد إضافات لـ Monero و Zcash و USDt. تحذّر إضافة Monero من أنها تستخدم محفظة واحدة لكل المتاجر على الخادم، لذا لا تستخدمها إلا على خادم لا تتشاركه مع أحد.
  • النقد الإلكتروني (Ecash). BTCNutServer تقبل Cashu ecash. ويقول وصفها نفسه إنها نسخة تجريبية مبكرة لم تخضع للتدقيق.

مسؤول الخادم وحده يستطيع تثبيت الإضافات، لذا على خادم شخص آخر تحصل على ما ثبّته هو. تعمل الإضافات داخل BTCPay مع وصول إلى بياناته. يقول إشعار BTCPay نفسه إنها "have not undergone review by the BTCPay Server team" (لم تخضع لمراجعة فريق BTCPay Server)، وتنصح وثائقه بالتثبيت فقط من مصادر تثق بها. تحقق ممن يصون الإضافة، وحدّثها باستمرار، وخذ نسخة احتياطية من الخادم أولًا.

Plugin DirectoryInstalled Plugins
Important notice about plugins
Plugins are developed by third parties. They need to be updated and maintained regularly in addition to BTCPay Server. Use plugins at your own risk.
NostrNIP5 addresses, Zap support, Nostr Wallet Connect Lightning support
PrismAutomated value splits for Bitcoin.
TicketTailorAllows you to integrate with TicketTailor.com to sell tickets for Bitcoin
1 / 3
رسم توضيحي لتثبيت إضافة، مأخوذ من صياغة BTCPay Server نفسه في الإصدار 2.4.7 ومن دليل إضافاته. ليس لقطة شاشة. التخطيط والألوان مبسّطة، ورسالة إعادة التشغيل معاد صياغتها. Prism مثال، وليست توصية.

وثائق BTCPay: الإضافات ↗ · دليل إضافات BTCPay ↗ · وثائق BTCPay: WooCommerce ↗

المبالغ المستردة والسجلات

في الفاتورة، يتيح لك Issue Refund رد المبلغ بسعر الصرف وقت دفع العميل، أو بسعر اليوم، أو بعملتك، أو كمبلغ مخصص. ثم يعطيك BTCPay رابطًا ترسله إلى العميل. يُدخل العميل عنوانه، ثم توافق أنت على الدفعة وترسلها ضمن Payments، ثم Payouts.

DashboardSettingsWalletsBitcoinLightningPaymentsInvoicesReportingRequests
Create Invoice
Amount25.00
CurrencyUSD
Order Id1042
Item DescriptionCoffee beans, 1 kg
Create
1 / 4
رسم توضيحي لإنشاء فاتورة واسترداد مبلغها، مأخوذ من صياغة BTCPay Server نفسه في الإصدار 2.4.7. ليس لقطة شاشة. التخطيط والألوان مبسّطة، وشاشتا الفاتورة والدفعات الصادرة مختصرتان إلى الأجزاء المذكورة هنا. المبالغ والطلب وأسعار الصرف أمثلة.

لحساباتك، يصدّر Payments، ثم Reporting، الفواتير والدفعات والمبيعات والمبالغ المستردة وغيرها كملف جدول بيانات. ويمكن للمحفظة أيضًا تصدير تسميات معاملاتها بالصيغة القياسية BIP 329.

الأمان والخصوصية

  • فعّل التحقق الثنائي عند تسجيل الدخول. ضمن Two-Factor Authentication في حسابك يمكنك إضافة تطبيق مصادقة أو مفتاح أمان FIDO2. يدعم BTCPay أيضًا مفاتيح المرور (passkeys).
  • حدّث الخادم باستمرار. تابع إصدارات BTCPay، كما يبيّن الإصدار 2.4.7.
  • أبقِ المحافظ الساخنة صغيرة، إن استخدمت واحدة أصلًا.
  • ثبّت فقط الإضافات التي تحتاجها، وحدّثها مع الخادم.
  • Payjoin، الذي يجعل تتبع الدفعات أصعب، يحتاج إلى محفظة ساخنة في BTCPay. يشرحه دليل Payjoin.
  • Tor اختياري. تضيف الأسئلة الشائعة لـ BTCPay أن تفعيله "doesn't make you anonymous at all" (لا يجعلك مجهول الهوية على الإطلاق).

كل فاتورة تستخدم عنوانًا جديدًا، وهذا يساعد خصوصية عملائك وخصوصيتك.

BTCPay: تحصين الخادم ↗ · BTCPay: الإضافات ↗

قبل أن تستلم مدفوعات حقيقية

  • سجّلت حساب المسؤول بنفسك، مباشرة بعد الإعداد.
  • يستخدم المتجر محفظة تملكها، مربوطة عبر مفتاحها العام، وكلمات استردادها مكتوبة على ورق.
  • دفعت فاتورة تجريبية ورأيتها تصل إلى تطبيق محفظتك.
  • التحقق الثنائي عند تسجيل الدخول مفعّل لكل حساب على الخادم.
  • يعرف الموظفون أن عليهم انتظار Settled.
  • تعرف كيف تصدر مبلغًا مستردًا.
  • هناك من يتحقق من تحديثات BTCPay.

المصادر وقراءات إضافية

بُحث في 18 نوفمبر 2026. البرامج والخدمات تتغير: راجع الوثائق الحالية قبل أن تتصرف.

Umbrel: شغّل عقدة وصِل محافظك بها → · Start9: شغّل عقدة وصِل محافظك بها → · Sparrow: أنشئ محفظة تستطيع فحصها → · Payjoin → · اختر إعداد Lightning الذي تستطيع صيانته → · رصيدك مجموعة من القصص → · Alby Hub: عقدة Lightning خاصة بك، متصلة بتطبيقاتك →

تابع مسار تعلمك

سؤال يقود إلى آخر.

01شغّل عقدة تستخدمها فعلًا02Umbrel: شغّل عقدة وصِل محافظك بها

Find your next answer.

Search the complete field guide · Esc to close