Сборка из исходного кода

​

Пакеты релиза

• gproxy-*: CLI со встроенной веб-консолью.
• gproxy-headless-*: тот же CLI без консоли, для CI и небольших серверов. См. CLI без консоли.
• gproxy-tauri-*: настольное и мобильное приложение, которое тоже содержит консоль.

• Linux: DEB с CLI устанавливает gproxy в /usr/bin. Приложению для GNU Linux нужны пакеты GTK 3 и WebKitGTK 4.1 из дистрибутива. Сборки musl предназначены для Alpine и выпускаются как APK, а не DEB.
• Android CLI: DEB для Termux устанавливается в /data/data/com.termux/files/usr. Сборки Android CLI используют рецепт из distribution/termux/ и закреплённую версию официального сборщика Termux. И DEB, и ZIP используют libc++, OpenSSL и сертификаты CA из Termux; ZIP содержит скрипт запуска, исполняемый файл и TERMUX.txt с инструкциями по установке и обновлению. Самообновление в этих сборках отключено: установите новый DEB через APT или используйте pkg upgrade gproxy, когда пакет появится в подключённом репозитории.
• Android-приложение: APK подписывается и проверяется секретами ANDROID_SIGNING_*. Запись <target-triple>-tauri-apk каждого приложения входит в подписанный Ed25519 манифест обновлений отдельно от обновлений CLI ZIP. Старый APK-обёртка сервера больше не собирается.
• Windows: MSIX с CLI имеет собственную идентичность в Partner Center, LeenHawk.GPROXYCLI, и псевдоним для запуска из консоли. Приложению нужен системный WebView2 Runtime.
• macOS: DMG с CLI содержит исполняемый файл и инструкции по установке из Терминала. ZIP приложения сохраняет ресурсы приложения, а на macOS — полный .app. Сборки подписываются ad-hoc; подпись Developer ID и нотаризация не настроены.
• OpenHarmony: сборки используют кешированный образ инструментов и закреплённую экспериментальную ветку Tauri; остальные платформы используют стабильный Tauri. HAP перед установкой нужно подписать. Он проверен на эмуляторе. Непрерывная работа в фоне реализована, но её доступность зависит от устройства, версии ОС и выданных разрешений; прокси останавливается вместе с процессом приложения.

​

Окружение сборки

​

CLI и консоль

pnpm --dir console install --frozen-lockfile
pnpm --dir console build
cargo build -p gproxy --release
./target/release/gproxy serve --data-dir ./data

​

Фичи Cargo

cargo build -p gproxy --release --no-default-features \
  --features embedded-console,memory,fs,codex,claudecode,openai,custom

​

CLI без консоли

cargo build --locked --release -p gproxy --bin gproxy \
  --no-default-features --features channels,memory,fs,bundled-vocabulary,postgres,mysql
./target/release/gproxy serve --console=false

pkg install ./gproxy-headless-android-<arch>.deb
gproxy serve --console=false

pkg install libc++ openssl ca-certificates
./gproxy serve --console=false

​

Настольное и мобильное приложение

cargo run -p gproxy-host-tauri --bin gproxy-desktop

pnpm --dir console build
node console/scripts/sync-to-embed.mjs
pnpm --dir crates/gproxy-host-tauri install --frozen-lockfile
TARGET_OS=linux TARGET_TRIPLE=x86_64-unknown-linux-gnu \
  ARTIFACT_NAME=gproxy-tauri-linux-x86_64 \
  GPROXY_BUILD_VERSION=$(scripts/release-metadata.sh version) \
  scripts/package-tauri-release.sh

​

Cloudflare Workers

rustup target add wasm32-unknown-unknown
cargo install worker-build
pnpm --dir console install --frozen-lockfile
pnpm --dir deploy/cloudflare install
pnpm --dir deploy/cloudflare build
pnpm --dir deploy/cloudflare check

​

Проверки CI

cargo fmt --all --check
cargo clippy --all-targets -- -D warnings
cargo test

cargo clippy -p gproxy --bin gproxy-serverless --no-default-features --features channels,postgres,embedded-console -- -D warnings
cargo clippy -p gproxy-example-channel -p gproxy-example-native --all-targets -- -D warnings

cargo clippy -p gproxy-host-tauri --all-targets -- -D warnings
cargo test -p gproxy-host-tauri

cargo check --target wasm32-unknown-unknown \
  -p gproxy-protocol -p gproxy-store -p gproxy-seaorm -p gproxy-client \
  -p gproxy-cache -p gproxy-channel -p gproxy-core -p gproxy-file \
  -p gproxy-tokenizer -p gproxy-sdk -p gproxy-app -p gproxy-host-axum \
  -p gproxy-host-edge

cargo check --target wasm32-unknown-unknown -p gproxy-sdk --features libsql
cargo check --target wasm32-unknown-unknown -p gproxy-cache --all-features
cargo check --target wasm32-unknown-unknown -p gproxy-file --no-default-features --features s3
cargo check --target wasm32-unknown-unknown -p gproxy-channel --all-features --lib
cargo check --target wasm32-unknown-unknown -p gproxy-example-edge --lib

pnpm --dir console lint
pnpm --dir console test
pnpm --dir console build
git submodule update --init docs
pnpm --dir docs install --frozen-lockfile
pnpm --dir docs check

​

Публикация

​

Ветки и каналы обновлений

• dev — разработка новых функций. Push в неё публикует только в nightly, канал обновлений для разработки.
• main — сопровождение выпущенной функциональности и исправление ошибок. Push в неё публикует только в staging, бета-канал обновлений.
• Теги стабильных версий создаются из main и публикуются в канал release и в бета-канал. Канал dev они никогда не перезаписывают.

​

Выпуск версии

• тег совпадает с версией workspace, и существует release-notes/v<version>.md;
• отслеживаемое рабочее дерево чистое;
• HEAD содержит последний origin/main, и все коммиты после него — коммиты chore(release):.

​

Подпись и публикация в магазинах

• Манифест обновлений подписывается Ed25519; самообновление проверяет подпись перед установкой.
• Android: APK подписываются секретами ANDROID_SIGNING_*.
• macOS: только подпись ad-hoc.
• Windows: пакеты используют идентичность пакета Microsoft Store. Задайте в окружении release четыре переменные: MS_STORE_IDENTITY_NAME, MS_STORE_DISPLAY_NAME, MS_STORE_IDENTITY_PUBLISHER и MS_STORE_PUBLISHER_DISPLAY_NAME. CLI использует соответствующие переменные MS_STORE_CLI_*. У Headless идентичность и отображаемое имя фиксированы, поэтому для его публикации в Store к общим переменным издателя добавляется только MS_STORE_HEADLESS_PRODUCT_ID. Стабильные релизы сохраняют пакеты обеих архитектур для Store, а при включённом MS_STORE_PUBLISH_ENABLED успешная публикация на GitHub запускает рабочий процесс отправки в Store. Пакеты для Store не подписываются: их подписывает Store при распространении.
• Windows на GitHub: пакеты релиза не подписываются. Файлы ZIP и MSIX, приложенные к релизу, не имеют подписи, поэтому Windows может показать предупреждение перед запуском, а для установки MSIX нужно разрешить загрузку неопубликованных приложений. Подписанные копии есть только в Microsoft Store, в том числе через winget install --source msstore. Общественный источник WinGet принимает только подписанные MSIX, поэтому, пока релизы не подписываются, новые версии туда не попадают.