sish

Туннелирование SSH с открытым исходным кодом для HTTP(S), WS(S), TCP, псевдонимов и SNI.

Если вам нравится простота общего доступа в стиле serveo/ngrok, но вы хотите использовать обычный SSH и запускать собственную инфраструктуру, sish создан именно для этого.

• Для конечных пользователей не требуется специальный клиент
• Рабочие процессы с открытыми и закрытыми туннелями
• Релизы в формате Docker и бинарников
• Разработан для профессионального самостоятельного хостинга

Документация | Управляемый сервис | Релизы | Образы Docker | Спонсируется pico.sh

Зачем sish

sish запускает SSH-сервер, ориентированный на пересылку и мультиплексирование. Пользователи подключаются с помощью уже знакомых им команд, а sish обрабатывает маршрутизацию.

Типичные сценарии использования

• Мгновенно опубликовать локальное веб-приложение через HTTPS
• Открыть TCP-сервис на фиксированном или случайном внешнем порту
• Создать частные TCP-псевдонимы, доступные только через аутентифицированный SSH
• Маршрутизировать TLS-трафик по SNI на несколько серверов без завершения TLS

Быстрый старт

1) Попробуйте управляемый сервис

Самый быстрый способ проверить ваш рабочий процесс:

ssh -R 80:localhost:8080 tuns.sh

Это создаёт публичный URL для вашего локального приложения, работающего на порту 8080.

2) Самостоятельный хостинг с Docker

Загрузите образ:

docker pull antoniomika/sish:latest

Подготовьте каталоги:

mkdir -p ~/sish/ssl ~/sish/keys ~/sish/pubkeys
cp ~/.ssh/id_ed25519.pub ~/sish/pubkeys

Запустите:

docker run -itd --name sish \
	-v ~/sish/ssl:/ssl \
	-v ~/sish/keys:/keys \
	-v ~/sish/pubkeys:/pubkeys \
	--net=host antoniomika/sish:latest \
	--ssh-address=:2222 \
	--http-address=:80 \
	--https-address=:443 \
	--https=true \
	--https-certificate-directory=/ssl \
	--authentication-keys-directory=/pubkeys \
	--private-keys-directory=/keys \
	--bind-random-ports=false \
	--domain=example.com

Затем подключитесь:

ssh -p 2222 -R 80:localhost:8080 example.com

Примеры пересылки

HTTP-туннель

ssh -R myapp:80:localhost:8080 tuns.sh

Ваше приложение на localhost:8080 становится доступно по адресу https://myapp.tuns.sh.

TCP-туннель

ssh -R 2222:localhost:22 tuns.sh

localhost:22 доступен на tuns.sh:2222

Приватный TCP-псевдоним

ssh -R mylaptop:22:localhost:22 tuns.sh

Доступ с другого клиента:

ssh -J tuns.sh mylaptop

Ключевые возможности

• Пересылка и мультиплексирование HTTP(S), WS(S), TCP
• TCP-псевдонимы для шаблонов доступа только из внутренней сети
• Поддержка SNI-прокси для маршрутизации бэкендов на основе TLS
• Опциональные режимы балансировки нагрузки для HTTP/TCP/SNI-псевдонимов
• Поддержка консоли сервиса для просмотра пересылаемых запросов
• Аутентификация по ключу и паролю с динамической перезагрузкой ключей
• Ограничительные политики привязки для более безопасной многопользовательской среды

Локальная разработка

Клонируйте:

git clone [email protected]:antoniomika/sish.git
cd sish

Запустите локально:

go run main.go --http-address localhost:3000 --domain testing.ssi.sh

Или используйте:

make dev

Проверьте туннель:

ssh -p 2222 -R 80:localhost:8080 testing.ssi.sh

testing.ssi.sh настроен на указание localhost для разработки.

Узнать больше

• Начало работы
• Типы пересылки
• Справка по CLI
• Часто задаваемые вопросы

Сообщество

• IRC: #sish на libera / #pico.sh на libera
• Email: [email protected]