Definiera plånboksgränsen
En watch-only-plånbok kan upptäcka betalningar utan att inneha de privata spenderingsnycklarna. En utökad publik nyckel avslöjar fortfarande känslig plånboksaktivitet och bör skyddas. Lightning-integration kan kräva en onlineplånbok och medför ytterligare operativ risk.
Dimensionera för hela stacken
En Bitcoin-backend, databas, webbtjänst och valfri Lightning-nod har olika lagrings- och minnesbehov. Granska aktuella supportade distributionsinstruktioner och tillväxtkrav innan du väljer en liten maskin.
Säkra handlarens gränssnitt
Använd ett dedikerat värdnamn, HTTPS, starkt inloggningsskydd och begränsad administrativ åtkomst. Håll servern uppdaterad och verifiera webhook-signaturer eller verifieringsmekanismer som stöds i den mottagande applikationen. Skicka inte varor enbart baserat på en webbläsaromdirigering.
Säkerhetskopiera och stäm av
Skydda butikskonfiguration, databas, plånboksåterställningsinformation och Lightning-specifikt material enligt relevant dokumentation. Testa återställning och stäm av fakturor mot betalningssystemet, särskilt kring utgång, underbetalning och återbetalningar.
Kontrollera distributions- och kedjestrategin
Använd de aktuella instruktionerna för driftsättning som stöds, ett dedikerat värdnamn och en verifierad HTTPS rutt. En beskuren kedja kan minska löpande lagringskrav där det stöds, men behov av omsökning och återställning måste förstås. Välj inte en disk enbart utifrån den aktuella kedjestorleken; lämna utrymme för hela stacken och tillväxt.
- Verifiera betalningsåteranropet från ett externt test
- Använd testbetalningar innan en livebutik
- Bekräfta fakturans avräkningspolicy
Officiell dokumentation: Distributionsalternativ för BTCPay
Förvara spenderingsnyckeln där du avser
En watch-only-konfiguration kan upptäcka betalningar från en utökad publik nyckel utan att ge servern spenderingsnyckeln. xpub är känslig eftersom den kan avslöja plånboksaktivitet. En hot wallet ändrar denna risk genom att placera spenderingsförmåga online. Granska plånboks- och Lightning-förvaring separat och följ den backupprocess som stöds.
Officiell dokumentation: BTCPay-plånbokmodell
Bygg en distributionschecklista kring den valda stacken
Börja med en dedikerad domän, en distributionsmetod som stöds, avsedd kedjeläge och tillräckligt med diskutrymme för synkronisering. Granska den uppströms Docker-generatorn och dess valda komponenter före installation; bevara de icke-hemliga distributionsvalen så att en annan maskin kan byggas om konsekvent. Kontrollera domänupplösning, certifikatutfärdande och ägarskap av administratörskontot innan du visar en kassa för kunder. Ett generiskt Docker Compose-exempel är inte bevis på att varje valfri BTCPay-komponent är konfigurerad.
- Bestäm vilken instansägare som kontrollerar uppdateringar, övervakning, säkerhetskopior och incidenthantering.
- Separera omvänd proxy-exponering från privat Bitcoin RPC, databas och Lightning-administration.
- Dokumentera en beskuren backends återställnings-/omsökningsgränser innan du ansluter en plånbok med historiska betalningar.
- Behåll en testmiljö som stöds eller en liten kontrollerad betalningsövning för integrationer innan du fullgör värdefulla ordrar.
Officiell dokumentation: BTCPay Server: distributionsval · BTCPay Server: Docker-driftsättning som stöds
Utred saknade plånboksbetalningar utan att importera en seed
En butik kan använda en plånboks xpub-/härledningsinformation medan spenderingsnyckeln finns kvar på en annan enhet. Testa mottagning och återställningsvägen med den valda plånboken. Om BTCPay ser en fakturabetalning men en extern plånbok inte visar den, granska dess härledningsschema och beteende för adressgapgräns innan du antar att medlen försvunnit. Långa serier av obetalda genererade adresser kan påverka en plånboks upptäckt. Använd plånbokens supportsdiagnostik i stället för att kopiera återställningsfraser till servern.
Officiell dokumentation: BTCPay Server: felsökning av plånbok och derivation
Avstäm fakturor före leverans
Registrera fakturaidentifierare och gör fullgörandeoperationen idempotent. En webbläsares återkomst till butiken är en navigationshändelse, inte bevis på avräkning. Verifiera betalningsstatusen via din autentiserade serverintegration, hantera utgångna, sena eller underbetalda fakturor explicit och behåll en granskningsväg för olösta utfall. Om en callback upprepas får en returnerad lyckad bekräftelse inte leverera eller kreditera ordern två gånger.
- Testa en betalning som anländer nära utgången och verifiera att beställningen förblir kopplad till rätt faktura.
- Håll databas, butikskonfiguration och plånboksåterställningsmaterial i en testad oberoende säkerhetskopia.
- Lightning tillför ett separat ansvar för likviditet och kanalsäkerhetskopior; att återställa hela gårdagens VPS är inte en säker universell återställningsprocedur.
- Att hosta en BTCPay-instans lägger inte till Lightning eller XMR i kassan för KoalaVPS-kunder; betalningsmetoderna på denna hostingsajt är fortfarande dess sju publicerade vägar.
Officiell dokumentation: Bitcoin utvecklarguide: betalningsverifiering · LND: katastrofåterställning · Core Lightning: säkerhetskopior av plånbok och kanaler