معالج الدفع يفعل أكثر من أخذ رسوم. فهو يحتفظ بأموالك، ويرى عملاءك، ويمكنه تجميد حسابك. BTCPay Server برنامج مجاني ومفتوح المصدر يتيح لك قبول Bitcoin مباشرة في محفظة تتحكم بها. يعمل على VPS، ويعرض هذا الدليل التثبيت القياسي المعتمد على Docker.
ما تحتاجه
- VPS بمعالجين افتراضيين (2 vCPU) و4 GB من RAM و80 GB من القرص إذا شغّلت عقدة Bitcoin مقلَّمة بجانبه. وأقل من ذلك إذا وجّهته إلى عقدة خارجية.
- اسم نطاق، مثل
pay.example.com، مع سجل A يشير إلى الخادم. - Ubuntu 22.04 أو 24.04 مع تثبيت Docker وإعداد SSH محصّن.
الخطوة 1: وجّه النطاق
أنشئ سجل A أولاً وانتظر حتى يُحلّ. يطلب المثبّت شهادة Let's Encrypt للاسم، وسيفشل إذا كان السجل مفقوداً. يغطي دليل DNS لدينا ذلك.
الخطوة 2: شغّل المثبّت الرسمي
sudo su -
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="pay.example.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="clightning"
export BTCPAYGEN_REVERSEPROXY="nginx"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-s"
export LETSENCRYPT_EMAIL="you@example.com"
. ./btcpay-setup.sh -iيقوم الجزء opt-save-storage-s بتقليم سلسلة الكتل لتوفير القرص. قد تستغرق المزامنة الأولية ساعات طويلة، ويعمل المتجر مع الفواتير بمجرد أن تلحق العقدة بالشبكة. Lightning اختياري، لذا احذف ذلك السطر إذا لم ترغب به.
الخطوة 3: أنشئ المسؤول والمتجر
افتح نطاقك، وسجّل الحساب الأول (يصبح مسؤول الخادم)، ثم عطّل التسجيل العام ضمن إعدادات الخادم. أنشئ متجراً وحدد عملته الافتراضية.
الخطوة 4: اربط محفظة تتحكم بها
أنشئ المحفظة على محفظة عتادية أو على جهازك، والصق المفتاح العام فقط (xpub) في BTCPay. لا تنشئ محفظة ساخنة على الخادم إن أمكنك تجنب ذلك، لأن الأموال حينئذ تعتمد على بقاء الخادم آمناً. تذهب المدفوعات مباشرة إلى عناوين مشتقة من مفتاحك العام.
الخطوة 5: اختبر وادمج
أنشئ فاتورة تجريبية وادفع مبلغاً صغيراً. ثم ثبّت إضافة لمتجرك (WooCommerce أو Shopify أو مفتاح API مخصص) باتباع وثائق BTCPay.
أبقِه آمناً
- فعّل المصادقة الثنائية للمسؤول.
- انسخ بيانات BTCPay احتياطياً باستخدام سكربت النسخ الاحتياطي المدمج، وخزّنها خارج الخادم ومشفّرة.
- حدّث باستخدام
btcpay-update.sh، بعد قراءة ملاحظات الإصدار. - شغّل جدار الحماية مع فتح SSH و80 و443 فقط.
لمعرفة أي عملة تناسب عملاءك، اقرأ أرخص عملة مشفرة للمدفوعات. هل تشغّل عقدتك الداعمة الخاصة؟ اطّلع على تشغيل عقدة Bitcoin.