EasyXrayEasyXray

Settings

Panel configuration and user credentials. All endpoints live under /easyxray/api/v1/setting and require a logged-in session or Bearer token.

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}

Return the shipped (factory) default value per browser-safe setting key, so clients can tell a stored value apart from the default it would fall back to. Per-install material (secret, panelGuid, mTLS keys) and credential fields are never included.

POST
/easyxray/api/v1/setting/factoryDefaults

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/factoryDefaults"
{  "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}

Validate any regular expression with the backend Go RE2 compiler without saving it.

POST
/easyxray/api/v1/setting/validateRegex

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/validateRegex" \  -H "Content-Type: application/json" \  -d '{    "regex": "(?m)^general-purpose$"  }'
{  "success": true,  "msg": ""}

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"}

Test Discord bot connection by sending a test embed to the configured channel.

POST
/easyxray/api/v1/setting/testDiscord

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/testDiscord"
{  "success": true,  "msg": "Test notification sent successfully"}

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}