Java API-обёртка для панели 3x-ui, разработанная @megoRU. Позволяет полноценно взаимодействовать с панелью 3x-ui через HTTP API.
Добавьте репозиторий JitPack и зависимость:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependency>
<groupId>com.github.megoRU</groupId>
<artifactId>3x-ui-wrapper</artifactId>
<version>2.5.2</version>
</dependency>ThreeUIAPI threeUIAPI = new ThreeUIAPI.Builder()
.setHost("https://your-host:port")
.setToken("TestTokenPhQgU9Cr84AqJ9f0hyPE")
.enableDevMode()
.build();
boolean deleted = threeUIAPI.deleteClient("email");
System.out.println("Клиент удалён: " + deleted);ThreeUIAPI threeUIAPI = new ThreeUIAPI.Builder()
.setHost("https://your-host:port")
.setToken("TestTokenPhQgU9Cr84AqJ9f0hyPE")
.enableDevMode()
.build();
ClientBuilder clientBuilder = new ClientBuilder();
clientBuilder.setEmail("TestEmail");
clientBuilder.setId(UUID.randomUUID().toString());
clientBuilder.setLimitIp(3);
clientBuilder.setFlow(FlowEnum.XLTS_RPRX_VISION);
clientBuilder.setEnable(true);
Client client = new Client();
client.setClient(clientBuilder);
client.setInboundId(1);
boolean created = threeUIAPI.addClient(client);
System.out.println("Клиент создан: " + created);Данная библиотека распространяется по лицензии MIT.
updateClientсохраняет текущие поля клиента и применяет только заданные значения. Числовые поля иenableвClientSettingsтеперь nullable:nullозначает не менять, явный0/falseозначает установить значение. Обновление выполняет GET, затем POST; конкурентные изменения одного клиента необходимо сериализовать на стороне приложения.tgIdиспользует 64-битный тип:Longв обновлении иlongпри создании. После обновления зависимости пересоберите приложение (изменились сигнатуры модели).setClientEnable(email, enable)переключает только состояние клиента, не меняя лимиты, срок и реквизиты.setClientsEnable(emails, enable)возвращаетchangedиskipped; проверяйтеskipped, даже если API вернулsuccess: true.deleteClient(email, true)сохраняет статистику; обычныйdeleteClient(email)удаляет её. Удаление затрагивает все привязанные inbound. Для одного inbound используйтеdetachClient.- Бэкапы проверяются по сигнатуре SQLite/PostgreSQL и сохраняются в уникальные временные
файлы
.db/.dump. Вызывающий код должен переместить или удалить возвращённый файл. JSON с ошибкой и HTML больше не сохраняются как успешные бэкапы. - Ошибка обновления/удаления не гарантирует отсутствие изменений: часть inbound могла обработать запрос. Перед повтором проверяйте фактическое состояние панели.
threeUIAPI.setClientEnable("email", false);
threeUIAPI.setClientEnable("email", true);
threeUIAPI.deleteClient("email", true); // сохранить статистику- Исправлено ложное исключение при успешном включении/выключении клиента: отсутствующее поле skipped или null теперь возвращается как пустой список. Реальные пропуски и ошибки API по-прежнему обрабатываются как ошибки.