マニュアル

1. どれを入れるか

使い方が 3 通りあります。まず自分がどれをやりたいのかを選んでください。 迷ったら Portable です。サービス登録も管理者権限も要らず、 起動すればすぐ動きます。

三つの部品

Windows ではいずれも .exe が付きます。実行ファイルは GitHub Releases から入手してください。ソースからビルドする場合は BUILD.ja.md を参照してください（ビルド後の手順は配布バイナリと同じです）。

2. Portable をすぐ試す

Portable は単体で UDP 514 を待ち受ける GUI です。 展開して起動し、テスト送信して行が増えれば成功です。

2.1 Windows

vlt-syslogd-portable-windows-v0.4.0.zip を展開し、 vlt-syslogd-portable.exe をダブルクリックします。 SmartScreen の警告が出たら「詳細情報」→「実行」を選んでください。 Windows には特権ポートの概念が無いので、514 の待ち受けに管理者権限は要りません。

$u = New-Object System.Net.Sockets.UdpClient
$b = [Text.Encoding]::UTF8.GetBytes('<132>auth: 認証に失敗しました')
$u.Send($b, $b.Length, '127.0.0.1', 514) | Out-Null; $u.Close()

2.2 macOS

vlt-syslogd-macos-portable-v0.4.0.dmg を開き、 vlt-syslogd-portable.app を取り出して起動します。 macOS 版は ad-hoc 署名（公証なし）のため、初回は Gatekeeper に止められます。 右クリック →「開く」を一度行うか、隔離属性を外してください。

xattr -dr com.apple.quarantine vlt-syslogd-portable.app

printf '<34>Oct 11 22:14:15 myhost myapp: hello' | nc -u -w1 127.0.0.1 514

2.3 Linux

単一の ELF バイナリです。実行権限を付けて起動します。 514 は特権ポートなので、bind に失敗する場合は root で実行するか CAP_NET_BIND_SERVICE を付与してください。

chmod +x vlt-syslogd-linux-x86_64-portable-v0.4.0
./vlt-syslogd-linux-x86_64-portable-v0.4.0

GUI の表示には CJK フォントが必要です。入っていないと日本語が □（豆腐）になります。fonts-noto-cjk 等を入れてください。

3. 画面の見かた

3.1 5 つの列

Filter 欄に文字を入れると、本文とタグを対象に絞り込みます。 Auto-scroll を外すと最新行への追従が止まるので、 流れているログの中で 1 行を読みたいときに使ってください。 🗑 Clear は表示中の行を捨てます（保存済みのログファイルは消えません）。

行を右クリックすると Copy Message（復号後の本文）と Copy as Hex（届いた生のバイト列）を取り出せます。 表示がおかしいと思ったときは Hex を見れば、 送信側とこちらのどちらの問題かが切り分けられます。

3.2 Enc 欄の読み方

文字コードの判定は通信全体ではなく 1 通ごとに行います。 同じポートに Shift_JIS の機器と UTF-8 の機器が混ざっていても構いません。

3.3 環境設定

ファイル(File) メニュー 環境設定のほか、ログの保存先フォルダを OS のファイルマネージャで 開く項目があります。macOS ではアプリメニュー側に入ります。

ファイル(File) → 環境設定… 待ち受けポートとログの保存先だけの設定です。 「適用」を押すと待ち受けし直します。 全体を開く

起動時の bind の成否は、ログ一覧の 1 行目にそのまま出ます （Listening on 0.0.0.0:514 (UDP)）。 514 が他のプロセスに使われていて失敗した場合は、 ここで 1024 番以上のポートに変えてください。送信側も同じポートに合わせます。

GUI 版の待ち受けアドレスは、環境変数 VLT_SYSLOGD_BIND でも上書きできます （例: VLT_SYSLOGD_BIND=0.0.0.0:5514）。

4. Server を常駐させる

Server は画面を持たない常駐プログラムです。 同梱のインストールスクリプトが「実行ファイル配置 → データフォルダ作成 → サービス登録 → 起動」までを行います。管理者権限が要るのは インストール時の 1 回だけで、以後は OS の起動時に自動で立ち上がります。

4.1 Windows サービス

管理者として実行した PowerShell から:

cd Server
powershell -ExecutionPolicy Bypass -File .\install-windows.ps1

PowerShell スクリプトは CP932 での文字化けを避けるため、 意図的に ASCII のみで書かれています。日本語の説明はこのページにあります。

4.2 macOS / launchd

cd Server
sudo ./install-macos.sh

LaunchDaemon は root で動くため、514 を bind できます。 インストール時に管理者認証を求められるのはこのためです。

4.3 Linux / systemd

cd Server
sudo ./install-linux.sh

