# 渠道一：仅配置文件（文件里 port=23101）
dotnet BTCPayServer.dll --nodefaultchain
# 实测日志：
info: Configuration:  Data Directory: /test
info: Configuration:  Configuration File: /test/Main/settings.config
info: Configuration:  Network: Regtest
info: Configuration:  Now listening on: http://0.0.0.0:23101

# 渠道二：命令行 --port=23102 覆盖文件的 23101
dotnet BTCPayServer.dll --nodefaultchain --port=23102
# 实测日志：
info: Configuration:  Now listening on: http://0.0.0.0:23102

# 渠道三：环境变量 BTCPAY_PORT=23103 与命令行 --port=23102 同时给出
BTCPAY_PORT=23103 dotnet BTCPayServer.dll --nodefaultchain --port=23102
# 实测日志（命令行胜出）：
info: Configuration:  Now listening on: http://0.0.0.0:23102

# 渠道四：仅环境变量 BTCPAY_PORT=23103（文件仍是 23101）
BTCPAY_PORT=23103 dotnet BTCPayServer.dll --nodefaultchain
# 实测日志（配置文件胜出，环境变量落败）：
info: Configuration:  Now listening on: http://0.0.0.0:23101

info: Configuration:  Network: Regtest

info: Configuration:  Configuration File: /test/Main/settings.config
info: Configuration:  Now listening on: http://127.0.0.1:24451

ls -la /datadir/ /datadir/RegTest/

/datadir/:
-rw-------  1 root root  48589 Oct 23 02:26 btcpay20261023.log
drwxr-xr-x  3 root root   4096 Oct 23 02:26 LocalStorage
-rw-------  1 root root    940 Oct 23 02:26 key-4b2a1b1d-286c-4e1b-a062-42031f1b6a7b.xml
-rw-------  1 root root   1261 Oct 23 02:26 rates-cache.json
drwxr-xr-x  3 root root   4096 Oct 23 02:26 RegTest
drwxr-xr-x  2 root root   4096 Oct 23 02:26 tmp

/datadir/RegTest/:
-rw-------  1 root root 745 Oct 23 02:26 settings.config

### Global settings ###
#network=mainnet

### Server settings ###
#port=23002
#bind=127.0.0.1
#httpscertificatefilepath=devtest.pfx
#httpscertificatefilepassword=toto
#disablessrfprotection=false
#ssrfexceptions=nas.home.arpa:8080;10.8.0.0/24;[fd00::/8]:443

### Host integration ###
#btcpayhostenabled=false
#btcpayhostexecutable=btcpay-host

### Database ###
#postgres=User ID=root;Password=myPassword;Host=localhost;Port=5432;Database=myDataBase;

### NBXplorer settings ###
#BTC.explorer.url=http://127.0.0.1:24446/
#BTC.explorer.cookiefile=/root/.nbxplorer/RegTest/.cookie
#BTC.blockexplorerlink=https://mempool.space/tx/{0}
#BTC.lightning=/root/.lightning/lightning-rpc
#BTC.lightning=https://apitoken:API_TOKEN_SECRET@charge.example.com/

####Common Commands####
####If Bitcoin Core is running with default settings, you should not need to modify this file####
####All those options can be passed by through command like arguments (ie `-port=19382`)####
## This is the RPC Connection to your node
#btc.rpc.url=http://127.0.0.1:18443/
#By user name and password
#btc.rpc.user=bitcoinuser
#btc.rpc.password=bitcoinpassword
#By cookie file
#btc.rpc.cookiefile=yourbitcoinfolder/.cookie
#By raw authentication string
#btc.rpc.auth=walletuser:password

## This is the connection to your node through P2P
#btc.node.endpoint=127.0.0.1:BTC

## minutxovalue defines the minimum value allowed for a utxo to be tracked
#btc.minutxovalue=1

## startheight defines from which block you will start scanning, if -1 is set, it will use current blockchain height
#btc.startheight=-1
## rescan forces a rescan from startheight
#btc.rescan=0
## rescaniftimebefore only lets rescan occur if current unix timestamp (seconds) is less than the given value
## requires btc.rescan to be true
#btc.rescaniftimebefore=1635210000

