CLI リファレンス

SecurQbit コマンドラインクライアントの全 sqctl コマンド — サインイン、接続、国の選択、設定変更、更新、機械可読な出力まで。

sqctl は、ターミナルから SecurQbit を操作するための手段です。ローカルソケット経由でバックグラウンドサービスと通信します。認証情報は保持せず、それ自体に特権も不要です。まだ導入していない場合はデスクトップとルーターの設定から始めてください。

すべてのコマンドは --json を受け付け、整形された表示の代わりに生のドキュメントを出力します。スクリプトから使うべきなのはそちらです — 人向けのレイアウトは変わり得ます。

一覧

sqctl status                        VPN が有効か、どのアカウントか
sqctl login                         ブラウザーでリンクを承認してサインイン
sqctl logout
sqctl locations                     このプランで使える国
sqctl connect [COUNTRY] [--fastest]
sqctl disconnect
sqctl set                           設定を表示
sqctl set country DE|any
sqctl set autoconnect on|off
sqctl set updates on|off
sqctl update [--check] [--yes]      最新版をインストール

sqctl status

保護されているか、そしてどのアカウントかを表示します。

$ sqctl status
 
  ● Connected      Germany
    Connected for  12m 40s
    Transferred    ↓ 148 MB   ↑ 22 MB
 
    Account        Alice  [email protected]
    Plan           Monthly
    Renews         1 September 2026

トンネルの作り方に関することは意図的に一切表示しません — サーバーのアドレスもセッション識別子も出しません。どれもユーザーが対処できる情報ではありませんし、とりわけサーバーアドレスは、サポートを求めるときのスクリーンショットに紛れ込ませてよいものではありません。

サービスが動いていなければ、sqctl はその旨を伝え、init システムが何であれこの機器でサービスを起動するコマンドを表示します。

ブラウザーで承認することで、このコンピューターをサインインさせます。

$ sqctl login
 
Open this link to approve the sign-in:
 
    https://accounts.securqbit.com/device?code=BCDF-GHJK
 
Check the page shows this code:
 
    B C D F - G H J K
 
Waiting for approval — expires in 10 minutes, Ctrl-C to cancel

リンクを開き（sqctl が代わりに開こうとします。--no-browser でそれを止められます）、未サインインならサインインし、ページに表示されたコードがターミナルのものと一致することを確認して承認します。ターミナルに何かを打ち返す必要は一切ありません。

この照合こそが、この仕組みの安全性のすべてです。

自分で始めた要求だけを承認してください。 誰かからこの種のリンクを送られて承認すれば、相手のコンピューターをあなたのアカウントにサインインさせたことになります。ページに出るコードとマシン名は、まさにその違いに気づけるようにあります。

サインインには既存のアカウントが必要です。iOS または Android アプリで作成してください。ゲストアカウントも同じで、リカバリーコードで accounts.securqbit.com にサインインし、ほかと同様そこで承認します。

sqctl logout

VPN を切り、このコンピューターをサインアウトします。トンネルは先に落とされます。これは意図的です。失効した直後の認証情報でトンネルを張ったままにすると、サーバーが間もなく削除するセッションの上に通信が取り残されてしまうからです。

ゲストアカウントでは先に確認が入ります。リカバリーコードがないと再びサインインできないためです。--force でこの確認を省略できます。

sqctl connect

sqctl connect            # 保存された設定
sqctl connect DE         # ドイツから接続しているように見せる
sqctl connect --fastest  # SecurQbit に選ばせる

国は 2 文字のコードです — プランで使えるものは sqctl locations で確認できます。接続には数秒かかります。ターミナルは黙り込まず、実際の状態が変わるのに合わせて表示を追随させます。

トライアルでは国を選べません。 トライアルプランでは --fastest を使ってください。国を指定すると、黙って別の場所につなぐのではなく、有料プランが必要である旨のエラーが返ります。アカウントと請求を参照してください。

sqctl disconnect

トンネルを落とし、ルーティングと DNS を元の状態に戻します。

