Background ja

​

バックグラウンド実行 + ログ（lcpd-grpcd）

このドキュメントでは、実用的な方法として以下を説明します:

• lcpd-grpcd をバックグラウンドで動かす
• ログをディスクに残す（簡易ローテーション付き）

注意: ログはセンシティブです。lcpd-grpcd は生のプロンプト/出力をログに残さない設計ですが、ログにはメタデータ（peer id / job id / 価格 / 時間など）が残ります。詳細は ログとプライバシー を参照してください。

長期運用のインフラでは service manager（systemd/launchd）を使ってください。 「ターミナルを閉じても動き続けてほしい」程度なら、このリポジトリのスクリプトで十分な場合が多いです。

​

Option A（手軽で推奨）: リポジトリのスクリプト + ログファイル

このリポジトリには小さな runner スクリプトがあります:

cd go-lcpd
./scripts/lcpd-grpcd --help

​

0) daemon バイナリをビルド（初回のみ）

cd go-lcpd
mkdir -p bin
GOBIN="$PWD/bin" go install ./tools/lcpd-grpcd

​

1) 環境変数の設定

起動パラメータと秘密情報をシェル履歴に残さないため、direnv（.envrc）で管理するのがおすすめです。 direnv を使わない場合は、シェルや service manager 側で LCPD_* を export してください。

​

Option A: direnv（.envrc）

cd go-lcpd
cp .envrc.sample .envrc
direnv allow

その後 .envrc を編集して LCPD_* を追加してください。

Requester のみ（Provider 実行なし）のヒント:

• config.yaml があるディレクトリで実行すると、lcpd-grpcd はデフォルトでそれを使います。
• このリポジトリの go-lcpd/config.yaml は、デフォルトで Provider を無効にしています。
• Provider を有効にする別の config.yaml を使っている（または別の作業ディレクトリで実行している）場合は、 LCPD_PROVIDER_CONFIG_PATH=/dev/null（空 YAML）を指定して Provider 無効を強制できます。

​

2) 起動 / 停止

起動（バックグラウンド）:

cd go-lcpd
./scripts/lcpd-grpcd up

ステータス:

cd go-lcpd
./scripts/lcpd-grpcd status

ログを tail:

cd go-lcpd
./scripts/lcpd-grpcd logs

停止（graceful SIGINT）:

cd go-lcpd
./scripts/lcpd-grpcd down

​

疎通チェック

簡易チェック:

cd go-lcpd
./scripts/lcpd-grpcd status
tail -n 50 ./.data/lcpd-grpcd/logs/lcpd-grpcd.log

ポートレベルのチェック（どちらか）:

nc -vz 127.0.0.1 50051

lsof -nP -iTCP:50051 -sTCP:LISTEN

LCPD_GRPCD_GRPC_ADDR=127.0.0.1:15051 のように listen アドレスを変更した場合は、ポート番号も合わせてください。

​

ログとローテーションの挙動

• ログのリンクパス（デフォルト）: ./.data/lcpd-grpcd/logs/lcpd-grpcd.log（gitignored）
• PID ファイル: ./.data/lcpd-grpcd/pids/lcpd-grpcd.pid
• 起動ごとに日時付きのログファイルを作成します（例: lcpd-grpcd.YYYYmmdd-HHMMSS.<pid>.<rand>.log）。
• lcpd-grpcd.log は、現在の run のログファイルを指す symlink です。
• LCPD_GRPCD_LOG_KEEP_ROTATED 個の最新 run ログだけを保持します（デフォルト 10）。

​

Option B: systemd（Linux）

systemd でできること:

• クラッシュ時の自動再起動
• 起動時の自動起動
• journald による堅牢なログ保持

最小の user service 例（lnd の cert/macaroon が home 配下にある場合に推奨）:

1. ~/.config/systemd/user/lcpd-grpcd.service を作成:

[Unit]
Description=lcpd-grpcd (Lightning Compute Protocol daemon)
After=network-online.target

[Service]
Type=simple
WorkingDirectory=/ABS/PATH/TO/go-lcpd
ExecStart=/usr/bin/env direnv exec /ABS/PATH/TO/go-lcpd /ABS/PATH/TO/go-lcpd/bin/lcpd-grpcd -grpc_addr=127.0.0.1:50051
Restart=on-failure
RestartSec=2s
KillSignal=SIGINT

[Install]
WantedBy=default.target

2. 起動 + enable:

systemctl --user daemon-reload
systemctl --user enable --now lcpd-grpcd

3. ログ:

journalctl --user -u lcpd-grpcd -f

ログインしていない状態でも user service を動かし続けたい場合、以下が必要になることがあります:

loginctl enable-linger "$USER"

​

Option C: launchd（macOS）

launchd は macOS の service manager です。バックグラウンド + 自動再起動には LaunchAgent（ユーザーとして起動）を使います。

1. ~/Library/LaunchAgents/com.bruwbird.lcpd-grpcd.plist を作成（絶対パスは調整）:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>com.bruwbird.lcpd-grpcd</string>

    <key>ProgramArguments</key>
    <array>
      <string>/bin/bash</string>
      <string>-lc</string>
      <string>cd /ABS/PATH/TO/go-lcpd && exec direnv exec . ./bin/lcpd-grpcd -grpc_addr=127.0.0.1:50051</string>
    </array>

    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>

    <key>StandardOutPath</key>
    <string>/ABS/PATH/TO/go-lcpd/.data/lcpd-grpcd/logs/lcpd-grpcd.launchd.out.log</string>
    <key>StandardErrorPath</key>
    <string>/ABS/PATH/TO/go-lcpd/.data/lcpd-grpcd/logs/lcpd-grpcd.launchd.err.log</string>
  </dict>
</plist>

2. ロード:

launchctl bootstrap "gui/$UID" ~/Library/LaunchAgents/com.bruwbird.lcpd-grpcd.plist
launchctl enable "gui/$UID/com.bruwbird.lcpd-grpcd"
launchctl kickstart -k "gui/$UID/com.bruwbird.lcpd-grpcd"

3. ステータス確認:

launchctl print "gui/$UID/com.bruwbird.lcpd-grpcd"

補足:

• plist では direnv exec を使うことで、認証情報を plist に埋め込まずに済みます（.envrc に置く）。
• macOS はこれらのログファイルを自動ローテーションしません。newsyslog を使うか、定期的にアーカイブ/削除してください。