tg-ws-proxy/docs/RU/README.linux.md

TG WS Proxy для Linux

Готовые сборки

Для Debian/Ubuntu скачайте со страницы релизов пакет TgWsProxy_linux_amd64.deb.

Для Arch и основанных на Arch дистрибутивов подготовлены пакеты в AUR:

• tg-ws-proxy-bin
• tg-ws-proxy-git
• tg-ws-proxy-cli

# Установка без AUR-helper
git clone https://aur.archlinux.org/tg-ws-proxy-bin.git
cd tg-ws-proxy-bin
makepkg -si

# При помощи AUR-helper
paru -S tg-ws-proxy-bin

# Для пакета -cli запуск через systemd (8888 — номер порта; secret можно сгенерировать командой openssl rand -hex 16)
sudo systemctl start tg-ws-proxy@8888:3075abe65830f0325116bb0416cadf9f

Для остальных дистрибутивов можно использовать TgWsProxy_linux_amd64 (бинарный файл для x86_64).

chmod +x TgWsProxy_linux_amd64
./TgWsProxy_linux_amd64

При первом запуске откроется окно с инструкцией. Приложение работает в системном трее (требуется AppIndicator).

Обновление

Если в настройках включена проверка обновлений, при запуске приложение само предложит обновиться и установит новую версию:

• установка из .deb/.rpm — скачивается новый пакет и ставится пакетным менеджером (через pkexec, потребуется подтверждение пароля);
• отдельный бинарный файл — заменяется на месте, если каталог доступен на запись, иначе тоже через pkexec.

Загруженный файл проверяется по длине ответа и контрольной сумме SHA-256 из релиза, повреждённая загрузка не устанавливается. После установки приложение перезапускается автоматически.

Для пакетов из AUR, установки через pip и архитектур, отличных от x86_64, обновление выполняется прежним способом — открывается страница релиза.

Настройка Telegram Desktop

1. Telegram → Настройки → Продвинутые настройки → Тип подключения → Прокси
2. Добавьте прокси:
   • Тип: MTProto
   • Сервер: 127.0.0.1 (или переопределенный вами)
   • Порт: 1443 (или переопределенный вами)
   • Secret: из настроек или логов

Установка из исходников

Подробная инструкция: BuildFromSource.md

pip install -e .
tg-ws-proxy-tray-linux