┌──────────────────────────── 服务器 btcpay245 ────────────────────────────┐
│                                                                          │
│  浏览器 ──HTTP:23000──▶ BTCPay Server（.NET 10，User=btcpay）             │
│                           │              │                                │
│        PostgreSQL 14 ◀────┘              ▼                                │
│        127.0.0.1:5432                NBXplorer 2.6.19（User=btcpay）      │
│        两套库：btcpayservermainnet       │  HTTP API 127.0.0.1:24446      │
│                 nbxplorermainnet         ▼                                │
│                                    Bitcoin Core 31.1（User=bitcoin）      │
│                                    RPC 127.0.0.1:18443（regtest）         │
│                                    P2P  127.0.0.1:18444（regtest）        │
└──────────────────────────────────────────────────────────────────────────┘

apt update
DEBIAN_FRONTEND=noninteractive apt-get install -y postgresql postgresql-contrib

Setting up postgresql-contrib (14+238) ...
Setting up postgresql (14+238) ...
Processing triggers for libc-bin (2.35-0ubuntu3.15) ...

systemctl enable --now postgresql
systemctl status postgresql --no-pager | head -6

Synchronizing state of postgresql.service with SysV service script with /lib/systemd/systemd-sysv-install.
Executing: /lib/systemd/systemd-sysv-install enable postgresql
● postgresql.service - PostgreSQL RDBMS
     Loaded: loaded (/lib/systemd/system/postgresql.service; enabled; vendor preset: enabled)
     Active: active (exited) since Thu 2026-10-22 18:09:35 UTC; 2s ago
     Main PID: 5620 (code=exited, status=0/SUCCESS)

su - postgres -c "psql -c 'SELECT version();'" | head -3

                                                        version
------------------------------------------------------------------------------------------------------------------------------------------
 PostgreSQL 14.24 (Ubuntu 14.24-0ubuntu0.22.04.1) on x86_64-pc-linux-gnu, compiled by gcc (Ubuntu 11.4.0-1ubuntu1~22.04.3) 11.4.0, 64-bit

su - postgres -c "psql -c \"CREATE USER btcpay WITH PASSWORD 'q1w2e3r4';\""
su - postgres -c "createdb -O btcpay btcpayservermainnet"
su - postgres -c "createdb -O btcpay nbxplorermainnet"

CREATE ROLE

su - postgres -c "psql -l" | grep -E "btcpayservermainnet|nbxplorermainnet"

 btcpayservermainnet | btcpay   | UTF8     | C.UTF-8 | C.UTF-8 |
 nbxplorermainnet    | btcpay   | UTF8     | C.UTF-8 | C.UTF-8 |

apt-cache search -n "^dotnet-sdk" | grep -v dbg | grep -v artifacts

dotnet-sdk-6.0 - dotNET 6.0 Software Development Kit
dotnet-sdk-8.0 - .NET 8.0 Software Development Kit
dotnet-sdk-7.0 - dotNET 7.0 Software Development Kit

curl -fsSL https://dot.net/v1/dotnet-install.sh -o /tmp/dotnet-install.sh
chmod +x /tmp/dotnet-install.sh
/tmp/dotnet-install.sh --channel 10.0 --install-dir /usr/share/dotnet

dotnet-install: Adding to current process PATH: `/usr/share/dotnet`. Note: This change will be visible only when sourcing script.
dotnet-install: Note that the script does not resolve dependencies during installation.
dotnet-install: To check the list of dependencies, go to https://learn.microsoft.com/dotnet/core/install, select your operating system and check the "Dependencies" section.
dotnet-install: Installation finished successfully.

ln -sf /usr/share/dotnet/dotnet /usr/local/bin/dotnet
dotnet --version

10.0.402

cd /tmp
curl -fSL -o bitcoin-31.1.tar.gz https://bitcoincore.org/bin/bitcoin-core-31.1/bitcoin-31.1-x86_64-linux-gnu.tar.gz
ls -lh bitcoin-31.1.tar.gz
sha256sum bitcoin-31.1.tar.gz

100 86.1M  100 86.1M    0     0  5559k      0  0:00:15  0:00:15 --:--:-- 6918k
-rw-r--r-- 1 root root 87M Oct 22 18:10 bitcoin-31.1.tar.gz
b80d9c3e04da78fb6f0569685673418cf686fadba9042d926d13fb87ff503f9e  bitcoin-31.1.tar.gz

cd /tmp
tar -xzf bitcoin-31.1.tar.gz
mkdir -p /opt/bitcoin
cp -r bitcoin-31.1/{bin,libexec,share} /opt/bitcoin/
ln -sf /opt/bitcoin/bin/bitcoind /opt/bitcoin/bin/bitcoin-cli /opt/bitcoin/bin/bitcoin-wallet /opt/bitcoin/bin/bitcoin-tx /usr/local/bin/
bitcoind --version | head -2

