ユーザガイド

Pockterm へようこそ

Pockterm とは何か、どう構成されているか

Pockterm は iPhone 向けの本格的な SSH クライアントです。サーバに接続し、対話型ターミナルを使い、SFTP でファイルを転送し、ポート転送のトンネルを設定できます。

下部のタブを使って、ホスト、スニペット、キーチェーン、ポート転送を切り替えます。

すべてがデバイス内に留まります。詳しくはあなたのデータとプライバシーをご覧ください。

ホストを追加する

接続できるサーバを作成します

ホストを作成する

• ホストタブで + をタップし、新規ホストを選びます。
• ラベル、アドレス（ホスト名または IP）、ポート（デフォルトは 22）を入力します。
• Pockterm がサインイン方法を判断できるよう、認証情報を選びます。まだない場合は、新規認証情報をタップします。
• 保存をタップします。

ホストの操作

• ホストをタップすると接続します。
• 左にスワイプすると、編集、お気に入りに追加、削除ができます。
• 右にスワイプしてファイルをタップすると、SFTP で閲覧できます。

認証情報と SSH 鍵

Pockterm のサインイン方法

認証情報は、ユーザ名と認証方法（パスワードまたは SSH 鍵）の組み合わせです。

鍵を生成する

• キーチェーンタブで + をタップし、Ed25519 鍵を生成… を選んで、鍵にラベルを付けます。
• Pockterm は Ed25519 の鍵ペアを作成し、秘密鍵を iOS のキーチェーンに保存します。
• 表示された公開鍵の行を、サーバの ~/.ssh/authorized_keys ファイルに追加します。

すでにある鍵を読み込む

• キーチェーンタブで + をタップし、既存の鍵を読み込む… を選びます。
• BEGIN 行と END 行を含め、秘密鍵ファイル全体を貼り付けてください。OpenSSH 形式の Ed25519 鍵と RSA 鍵に対応しています。
• または ファイルを選択… をタップして、“ファイル”から鍵を選びます。
• 鍵にパスフレーズが設定されている場合、Pockterm は一度だけ入力を求め、鍵と一緒にキーチェーンに保存します。

-----BEGIN RSA PRIVATE KEY----- で始まる鍵は古い PEM 形式です。ssh-keygen -p -f <file> で変換してから読み込んでください。鍵を変えずにファイルを書き換えます。

認証情報を作成する

• ホストのエディタで、新規認証情報を選びます。
• ユーザ名を入力し、パスワードまたは鍵を選びます。
• 鍵を選んだ場合は、登録済みの鍵から 1 つ選びます。

ターミナル

接続してセッションで作業する

ホストをタップしてターミナルセッションを開きます。

• キーボードの上のバーには、esc、ctrl、tab、矢印キーなどがあります。
• 複数のホストを同時に開けます。各セッションは上部のタブになります。名前をタップして切り替え、赤い ✕ で閉じます。
• スニペットボタンをタップすると、保存したコマンドをセッションで実行できます。

スニペット

再利用できるコマンドを保存して実行します

スニペットは、よく使うコマンドです。

• スニペットタブで + をタップし、ラベルを付けてコマンドを保存します。
• 接続中は、ターミナルのスニペットボタンをタップすると実行できます。
• ホストに起動スニペットを設定すると、接続時に自動的に実行されます。

グループ、お気に入り、検索

多くのホストを整理しておきます

• ホストメニューから、グループを管理を選びます。グループは入れ子にでき、グループのデフォルトの認証情報とポートは、その配下のホストに継承されます。
• ホストエディタで、ホストをグループに割り当てます。
• ホストをお気に入りに追加すると（左にスワイプ）、「お気に入り」セクションに固定されます。
• 下に引くと、ラベルやアドレスで検索できます。最近使ったホストは「最近」に表示されます。

ssh_config から読み込む

既存のホストを取り込みます