514 を開くため、ユニットは既定で root で動きます。 非 root で動かしたい場合は、ユニットファイル内に専用ユーザー ＋ AmbientCapabilities=CAP_NET_BIND_SERVICE のコメントヒントがあります。

5. 設定ファイル

Server は初回起動時にデータフォルダへ config.toml を自動生成します。 既定のままで動くので、ポートやネットワークを変えたいときだけ触ってください。

[server]
bind_addr    = "0.0.0.0:514"        # syslog 受信 (UDP)
stream_addr  = "127.0.0.1:5141"     # Console への配信 (TCP)
control_addr = "127.0.0.1:5142"     # 制御チャネル (TCP)

[logging]
level        = "info"
max_size_mb  = 10
keep_files   = 7

変更したらサービスを再起動するか、Console の サーバへ適用(再起動) を使ってください。 データフォルダの場所は環境変数 VLT_SYSLOGD_DATA_DIR で上書きできます（テスト用）。

6. ネットワークとファイアウォール

3 つのポートは意図的に公開範囲を変えてあります。

配信と制御のチャネルは、どちらも共有トークン （<データフォルダ>/control.token、 インストーラが管理ユーザー所有・0600 で生成）で保護されています。 同一マシンの Console はそのまま接続でき、他の非特権ユーザーは接続できません。

別マシンから Console を繋ぐ

SSH トンネル経由を推奨します。直接到達できるアドレスに変更する場合は、 Server 側で環境変数 VLT_SYSLOGD_ALLOW_NONLOOPBACK を設定する必要があります（設定しない限り、非ループバックの stream_addr / control_addr は拒否されます）。 そのうえで Console の環境設定「制御トークン」に、 サーバの control.token の値を貼り付けてください。

ファイアウォール

Windows（管理者 PowerShell）:

New-NetFirewallRule -DisplayName "vlt-syslogd 514/udp" -Direction Inbound -Protocol UDP -LocalPort 514 -Action Allow

macOS のアプリケーションファイアウォールはポートではなくアプリ単位で フィルタします。プロンプトで vlt-syslogd-srv の着信接続を許可するか、システム設定 → ネットワーク → ファイアウォール → オプションから追加してください。

7. Console を使う

Console はサービスにする必要はありません。実行ファイルを開くだけです。 初回起動後、⚙ 設定 を開いて接続先が Server と一致しているか確認します。

• 配信アドレス → Server の stream_addr（既定 127.0.0.1:5141）
• 制御アドレス → Server の control_addr（既定 127.0.0.1:5142）

Console の環境設定 上半分が Console 自身の接続先、下半分が Server の設定です。 下半分は「現在値を取得」で Server から読み出し、 「サーバへ適用(再起動)」で書き戻します（サービス登録済みのときだけ有効）。 原寸で開く

画面上部の ● 受信中 が緑なら配信チャネルが繋がっています。 サービス操作 の開始 / 停止 / 再起動は、Server が同梱の インストーラでサービス登録されているときに動作します。

• Windows では UAC、macOS では パスワード / Touch ID のダイアログが出ます。承認すると続行します。
• サービス未登録のときは、操作は分かりやすいメッセージで即座に失敗します。 設定の保存自体は成功し、再起動だけがスキップされます。

8. 動作確認

1. サービスが稼働しているか（プロセスの有無ではなく、サービスとして）:

   sc.exe query vlt-syslogd-srv                                   # Windows
   sudo launchctl print system/com.veltrea.vlt-syslogd-srv        # macOS
   systemctl status vlt-syslogd-srv.service                       # Linux

2. 待ち受けているか:

   Get-NetUDPEndpoint -LocalPort 514                              # Windows
   lsof -nP -iUDP:514                                            # macOS / Linux

3. ローカルから 1 通投げて、Console に出るか:

   printf '<34>Oct 11 22:14:15 myhost myapp: hello' | nc -u -w1 127.0.0.1 514

   状態インジケータが緑（● 受信中）になり、表に行が増えれば OK です。

4. リモート機器から送る場合のみ — ネットワーク上の別ホストから 届くかを確かめます。届かないときは bind_addr、ファイアウォール、送信側の宛先 IP の順に確認してください。

9. アンインストール

cd Server; powershell -ExecutionPolicy Bypass -File .\uninstall-windows.ps1   # Windows（管理者）
cd Server && sudo ./uninstall-macos.sh                                       # macOS
cd Server && sudo ./uninstall-linux.sh                                       # Linux

サービスを停止・解除し、配置した実行ファイルを削除します。 設定とログはデータフォルダに残します。 完全に消したい場合はデータフォルダ（§11）を 手で削除してください。Portable はインストールしていないので、 ファイルを捨てるだけです。

10. 困ったとき

11. 識別子とパスの一覧

環境変数

さらに詳しい構成は 構成リファレンス に、OS 別の詳細手順は DOCS/ にあります。