MacOS build simplify, readme update

This commit is contained in:
Flowseal 2026-03-18 19:22:46 +03:00
parent d2190cfec6
commit 7572258a28
4 changed files with 26 additions and 206 deletions

View File

@ -145,8 +145,27 @@ jobs:
- name: Create macOS icon from ICO - name: Create macOS icon from ICO
run: | run: |
set -euo pipefail set -euo pipefail
chmod +x packaging/create_icon.sh python3.12 - <<'PY'
packaging/create_icon.sh from PIL import Image
image = Image.open('icon.ico')
image = image.resize((1024, 1024), Image.LANCZOS)
image.save('icon_1024.png', 'PNG')
PY
mkdir -p icon.iconset
sips -z 16 16 icon_1024.png --out icon.iconset/icon_16x16.png
sips -z 32 32 icon_1024.png --out icon.iconset/icon_16x16@2x.png
sips -z 32 32 icon_1024.png --out icon.iconset/icon_32x32.png
sips -z 64 64 icon_1024.png --out icon.iconset/icon_32x32@2x.png
sips -z 128 128 icon_1024.png --out icon.iconset/icon_128x128.png
sips -z 256 256 icon_1024.png --out icon.iconset/icon_128x128@2x.png
sips -z 256 256 icon_1024.png --out icon.iconset/icon_256x256.png
sips -z 512 512 icon_1024.png --out icon.iconset/icon_256x256@2x.png
sips -z 512 512 icon_1024.png --out icon.iconset/icon_512x512.png
sips -z 1024 1024 icon_1024.png --out icon.iconset/icon_512x512@2x.png
iconutil -c icns icon.iconset -o icon.icns
rm -rf icon.iconset icon_1024.png
- name: Build app with PyInstaller - name: Build app with PyInstaller
run: python3.12 -m PyInstaller packaging/macos.spec --noconfirm run: python3.12 -m PyInstaller packaging/macos.spec --noconfirm

View File