• ホストメニューから、ssh_config から読み込むを選びます。
• 設定のテキストを貼り付けるか、ファイルを選択をタップします。
• 検出されたホストを確認し、不要なものをオフにしてから、読み込むをタップします。

Pockterm は Host、HostName、User、Port の設定を読み取ります。ユーザ名ごとにパスワードの認証情報が作成されるので、あとから秘密の値を入力できます。

ファイルを転送する（SFTP）

ファイルを閲覧、ダウンロード、アップロードします

どのホストにも SFTP のファイルブラウザがあります。SFTP は同じ SSH 接続上で動くため、追加の設定は必要ありません。

ブラウザを開く

• ホストを長押しして、ファイルを見るを選びます。
• または、ホストのプロトコルを SFTP（ファイル）に設定すると、タップしたときにターミナルではなくブラウザが開きます。
• すでにセッション中ですか？ ターミナル上部のバーにあるフォルダボタンをタップします。

ファイルをダウンロードする

• ファイルを長押しして、ダウンロードを選びます。
• 共有シートで開くので、どこへでも送れます。保存するには“ファイル”に保存を選びます。iCloud Drive にも保存できます。

ファイルをアップロードする

• + をタップして、ファイルをアップロードを選びます。
• iPhone のファイル選択画面が開くので、iCloud Drive、「この iPhone 内」、その他「ファイル」内のどの場所からでも直接アップロードできます。
• ファイルは現在表示しているフォルダに置かれます。

ファイルを管理する

• ファイルを長押しすると、名称変更、アクセス権の変更、削除ができます。
• + をタップしてフォルダを作成します。下に引くと一覧を更新します。
• 上部の .. をタップすると、1 つ上の階層に移動します。

転送は分割して行われるため、大きなファイルでもメモリを使い切ることはありません。転送中は、パスバーに転送済みの量と全体のサイズが表示されます。

ポート転送

SSH 経由で接続をトンネルします

ポート転送は、ネットワーク接続を SSH サーバ経由で中継します。

• ローカル — デバイス上のポートが、サーバから到達できるホストへ転送します。
• リモート — サーバ上のポートが、あなたのデバイスへ転送し返します。
• ダイナミック — デバイス上の SOCKS5 プロキシが、各接続をサーバ経由で送ります。

転送を実行する

• ポート転送タブで + をタップして追加します。
• 行をタップすると編集できます。
• ▶ をタップして開始します。動作中かどうかは状態表示でわかります。停止するには ⏹ をタップします。

ホスト鍵を確認する

サーバを安全に信頼する

サーバに初めて接続するとき、Pockterm はその鍵のフィンガープリントを表示し、受け入れるかどうかを尋ねます。これは trust on first use と呼ばれます。

• フィンガープリントがサーバの管理者から知らされたものと一致する場合にのみ受け入れてください。
• 一度受け入れると鍵が記憶され、次回以降は確認されません。
• 後でサーバが異なる鍵を提示した場合、Pockterm は続行前に警告します。サーバが再構築されたか、何か問題がある可能性があります。

あなたのデータとプライバシー

すべてが保存される場所

Pockterm にアカウントはなく、接続に関するデータはデバイス内に留まります。

• ホスト、グループ、スニペット、転送はデバイス内に保存されます。
• パスワードと秘密鍵は iOS のキーチェーンに保存されます。
• 信頼したホスト鍵は、ホスト鍵を確認するで説明した警告のためにデバイス内に記憶されます。
• アシスタントとの会話はホストごとに 1 つずつデバイス内に保存されるため、再接続してもチャットはそのまま残ります。削除するには、アシスタント内のゴミ箱をタップします。

AIアシスタントだけは例外です。使用すると、関係するターミナルの出力（および添付したファイル）が、設定したモデルプロバイダ（Anthropic、OpenAI、OpenRouter、Hugging Face）へ、あなた自身の API キーを使って送信されます。アシスタントを使うまで何も送信されず、キーは iOS のキーチェーンに保存されます。そのデータの取り扱いについては、プロバイダのプライバシーポリシーをご確認ください。