Linuxでのエージェントセットアップ

前提

• check_circlex86_64（amd64）の Linux。エージェントはランタイム不要の静的単一バイナリです
• check_circle外向きの HTTPS（443 番）が通ること（受信ポートの開放・VPN は不要）
• check_circleWireCanal のアカウントと canal（ダッシュボードで作成）

ダッシュボードで canal を作成し、canal 詳細の「セットアップ」タブから接続ファイルwirecanal.jsonをダウンロードします（スクリーンショットつきの手順は① canal を作成する）。 このファイルにはその canal 用の接続キーが入っています。

エージェントを置きたいディレクトリ（例/opt/wirecanal）で、次の 1 行を実行します。 そのディレクトリに実行ファイルwirecanalが配置され、バージョン表示まで自動で確認されます。

curl -fsSL https://download.wirecanal.com/install.sh | sh

手動で入れる場合はhttps://download.wirecanal.com/latest/wirecanal-linux-amd64をダウンロードしてwirecanalという名前で置き、chmod +x wirecanalしてください。

ダウンロードしたwirecanal.jsonを同じディレクトリに置いて、起動します。 接続キー入りのファイルなので、読み取りを本人だけに絞っておくのがおすすめです。

chmod 600 wirecanal.json
./wirecanal -config wirecanal.json

起動ログに「canal <ID>: https://<ホスト名> へのアクセスをローカルの転送先 <転送先> に届けます」と出れば開通です。 ダッシュボードの canal 詳細でも「接続されました！」に切り替わります。

サーバーとして常駐させるなら、OS 標準の systemd に任せるのが確実です。 以下は/opt/wirecanalに置いた場合の雛形です（パス・ユーザー名はお使いの環境に合わせて調整してください）。

[Unit]
Description=WireCanal Agent
After=network-online.target
Wants=network-online.target

[Service]
User=wirecanal
WorkingDirectory=/opt/wirecanal
ExecStart=/opt/wirecanal/wirecanal -config /opt/wirecanal/wirecanal.json
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo useradd --system --home /opt/wirecanal --shell /usr/sbin/nologin wirecanal
sudo chown -R wirecanal: /opt/wirecanal
sudo systemctl daemon-reload
sudo systemctl enable --now wirecanal
systemctl status wirecanal --no-pager

• check_circleOS 起動時に自動で開始し、止まっても 5 秒後に自動で再起動します（Restart=always）。
• check_circleログはjournalctl -u wirecanal -fで確認できます。
• check_circle自動更新を効かせるため、実行ユーザーがバイナリの置き場所へ書き込めるようにしておきます（上のchown）。書き込めない置き方でも動作はしますが、更新は手動（wirecanal update）になります。

補足

表示を英語にしたいときはwirecanal.jsonに"lang": "en"を 1 行足します。 うまくつながらないときは-verboseを付けて起動すると詳しい記録が出ます。接続キーの失効・再発行はダッシュボードからいつでもできます。これらを含む全オプション（複数 canal・タイムアウト・操作記録など）の解説はwirecanal.json 設定リファレンスにまとめています。