@ -10,22 +10,20 @@
# TG WS Proxy # TG WS Proxy
Локальный SOCKS5-прокси для Telegram Desktop, который перенаправляет трафик через WebSocket-соединения к указанным серверам, помогая частично ускорить работу Telegram. **Локальный SOCKS5-прокси** для Telegram Desktop, который **ускоряет работу Telegram**, перенаправляя трафик через WebSocket-соединения. Данные передаются в том же зашифрованном виде, а для работы не нужны сторонние сервера.
**Ожидаемый результат аналогичен прокидыванию hosts для Web Telegram**: ускорение загрузки и скачивания файлов, загрузки сообщений и части медиа.
<img width="529" height="487" alt="image" src="https://github.com/user-attachments/assets/6a4cf683-0df8-43af-86c1-0e8f08682b62" /> <img width="529" height="487" alt="image" src="https://github.com/user-attachments/assets/6a4cf683-0df8-43af-86c1-0e8f08682b62" />
## Как это работает ## Как это работает
``` ```
Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS (kws*.web.telegram.org) → Telegram DC Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC
``` ```
1. Приложение поднимает локальный SOCKS5-прокси на `127.0.0.1:1080` 1. Приложение поднимает локальный SOCKS5-прокси на `127.0.0.1:1080`
2. Перехватывает подключения к IP-адресам Telegram 2. Перехватывает подключения к IP-адресам Telegram
3. Извлекает DC ID из MTProto obfuscation init-пакета 3. Извлекает DC ID из MTProto obfuscation init-пакета
4. Устанавливает WebSocket (TLS) соединение к соответствующему DC через домены `kws{N}.web.telegram.org` 4. Устанавливает WebSocket (TLS) соединение к соответствующему DC через домены Telegram
5. Если WS недоступен (302 redirect) — автоматически переключается на прямое TCP-соединение 5. Если WS недоступен (302 redirect) — автоматически переключается на прямое TCP-соединение
## 🚀 Быстрый старт ## 🚀 Быстрый старт
@ -42,25 +40,6 @@ Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS (kws*.web.t
- **Открыть логи** — открыть файл логов - **Открыть логи** — открыть файл логов
- **Выход** — остановить прокси и закрыть приложение - **Выход** — остановить прокси и закрыть приложение
## Установка из исходников
> Для Windows:
```bash
pip install -r requirements.txt
```
> Для MacOS:
```bash
pip install -r requirements-macos.txt
```
### Windows (Tray-приложение)
```bash
python windows.py
```
### MacOS (Tray-приложение) ### MacOS (Tray-приложение)
Перейдите на [страницу релизов](https://github.com/Flowseal/tg-ws-proxy/releases) и скачайте **`TgWsProxy.dmg`** — универсальная сборка для Apple Silicon и Intel. Перейдите на [страницу релизов](https://github.com/Flowseal/tg-ws-proxy/releases) и скачайте **`TgWsProxy.dmg`** — универсальная сборка для Apple Silicon и Intel.
@ -69,7 +48,7 @@ python windows.py
2. Перенести **TG WS Proxy.app** в папку **Applications** 2. Перенести **TG WS Proxy.app** в папку **Applications**
3. При первом запуске macOS может попросить подтвердить открытие: **Системные настройки → Конфиденциальность и безопасность → Всё равно открыть** 3. При первом запуске macOS может попросить подтвердить открытие: **Системные настройки → Конфиденциальность и безопасность → Всё равно открыть**
### Консольный режим (Windows) ### Консольный режим из исходников
```bash ```bash
python proxy/tg_ws_proxy.py [--port PORT] [--dc-ip DC:IP ...] [-v] python proxy/tg_ws_proxy.py [--port PORT] [--dc-ip DC:IP ...] [-v]
@ -96,11 +75,6 @@ python proxy/tg_ws_proxy.py --port 9050 --dc-ip 1:149.154.175.205 --dc-ip 2:149.
python proxy/tg_ws_proxy.py -v python proxy/tg_ws_proxy.py -v
``` ```
### Консольный режим (MacOS)
```bash
python macos.py
```
## Настройка Telegram Desktop ## Настройка Telegram Desktop
### Автоматически ### Автоматически
@ -133,34 +107,7 @@ Tray-приложение хранит данные в `%APPDATA%/TgWsProxy`:
## Автоматическая сборка ## Автоматическая сборка
Проект содержит спецификацию PyInstaller ([`windows.spec`](packaging/windows.spec)) и GitHub Actions workflow ([`.github/workflows/build.yml`](.github/workflows/build.yml)) для автоматической сборки. Проект содержит спецификации PyInstaller ([`packaging/windows.spec`](packaging/windows.spec), [`packaging/macos.spec`](packaging/macos.spec)) и GitHub Actions workflow ([`.github/workflows/build.yml`](.github/workflows/build.yml)) для автоматической сборки.
> Для Windows:
```bash
pip install pyinstaller
pyinstaller packaging/windows.spec
```
> Для MacOS:
```bash
pip install pyinstaller
packaging/create_icon.sh
pyinstaller packaging/macos.spec
```
> Создать универсальный DMG (local-тест с двумя копями одной архитектуры):
```bash
pip install pyinstaller
packaging/create_icon.sh
pyinstaller packaging/macos.spec --noconfirm
cp -R "dist/TG WS Proxy.app" "dist/TG WS Proxy-intel.app"
packaging/merge_universal2.sh \
"dist/TG WS Proxy.app" \
"dist/TG WS Proxy-intel.app" \
"dist/TG WS Proxy-universal.app"
```
- В результате в папке `dist/` появятся `.app` под текущую архитектуру и `TgWsProxy.dmg`.
## Лицензия ## Лицензия

View File

@ -1,30 +0,0 @@
#!/bin/bash
# Create icon.icns from icon.ico for macOS app
set -e
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
python3 -c "
from PIL import Image
img = Image.open('$PROJECT_DIR/icon.ico')
img = img.resize((1024, 1024), Image.LANCZOS)
img.save('$PROJECT_DIR/icon_1024.png', 'PNG')
"
mkdir -p "$PROJECT_DIR/icon.iconset"
sips -z 16 16 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_16x16.png"
sips -z 32 32 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_16x16@2x.png"
sips -z 32 32 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_32x32.png"
sips -z 64 64 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_32x32@2x.png"
sips -z 128 128 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_128x128.png"
sips -z 256 256 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_128x128@2x.png"
sips -z 256 256 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_256x256.png"
sips -z 512 512 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_256x256@2x.png"
sips -z 512 512 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_512x512.png"
sips -z 1024 1024 "$PROJECT_DIR/icon_1024.png" --out "$PROJECT_DIR/icon.iconset/icon_512x512@2x.png"
iconutil -c icns "$PROJECT_DIR/icon.iconset" -o "$PROJECT_DIR/icon.icns"
rm -rf "$PROJECT_DIR/icon.iconset" "$PROJECT_DIR/icon_1024.png"
echo "icon.icns created: $PROJECT_DIR/icon.icns"

View File

@ -1,116 +0,0 @@
#!/bin/bash
# Merge arm64 and x86_64 .app bundles into a universal2 .app and create DMG
set -euo pipefail
trap 'echo "merge_universal2.sh failed at line $LINENO" >&2' ERR
ARM_APP="$1"
INTEL_APP="$2"
OUT_APP="$3"
if [ -z "$ARM_APP" ] || [ -z "$INTEL_APP" ] || [ -z "$OUT_APP" ]; then
echo "Usage: $0 <arm64.app> <x86_64.app> <output.app>"
exit 1
fi
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
DIST_DIR="$PROJECT_DIR/dist"
APP_NAME="$(basename "$OUT_APP" .app)"
DMG_NAME="TgWsProxy"
echo "Starting universal2 merge"
echo "ARM_APP=$ARM_APP"
echo "INTEL_APP=$INTEL_APP"
echo "OUT_APP=$OUT_APP"
echo "DIST_DIR=$DIST_DIR"
if [ ! -d "$ARM_APP" ]; then
echo "ARM app bundle not found: $ARM_APP" >&2
exit 1
fi
if [ ! -d "$INTEL_APP" ]; then
echo "Intel app bundle not found: $INTEL_APP" >&2
exit 1
fi
has_arch() {
local arches="$1"
local target="$2"
for arch in $arches; do
if [ "$arch" = "$target" ]; then
return 0
fi
done
return 1
}
is_subset() {
local subset="$1"
local superset="$2"
for arch in $subset; do
has_arch "$superset" "$arch" || return 1
done
return 0
}
# --- Merge ---
echo "Merging '$ARM_APP' + '$INTEL_APP' -> '$OUT_APP'"
rm -rf "$OUT_APP"
cp -R "$ARM_APP" "$OUT_APP"
find "$OUT_APP" -type f | while read -r file; do
rel="${file#"$OUT_APP"/}"
intel_file="$INTEL_APP/$rel"
[ -f "$intel_file" ] || continue
if file "$file" | grep -qE "Mach-O (64-bit )?executable|Mach-O (64-bit )?dynamically linked|Mach-O (64-bit )?bundle"; then
arm_arch=$(lipo -archs "$file" 2>/dev/null || echo "")
intel_arch=$(lipo -archs "$intel_file" 2>/dev/null || echo "")
echo "Processing Mach-O: $rel"
echo " arm_arch=$arm_arch"
echo " intel_arch=$intel_arch"
if [ -z "$arm_arch" ] || [ -z "$intel_arch" ]; then
echo " action=skip (unable to determine architecture)"
continue
fi
if is_subset "$intel_arch" "$arm_arch"; then
echo " action=skip (arm binary already contains intel slices)"
continue
fi
if is_subset "$arm_arch" "$intel_arch"; then
echo " action=copy-intel (intel binary is a superset)"
cp "$intel_file" "$file"
continue
fi
echo " action=lipo-create"
lipo -create "$file" "$intel_file" -output "$file"
echo " merged_arch=$(lipo -archs "$file" 2>/dev/null || echo "")"
fi
done
echo "Merge done: $OUT_APP"
# --- Create DMG ---
DMG_TEMP="$DIST_DIR/dmg_temp"
rm -rf "$DMG_TEMP"
mkdir -p "$DMG_TEMP"
cp -R "$OUT_APP" "$DMG_TEMP/"
ln -s /Applications "$DMG_TEMP/Applications"
hdiutil create \
-volname "$APP_NAME" \
-srcfolder "$DMG_TEMP" \
-ov \
-format UDZO \
"$DIST_DIR/$DMG_NAME.dmg"
rm -rf "$DMG_TEMP"
echo "DMG created: $DIST_DIR/$DMG_NAME.dmg"