一条の neoserver:// リンクをクリックするだけで、NeoServer が自動的に起動し、サーバーに接続して、ターミナルを希望の位置に開きます—— それは特定のマシン、特定の tmux セッション、あるいは特定のディレクトリかもしれません。

Safari のブックマーク、メモ、ホーム画面のアイコン、Siri ショートカットに保存しても、同僚に AirDrop で送っても、すべて機能します。

一、ターミナルリンクの書き方

すべてのターミナルリンクは次のような形式です：

neoserver://terminal?host=<サーバー>&port=<ポート>&user=<ユーザー>&tmuxName=<tmuxセッション>&zellijName=<zellijセッション>&workdir=<ディレクトリ>

⚠️ tmuxName / zellijName / workdir は1つしか指定できません。複数指定した場合は、tmuxName が優先され、 次に zellijName、最後に workdir が認識されます。

以下を参考に、自分用に書き換えてください：

# 最もシンプル：host のみ指定
neoserver://terminal?host=1.2.3.4

# ポートとユーザーを指定
neoserver://terminal?host=1.2.3.4&port=2222&user=deploy

# 接続して直接 main という tmux セッションに入る
neoserver://terminal?host=1.2.3.4&user=root&tmuxName=main

# 接続して直接 dev という zellij セッションに入る
neoserver://terminal?host=1.2.3.4&user=root&zellijName=dev

# 接続して自動的にログディレクトリに cd する
neoserver://terminal?host=1.2.3.4&user=root&workdir=/var/log/nginx

二、接続後、ターミナルはどこで開くか

これがターミナルリンクの最も便利な点です——指定するパラメータによって、接続後にターミナルが開く位置が変わります：

なぜこの3つに分かれているのか？

• tmux / zellij セッション：ネットワーク切断、App の終了、別のスマートフォンへの切り替え後でも、セッションは維持され、プロセスは失われません。サーバーの tmux セッションを同僚と共有すれば、二人が同じ画面に入って一緒にトラブルシューティングができます。
• ディレクトリ：接続のたびに cd /opt/app/logs を打つより、リンクで直接そこに飛ばす方がはるかに便利です。

三、App 内でリンクをコピー（手書き不要）

手書きのリンクはミスが発生しやすいです。NeoServer では3箇所でワンクリックでコピーでき、コピー後にどこにでも貼り付けることができます。

1. 「このサーバー」のリンクをコピー

サーバー tab · サーバーリスト → いずれかのサーバーを左スワイプ → Copy Scheme Link

コピーされる内容：

neoserver://terminal?host=...&port=...&user=...

2. ターミナル quick モードでコピー

ターミナル tab · サーバーリスト（quick モード）→ いずれかのサーバーを長押し → Copy Scheme Link

3. 「このセッション」のリンクをコピー ⭐ 最も便利

ターミナル tab · セッションリスト → いずれかのセッションを長押し → Copy Scheme Link

このリンクは、「XサーバーのYセッションへの接続」をパッケージ化します：

• このセッションが tmux の場合 → 自動的に &tmuxName=... が付与されます
• このセッションが zellij の場合 → 自動的に &zellijName=... が付与されます
• 通常のセッション → host/port/user のみ

コピーに成功すると Link Copied とポップアップ表示され、リンクがクリップボードに保存されます。

💡 実行中の tmux セッション を長押ししてコピーし、同僚に送ってください。彼らが NeoServer で開くと、同じセッションに直接 attach します——二人が同じターミナル画面に入ることができます。

四、このリンクを開く方法

neoserver:// は iOS リンクプロトコルです。リンクをタップできる場所ならどこでも NeoServer を起動できます：

• Safari：アドレスバーに貼り付けて Enter キーを押すか、ブックマークに保存してタップします。
• メモ / リマインダー：アイテムとして保存し、タップするだけで直接アクセスできます。
• ショートカット：「URL を開く」アクションにリンクを入力 → Siri の音声、ホーム画面のアイコン、自動化に割り当て可能です。
• AirDrop：2台の iPhone 間でリンクを送信すると、相手がタップするだけで接続します。
• メール：リンクをテキストとして送信すると、相手が Safari にコピーして開くことができます。

📱 実機で初めて neoserver:// をタップすると、iOS が「NeoServer で開きますか？」と尋ねるので、承認すれば以降は尋ねられません。

五、3つの実用シナリオ

🏠 シナリオ 1：「本番 tmux への接続」をホーム画面のアイコンにする

毎日本番マシンの main tmux セッションに接続しなければならないとします。毎回 App を開く → サーバーを探す → 接続する → attach する代わりに、アイコンにしてしまいましょう：

1. App でこのサーバーのリンクをコピーし、手動で &tmuxName=main を追加します；
2. iOS の「ショートカット」を開く → 新規作成 → 「URL」アクションを追加し、このリンクを貼り付けます；
3. 「URL を開く」アクションを追加します；
4. 共有をタップ → ホーム画面に追加、「本番に接続」などの名前をつけ、アイコンを選びます。

以後、ホーム画面でこのアイコンをタップするだけで、NeoServer が自動的に接続し、main セッションに入ります。すべての操作がゼロになります。

🎙️ シナリオ 2：音声で接続

上記のショートカットを Siri に連携し、「Hey Siri、本番に接続」というフレーズを設定します。話しかけるだけでスマートフォンが自動的に接続します。

🤝 シナリオ 3：同僚にセッションを渡す

1. ターミナル · セッションリスト → このセッションを長押し → Copy Scheme Link；
2. 同僚に送信します（AirDrop / WeChat など何でも構いません）；
3. 相手が NeoServer で開く → 自動的に同じ tmux セッションに attach します。

（前提：相手の iPhone の NeoServer サーバーライブラリも、同じ host に接続できる必要があります。）

六、ターミナルリンクのよくある質問

Q：リンクをタップしたら、間違ったサーバーに接続されました？ A：NeoServer は host（+ 入力されていれば port + 入力されていれば user）でサーバーを検索します。ライブラリに同じ host を持つサーバーが2台ある場合、最初に一致したものに接続されます。port や user を入力することで正確に区別できます。

Q：ライブラリにそのサーバーがない場合、リンクをタップするとどうなりますか？ A：「新規サーバー」ページに移動し、host/port/user はすでに自動入力されています。パスワードまたは秘密鍵を入力して → 保存 → 自動的に接続 され、元のリンクに含まれるセッション / ディレクトリも同様に有効になります。

Q：リンクに直接パスワードを含めて、毎回入力する手間を省けますか？ A：できません。 これはセキュリティ上の制限です——リンクにパスワードが含まれることはありません。手動で password=xxx を追加しても無視されます。パスワードは App 内のキーチェーンのみを経由します。

Q：中国語やスペースを含むディレクトリを workdir に指定できますか？ A：できます。workdir=/home/me/my logs のようにそのまま入力してください。特殊文字は App が自動的に処理します。最も安全な方法は、手書きではなくApp のコピー機能を使うことです。

Q：タップしても反応がありません？ A：① neoserver:// で始まっていることを確認してください；② 初回は「NeoServer で開く」の確認画面が表示されます；③ host が空欄になっていないか確認してください；④ App がフォアグラウンドになくても問題ありません。自動的に起動します。

Q：Android / Windows で開けますか？ A：開けません。neoserver:// は NeoServer がインストールされている iPhone / iPad でのみ認識されます。

七、付録：通知センターを開く

ターミナルとは別に、通知センターを開くリンクもあります：

neoserver://notifications

ホーム画面の通知ウィジェットをタップしたときに実行されるのはこれです。