Definer tegnebogsgrænsen
En watch-only-tegnebog kan registrere betalinger uden at holde de private brugsnøgler. En udvidet offentlig nøgle afslører stadig følsom tegnebogsaktivitet og bør beskyttes. Lightning-integration kan kræve en online tegnebog og introducerer yderligere driftsrisiko.
Dimensionér til hele stakken
Et Bitcoin backend, database, webtjeneste og valgfri Lightning-node har forskellige lager- og hukommelsesbehov. Gennemgå aktuelle understøttede implementeringsinstruktioner og vækstkrav, før du vælger en lille maskine.
Sikr købmandsgrænsefladen
Brug et dedikeret værtsnavn, HTTPS, stærk loginbeskyttelse og begrænset administrativ adgang. Hold serveren opdateret, og verificér webhook-signaturer eller understøttede verifikationsmekanismer i den modtagende applikation. Afsend ikke varer alene baseret på en browseromdirigering.
Tag backup og afstem
Beskyt butikkonfiguration, database, wallet-gendannelsesoplysninger og Lightning-specifikt materiale i overensstemmelse med den relevante dokumentation. Test gendannelse, og afstem fakturaer mod betalingssystemet, især vedrørende udløb, underbetaling og refusioner.
Kontroller udrulnings- og kædestrategien
Brug de aktuelt understøttede implementeringsinstruktioner, et dedikeret værtsnavn og en verificeret HTTPS-rute. En beskåret kæde kan reducere løbende lagerkrav, hvor det understøttes, men behov for rescan og gendannelse skal forstås. Vælg ikke en disk ud fra den aktuelle kædestørrelse alene; efterlad plads til hele stakken og vækst.
- Bekræft betalingscallbacket fra en ekstern test
- Brug testbetalinger før en livebutik
- Bekræft fakturaafregningspolitikken
Officiel dokumentation: BTCPay-implementeringsmuligheder
Opbevar brugsnøglen, hvor du har til hensigt
En watch-only-opsætning kan registrere betalinger fra en udvidet offentlig nøgle uden at give serveren brugsnøglen. xpub'en er følsom, fordi den kan afsløre tegnebogsaktivitet. En hot wallet ændrer denne risiko ved at placere brugsevnen online. Gennemgå tegnebogs- og Lightning-opbevaring separat, og følg den understøttede backup-procedure.
Officiel dokumentation: BTCPay-tegnebogsmodel
Lav en udrulningscheckliste omkring den valgte stack
Begynd med et dedikeret domæne, en understøttet udrulningsmetode, den tilsigtede kædetilstand og tilstrækkelig diskplads til synkronisering. Gennemgå den upstream Docker-generator og dens valgte komponenter før installation; bevar de ikke-hemmelige udrulningsvalg, så en anden maskine kan genopbygges ensartet. Kontrollér domæneopløsning, certifikatudstedelse og ejerskab af den administrative konto, før du viser en checkout til kunder. Et generisk Docker Compose-eksempel er ikke bevis på, at hver valgfri BTCPay-komponent er konfigureret.
- Beslut, hvilken instansejer der styrer opdateringer, overvågning, sikkerhedskopier og hændelseshåndtering.
- Adskil reverse-proxy-eksponering fra privat Bitcoin RPC, database og Lightning-administration.
- Dokumentér en beskåret backends grænser for gendannelse/rescan, før du tilslutter en tegnebog med historiske betalinger.
- Hold et understøttet testmiljø eller en lille kontrolleret betalingsøvelse til integrationer, før du opfylder værdifulde ordrer.
Officiel dokumentation: BTCPay Server: implementeringsvalg · BTCPay Server: understøttet Docker-udrulning
Undersøg manglende tegnebogsbetalinger uden at importere en seed
En butik kan bruge en tegnebogs xpub/derivation-oplysninger, mens brugsnøglen forbliver på en anden enhed. Test modtagelse og gendannelsesforløbet med den valgte tegnebog. Hvis BTCPay ser en fakturabetaling, men en ekstern tegnebog ikke viser den, skal du undersøge dens derivation-skema og adresse-gap-limit-adfærd, før du antager, at midlerne er forsvundet. Lange serier af ubetalte genererede adresser kan påvirke en tegnebogs opdagelse. Brug understøttede tegnebogsdiagnostik i stedet for at kopiere gendannelsesord til serveren.
Officiel dokumentation: BTCPay Server: fejlfinding af wallet og derivation
Afstem fakturaer før opfyldelse
Registrér fakturaidentifikatorer, og gør opfyldelsesoperationen idempotent. En browsers tilbagevenden til butikken er en navigationshændelse, ikke bevis på afregning. Verificér betalingstilstanden via din autentificerede serverintegration, håndtér udløbne, forsinkede eller underbetalte fakturaer eksplicit, og hold en gennemgangsvej for uafklarede udfald. Hvis en callback gentages, må returnering af en vellykket bekræftelse ikke sende eller kreditere ordren to gange.
- Test en betaling, der ankommer tæt på udløb, og bekræft, at ordren forbliver knyttet til den korrekte faktura.
- Opbevar database, butikskonfiguration og wallet-gendannelsesmateriale i en testet uafhængig backup.
- Lightning tilføjer et separat ansvar for likviditet og kanalbackup; gendannelse af hele gårsdagens VPS er ikke en sikker universel gendannelsesprocedure.
- Hosting af en BTCPay-instans tilføjer ikke Lightning eller XMR til KoalaVPS-kundebetaling; betalingsmetoder på dette hostingsite forbliver dets syv offentliggjorte ruter.
Officiel dokumentation: Bitcoin udviklerguide: betalingsverifikation · LND: katastrofegendannelse · Core Lightning: tegnebogs- og kanalbackups