porterminal v1.0.6
Быстрый и грязный веб/MCP туннель терминала для вашего телефона и ПК
Передайте компьютер агенту, полный контроль, и наблюдайте за ним.
Одна команда, один URL. (А также удобный терминал для вашего собственного телефона.)
1. uvx ptn
2. Передайте URL ИИ-агенту или отсканируйте QR-код сами
3. Наблюдайте за его работой в любом браузере и перехватывайте управление в любой момент
[!WARNING] Этот полный URL — это полный доступ к данному компьютеру. Он содержит случайный код доступа, создаваемый при каждом запуске, и любой (или любой ИИ-агент), кому вы его передадите, получит настоящую оболочку на вашей машине. Относитесь к URL и QR-коду как к секрету, делитесь ими только с теми людьми и агентами, которым доверяете, и прочитайте раздел Безопасность, прежде чем направлять Porterminal на что-либо важное.
Зачем
Мне нужно что-то опасно простое для удалённого доступа к компьютеру.
ngrok требует регистрации, а бесплатный тариф никуда не годится. Cloudflare Tunnel — отличная инфраструктура, но сам по себе он даёт только туннель, а не удобный для телефона терминал. Tailscale отлично работает, когда вы владеете обоими концами, но он всё равно означает подключение устройств к частной сети. Termius требует сложной настройки: проброс портов, правила брандмауэра, управление ключами...
Поэтому я сделал кое-что попроще: запустите команду, отсканируйте QR-код, начните печатать.
А потом меня осенило: тот же приём (одна команда, один URL) — это самый простой способ дать ИИ-агенту настоящий терминал на любом компьютере. Никакого MCP-сервера писать не нужно, никаких SSH-ключей, никакого Docker, никакой конфигурации. Запустите uvx ptn, передайте URL — и агент выполняет команды, читает экран и отвечает на запросы на этой машине. А поскольку это веб-терминал, вы можете открыть ту же сессию в любом браузере, чтобы наблюдать за его работой в реальном времени, или перехватить клавиатуру и взять управление на себя.
Возможности
- Передайте компьютер агенту, полный контроль, и наблюдайте за ним — Дайте ИИ-агенту URL, и он получит настоящий терминал на машине через MCP или обычный REST. Откройте ту же сессию в любом браузере, чтобы наблюдать за его работой в реальном времени, и перехватывайте клавиатуру, когда захотите. Никаких ключей, никакого Docker. Агент узнаёт, как это делать, из
<url>/llms.txtи<url>/.well-known/mcp.json. См. Доступ агента. - Одна команда, мгновенный доступ —
uvx ptn, и вы (или агент) получаете настоящий терминал на этой машине. Никакого SSH, никакого проброса портов, никаких конфигурационных файлов. Туннель Cloudflare + QR-код. - Действительно удобно на мобильных — Оптимизировано для сенсорного ввода: инерционная прокрутка, масштабирование щипком, жесты смахивания и клавиши-модификаторы (Ctrl, Alt).
- Полноценные терминальные приложения — vim, htop, less, tmux работают корректно с правильной обработкой альтернативного экранного буфера.
- Постоянные многосессионные вкладки — Сессии переживают отключения. Закройте браузер, смените сеть, переподключитесь с другого устройства — ваша оболочка и запущенные процессы всё ещё на месте. Вы и агент можете совместно использовать одну сессию: наблюдайте за работой или перехватывайте управление.
- Кроссплатформенность — Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish, Nushell и любая оболочка через
$SHELL). Автоматически определяет ваши оболочки. - Сложно угадать по умолчанию — Каждый запуск добавляет независимый случайный путь доступа длиной 128 бит. Голое имя хоста туннеля и любой неверный путь возвращают 404. URL скрыт на экране, но QR-код содержит полные учётные данные, поэтому держите в секрете и то, и другое. Нажмите
c, чтобы скопировать инструкции для агента и URL, илиu, чтобы скопировать только URL.
Установка
| Способ | Установка | Обновление |
|---|---|---|
| uvx (без установки) | uvx ptn | uvx ptn@latest |
| uv tool | uv tool install ptn | uv tool upgrade ptn |
| pipx | pipx install ptn | pipx upgrade ptn |
| pip | pip install ptn | pip install -U ptn |
Установка одной строкой (uv + ptn):
| ОС | Команда |
|---|---|
| Windows | powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lyehe/porterminal/master/install.ps1 | iex" |
| macOS/Linux | curl -LsSf https://raw.githubusercontent.com/lyehe/porterminal/master/install.sh | sh |
Требуется Python 3.12+ и cloudflared (устанавливается автоматически, если отсутствует).
Использование
ptn # Start in current directory
ptn ~/projects/myapp # Start in specific folder
| Флаг | Описание |
|---|---|
-n, --no-tunnel | Только локальная сеть (без туннеля Cloudflare) |
--mcp-only | Управление оболочкой через MCP без QR-кода, браузерного терминала или REST API |
-p, --password | Запросить пароль для защиты этой сессии |
-sp, --save-password | Сохранить или очистить пароль в конфигурации |
-tp, --toggle-password | Установить требование пароля (вкл/выкл/переключить) |
-v, --verbose | Показывать подробные журналы запуска |
-i, --init | Создать .ptn/ptn.yaml с автоматически обнаруженными скриптами проекта в виде кнопок |
-if, --init-from URL/PATH | Создать .ptn/ptn.yaml из URL или локального файла |
-c, --compose | Включить режим compose по умолчанию |
-k, --keep-qr | Оставлять QR-код видимым после первого подключения |
-u, --check-update | Проверить наличие новой версии |
-V, --version | Показать версию |
Во время работы: при активном туннеле URL подключения скрыт на экране для приватности. Нажмите c, чтобы скопировать инструкции для агента и URL, включая /mcp, /api/agent/run и /llms.txt; нажмите u, чтобы скопировать только URL; или отсканируйте QR-код для подключения. Ctrl+C останавливает сервер.