# Lightning Network よくある質問

このドキュメントでは、BTCPay の Lightning Network に関して、ユーザーがよく直面する質問や問題を整理しています。オフチェーンプロトコルを使い始める前に、リスクを把握してください。あわせて BTCPay での Lightning Network 入門もお読みください。

Lightning Network 一般 FAQ
Lightning Network LND よくある質問
Lightning Network Core Lightning (CLN) よくある質問
Lightning Network の質問とサポート

# Lightning Network 一般 FAQ

ここでは、実装の種類に関係なく、BTCPay の LN に関する一般的な質問を扱います。

# BTCPay では何人が Lightning Network を利用できますか？

セルフホストサーバーでは、内部 Lightning ノードは 1 つだけ利用できます。サーバー所有者は、自分の管理者アカウントに紐づく無制限のストアで同じ Lightning ノードを利用できます。

バージョン 1.0.3.128 以降、BTCPay Server ホストは登録ユーザーに内部 Lightning Network ノードの利用を許可できます。
これは Server Settings > Policies > Allow non-admins to use the internal lightning node in their stores で有効化できます。

サードパーティホストとして

登録ユーザーの資金はすべてあなた自身の Lightning ウォレットに入ります。
その後、各所有者へ手動で確認・再送金する必要があります。負担になる可能性があります。

サードパーティホストを利用する個人として

Lightning Network 経由の支払いはすべてサードパーティのウォレットに入ります。
資金を確実に取り戻せるよう、信頼できるサードパーティホストを使う場合にのみこの方法を使い、十分注意してください。

管理者以外のユーザーは、自分の外部ノードへ接続することもできます。Lightning ノードの外部接続は高度な技術作業です。Lightning を使いたい場合は、必要な構成が一式そろっている自前サーバーのデプロイを推奨します。

# BTCPay を使うストアのノード情報を確認し、直接チャネルを開くには？

Lightning Network の請求書を支払いたい顧客の場合:

コイン選択で「Lightning」を選択します。
Copy/Scan を選択します。
Node Info を選択し、スキャンまたは手動コピーします。

直接 Lightning Network チャネルを開く具体的な手順は、使用しているウォレットによって異なります。ただし、加盟店のノード情報があれば、進め方はすぐに分かるはずです。

# 加盟店として、直接チャネルを開く必要はありますか？

加盟店には受信チャネルが必要です。他者が加盟店にチャネルを開くと、加盟店側の流動性が増えます。顧客はあなたに直接チャネルを開けるはずです。

接続性の高いノードに、あなた宛ての直接チャネル開設を依頼することもできます。チャネル開設は資金の消費ではなく、プリペイドカードに資金を入れて後で使う、またはチャネルを閉じて引き出すのに近いイメージです。

# 自分のノードで受信容量（inbound capacity）を得るには？

受信容量（inbound capacity）を得る方法は多数あります。実践的なヒントとして、この inbound capacity に関する記事 (opens new window) を推奨します。
受信容量（inbound capacity）を依頼する際は、サービス側のルーティングポリシー手数料も考慮してください。

# 以前 Lightning なしで BTCPayServer をインストールしました。後から有効化できますか？

BTCPay Server では、最初のストア作成後でもいつでも Lightning を設定できます。
現在、以下 3 つの Lightning Network 実装をサポートしています。

ストアでの Lightning 設定をさらに学びたい場合は、Lightning Network ガイドをご覧ください。ストアを Lightning Network に接続できます。

# BTCPay で LN と一緒に pruned node を使えますか？

この実装は pruned node をサポートしているため、Core Lightning (CLN) の利用を推奨します。

# 既存の LN ノードを BTCPay と一緒に使えますか？

すでに十分な受信流動性（inbound liquidity）を持つ接続性の高い Lightning ノードがある場合、同梱ノードではなく既存ノードを BTCPay で使いたいかもしれません。

その場合は、ストアの Lightning ノード設定ページ（Store > Settings > Lightning > Modify）に移動します。そこで Use a custom lightning node を選択します。

接続文字列は Lightning 実装ごとに異なります。詳細は設定ページの接続設定ドキュメントを参照してください。

# Core Lightning (CLN) から LND、またはその逆に変更するには？

WARNING

切り替え前に、チャネルをすべて閉じ、Lightning ノードからオンチェーン資金・Lightning 資金の両方を引き出しておいてください。

仮想マシンへ SSH ログインする必要があります。

LND に切り替える場合:

sudo su -
cd btcpayserver-docker
export BTCPAYGEN_LIGHTNING="lnd"
. ./btcpay-setup.sh -i

Core Lightning (CLN) に切り替える場合:

