Перейти к содержанию

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

Самый простой способ запустить Teleproxy — никакой настройки не нужно:

docker run -d \
  --name teleproxy \
  -p 443:443 \
  -p 8888:8888 \
  --restart unless-stopped \
  ghcr.io/teleproxy/teleproxy:latest

Контейнер автоматически:

  • Скачивает актуальную конфигурацию прокси от Telegram
  • Генерирует случайный секрет, если не задан
  • Запускает прокси на порту 443

Ссылки для подключения выводятся в логах:

docker logs teleproxy
# ===== Connection Links =====
# https://t.me/proxy?server=203.0.113.1&port=443&secret=eecafe...
# =============================

Если автоопределение внешнего IP не работает (например, за корпоративным файрволом), задайте переменную окружения EXTERNAL_IP явно.

С Fake-TLS (режим EE)

Оборачивает трафик MTProto в настоящий TLS-хэндшейк, делая его неотличимым от обычного HTTPS:

docker run -d \
  --name teleproxy \
  -p 443:443 \
  -e EE_DOMAIN=www.google.com \
  --restart unless-stopped \
  ghcr.io/teleproxy/teleproxy:latest

Прямое подключение к DC

Минует промежуточные relay-серверы Telegram, направляя клиентов напрямую к ближайшему дата-центру:

docker run -d \
  --name teleproxy \
  -p 443:443 \
  -e DIRECT_MODE=true \
  --restart unless-stopped \
  ghcr.io/teleproxy/teleproxy:latest

Доступные теги

GitHub Container Registry:

  • ghcr.io/teleproxy/teleproxy:latest
  • ghcr.io/teleproxy/teleproxy:{version} (напр. 4.7.0, 4.7, 4)

Docker Hub:

  • rkline0x/teleproxy:latest
  • rkline0x/teleproxy:{version} (напр. 4.7.0, 4.7, 4)

Используйте Docker Hub, если ваше окружение не может загружать образы из ghcr.io (например, контейнеры MikroTik RouterOS).

Сборка собственного образа

docker build -t teleproxy .
docker run -d --name teleproxy -p 443:443 -p 8888:8888 teleproxy
docker logs teleproxy 2>&1 | grep "Generated secret"

Обновление

Скачайте свежий образ и пересоздайте контейнер:

docker pull ghcr.io/teleproxy/teleproxy:latest
docker rm -f teleproxy
docker run -d --name teleproxy -p 443:443 -p 8888:8888 --restart unless-stopped ghcr.io/teleproxy/teleproxy:latest

С Docker Compose:

docker compose pull
docker compose up -d