FoxiGram/README.md
instant992 bbb2b84f07 Auto-enable bundled proxy on first launch; drop in-app download button
- ApplicationLoader now enables a bundled VLESS proxy on a truly fresh
  install (one-time, guarded by builtin_proxy_autoenabled) so the app can
  connect even when plain Telegram is blocked; existing users' choices are
  left untouched
- Remove the 'Download FoxiGram' settings row (the app is already
  installed) and its strings; drop the in-app download mention from READMEs
2026-06-10 22:24:42 +04:00

86 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# FoxiGram
**Русский** · [English](README.en.md)
Неофициальный клиент Telegram на базе Nekogram со встроенным
прокси-клиентом VLESS+Reality (Xray) для доступа к прокси в одно касание.
## Скачать
Свежие версии — на странице релизов:
**https://github.com/instant992/FoxiGram/releases**
Скачайте файл `FoxiGram-<версия>-<код>-arm64-v8a.apk` из последнего релиза и
установите его на устройстве (для этого может понадобиться разрешить установку
из неизвестных источников).
## Встроенные прокси-серверы
Данные серверов намеренно не хранятся в этом репозитории.
- Реальные серверы лежат в файле
`TMessagesProj/src/main/java/org/telegram/messenger/XrayServers.java`,
который исключён из git.
- Шаблон находится в `XrayServers.java.template`.
Чтобы настроить свои встроенные прокси:
```sh
cd TMessagesProj/src/main/java/org/telegram/messenger/
cp XrayServers.java.template XrayServers.java
# затем отредактируйте XrayServers.java и впишите данные своих серверов VLESS+Reality
```
Если оставить адреса пустыми, встроенные прокси отключатся — приложение всё
равно соберётся и будет работать, просто в списке прокси не будет
предзаданных записей.
## Нативная библиотека Xray (libxray.so)
Ядро прокси — небольшая Go-обёртка над xray-core, собранная как разделяемая
JNI-библиотека. Исходники в `libxray/`. Скомпилированный `libxray.so` исключён
из git и собирается локально.
Сборка под Android arm64 (нужны Go и Android NDK):
```sh
cd libxray
go mod tidy
set CGO_ENABLED=1
set GOOS=android
set GOARCH=arm64
set CC=<NDK>/toolchains/llvm/prebuilt/<host>/bin/aarch64-linux-android21-clang
go build -buildmode=c-shared -o ../TMessagesProj/src/main/jniLibs/arm64-v8a/libxray.so .
```
## Сборка приложения
Обычная сборка через Gradle:
```sh
./gradlew :TMessagesProj_App:assembleRelease -Pandroid.injected.build.abi.filter=arm64-v8a
```
Итоговый APK называется `FoxiGram-<версия>-<код>-<abi>.apk`.
## Примечания
- `google-services.json`, ключи подписи и `local.properties` не хранятся в
репозитории. Для релизной сборки подставьте свои.
- Основан на Nekogram, который основан на Telegram для Android.
## Лицензия
Проект распространяется на условиях **GNU General Public License v2.0 или
новее** (GPL-2.0-or-later) — как и Telegram для Android и Nekogram, на которых
он основан.
Это означает, что вы можете свободно использовать, изменять и распространять
приложение, в том числе передавать его другим людям. При распространении —
оригинального или изменённого — необходимо открывать исходный код на тех же
условиях и сохранять указание авторства.
FoxiGram — независимый форк и не связан с официальным Telegram. Названия
«Telegram», логотипы и торговые марки принадлежат их правообладателям.