sudo su -
cd btcpayserver-docker
export BTCPAYGEN_LIGHTNING="clightning"
. ./btcpay-setup.sh -i

# Lightning Network 実装を切り替えた後、`no payment available` エラーが出ます

実装を切り替えた場合、ストア単位で Lightning 接続文字列を適切な実装に合わせて再設定する必要があります。Stores > Settings > Lightning > Setup > Connection string に進み、接続文字列画面の click here リンクをクリックしてください。

# コンテナ起動時に `WARNING: The LIGHTNING_ALIAS variable is not set. Defaulting to a blank string` が表示されます

これは無視して問題ありません。
Lightning ノードのエイリアスを設定したい場合は、環境変数ファイルを開きます。

sudo su -
vim $BTCPAY_ENV_FILE

そして LIGHTNING_ALIAS エントリを LIGHTNING_ALIAS=myawesomenode に追加または変更してください。

# 他のユーザーが接続できるように、自分の Lightning ノード情報を表示するには？

他のユーザーがあなたのノードへ接続するために必要な情報は、すでにチェックアウト画面に表示されています。加盟店によっては、顧客が事前接続できるようノード情報を表示したい場合があります。

ノード情報を確認する方法はいくつかありますが、他者へ表示する最も簡単な方法は Lightning ノード情報ページの利用です。Store > Settings > Lightning > Modify に移動してください。ページ下部に Open Public Node Page ボタンがあります。クリックすると情報が表示されます。このページは <iframe> で Web サイトへ埋め込めます。

# BTCPay Server の Lightning Network ウォレットのリカバリーシードバックアップはどこで確認できますか？

以前の BTCPay は noseedbackup を使用していたため、LN ウォレットのバックアップやリカバリーシードの取得はできませんでした。これは当時、Lightning Network ではチャネル内資金のバックアップ手段がなく、オンチェーンウォレットのみが対象だったためです。
現在の LND には、シードの存在に依存する static channel backup などの機能があります。
ただし、Lightning Network は依然として実験段階であることを理解し、失ってもよい範囲 (opens new window) の資金のみを扱ってください。

# シードありで LND を使う（`v1.0.3.138` (opens new window) 以降）

LND Seed Backup サービスは以下にあります:

Server Settings > Services > LND Seed Backup

リカバリーシードは安全にバックアップして保管してください。シードはオンチェーン Lightning ウォレットのバックアップであり、static channel backup 実行にも必要です。

安全にバックアップできたら、サーバー上から削除できます。

古いバージョンから v1.0.3.138 へ移行する場合、移行方法についてはこのブログ記事 (opens new window) が役立つかもしれません。

# オンチェーン決済を無効にして LN 決済だけを使うには？

方法は簡単に 2 つあります:

Store > Settings > Checkout experience > Choose default payment method at checkout
Store > Settings > Modify > Uncheck the Enabled box を実行してオンチェーン決済を無効化

# Lightning Network のバージョン確認方法は？

Lightning Network のバージョンはコマンドラインから確認できます。
LND の場合:

sudo su -
cd btcpayserver-docker
./bitcoin-lncli.sh help

Core Lightning (CLN) の場合:

sudo su -
./bitcoin-lightning-cli.sh getinfo

Lightning ノードへリモート接続できる多くのウォレット（RTL、Zap、Zeus など）でも、フロントエンド上にバージョンが表示されます。

# Lightning Address をリダイレクトする方法は？

ユースケース: pay.example.com で BTCPay サーバーを運用しているが、me@pay.example.com より見た目が良い me@example.com を Lightning Address として使いたい場合。

必要なのは、example.com/.well-known/lnurlp/me から pay.example.com/.well-known/lnurlp/me への 301 リダイレクト設定だけです。
Web サーバー設定で実施できます。以下は nginx の例です:

server {
  server_name example.com;

  # Redirect Lightning Address requests to BTCPay Server
  rewrite ^/\.well-known/lnurlp/(.*)$ https://pay.example.com/.well-known/lnurlp/$1 permanent;
}

# Lightning Network LND よくある質問

ここでは、Lightning Network の LND 実装 (opens new window) に関する一般的な質問を扱います。

# LND を再起動するには？

sudo su -
docker restart btcpayserver_lnd_bitcoin

# LND のオンチェーンウォレットを再スキャンするには？

WARNING

このフラグメントは、lnd のオンチェーンウォレット取引をリセットして再スキャンを発火させる目的で、一時的にのみ有効化してください。
再スキャン成功後は必ずこのフラグメントを無効化してください。無効化しないと、再起動のたびにオンチェーンウォレットを再スキャンします。
WARNING: 再スキャンで取得できるのは、アーカイブ済みブロック内の取引のみです（PRUNED ノードに注意）。

