EZ Encryption Middleware Tutorial (Simple Version + Advanced Version)

This tutorial uses the example where the middleware and V2Board admin backend are on the same server (BaoTa panel).
If your backend and middleware are on different servers, the method is similar.

I. Beginners: Directly Download Release Binary (Recommended)

No need to install Go environment, just use the binary file compiled by the author.

1. Download Release Binary (AMD64 example)

Go to download

BASH

# Switch to root directory
cd /root

# Grant execute permission (ez-api is the executable filename, you can change it freely)
chmod 777 ez-api

⚠️ Note: If your server is ARM architecture, please select the corresponding arm64 version on the Release page.

2. Configure `.env` file

Enter the directory and edit the configuration file:

BASH

nano .env

Reference configuration:

CodeBlock Loading...

3. BaoTa Process Guardian Manager

Add a process guardian to keep the middleware running persistently:

CodeBlock Loading...

4. BaoTa Reverse Proxy

Create a new site (domain like ez.api), point it to the VPS, and configure reverse proxy:

CodeBlock Loading...

And apply for an SSL certificate.

5. Modify frontend configuration `/src/config/index.js`

CodeBlock Loading...

II. Advanced Users: Compile Yourself

EZ Encryption Middleware Tutorial (Simple Version + Advanced Version)

This tutorial uses the example where the middleware and V2Board admin backend are on the same server (BaoTa panel).
If your backend and middleware are on different servers, the method is similar.

I. Beginners: Directly Download Release Binary (Recommended)

No need to install Go environment, just use the binary file compiled by the author.

1. Download Release Binary (AMD64 example)

Go to download

BASH

# Switch to root directory
cd /root

# Grant execute permission (ez-api is the executable filename, you can change it freely)
chmod 777 ez-api

⚠️ Note: If your server is ARM architecture, please select the corresponding arm64 version on the Release page.

2. Configure `.env` file

Enter the directory and edit the configuration file:

BASH

nano .env

Reference configuration:

BASH

# 1. Basic server settings
PORT=3939                                  # Middleware listening port
BACKEND_API_URL=https://api.xxx.com        # Real backend API root address (without /api/v1, no trailing slash)
PATH_PREFIX=/ez/ez                         # Path prefix; empty "" means process all requests

# 2. CORS / Security settings
CORS_ORIGIN=*                              # Allowed CORS origins
ALLOWED_ORIGINS=*                          # Request origin whitelist
REQUEST_TIMEOUT=30000                      # Request timeout (ms)
ENABLE_LOGGING=false                       # Whether to output request logs
DEBUG_MODE=false                           # Whether to output debug logs

# 3. Payment callback bypass verification paths (optional)
ALLOWED_PAYMENT_NOTIFY_PATHS=

# 4. AES encryption/decryption configuration
AES_KEY=4c6f8e5f9467dc71                   # Must match the frontend (16-character hex string)

CodeBlock Loading...

3. BaoTa Process Guardian Manager

Add a process guardian to keep the middleware running persistently:

BASH

# Name
ez-api

# Run User
root

# Process directory
/root/

# Start command
/root/ez-api

CodeBlock Loading...

4. BaoTa Reverse Proxy

Create a new site (domain like ez.api), point it to the VPS, and configure reverse proxy:

BASH

Target URL: http://127.0.0.1:3939

CodeBlock Loading...

And apply for an SSL certificate.

5. Modify frontend configuration `/src/config/index.js`

API_MIDDLEWARE_URL: "https://ez.api"
API_MIDDLEWARE_KEY: "4c6f8e5f9467dc71"

CodeBlock Loading...

EZ Middleware Setup

EZ Middleware Setup

EZ Encryption Middleware Tutorial (Simple Version + Advanced Version)

I. Beginners: Directly Download Release Binary (Recommended)

1. Download Release Binary (AMD64 example)

2. Configure .env file

3. BaoTa Process Guardian Manager

4. BaoTa Reverse Proxy

5. Modify frontend configuration /src/config/index.js

II. Advanced Users: Compile Yourself

EZ Encryption Middleware Tutorial (Simple Version + Advanced Version)

I. Beginners: Directly Download Release Binary (Recommended)

1. Download Release Binary (AMD64 example)

2. Configure .env file

3. BaoTa Process Guardian Manager

4. BaoTa Reverse Proxy

5. Modify frontend configuration /src/config/index.js

II. Advanced Users: Compile Yourself

2. Configure `.env` file

5. Modify frontend configuration `/src/config/index.js`

2. Configure `.env` file

5. Modify frontend configuration `/src/config/index.js`