Bitcoin Core daemon version v31.1.0 bitcoind
Copyright (C) 2009-2026 The Bitcoin Core developers

useradd -r -s /usr/sbin/nologin bitcoin
mkdir -p /etc/bitcoin /var/lib/bitcoind
chown -R bitcoin:bitcoin /var/lib/bitcoind

cat > /etc/bitcoin/bitcoin.conf <<'EOF'
# BTCPay Server 配套 Bitcoin Core（验证环境用 regtest 链；生产切换见本节末尾）
regtest=1
server=1
txindex=0
datadir=/var/lib/bitcoind

[regtest]
rpcbind=127.0.0.1
rpcport=18443
rpcallowip=127.0.0.1
rpcuser=btcpayrpc
rpcpassword=btcpayrpc-pass-245
EOF

# BTCPay Server 配套 Bitcoin Core（验证环境用 regtest 链；生产切换见本节末尾）
regtest=1
server=1
txindex=0
datadir=/var/lib/bitcoind

cat > /etc/systemd/system/bitcoind.service <<'EOF'
[Unit]
Description=Bitcoin Core daemon
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/bitcoind -conf=/etc/bitcoin/bitcoin.conf -datadir=/var/lib/bitcoind
User=bitcoin
Group=bitcoin
TimeoutSec=300
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now bitcoind

systemctl status bitcoind --no-pager -n 0 | head -7
bitcoin-cli -conf=/etc/bitcoin/bitcoin.conf getblockchaininfo | head -4