切断は同時に、SecurQbit に 止まれ と伝えることでもあります。トンネルが自然に切れた場合、サービスは復旧に向けて動き続けます — スリープから復帰したノート PC や、回線が不安定なルーターでは、それが望ましい挙動です。この意思を取り消すのは sqctl disconnect、サインアウト、サービスの停止だけです。

sqctl locations

プランで使える国を名前で一覧表示します。

$ sqctl locations
 
    DE             Germany
    FR             France
    NL             Netherlands
    SG             Singapore
    US             United States

sqctl set

設定を表示または変更します。3 つあり、それらは本当にユーザーが決めるべき 3 つです。

sqctl set                    # 3 つとも表示
sqctl set country DE         # 既定をドイツに
sqctl set country any        # 既定を最速に
sqctl set autoconnect on     # 機器の起動と同時に接続
sqctl set updates off        # 新しいバージョンを探すのをやめる

$ sqctl set
 
    Location       Germany (DE)
    Auto-connect   on
    Updates        on

トンネルに関するそれ以外のこと — どう構築するか、DNS に何を使うか、どう再試行するか — はすべて代わりに決めてあり、CLI からは触れません。選べるようにしたところで VPN が良くなる類の選択ではないからです。

updates が固定ではなく設定になっているのは、この確認が SecurQbit の CDN への定期的な通信だからです。VPN を運用する人には、それを断る権利があります。

sqctl update

最新版をインストールします。

sqctl update            # 確認したうえで導入し、再起動する
sqctl update --check    # 新しい版があるかどうかだけ伝える
sqctl update --yes      # 確認なし

$ sqctl update
 
  ! Update available
 
    Installed      v1.0.0
    Latest         v1.1.0
 
  SecurQbit restarts to finish, so the VPN disconnects for a moment.
 
Install it now? [y/N]

何かを置き換える前に、ダウンロードしたものが公開チェックサムと照合され、その後サービスが新しい版で再起動します。sqctl は復帰を待ってバージョンを読み取るので、ディスクに書かれた内容ではなく、実際に動いているものが報告されます。

SecurQbit は 1 日 1 回自分でも確認しますが、するのは知らせることだけです — sqctl status の下に 1 行:

    Update         v1.1.0 available — run: sqctl update

自分で導入することは決してありません。更新の完了には再起動が必要で、再起動すればその時つながっているトンネルが切れます。それを予告なく行うのは、1 バージョン遅れたままにしておくより悪いことです。

ディストリビューションのパッケージマネージャーで SecurQbit を入れている場合、sqctl update は何もダウンロードする前に処理を断り、導入したのと同じ方法で更新するよう案内します。

スクリプトから使う

どのコマンドでも --json を付ければ、プロトコルのドキュメントが出力されます。

$ sqctl status --json | jq '.state, .country'
"connected"
"DE"

# 接続し、本当に成功したかを確認する
sqctl connect --fastest --json > /dev/null
test "$(sqctl status --json | jq -r .state)" = connected

終了コード: 0 成功、1 コマンド失敗、2 SecurQbit サービスに到達できない。

うまくいかないとき

sqctl は失敗を、ユーザーが対処できる言葉に翻訳し、内部の事情は表に出しません。その内部の事情が必要なとき — 不具合報告のときなど — のために、隠しの診断コマンドがあります。

sqctl debug          # バージョン、各ファイルの場所、応答したソケット、
                     # トンネルのエンジン、直近のエラーの生データ
sqctl debug probe DE # 接続せずにサーバーをエンドツーエンドで試す

役に立つのは sqctl debug probe です。実際のサーバーに対してプロキシを起動し、そこへ 1 回リクエストを送り、相手側から見えたアドレスを報告します — ただしトンネルデバイスは作らず、ルーティングも変更しません。つまり、経路が機能しているかを教えてくれる一方で、機能していなくてもインターネット接続を失うことはありません。

問題を報告する際は sqctl debug の出力を添えてください。トラブルシューティングを参照してください。

次のステップ

デスクトップとルーターの設定 — 導入・更新・削除。
サーバーへの接続 — サーバー選択の仕組み。
ファイアウォール回避と難読化 — 制限のあるネットワークで。