Zao SDK / libzao-endpoint API リファレンス 2.0.1.0 (2025-09-01)
Loading...
Searching...
No Matches
ZaoIpProxyTun の使用方法

ZaoIpProxyTun は IP トンネリングを実現するために、TUN とクラウド側を接続するプログラムです。

■ ビルドと導入

ビルド方法にしたがって app/ip-proxy-tun/ でビルドすると ZaoIpProxyTun が得られます。

■ コマンドラインオプション

ZaoIpProxyTun [<options...>]
  • -i <device> : 接続する TUN デバイス
    • 省略時は tun0 となります。
  • --link-path=<path> : 連携用パスの指定 (SDK 1.6 から短いオプション(-p)は廃止されました)
    • ZaoRemoteEndpoint との連携に用いるパスを指定します。
    • 省略時は unix:///run/zao/RemoteEndpoint.sock となります。
  • -l <level> または --log-level=<level> : ログ出力レベルの指定
    • LEVELには trace, debug, info, warning, error, critical, off または、その頭文字である T, D, I, W, E, C, O (大文字)が指定できます。
    • デフォルトは info となります。
  • --log-color : ログへの色付けを有効にします。
  • --log-no-color : ログへの色付けを無効にします。
    • デフォルトでは、出力先が端末(tty)か否かに基づき自動で色の有無を決定します。
  • --log-output=<output> : ログの出力先。
    • stdout, stderr, syslog, null のいずれかを指定します。
    • デフォルトは stderr となります。
  • --syslog-ident=<name> : syslog出力時のident名称。
  • --syslog-facility=<name_or_number> : syslog出力時のfacilityコード。
    • alert 等の文字列か、0~23の数値でfacilityを指定します。
  • -v または --verbose : verbose 指定
    • -l/--log-level によるログレベルを1段階詳細な方に引き上げるのと同等です。
  • -h または --help : コマンドラインオプションに関するヘルプを表示して終了します。

■ 自動実行

systemd の zao-ip-proxy-tun.service から ZaoIpProxyTun が起動されます。 SDK セットアップ直後のデフォルト状態は無効化状態です。 有効化する場合は、関連サービス zao-ip-proxy-tun-prepare.service も有効化する必要があります。

zao-ip-proxy-tun.service が /etc/zao/IpProxyTun.conf を読み込み ZaoIpProxyTun へオプション指定する形になっています。

■ 手動実行

systemd service としてではなくターミナルから直接実行する場合についてです。

  • 関連サービス zao-ip-proxy-tun-prepare.service が実行済みである必要があります
  • zao group に属しているアカウントから実行する必要があります
  • ZaoIpProxyTun 自身は /etc/zao/IpProxyTun.conf を参照しませんので、コマンドラインオプションでデバイス指定等を行う必要があります
  • 取り込みと送信を止めるには Ctrl-C を入力します