● bitcoind.service - Bitcoin Core daemon
     Loaded: loaded (/etc/systemd/system/bitcoind.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2026-10-22 18:14:52 UTC; 3s ago
   Main PID: 6455 (bitcoind)
      Tasks: 36 (limit: 94371)
     Memory: 39.2M

{
  "chain": "regtest",
  "blocks": 0,
  "headers": 0,

bitcoin-cli -conf=/etc/bitcoin/bitcoin.conf createwallet mining

{
  "name": "mining"
}

ADDR=$(bitcoin-cli -conf=/etc/bitcoin/bitcoin.conf -rpcwallet=mining getnewaddress)
bitcoin-cli -conf=/etc/bitcoin/bitcoin.conf generatetoaddress 101 "$ADDR" | tail -3
bitcoin-cli -conf=/etc/bitcoin/bitcoin.conf getblockchaininfo | grep -E '"blocks"|"chain"'

  "38a75cecc30a39d17f772843d19eae2bff2030ede0afbcf80525a13203efba64",
  "6d0f3cd91a789480f666c746076c0241fef835d5f27ca64b519ad26432e8c66e"
]
  "chain": "regtest",
  "blocks": 101,

mkdir -p /usr/local/src
git clone --branch v2.6.19 https://github.com/NicolasDorier/NBXplorer.git /usr/local/src/NBXplorer
cd /usr/local/src/NBXplorer && git log -1 --format="%H %d %s"

a858b187a9025634787dce6b19e6bea66ecbb815  (HEAD, tag: v2.6.19, tag: Client/v5.0.11) Merge pull request #570 from btcpayserver/bump-dependencies-september-2026

cd /usr/local/src/NBXplorer
dotnet publish NBXplorer/NBXplorer.csproj -c Release -o /opt/nbxplorer

  NBXplorer -> /usr/local/src/NBXplorer/NBXplorer/bin/Release/net10.0/NBXplorer.dll
  NBXplorer -> /opt/nbxplorer/

cd /opt/nbxplorer && ./NBXplorer --btcconf=/etc/bitcoin/bitcoin.conf --network=regtest

info: Configuration:  NBXplorer version 2.6.19
Specify --help for a list of available options and commands.
fail: Explorer:
      Unrecognized option '--btcconf=/etc/bitcoin/bitcoin.conf'

cd /opt/nbxplorer && ./NBXplorer --help 2>&1 | grep -E "^\s+--(btcrpcuser|btcrpcpassword|btcrpcurl|btcnodeendpoint|postgres|nowarmup)"

  --nowarmup                 If true and on regtest, no block will be generated by NBXplorer when the tip got stalled or if no block has been mined (default: false)
  --btcrpcuser               RPC authentication method 1: The RPC user (default: using cookie auth from default network folder)
  --btcrpcpassword           RPC authentication method 1: The RPC password (default: using cookie auth from default network folder)
  --btcrpcurl                The RPC server url (default: default rpc server depended on the network)
  --btcnodeendpoint          The p2p connection to a Bitcoin node, make sure you are whitelisted (default: default p2p node on localhost, depends on network)
  --postgres                 Use PostgreSQL backend. Set the connection string of the postgres backend (For example: "User ID=postgres;Host=postgres;Port=5432;Application Name=nbxplorer;Database=nbxplorer", more options on https://www.npgsql.org/doc/connection-string-parameters.html)

cd /opt/nbxplorer
nohup ./NBXplorer \
  --btcrpcuser=btcpayrpc \
  --btcrpcpassword=btcpayrpc-pass-245 \
  --btcrpcurl=http://127.0.0.1:18443 \
  --btcnodeendpoint=127.0.0.1:18444 \
  --postgres="User ID=btcpay;Password=q1w2e3r4;Host=127.0.0.1;Database=nbxplorermainnet" \
  --network=regtest > /var/log/nbxplorer.log 2>&1 &

grep -E "NBXplorer version|listening|detected|Node state changed" /var/log/nbxplorer.log | head -6

info: Configuration:  NBXplorer version 2.6.19
info: Configuration:  Now listening on: http://127.0.0.1:24446
info: NBXplorer.Indexer.BTC: Full node version detected: 310100
info: NBXplorer.Events: BTC: Node state changed: NotStarted => NBXplorerSynching
info: NBXplorer.Events: BTC: Node state changed: NBXplorerSynching => Ready
info: NBXplorer.Events: BTC: New block 6d0f3cd91a789480f666c746076c0241fef835d5f27ca64b519ad26432e8c66e (101)

curl -sv --max-time 8 http://127.0.0.1:24446/v1/crypto/btc/status 2>&1 | grep -E "HTTP/|Connected to"

< HTTP/1.1 404 Not Found
< Server: Kestrel

curl -s --max-time 8 -w "\nHTTP=%{http_code}\n" http://127.0.0.1:24446/v1/cryptos/btc/status

HTTP=401

curl -s --max-time 8 -u "$(cat /root/.nbxplorer/RegTest/.cookie)" http://127.0.0.1:24446/v1/cryptos/btc/status | head -c 300; echo

{"bitcoinStatus":{"blocks":101,"headers":101,"verificationProgress":1.0,"isSynched":true,"incrementalRelayFee":0.1,"minRelayTxFee":0.1,"externalAddresses":[],"capabilities":{"canScanTxoutSet":true,"canSupportSegwit":true,"canSupportTaproot":true,"canSupportTransactionCheck":true}},"isFullySynched":t

pkill -f NBXplorer

useradd -r -s /usr/sbin/nologin btcpay
mkdir -p /var/lib/nbxplorer /var/lib/btcpay
chown -R btcpay:btcpay /var/lib/nbxplorer /var/lib/btcpay

cat > /etc/systemd/system/nbxplorer.service <<'EOF'
[Unit]
Description=NBXplorer - lightweight block explorer for BTCPay Server
After=bitcoind.service postgresql.service
Wants=postgresql.service

[Service]
Type=simple
User=btcpay
Group=btcpay
WorkingDirectory=/opt/nbxplorer
ExecStart=/usr/share/dotnet/dotnet /opt/nbxplorer/NBXplorer.dll \
  --datadir=/var/lib/nbxplorer \
  --network=regtest \
  --btcrpcuser=btcpayrpc --btcrpcpassword=btcpayrpc-pass-245 \
  --btcrpcurl=http://127.0.0.1:18443 \
  --btcnodeendpoint=127.0.0.1:18444 \
  --btcrpcdefaultwallet=mining \
  --postgres="User ID=btcpay;Password=q1w2e3r4;Host=127.0.0.1;Database=nbxplorermainnet"
Restart=on-failure
RestartSec=10
TimeoutSec=120

[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now nbxplorer

systemctl is-active nbxplorer
journalctl -u nbxplorer --no-pager -n 5 | tail -3
ls -la /var/lib/nbxplorer/RegTest/.cookie

active
Oct 22 18:19:24 btcpay245 dotnet[7859]: info: NBXplorer.Indexer.BTC: BTC: RPC Wallet loaded
Oct 22 18:19:24 btcpay245 dotnet[7859]: info: NBXplorer.Events: BTC: Node state changed: NotStarted => NBXplorerSynching
Oct 22 18:19:24 btcpay245 dotnet[7859]: info: NBXplorer.Events: BTC: Node state changed: NBXplorerSynching => Ready
-rw-r--r-- 1 btcpay btcpay 75 Oct 22 18:19 /var/lib/nbxplorer/RegTest/.cookie

git clone --branch v2.4.5 https://github.com/btcpayserver/btcpayserver.git /usr/local/src/btcpayserver
cd /usr/local/src/btcpayserver && git describe --tags

v2.4.5

cd /usr/local/src/btcpayserver
dotnet publish BTCPayServer/BTCPayServer.csproj -c Release -o /opt/btcpayserver

  BTCPayServer -> /usr/local/src/btcpayserver/BTCPayServer/bin/Release/net10.0/BTCPayServer.dll
  BTCPayServer -> /opt/btcpayserver/

cat > /etc/systemd/system/btcpayserver.service <<'EOF'
[Unit]
Description=BTCPay Server - self-hosted cryptocurrency payment processor
After=nbxplorer.service postgresql.service
Wants=postgresql.service

[Service]
Type=simple
User=btcpay
Group=btcpay
WorkingDirectory=/opt/btcpayserver
ExecStart=/usr/share/dotnet/dotnet /opt/btcpayserver/BTCPayServer.dll \
  --datadir=/var/lib/btcpay \
  --network=regtest \
  --postgres="User ID=btcpay;Password=q1w2e3r4;Host=127.0.0.1;Database=btcpayservermainnet" \
  --btcexplorerurl=http://127.0.0.1:24446 \
  --btcexplorercookiefile=/var/lib/nbxplorer/RegTest/.cookie \
  --port 23000 \
  --bind 0.0.0.0
Restart=on-failure
RestartSec=10
TimeoutSec=120

[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now btcpayserver

info: Configuration:  BTC: Explorer url is http://127.0.0.1:24446/
info: Configuration:  BTC: Cookie file is /var/lib/nbxplorer/RegTest/.cookie
info: Configuration:  Now listening on: http://0.0.0.0:23000

systemctl is-active btcpayserver
curl -s --max-time 10 http://127.0.0.1:23000/api/v1/health; echo
curl -s -o /dev/null -w "login page HTTP=%{http_code}\n" --max-time 10 http://127.0.0.1:23000/login

active
{"synchronized":true}
login page HTTP=200

su - postgres -c "psql btcpayservermainnet -c 'SELECT \"Email\" FROM \"AspNetUsers\";'"

       Email
-------------------
 admin@example.com
(1 row)

# 状态查看
systemctl status bitcoind nbxplorer btcpayserver --no-pager

# 启停与重启
systemctl stop btcpayserver nbxplorer
systemctl start bitcoind nbxplorer btcpayserver
systemctl restart btcpayserver

# 实时日志
journalctl -u btcpayserver -f
journalctl -u nbxplorer --since "10 min ago"

systemctl is-enabled bitcoind nbxplorer btcpayserver

enabled
enabled
enabled

cd /usr/local/src/NBXplorer
git fetch --tags
git tag -l "v2.6.1*" | sort -V | tail -4

v2.6.16
v2.6.17
v2.6.18
v2.6.19

cd /usr/local/src/NBXplorer
git checkout v2.6.18
dotnet publish NBXplorer/NBXplorer.csproj -c Release -o /opt/nbxplorer
systemctl restart nbxplorer
journalctl -u nbxplorer --no-pager -n 20 | grep "NBXplorer version" | tail -1

  NBXplorer -> /opt/nbxplorer/
Oct 22 18:24:57 btcpay245 dotnet[8065]: info: Configuration:  NBXplorer version 2.6.18

cd /usr/local/src/NBXplorer
git checkout v2.6.19
dotnet publish NBXplorer/NBXplorer.csproj -c Release -o /opt/nbxplorer
systemctl restart nbxplorer
journalctl -u nbxplorer --no-pager -n 20 | grep "NBXplorer version" | tail -1

  NBXplorer -> /opt/nbxplorer/
Oct 22 18:25:16 btcpay245 dotnet[8201]: info: Configuration:  NBXplorer version 2.6.19

cd /usr/local/src/NBXplorer
git checkout v2.6.18
dotnet publish NBXplorer/NBXplorer.csproj -c Release -o /opt/nbxplorer-2.6.18
/usr/share/dotnet/dotnet /opt/nbxplorer-2.6.18/NBXplorer.dll --version | head -1
git checkout v2.6.19

  NBXplorer -> /opt/nbxplorer-2.6.18/
info: Configuration:  NBXplorer version 2.6.18

# 1. 停止并禁用服务
systemctl disable --now btcpayserver nbxplorer bitcoind

# 2. 删除服务单元与配置
rm -f /etc/systemd/system/{btcpayserver,nbxplorer,bitcoind}.service
systemctl daemon-reload

# 3. 删除程序与数据目录
rm -rf /opt/btcpayserver /opt/nbxplorer /opt/bitcoin
rm -rf /var/lib/btcpay /var/lib/nbxplorer /var/lib/bitcoind /etc/bitcoin
rm -rf /usr/local/src/btcpayserver /usr/local/src/NBXplorer
rm -f /usr/local/bin/{bitcoind,bitcoin-cli,bitcoin-wallet,bitcoin-tx,dotnet}

# 4. 删除数据库（psql 中执行）
#   DROP DATABASE btcpayservermainnet; DROP DATABASE nbxplorermainnet; DROP USER btcpay;

# 5. 删除系统用户
userdel bitcoin btcpay