[**English**](README_EN.md)
## FlClashX
[](https://github.com/pluralplay/FlClashX/releases/)
[](https://github.com/pluralplay/FlClashX/releases/)
[](LICENSE)
[](https://t.me/FlClashX)
Форк многоплатформенного прокси-клиента FlClash на основе ClashMeta, простого и удобного в использовании, с открытым исходным кодом и без рекламы.
Десктопный вид:
Мобильный вид:
## Добавленный функционал
🛠️ Исправлены стандартные настройки: режим поиска процессов вкл, режим tun вкл, режим системного прокси выкл, режим отображения списка прокси list, изменена работа камеры при добавлении подписки через QR.
📱 **Поддержка 120Гц дисплеев на Android:** Добавлена поддержка высокочастотных дисплеев (120Гц) на устройствах Android для более плавных анимаций и прокрутки.
🗑️ **Очистка данных приложения:** Добавлена кнопка "Очистить данные" в настройках приложения, которая удаляет все профили из папки profiles. Полезно для устранения неполадок или сброса приложения.
🇷🇺 Добавлен русский язык в установщик и переработана локаль в приложении
✈️ Передача HWID в панель (Работает только с Remnawave)
💻 Добавлен новый виджет "Анонсы". Передаёт анонсы из панели в виджет. (Работает только с Remnawave)
📺 Оптимизация управления на Android TV
- добавлена кнопка "Вставить" для меню добавления подписки по ссылке
- добавлена кнопка выбора профиля
- добавлена передача профиля с мобильного приложения через QR-код
💻 macOS - приложение в нативной строке состояния (status bar) вместо оконного интерфейса.
🪪 Переработана карточка профиля на странице профиля и виджет на главной:
- Используется индикатор объёма трафика с изменением цвета (не отображается, если трафик неограничен).
- Отображается дата окончания подписки (если год — 2099, выводится «Ваша подписка вечная»).
- Добавлена новая кнопка «Поддержка» в профиле, которая подтягивает supportUrl с панели.
- Параметр autoupdateinterval для профиля теперь корректно передаётся с панели.
- Добавлен виджет "MetaInfo". Передаёт параметры с подписки на виджет. Сколько трафика осталось, когда заканчивается подписка, имя профиля, и крупно отображает сколько дней до окончании подписки осталось (за 3 дня до окончания).
- Добавлен виджет "serviceInfo". Передаёт название вашего сервиса. Можно передать дополнительно хедер `flclashx-servicelogo` для кастомного лого (поддерживается ссылка svg/png), дополнительно по клику открыватеся ссылка на поддержку (supportURL)
- Добавлен виджет "changeServerButton". По клику перенаправляет на страницу прокси.
### Добавлен парсинг кастомных хедеров со страницы подписки:
flclashx-widgets
Выстраивает виджеты в порядке, полученным с подписки
| Значение | Виджет |
| :------------------: | ----------------------------------------------------------- |
| `announce` | Анонсы |
| `networkSpeed` | Скорость сети |
| `outboundModeV2` | Режим работы прокси (новый вид) |
| `outboundMode` | Режим работы прокси (старый вид) |
| `trafficUsage` | Использование трафика |
| `networkDetection` | Определение локации и IP |
| `tunButton` | Кнопка TUN (только Desktop) |
| `vpnButton` | Кнопка VPN (только Android) |
| `systemProxyButton` | Кнопка системного прокси (только Desktop) |
| `intranetIp` | Локальный IP-адрес |
| `memoryInfo` | Использование памяти |
| `metainfo` | Информация о подписке |
| `changeServerButton` | Кнопка смены сервера |
| `serviceInfo` | Информация о сервисе (работает только с header flclashx-servicename) |
Использование:
```bash
flclashx-widgets: announce,metainfo,outboundModeV2,networkDetection
```
flclashx-view
Настраивает вид страницы прокси, полученным с подписки
| Значение | Описание | Возможные значения |
| :------: | ----------------------------------- | --------------------------------- |
| `type` | Режим отображения | `list`,`tab` |
| `sort` | Тип сортировки | `none`,`delay`,`name` |
| `layout` | Макет | `loose`,`standard`,`tight` |
| `icon` | Стиль иконок (для list-отображения) | `none`,`icon` |
| `card` | Размер карточки | `expand`,`shrink`,`min`,`oneline` |
Использование:
```bash
flclashx-view: type:list; sort:delay; layout:tight; icon:icon; card:shrink
```
flclashx-custom
Управляет состоянием применения стилей для Dashboard и ProxyView
| Значение | Описание |
| :------: | ------------------------------------------------------- |
| `add` | Стиль страницы прокси и виджеты применяются только при первом добавлении подписки |
| `update` | Стиль страницы прокси и виджеты применяются каждый раз при обновлении подписки |
Использование:
```bash
flclashx-custom: update
```
flclashx-denywidgets
При true — запрещает редактировать страницу Dashboard. Имеет значение true/false.
Использование:
```bash
flclashx-denywidgets: true
```
flclashx-servicename
Название вашего сервиса, отображаемое в виджете ServiceInfo.
Использование:
```bash
flclashx-servicename: FlClashX
```
flclashx-servicelogo
Ваш логотип, используемый в виджете ServiceInfo (работает только с активным хедером flclashx-servicename). Поддерживает png/svg.
Использование:
```bash
flclashx-servicelogo: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/remnawave.svg
```
flclashx-serverinfo
Название прокси-группы для отображения в виджете ChangeServerButton. Виджет показывает активный сервер из указанной группы с флагом страны, пингом и кнопкой для быстрого переключения. Если не передаётся — работает фолбек на «Изменить сервер»
**Отображаемые элементы:**
- Флаг страны (автоматически извлекается из имени прокси, если отсутствует — фолбек иконка)
- Название активного сервера
- Текущий пинг с цветовой индикацией (зелёный < 600ms, оранжевый >= 600ms, красный — timeout)
- Кнопка быстрого перехода на страницу прокси
Использование:
```bash
flclashx-serverinfo: Proxy
```
flclashx-background
Устанавливает пользовательское фоновое изображение для приложения. Укажите прямую ссылку на изображение. Опционально через запятую можно задать прозрачность (видимость) фона от 1 до 100 (чем больше — тем заметнее изображение; без параметра — стандартный приглушённый вид).
**Рекомендации для изображения:**
- Формат: PNG, JPG или WebP
- Разрешение: 1920x1080 или выше для десктопа, 1080x1920 для мобильных устройств
- Размер файла: Желательно до 2МБ для лучшей производительности
- Содержание: Используйте изображения с тонкими узорами или градиентами; избегайте слишком ярких или загруженных изображений
- Контраст: Обеспечьте хорошую читаемость текста на фоне
Использование:
```bash
flclashx-background: https://example.com/background.jpg
# с прозрачностью (1-100, выше = заметнее фон):
flclashx-background: https://example.com/background.jpg,30
```
flclashx-settings
Управление настройками приложения через хедер (с возможностью переопределения со стороны клиента). По умолчанию все параметры выключены. Если вы передаёте параметр, то он будет включён. Если не передаёте — останется выключенным.
| Параметр | Описание | По умолчанию |
| :-----------: | -------------------------------------------------------- | :----------: |
| `minimize` | Сворачивать приложение при выходе вместо закрытия | ❌ Выкл |
| `autorun` | Запускать приложение при старте системы | ❌ Выкл |
| `shadowstart` | Запускать приложение свернутым в трей | ❌ Выкл |
| `autostart` | Автоматически запускать прокси при запуске приложения | ❌ Выкл |
| `autoupdate` | Автоматически проверять обновления приложения | ❌ Выкл |
| `openlogs` | Включить логирование (вкладка «Логи» и стрим логов ядра) | ❌ Выкл |
|`closeconnections`| Разрывать активные соединения при смене прокси/режима | ❌ Выкл |
> Примечание: `closeconnections` в самом приложении по умолчанию включён, но при использовании `flclashx-settings` состояние задаётся явно — если не передать токен, опция будет выключена.
Переопределение на стороне клиента: Пользователи могут включить «Переопределить настройки провайдера» в настройках приложения, чтобы применять свою локальную конфигурацию вместо настроек из подписки. Соответствующие переключатели в настройках (в т.ч. «Логи» и «Разрывать соединения») редактируются только при включённом «Переопределить настройки провайдера».
Использование:
```bash
flclashx-settings: minimize, autorun, shadowstart, autostart, autoupdate, openlogs, closeconnections
```
flclashx-globalmode
Данный хедер при FALSE позволяет скрыть все настройки режима прокси из клиента (трей, страница прокси, виджеты смены режима)
Использование:
```bash
flclashx-globalmode: false
```
flclashx-hex
Данный хедер позволяет настроить тему в приложении, возможность передать основной цвет, вариант, и выбрать "Чисто черный режим" параметром `pureBlack`
Варианты:
| Вариант | Название|
| :-----------: | ------ |
| `tonalSpot` | Тональный акцент|
| `fidelity` | Точная передача |
| `monochrome` | Монохром |
| `neutral` | Нейтральные |
| `vibrant` | Яркие |
| `expressive` | Экспрессивные |
| `content` | Контентная тема |
| `rainbow` | Радужные |
| `fruitSalad` | Фруктовый микс |
Использование:
```bash
flclashx-hex: FF5733
flclashx-hex: FF5733:vibrant
flclashx-hex: FF5733:vibrant:pureblack
```
Так-же можно параметры использовать по отдельности:
```bash
flclashx-hex: FF5733
flclashx-hex: vibrant
flclashx-hex: pureblack
```
HEX-коды стандартных тем:
| HEX | ЦВЕТ|
| :-----------: | ------ |
| `795548` | Brown (Коричневый)|
| `03A9F4` | Light Blue (Светло-голубой) - по умолчанию |
| `FFFF00` | Yellow (Желтый) |
| `BBC9CC` | Light Blue Grey (Светло-серо-голубой) |
| `ABD397` | Light Green (Светло-зеленый) |
| `D8C0C3` | Light Pink (Светло-розовый) |
| `665390` | Deep Purple (Темно-фиолетовый) |
flclashx-androidsecure
Данный хедер позволяет принудительно включить Mixed-port:0 только на Андроид-девайсах, при активном 7890 (например) в конфиге.
Использование:
```bash
flclashx-androidsecure: true
```
flclashx-newboard
При `true` включает новый вид главной страницы вместо сетки виджетов: крупное лого и название сервиса, карточка трафика/срока, панель активного сервера (флаг, IP, пинг) с веером доступных локаций, кнопка подключения и нижняя навигация. Редактирование виджетов в этом режиме скрыто. Пользователь может включить тот же вид локально настройкой «Новый вид».
Использование:
```bash
flclashx-newboard: true
```
flclashx-newdomain
Миграция домена подписки. Если значение отличается от текущего хоста ссылки профиля, при следующем обновлении клиент автоматически заменит хост в URL подписки на указанный (путь и параметры сохраняются). Удобно при переезде страницы подписки на новый домен без переустановки профиля у пользователей.
Использование:
```bash
flclashx-newdomain: new.example.com
```
flclashx-buyplan
Прямая ссылка на оплату/продление подписки. Кнопка «Продлить подписку» появляется под карточкой трафика на новой главной (`flclashx-newboard`) только когда до конца подписки остаётся меньше 3 дней (в т.ч. если подписка уже истекла). По нажатию открывается переданная ссылка.
Использование:
```bash
flclashx-buyplan: https://example.com/pay
```
flclashx-buytraffic
Прямая ссылка на докупку трафика. Кнопка «Докупить трафик» появляется под карточкой трафика на новой главной (`flclashx-newboard`) только когда остаётся меньше 10% от лимита трафика. Если сработали оба триггера (`flclashx-buyplan` и `flclashx-buytraffic`), кнопки показываются в один ряд.
Использование:
```bash
flclashx-buytraffic: https://example.com/buy-traffic
```
### YAML-ключи в конфиге
Эти ключи указываются не в HTTP-заголовках ответа, а прямо в YAML-конфиге подписки (в секции `proxy-groups`).
flclashx-override (в группе GLOBAL)
Указывается внутри прокси-группы `GLOBAL`. При `flclashx-override: true` клиент берёт список и порядок прокси из этой группы как «курированный GLOBAL»: в режиме «Глобальный» в разделе Proxies показывается только группа `GLOBAL` ровно с этими элементами и в этом порядке, а сервисные группы (нужные для rule-режима) скрываются. Без флага поведение прежнее — `GLOBAL` формируется ядром автоматически из всех групп.
Использование:
```yaml
proxy-groups:
- name: GLOBAL
flclashx-override: true
type: select
proxies:
- 🎲 Любой доступный
- 🔓 Без VPN
- 🌍 Основной VPN
- 🇩🇪 Германия
- 🇫🇮 Финляндия
```
description (в любой прокси-группе)
Кастомный подзаголовок группы в разделе Proxies. По умолчанию под названием группы показывается её тип (Selector/URLTest/Fallback…) либо текущий выбранный узел; если задать `description`, вместо этого выводится указанный текст. Удобно для понятных подписей вложенных групп.
Использование:
```yaml
proxy-groups:
- name: 🌍 Основной VPN
type: select
description: Авто-выбор лучшей локации
proxies:
- 🇩🇪 Германия
- 🇫🇮 Финляндия
```
### Переопределение настроек конфигурации
По умолчанию следующие параметры конфигурации, полученные от подписки, **не переопределяются** клиентом:
- `allow-lan` - Разрешить подключения из локальной сети
- `ipv6` - Включить поддержку IPv6
- `find-process-mode` - Режим поиска процессов
- `tun-stack` - Сетевой стек режима TUN
- `mixed-port` - Смешанный порт для HTTP/SOCKS прокси
**Переопределение на стороне клиента:** Пользователи могут включить "Переопределить настройки провайдера" или "Переопределить сетевые настройки" в настройках приложения, чтобы применять свою локальную конфигурацию вместо настроек из подписки. Это полезно, когда нужны кастомные сетевые настройки.
## Использование
### Linux
⚠️ Перед использованием убедитесь, что установлены следующие зависимости:
```bash
sudo apt-get install libayatana-appindicator3-dev
sudo apt-get install libkeybinder-3.0-dev
```
### Android
Поддерживаются следующие действия:
```bash
com.follow.clashx.action.START
com.follow.clashx.action.STOP
com.follow.clashx.action.CHANGE
```
## Скачать
## Star
Самый простой способ поддержать разработчиков — нажать на звездочку (⭐) в верхней части страницы.
Если хотите поддержать копеечкой, то можно сделать это тут.
**TON USDT:** `UQDSfrJ_k1BdsknhdR_zj4T3Is3OdMylD8PnDJ9mxO35i-TE`