## If more than 0, the size of the cache for the database, in MB. Else, no limit on the size of the cache. (default: 50)
#dbcache=50
## Disable cookie, local ip authorization (unsecured)
#noauth=0
## Add a server alias to be returned in status response
#instancename=my_business_nbxplorer
## Expose the node RPC through the REST API
#exposerpc=0
## What crypto currencies is supported
#chains=agm,btc,btx,ltc,doge,pepe,bch,grs,btg,dash,trc,polis,mona,ftc,ufo,via,xmcc,gbx,colx,chc,lbtc,qtum,html,mue
## Activate or disable verbose logs
#verbose=0

####Server Commands####
#port=24446
#bind=127.0.0.1
#regtest=1

btcpay-admin.sh reset-server-policy

BTCPay
Open source, self-hosted payment processor.

Usage: BTCPay [options]

Options:
  -? | -h | --help                    Show help information
  -n | --network                      Set the network among (mainnet,testnet,regtest) (default: mainnet)
  --testnet | -testnet                Use testnet (deprecated, use --network instead)
  --regtest | -regtest                Use regtest (deprecated, use --network instead)
  --signet | -signet                  Use signet (deprecated, use --network instead)
  --chains | -c                       Chains to support as a comma separated. Default to empty if --nodefaultchain is set (default: btc; available: btc)
  --nodefaultchain | -nodefaultchain  Allow BTCPay to start without any chain enabled (default: false)
  --postgres                          Connection string to a PostgreSQL database
  --nocsp                             Disable CSP (default false)
  --disablessrfprotection             Disable outbound HTTP protection against DNS rebinding and private-network access (default: false)
  --ssrfexceptions                    Comma- or semicolon-separated exact hostnames, IP addresses, and CIDR ranges allowed through SSRF protection, optionally restricted to a port (for example: nas.home.arpa:8080;10.8.0.0/24;[fd00::/8]:443). Exact hostnames trust all resolved addresses (default: empty)
  --deprecated                        Allow deprecated settings (default:false)
  --externalservices                  Links added to external services inside Server Settings / Services under the format service1:path2;service2:path2.(default: empty)
  --btcpayhostenabled                 Enable the btcpay-host integration (default: false)
  --btcpayhostexecutable              Path to the btcpay-host executable (default: btcpay-host)
  --rootpath                          The root path in the URL to access BTCPay (default: /)
  --torrcfile                         Path to torrc file containing hidden services directories (default: empty)
  --torservices                       Tor hostnames of available services added to Server Settings (and sets onion header for btcpay). Format: btcpayserver:host.onion:80;btc-p2p:host2.onion:81,BTC-RPC:host3.onion:82,UNKNOWN:host4.onion:83. (default: empty)
  --socksendpoint                     Socks endpoint to connect to onion urls (default: empty)
  --updateurl                         Url used for once a day new release version check. Check performed only if value is not empty (default: empty)
  --debuglog                          A rolling log file for debug messages.
  --debugloglevel                     The severity you log (default:information)
  --disable-registration              Disables new user registrations (default:true)
  --recommended-plugins               Deprecated. Accepted for compatibility but no longer used by the embedded plugin directory.
  --xforwardedproto                   If specified, set X-Forwarded-Proto to the specified value, this may be useful if your reverse proxy handle https but is not configured to add X-Forwarded-Proto (example: --xforwardedproto https)
  --cheatmode                         Add some helper UI to facilitate dev-time testing (Default false)
  --explorerpostgres                  Connection string to the postgres database of NBXplorer. (optional, used for dashboard and reporting features)
  --btcexplorerurl                    URL of the NBXplorer for BTC (default: http://127.0.0.1:24444/)
  --btcexplorercookiefile             Path to the cookie file (default: /var/lib/btcpay/.nbxplorer/Main/.cookie)
  --btclightning                      Easy configuration of lightning for the server administrator: Must be a UNIX socket of c-lightning (lightning-rpc) or URL to a charge server (default: empty)
  --btcexternallndgrpc                The LND gRPC configuration BTCPay will expose to easily connect to the internal lnd wallet from an external wallet (default: empty)
  --btcexternallndrest                The LND REST configuration BTCPay will expose to easily connect to the internal lnd wallet from an external wallet (default: empty)
  --btcexternalrtl                    The Ride the Lightning configuration so BTCPay will expose to easily open it in server settings (default: empty)
  --btcexternalspark                  Show spark information in Server settings / Server. The connection string to spark server (default: empty)
  --btcexternalcharge                 Show lightning charge information in Server settings/Server. The connection string to charge server (default: empty)
  -c | --conf                         The configuration file
  -p | --port                         The port on which to listen
  -b | --bind                         The address on which to bind
  -d | --datadir                      The data directory

  --customkeypathtemplate    Define an additional derivation path tracked by NBXplorer (Format: m/1/392/*/29, default: empty)
  --maxgapsize               The maximum gap address count on which the explorer will track derivation schemes (default: 30)
  --mingapsize               The minimum gap address count on which the explorer will track derivation schemes (default: 20)
  --trimevents               When NBXplorer starts, NBXplorer will remove old events to reach this count. No trimming if equals to less than 0 (default: -1)
  --signalfilesdir           The directory where files signaling if a chain is ready is created (default: the network specific datadir)
  --noauth                   Disable cookie authentication
  --instancename             Define an instance name for this server that, if not null, will show in status response and in HTTP response headers (default: empty)
  --exposerpc                 Expose the node RPC through the REST API (default: false)
  --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)
  --socksendpoint            Configure a SocksV5 endpoint as proxy to connect to P2P
  --socksuser                SocksV5 username credential
  --sockspassword            SocksV5 password credential
  -v | --verbose             Verbose logs (default: false)
  -c | --conf                The configuration file
  -p | --port                The port on which to listen
  -b | --bind                The address on which to bind
  -d | --datadir             The data directory

info: Configuration:  Supported chains: BTC
info: Configuration:  Network: Regtest

# Docker Compose 形态（容器内主机名 postgres，库名带网络后缀）
BTCPAY_POSTGRES=User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayserverregtest

# 原生 systemd 形态（本机 PostgreSQL，独立业务库）
--postgres="User ID=btcpay;Password=q1w2e3r4;Host=127.0.0.1;Database=btcpayservermainnet"

info: Configuration:  Connection to NBXplorer's database successful, dashboard and reporting features activated.

__cookie__:e5b34334099fa5c2c663035b696be672891690f91411dc1bc…

curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:24446/v1/cryptos/btc/status
# 实测输出：401
curl -s -u "$(cat /var/lib/nbxplorer/RegTest/.cookie)" http://127.0.0.1:24446/v1/cryptos/btc/status | head -c 120
# 实测输出（节选）：
{"bitcoinStatus":{"blocks":103,"headers":103,…

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
info: Configuration:  Root Path: /

info: Configuration:  NBXplorer version 2.6.19
info: Configuration:  Data Directory: /datadir
info: Configuration:  Configuration File: /datadir/RegTest/settings.config
info: Configuration:  Network: Regtest
info: Configuration:  Supported chains: BTC
info: NBXplorer.DatabaseSetup: Postgres services activated

info: NBXplorer.Indexer.BTC: TCP Connection succeed, handshaking...
info: NBXplorer.Indexer.BTC: Handshaked
info: NBXplorer.Indexer.BTC: Testing RPC connection to http://bitcoind:43782/

info: NBXplorer.Indexer.BTC: BTC: RPC wallet features are disabled because neither `BTC.rpc.defaultwallet` nor `NBXPLORER_BTC_RPC_DEFAULTWALLET` is configured.

# /root/.env（实测）
BTCPAY_PROTOCOL=http
BTCPAY_HOST=btcpay.local
REVERSEPROXY_HTTP_PORT=80
REVERSEPROXY_HTTPS_PORT=443
NBITCOIN_NETWORK=regtest
BTCPAY_CRYPTOS=btc
# ……（其余键默认留空）

# /etc/profile.d/btcpay-env.sh（实测节选）
export COMPOSE_HTTP_TIMEOUT=180
export BTCPAYGEN_CRYPTO1=btc
export BTCPAYGEN_LIGHTNING=none
export BTCPAYGEN_REVERSEPROXY=none
export BTCPAYGEN_ADDITIONAL_FRAGMENTS=''
export BTCPAY_DOCKER_COMPOSE=/root/btcpayserver-docker/Generated/docker-compose.generated.yml
export BTCPAY_BASE_DIRECTORY=/root
export BTCPAY_ENV_FILE=/root/.env
# 随后脚本会把 /root/.env 的非注释行也逐行 export

{"excludedFragments":[],"additionalFragments":[],"effectiveFragments":["bitcoin","btcpay-host","btcpayserver","btcpayserver-noreverseproxy","nbxplorer","opt-mempoolfullrbf","postgres"],"availableFragments":["beldex","bitcoin","bitcoin-clightning","bitcoin-lnd","bitcoincore","btcpay-host","btcpayserver","btcpayserver-nginx",…

services:
  btcpayserver:
    image: ${BTCPAY_IMAGE:-btcpayserver/btcpayserver:2.4.5}
    environment:
      BTCPAY_POSTGRES: User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayserver${NBITCOIN_NETWORK:-regtest}
      BTCPAY_NETWORK: ${NBITCOIN_NETWORK:-regtest}
      BTCPAY_BIND: 0.0.0.0:49392
      BTCPAY_CHAINS: "btc"
      BTCPAY_BTCEXPLORERURL: http://nbxplorer:32838/
    ports:
    - "${NOREVERSEPROXY_HTTP_PORT:-80}:49392"
  nbxplorer:
    image: nicolasdorier/nbxplorer:2.6.19
    environment:
      NBXPLORER_NETWORK: ${NBITCOIN_NETWORK:-regtest}
      NBXPLORER_BIND: 0.0.0.0:32838
      NBXPLORER_TRIMEVENTS: 10000
      NBXPLORER_POSTGRES: User ID=postgres;Host=postgres;Port=5432;Application Name=nbxplorer;MaxPoolSize=20;Database=nbxplorer${NBITCOIN_NETWORK:-regtest}
      NBXPLORER_BTCRPCURL: http://bitcoind:43782/
      NBXPLORER_BTCNODEENDPOINT: bitcoind:39388

# 1. 登录 shell 保证快照已加载（bash -l），再导出要改的变量
bash -l
export NBITCOIN_NETWORK="mainnet"

# 2. 重新执行安装（会重新生成 Compose 并滚动重启）
cd /root/btcpayserver-docker && . ./btcpay-setup.sh -i

# 3. 验证生成结果与容器实际注入
grep "NBITCOIN_NETWORK" /root/.env
docker inspect generated_btcpayserver_1 --format '{{range .Config.Env}}{{println .}}{{end}}' | grep BTCPAY_NETWORK
# 实测输出（regtest 栈）：
BTCPAY_NETWORK=regtest

[Service]
ExecStart=/usr/share/dotnet/dotnet /opt/btcpayserver/BTCPayServer.dll \
  --datadir=/var/lib/btcpay \
  --network=mainnet \
  --postgres="User ID=btcpay;Password=q1w2e3r4;Host=127.0.0.1;Database=btcpayservermainnet" \
  --btcexplorerurl=http://127.0.0.1:24444 \
  --btcexplorercookiefile=/var/lib/nbxplorer/Main/.cookie \
  --port 23000 \
  --bind 0.0.0.0

export BTCPAY_HOST="btcpay.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-xs"
export BTCPAY_IMAGE="btcpayserver/btcpayserver:2.4.5"
. ./btcpay-setup.sh -i

#!/usr/bin/env bash
echo "$(/sbin/ip route|awk '/default/ { print $3 }')  host.docker.internal" >> /etc/hosts
exec dotnet BTCPayServer.dll