環境変数では指定できない LND 設定を調整するには、docker-compose-generator/docker-fragments/opt-lnd-wallet-rescan.custom.yml にカスタムフラグメントを次のように作成します:

version: "3"
services:
  lnd_bitcoin:
    environment:
      LND_EXTRA_ARGS: |
        reset-wallet-transactions=1
  lnd_litecoin:
    environment:
      LND_EXTRA_ARGS: |
        reset-wallet-transactions=1
  lnd_bitcoingold:
    environment:
      LND_EXTRA_ARGS: |
        reset-wallet-transactions=1

この LND 機能の詳細は、公式ドキュメント (opens new window) を参照してください。

# LND ログを確認するには？

BTCPay Server（Docker インストール）で LND ノードのログを確認するには、次のコマンドを使います:

docker logs --tail 40 btcpayserver_lnd_bitcoin

40 は任意の数に変更できます。これは表示するログ行数を表します。ログの詳細は Troubleshooting ページを参照してください。

# BTCPay における LND のデフォルトディレクトリは？

/var/lib/docker/volumes/generated_lnd_bitcoin_datadir/_data

# 外部ノード接続時にはどの macaroon を提供すべきですか？

BTCPay Server は、請求書作成前に Lightning ノードが完全同期済みか確認するため admin.macaroon を必要とします。
BTCPay Server 接続専用に macaroon を調整したい場合は、LND macaroon bakery を使ってください:

lncli bakemacaroon address:read address:write info:read invoices:read invoices:write onchain:read

# アップデート後の LND 接続問題

アップデート後、LND では認証失敗が起きることがあります。症状は次のとおりです:

ストア設定でノード接続テスト時に Error while connecting to the API (The HTTP status code of the response was not expected (500).) が出る
Zap ウォレットで Unable to connect to host: cannot retrieve macaroon: cannot get macaroon: root key with id 0 doesn’t exist が出る

この場合、lnd の macaroon を削除して再起動する必要があります。

Docker デプロイを使っている場合は、VM に SSH 接続して次のコマンドを実行してください:

sudo su -
docker exec btcpayserver_lnd_bitcoin rm /data/admin.macaroon
docker exec btcpayserver_lnd_bitcoin rm /data/invoice.macaroon
docker exec btcpayserver_lnd_bitcoin rm /data/readonly.macaroon
docker exec btcpayserver_lnd_bitcoin rm /data/data/macaroons.db
docker exec btcpayserver_lnd_bitcoin rm /data/data/chain/bitcoin/mainnet/invoice.macaroon
docker exec btcpayserver_lnd_bitcoin rm /data/data/chain/bitcoin/mainnet/macaroons.db
docker exec btcpayserver_lnd_bitcoin rm /data/data/chain/bitcoin/mainnet/readonly.macaroon
docker restart btcpayserver_lnd_bitcoin

macaroon が存在しない場合はエラーメッセージが出ますが、安全に無視できます。

これにより以前の macaroon は無効になるため、Zap とは Server Settings / Services / LND-gRPC で手動再接続が必要です。

# LND ノードのエイリアスを変更するには？

LND ノードの表示名を変更するには、仮想マシンへ ssh ログインして以下を実行します:

sudo su -
cd btcpayserver-docker
export LIGHTNING_ALIAS="namehere"
. ./btcpay-setup.sh -i

# lnd.conf を編集するには？

環境変数で指定できない LND 設定 (opens new window) を調整するには、docker-compose-generator/docker-fragments/opt-lnd-config.custom.yml にカスタムフラグメントを次のように作成します:

version: '3'
services:
  lnd_bitcoin:
    environment:
      LND_EXTRA_ARGS: |
        minchansize=1234567

LND_EXTRA_ARGS の値にカスタマイズを追加できます。例では minchansize を設定しています。

その後、追加フラグメントへ設定を加えてセットアップを実行します:

export BTCPAYGEN_ADDITIONAL_FRAGMENTS="$BTCPAYGEN_ADDITIONAL_FRAGMENTS;opt-lnd-config.custom"
. ./btcpay-setup.sh -i

この方法でカスタム設定は config に追加され、アップデート後も維持されます。

# LND watchtower に接続するには？

LND watchtower に接続するには、opt-lnd-wtclient (opens new window) フラグメントを組み込み、必要に応じて LND_WTCLIENT_SWEEP_FEE を設定します:

