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

前提

check_circlex86_64（amd64）・arm64（Raspberry Pi など 64-bit ARM）・32-bit ARM（armv6/armv7＝Raspberry Pi の 32-bit OS や Luckfox Pico など）の Linux。エージェントはランタイム不要の静的単一バイナリで、CPU の種類はインストール時に自動判定されます
check_circle外向きの HTTPS（443 番）が通ること（受信ポートの開放・VPN は不要）
check_circleWireCanal のアカウントと canal（ダッシュボードで作成）

canal を作って、wirecanal.json をダウンロード

ダッシュボードで 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（arm64 は wirecanal-linux-arm64、32-bit ARM は wirecanal-linux-arm）をダウンロードして wirecanal という名前で置き、chmod +x wirecanal してください。

Raspberry Pi（Raspberry Pi OS の 64-bit / 32-bit どちらでも）や Luckfox Pico などの小型ボードでも、このページの手順がそのまま使えます。コマンドはすべて共通です。

起動する

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

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

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

常駐させる（systemd の雛形）

サーバーとして常駐させるなら、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）になります。

補足

update自動更新は最初から有効です

エージェントは新しい版が出ると自動で入れ替わります（配布物の署名を検証してから適用・更新に失敗しても直前の版へ自動で戻ります）。止めたい場合だけ wirecanal.json に "auto_update": false を書いてください。

lanプロキシ必須の社内ネットワークでは

wirecanal.json に "proxy_url": "http://proxy.example.co.jp:8080" のように 1 行足すだけで、外向きの接続がそのプロキシを経由します（環境変数のプロキシ設定は参照しません＝設定した値だけで動く、予測しやすい挙動です）。

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

無料で canal を作るセットアップガイドの一覧へ戻る