EasyXrayEasyXray
СправочникСправочник по API

Настройки

Конфигурация панели и учётные данные пользователя. Все эндпоинты находятся под /easyxray/api/v1/setting и требуют активной сессии или токена Bearer.

Return every panel setting: web server, Telegram bot, subscription, security, LDAP. The full JSON blob that the Settings page edits.

POST
/easyxray/api/v1/setting/all

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X POST "https://example.com/easyxray/api/v1/setting/all"
{  "success": true,  "msg": "string",  "obj": null}

Return the computed default settings based on the request host. Useful to preview what a fresh install would use.

POST
/easyxray/api/v1/setting/defaultSettings

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X POST "https://example.com/easyxray/api/v1/setting/defaultSettings"
{  "success": true,  "msg": "string",  "obj": null}

Persist every setting at once. The body mirrors the shape returned by /all. Invalid values (bad ports, missing cert pairs, etc.) are rejected before write.

POST
/easyxray/api/v1/setting/update

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Request Body

application/json
  1. body

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X POST "https://example.com/easyxray/api/v1/setting/update" \  -H "Content-Type: application/json" \  -d '{}'
{  "success": true,  "msg": "string",  "obj": null}

Change the panel admin username and password. Requires the current credentials for verification. The session is refreshed with the new values on success.

POST
/easyxray/api/v1/setting/updateUser

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Request Body

application/json
  1. body
oldUsername*string

Current admin username.

oldPassword*string

Current admin password.

newUsername*string

Desired new username.

newPassword*string

Desired new password.

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X POST "https://example.com/easyxray/api/v1/setting/updateUser" \  -H "Content-Type: application/json" \  -d '{    "oldUsername": "admin",    "oldPassword": "admin",    "newUsername": "newadmin",    "newPassword": "newpass"  }'
{  "success": true,  "msg": "string",  "obj": null}

Restart the entire EasyXray process after a 3-second grace period. The connection drops immediately; the panel comes back online ~5-10 seconds later.

POST
/easyxray/api/v1/setting/restartPanel

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X POST "https://example.com/easyxray/api/v1/setting/restartPanel"
{  "success": true,  "msg": "string",  "obj": null}

Test SMTP connection with stage-by-stage reporting (connect, auth, send). Returns structured result with stage and message.

POST
/easyxray/api/v1/setting/testSmtp

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X POST "https://example.com/easyxray/api/v1/setting/testSmtp"
{  "success": true,  "stage": "send",  "msg": "Test email sent successfully"}

Test Telegram bot connection by sending a test message to the configured chat.

POST
/easyxray/api/v1/setting/testTgBot

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X POST "https://example.com/easyxray/api/v1/setting/testTgBot"
{  "success": true,  "msg": "Test message sent to Telegram"}

Return the built-in default Xray JSON config template that ships with this panel version.

GET
/easyxray/api/v1/setting/getDefaultJsonConfig

Authorization

headerAuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

Response Body

Successful response

application/json
  1. response
success?boolean
msg?string
obj?unknown
curl -X GET "https://example.com/easyxray/api/v1/setting/getDefaultJsonConfig"
{  "success": true,  "msg": "string",  "obj": null}

Сервер

Состояние системы, получение логов, генераторы сертификатов, управление бинарным файлом Xray, а также резервное копирование и восстановление. Все эндпоинты находятся в /easyxray/api/v1/server.

Настройки Xray

Шаблон конфигурации Xray, управление исходящими подключениями, интеграция с Warp/Nord и тестирование конфигурации. Все эндпоинты находятся в /easyxray/api/v1/xray.