export BTCPAYGEN_ADDITIONAL_FRAGMENTS="$BTCPAYGEN_ADDITIONAL_FRAGMENTS;opt-lnd-wtclient"
export LND_WTCLIENT_SWEEP_FEE=10 # Fee to be used for sweep transaction, 10 sat/vbyte is the default
. ./btcpay-setup.sh -i

その後、watchtower 接続管理には wtclient RPC コマンドを使えます:

# Connect to a remote watchtower
./bitcoin-lncli.sh wtclient add PUBKEY@IP:PORT

# See your watchtower connections
./bitcoin-lncli.sh wtclient towers

# LND watchtower を実行するには？

LND インスタンスと並行して watchtower を実行するには、opt-lnd-watchtower (opens new window) フラグメントを組み込みます:

export BTCPAYGEN_ADDITIONAL_FRAGMENTS="$BTCPAYGEN_ADDITIONAL_FRAGMENTS;opt-lnd-watchtower"
. ./btcpay-setup.sh -i

これでサーバー上で watchtower が利用可能になります。

他の watchtower クライアント（wtclient RPC commands 経由）からの接続を許可するには、docker-compose-generator/docker-fragments/opt-lnd-config.custom.yml のカスタムフラグメントに watchtower.externalip を次のように追加する必要があります:

version: '3'
services:
  lnd_bitcoin:
    environment:
      LND_EXTRA_ARGS: |
        watchtower.externalip=YOUR_SERVER_IP

その後、追加フラグメントへ設定を加え、ファイアウォールでポート 9911 を開放します:

# Add the custom LND fragment
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="$BTCPAYGEN_ADDITIONAL_FRAGMENTS;opt-lnd-config.custom"
. ./btcpay-setup.sh -i

# Open port the watchtower RPC port in the firewall
ufw allow 9911/tcp

tower info コマンドを実行すると、uris セクションに公開 watchtower インスタンスが表示されるはずです。

# ./bitcoin-lncli.sh tower info
{
    "pubkey": "YOUR_TOWER_PUBKEY",
    "listeners": [
        "172.23.0.9:9911",
        "127.0.0.1:9911"
    ],
    "uris": [
        "YOUR_TOWER_PUBKEY@YOUR_SERVER_IP:9911"
    ]
}

watchtower 設定 (opens new window) も参照してください。

# ThunderHub をインストールするには？

インスタンスに ThunderHub をインストールするには、以下を実行します:

export BTCPAYGEN_ADDITIONAL_FRAGMENTS="$BTCPAYGEN_ADDITIONAL_FRAGMENTS;opt-add-thunderhub"
. btcpay-setup.sh -i

Unable to connect to this node という警告が出る場合、LND 通信で使う証明書に正しいドメインが含まれていない可能性があります。LND は既存証明書を削除しない限り新しい証明書を生成しません。

古い証明書と鍵を削除して LND に新規生成させるには、以下を実行します:

docker exec btcpayserver_lnd_bitcoin rm /data/tls.cert
docker exec btcpayserver_lnd_bitcoin rm /data/tls.key
docker restart btcpayserver_lnd_bitcoin
docker restart generated_bitcoin_thub_1

# Lightning Network Core Lightning (CLN) よくある質問

ここでは、Lightning Network の Core Lightning (CLN) (opens new window) 実装に関する一般的な質問を扱います。

# Core Lightning (CLN) を再起動するには？

sudo su -
docker restart btcpayserver_clightning_bitcoin

# IPv6 アドレスをアナウンスするには？

まず bitcoin-clightning.yml を Docker フラグメントフォルダへ bitcoin-clightning.custom.yml としてコピーします。
重要: ファイル名は必ず .custom.yml で終える必要があります。そうしないと btcpay-update.sh 実行時に git コンフリクトが発生します。

新しい bitcoin-clightning.custom.yml を次のように変更します:

services:
  clightning_bitcoin:
    environment:
      LIGHTNINGD_OPT: |
        announce-addr=[ipv6 here]

アドレスは 2 つの角括弧 [] の間に入れてください。

続いてセットアップします:

export BTCPAYGEN_ADDITIONAL_FRAGMENTS="bitcoin-clightning.custom"
. ./btcpay-setup.sh -i

# .lightning/config を編集するには？

環境変数で指定できない Core Lightning 設定 (opens new window) を調整するには、docker-compose-generator/docker-fragments/opt-lightningd-config.custom.yml にカスタムフラグメントを次のように作成します:

version: '3'
services:
  clightning_bitcoin:
    environment:
      LIGHTNINGD_OPT: |
        alias=MyNodeName
        rgb=003366

LIGHTNINGD_OPT の値にカスタマイズを追加できます。例では alias と rgb を設定しています。