Relayium を常時稼働の受信サービスとして実行する

最終更新: 2026-08-06

relayium serve --once は1回の受信を処理して終了します——たまに1回だけ pull する用途には十分です。しかし、あるマシンを常駐の受け皿にしたい場合——毎晩バックアップが届くホームサーバー、CI がビルド成果物をプッシュするビルドマシン、スマートフォンからいつでも写真を送れる NAS——には、毎回手動で起動するのではなく、serve をずっと動かし続けたいはずです。

本ガイドでは、長時間稼働するリスナーの起動、誰にプッシュを許可するかの承認、端末の前に誰もいない場合のためのピア事前承認、systemd 下での実行、そして sync --delete を使う送信側に削除をミラーさせる方法を扱います。

始める前に

以下はすべて relayium CLI なので、未インストールならまず入れてください。macOS または Linux では、1つのコマンドでビルド済みバイナリが PATH に入ります：

curl -fsSL https://relayium.com/install.sh | sh

• 自分でファイルを選びたい、または Windows の場合は、リリースページからバイナリを取得してください——relayium.com/cli にすべてのインストール方法があります（Go があれば go build -o relayium ./cmd/relayium も可）。
• relayium --version でインストールを確認できます。これをしないと以下のコマンドは「command not found」と出るだけです。

リスナーを起動する

