WebSSH

iOS/iPad向けタッチフレンドリーなWebベースターミナル。tmuxやClaude Codeなどのフルスクリーンアプリケーションに対応。

特徴

- タッチ操作対応: ハードウェアキーボードなしでも操作可能
- 特殊キーボタン: Ctrl, Alt, Esc, Tab, Enter, 矢印キー等
- tmuxサポート: tmux操作用のクイックボタンパネル
- 日本語入力: テキスト入力モーダルで長文入力に対応
- 自動コマンド実行: 接続時に指定コマンドを自動実行
- xterm.js: フル機能のターミナルエミュレーション

インストール

$3

``bash npm install -g webssh-terminal`

`$3`

`bash git clone https://github.com/shi3z/webssh.git cd webssh uv sync`

`使い方`

`$3`

`bash webssh webssh -p 8080 # ポート指定 webssh -c /path/to/config.json # 設定ファイル指定`

`$3`

`bash uv run python main.py`

ブラウザで http://<サーバーIP>:8765/ にアクセス。

`設定`

config.json で設定可能:

`json { "startup_command": "tmux a || tmux new", "shell": "/bin/bash", "port": 8765 }`

| 設定 | 説明 | デフォルト | |------|------|------------| |startup_command | 接続時に自動実行するコマンド | tmux a \|\| tmux new| |shell | 使用するシェル | /bin/bash| |port | 待ち受けポート | 8765 |

`コントロールパネル`

`$3`


- Ctrl / Alt: モディファイアキー（トグル）
- Esc / Tab / Enter: 特殊キー
- 矢印キー: カーソル移動
- Home / End / PgUp / PgDn: ナビゲーション
$3

- ^C: 中断 (Ctrl+C)
- ^D: EOF (Ctrl+D)
- ^Z: サスペンド (Ctrl+Z)
$3

tmux

ボタンで展開:
- c: 新規ウィンドウ
- n / p: 次/前のウィンドウ
- d: デタッチ
- % / ": 縦/横分割
- o: ペイン切替
- z: ズーム
- [: コピーモード
$3

Text`ボタンで入力モーダルを開き、長文や日本語をペーストしてターミナルに送信。

要件

- Python 3.10+
- FastAPI
- uvicorn
- websockets

ライセンス

MIT

特徴

設定

config.json で設定可能:

json
{
    "startup_command": "tmux a || tmux new",
    "shell": "/bin/bash",
    "port": 8765
}

| 設定 | 説明 | デフォルト |
|------|------|------------|
|

startup_command | 接続時に自動実行するコマンド | tmux a \|\| tmux new

|
|

shell | 使用するシェル | /bin/bash

|
|

port | 待ち受けポート | 8765 |

コントロールパネル

$3

- Ctrl / Alt: モディファイアキー（トグル）
- Esc / Tab / Enter: 特殊キー
- 矢印キー: カーソル移動
- Home / End / PgUp / PgDn: ナビゲーション

$3

- ^C: 中断 (Ctrl+C)
- ^D: EOF (Ctrl+D)
- ^Z: サスペンド (Ctrl+Z)

$3

ボタンで展開:
- c: 新規ウィンドウ
- n / p: 次/前のウィンドウ
- d: デタッチ
- % / ": 縦/横分割
- o: ペイン切替
- z: ズーム
- [: コピーモード