AQUA · mac-remote 2.0.5

iPhone から、自分の Mac の
ターミナルを安全に。

出先から Mac のコマンドを動かしたいときに。Mac で QR を出して iPhone で読むだけ。合言葉は打たず、通信は暗号化され、Mac で「許可」しない限り誰も入れません。

無料Mac のパスワード不要約1分で準備消すときもコマンド1つ

入れ方(コマンド1つ)

Mac の「ターミナル」を開いて、これを貼って Enter。説明が出て、1分ほどで準備が終わります。

/bin/bash -c "$(curl -fsSL https://www.aquallc.jp/mac-remote/install.sh)"

入るのは mac-remote 本体・Python・cloudflared(Cloudflare 社の公式ツール)です。すべて ~/.mac-remote の中だけに入り、決まった版だけをダウンロードして指紋を確かめます。

使い方

  1. ターミナルで yuatl と打つと、Mac に QR が出ます(インストールの最後に、そのまま起動もできます)。
  2. iPhone のカメラで QR を読みます。メールの確認を付けた人は、英語の画面でメールアドレスと届いた数字を入れます。
  3. iPhone と Mac に 6桁の番号 が出ます。同じなら Mac で「許可」、iPhone で「同じです」。
  4. iPhone にターミナルが出ます。使い終わったら「切断」。

守りの仕組み

合言葉を打たない

QR の中の使い捨ての合言葉(5分・1回だけ)。PIN の盗み見や総当たりが起きません。

Mac で許可・番号を見比べる

6桁の番号が両方で同じときだけ。QR を撮られても、割り込まれても、勝手には入れません。

中身は暗号化

つなぐたびに新しい鍵。通り道の Cloudflare にも中身は見えません。

Wi‑Fi からは入れない

Mac は外向きの入口を開けません。同じ Wi‑Fi の人も入れません。

自動で切れる

操作がないまま30分、または24時間で切れます。Mac の k、iPhone の「切断」でもすぐ切れます。

メールの確認(おすすめ)

知らない人はページにすら届きません。アドレスは Mac の中だけに保存し、AQUA には送りません。

更新は署名つき

yuatl update は AQUA の署名を確かめてから入れ替えます。古い版に戻されることもありません。

AQUA に何も送らない

使い方・コマンド・画面の中身を AQUA が受け取ることはありません。

コマンド

yuatl起動(n=新しい QR / k=iPhone を切断 / q=終了)
yuatl mail アドレスメールの確認を付ける(yuatl mail off で外す)
yuatl update署名を確かめて更新(Python・cloudflared もまとめて)
yuatl uninstall削除(~/.mac-remote と設定の1行を消します)

大切なこと

mac-remote は、Mac をあなたと同じ権限で操作できる道具です。QR や iPhone の画面を人に見せたり、写真で送ったりしないでください。AQUA や誰かが QR・番号を聞くことはありません。
iPhone はロックをかけて使い、使い終わったら「切断」を押してください。

分かっている限界

iPhone で開くページも Cloudflare を通って届くため、Cloudflare がページそのものを書き換えることまではブラウザでは防げません。端末から完全に切り離して動かしたプログラム(setsid など)や、sudo で動かしたプログラムは、切断しても止まらないことがあります。

以前の mac-remote を入れた方へ

GitHub から入れた古い版(~/mac-remote)には守りの弱いところがあります。上のコマンドで入れると、古い版をゴミ箱に移すか聞かれます。

指紋の確かめ方(任意)

インストーラーそのものを確かめたい方は、ダウンロードして指紋を見比べてから実行できます。

curl -fsSLo install.sh https://www.aquallc.jp/mac-remote/install.sh && shasum -a 256 install.sh

install.sh(2.0.5)の SHA-256:

b59bd603e416d55b4f7a006a84019cffbf9c603f1d32eefabd455f547829e769

一致したら /bin/bash install.sh で実行します。以後の更新は AQUA の署名(Ed25519)で自動的に確かめます。

動く環境

Apple シリコン(M1 以降)の Mac / iPhone の Safari(Intel の Mac には対応していません)。ネット接続が必要です。無料でお使いいただけますが、保証はありません。ご自身の責任でお使いください。

お問い合わせ:AQUA へのお問い合わせ