serve は証明書ピンニング付き TLS 1.3 接続上でデーモン直結のプッシュ(relayium://host:port)を待ち受け、受け取った内容をあるディレクトリへ書き込みます。起動するのに事前共有は何も必要ありません——コピーしておくフィンガープリントも、登録しておくサーバーもありません:

relayium serve --dir ~/inbox
relayium serve --dir /srv/drop --port 9040   # デフォルト以外のポート
relayium serve --dir ~/inbox --allow-delete  # sync --delete を使う送信側に削除をミラーさせる

1. ファイルの着地先を決めて、リスナーを起動します。ここまでに事前共有が必要なものはありません。

   relayium serve --dir ~/inbox

2. 送信側のマシンから、relayium:// アドレスでこのホストに向けて push します。

   relayium push ./report.pdf relayium://drop.example.com:9031

3. 受信側に戻り、承認プロンプトに答えます。y と答えるとそのフィンガープリントが authorized_fingerprints に書かれ、以降の同じマシンからの push では二度と尋ねられません。

4. ファイルが serve を起動したディレクトリではなく、--dir に実際に届いたことを確認します。

   ls -l ~/inbox

$ relayium serve --dir ~/inbox
no authorized peers yet — you'll be asked to approve each new peer on its first push.
Incoming push from 203.0.113.7:54021
  fingerprint: 74318e3b…
Accept and remember this peer? [y/N] y

• --dir はファイルの置き場所を設定します(デフォルトはカレントディレクトリ)。
• --port は待ち受けポートを設定します(デフォルトは 9031)。送信側が別の場所にいる場合はファイアウォールで開放してください。
• --once を付けなければ、serve は停止させるかプロセスマネージャーが再起動するまで動き続け、プッシュを受け入れ続けます——これが常時稼働サービスたる所以です。

誰にプッシュを許可するか承認する

新しいピアが初めてプッシュすると、serve がターミナルで動いていれば、そのプッシュがどこから来たか、フィンガープリントは何かを表示し、承認するかどうかを尋ねます——SSH が初めての接続先を尋ねるのと同じ要領です:

Incoming push from 203.0.113.7:54021
  fingerprint: 74318e3b…
Accept and remember this peer? [y/N] y

• 一度 y と答えれば、そのフィンガープリントは authorized_fingerprints に書き込まれます。以降、同じマシンからのプッシュはプロンプトなしで通過します。
• フィンガープリントはネットワークアドレスではなくマシンそのものを識別するため、送信側の IP が変わっても有効です。
• この手順は設計上、対話的です——キーボードの前に誰かが必要ですが、serve が systemd に移行すると(次の項目)それは成り立たなくなります。

非対話的な環境のためにピアを事前承認する

serve がプロンプトを出せる端末を持たない場合——systemd サービス、バックグラウンドプロセス、パイプなど——尋ねることができないため、まだ認識していないフィンガープリントはすべて拒否します。代わりに事前にピアを承認しておきます。プッシュする側のマシンで relayium id を実行してフィンガープリントを表示し、受信側では最初のプッシュが届く前にそれを追加します:

# プッシュする側のマシンで: フィンガープリントを表示する
relayium id

# この常時稼働の受信側で: 事前に承認しておく
relayium authorize 74318e3b...

1. push する側のマシンでフィンガープリントを表示します。64桁の16進数で、アドレスではなくそのマシンを識別します。

   relayium id

2. この受信側で承認します。サービスが動くときと同じ --config-dir を使ってください。別のユーザーで実行したり、ユニットが別のパスを使っているのに既定のパスで承認したりすると、フィンガープリントはサービスが決して読まないファイルに書かれます。

   relayium authorize 74318e3b… --config-dir /etc/relayium

• authorize は冪等です——すでに信頼しているフィンガープリントに対して再度実行しても何も起きません。
• アイデンティティと信頼のファイルは --config-dir で指定したディレクトリにあり、デフォルトは ~/.config/relayium です(id.key/id.crt はこのホストのアイデンティティ、authorized_fingerprints はピアの許可リスト)。

systemd の下で実行する

再起動やクラッシュをまたいで生き残るサービスにするには、serve を systemd に任せます。--config-dir を固定パスに向けて、ホストのアイデンティティとピア許可リストが再起動をまたいでも維持されるようにします:

# /etc/systemd/system/relayium-serve.service
[Unit]
Description=Relayium always-on receiver
After=network-online.target

[Service]
ExecStart=/usr/local/bin/relayium serve --dir /srv/drop --port 9031 --config-dir /etc/relayium --allow-delete
Restart=always
User=relayium

[Install]
WantedBy=multi-user.target

1. サービスを作る前に、push を許すピアをすべて承認しておきます。サービスはプロンプトを出せないため、すでに信頼されていないものはすべて拒否されます。

2. 上のユニットファイルを /etc/systemd/system/relayium-serve.service に書きます。--config-dir は、いま承認に使ったのと同じ固定パスを指すようにします。

3. systemd を再読み込みしてサービスを起動し、再起動後も戻るよう有効化します。

   sudo systemctl daemon-reload

   sudo systemctl enable --now relayium-serve

4. 動作していること、そして「すべて拒否」の警告がログにないことを確認します。この構成に固有なのは後者だけです。

   systemctl is-active relayium-serve

   journalctl -u relayium-serve -n 20 --no-pager

$ systemctl is-active relayium-serve
active
$ journalctl -u relayium-serve -n 20 --no-pager | grep -c 'all pushes will be rejected'
0

• このサービスを有効化する前に、プッシュを許可すべきすべてのピアに対して relayium authorize <fingerprint> を実行しておいてください——サービス自体はプロンプトを出せません。
• systemctl enable --now relayium-serve で起動し、起動のたびに復帰するようにします。
• /etc/relayium/id.key のパーミッションはちょうど 0600 でなければならず、所有者はユニットの User= です。それ以外は relayium が拒否します——0400 も含まれるので、0600 より厳しくすることも、誰でも読める状態にしておくことと同じくらい確実にサービスを止めます。

macOS で起動時に実行する (launchd)

macOS に systemd はありません——サービスマネージャーは launchd です。Mac 上で serve を動かし続けるには(受け取り口として常時稼働させる Mac mini など)、LaunchDaemon としてインストールし、誰もログインしていない起動時から開始させます。UserName を設定して root ではなく自分のユーザーとして実行し、--dir と --config-dir には絶対パスを指定して、アイデンティティと信頼のファイルが自分の ~/.config/relayium に残るようにします:

<!-- /Library/LaunchDaemons/com.relayium.serve.plist  (replace YOU with your macOS username) -->
<?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.relayium.serve</string>
  <key>UserName</key>           <string>YOU</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/relayium</string>
    <string>serve</string>
    <string>--dir</string>         <string>/Users/YOU/inbox</string>
    <string>--port</string>        <string>9031</string>
    <string>--config-dir</string>  <string>/Users/YOU/.config/relayium</string>
    <string>--allow-delete</string>
  </array>
  <key>RunAtLoad</key>   <true/>
  <key>KeepAlive</key>   <true/>
  <key>StandardOutPath</key>    <string>/Users/YOU/relayium-serve.log</string>
  <key>StandardErrorPath</key>  <string>/Users/YOU/relayium-serve.log</string>
</dict>
</plist>

# 1) authorize each pusher first — launchd gives serve no terminal to prompt on:
relayium authorize <fingerprint>     # get the fingerprint from the pusher's  relayium id

# 2) save the plist above to that path, then load it (root-owned, starts at boot):
sudo chown root:wheel /Library/LaunchDaemons/com.relayium.serve.plist
sudo launchctl bootstrap system /Library/LaunchDaemons/com.relayium.serve.plist

# check it's running / follow logs / stop it:
sudo launchctl print system/com.relayium.serve | grep state
tail -f ~/relayium-serve.log
sudo launchctl bootout system/com.relayium.serve

• launchd は serve にターミナルを与えないため、プロンプトを出せません——systemd のときと同様に、各プッシュ元について先に relayium authorize <fingerprint> を実行してください。フィンガープリントはそのマシンの relayium id から得られます。
• KeepAlive は serve がクラッシュしたときに再起動します。RunAtLoad と /Library/LaunchDaemons 内の LaunchDaemon を組み合わせれば、ログインなしで起動時に開始します——ヘッドレスの Mac mini にぴったりです。
• ログイン時だけ動くサービスにしたい場合は、同じ plist(UserName キーは削除)を ~/Library/LaunchAgents/ に置き、launchctl bootstrap gui/$(id -u) <path> で読み込みます——起動時ではなくログイン時に開始します。
• macOS のアプリケーションファイアウォールが有効な場合は、relayium の受信接続を許可してください(システム設定 → ネットワーク → ファイアウォール)。そうしないと、待ち受けポートへのプッシュがブロックされます。

sync --delete を使う送信側に削除をミラーさせる

デフォルトでは serve はファイルの追加・更新しか行いません——送信側が sync --delete を実行しても、新規・変更ファイルはコピーされますが、要求された削除はスキップされ、受信側に警告がログ出力されます。真のミラーリングを有効にするには --allow-delete を付けて serve を起動します。これにより送信側で削除されたファイルはこちらでも削除されます:

relayium serve --dir /srv/mirror --allow-delete

• --allow-delete は受信側で有効にするオプトインです。送信側は引き続き sync --delete で削除を要求する必要があります。
• このオプションを付けなければ、送信側が何を要求しても、このマシン上のファイルが削除されることはありません。

うまくいかないとき

この5つのうち4つは、サービスが動いたまま健全に見えます——すべてを拒否するリスナーもまたリスナーです。どれにも、読めば分かる1行か、実行すれば決着がつくコマンドがあります。

よくある質問

serve はデフォルトでどのポートを待ち受けますか?

9031 です。リスナー側(serve --port N)と送信側の宛先(relayium://host:N)の両方を --port で変更できます。

すべてのプッシュを手動で承認する必要がありますか?

あるフィンガープリントの最初のプッシュだけです。しかもそれは serve が端末付きで動いているときだけ表示されます。それ以降は記憶されます。serve を非対話的(systemd、パイプ)に動かす場合、プロンプトはまったく出ず未知のピアは拒否されます——その場合は relayium authorize で事前に承認してください。

送信側は私の常時稼働の受信機上のファイルを削除できますか?

serve を --allow-delete 付きで起動し、かつ送信側が sync --delete を実行している場合に限ります。--allow-delete がなければ削除は静かにスキップされ、それ以外は通常どおり転送されます。

常時稼働の受信サービスを動かすのは無料ですか?

はい。relayium serve は無料でセルフホスト可能な CLI の一部です——接続のどちら側もアカウントは不要で、有料プランもありません。

serve はアイデンティティとピアリストをどこに保存しますか?

デフォルトでは ~/.config/relayium です(id.key/id.crt はこのホストのアイデンティティ、authorized_fingerprints は許可リスト)。systemd サービスの場合は --config-dir を /etc/relayium のような固定の場所に向けてください。

macOS で起動時に serve を実行するには?

macOS に systemd はありません——launchd を使います。serve を /Library/LaunchDaemons に LaunchDaemon としてインストールする(起動時に開始。UserName を設定して自分のユーザーとして実行)か、~/Library/LaunchAgents に LaunchAgent としてインストールします(ログイン時に開始)。このガイドには編集してすぐ使える plist があります。Homebrew サービスはありません。launchd は serve にプロンプト用のターミナルを与えないため、先に relayium authorize でプッシュ元を事前認可してください。

続けて読む

• コマンドラインでファイルを受信する
• 常時稼働する Linux サーバーに Device Inbox を設定
• Relayium CLI でサーバー間転送（デーモン直結）
• cron で暗号化されたサーバーバックアップを自動化する
• Relayium