ASUSWRT Merlin XrayUI

This repository provides a lightweight and efficient UI to manage your Xray VPN services on routers running ASUSWRT-Merlin firmware.

Requirements

SSH Access

Access your router via SSH to execute installation commands.

Prerequisites

• Merlin firmware (384.15 or later, 3006.102.1 or later)
• Entware installed
  • you can use built-in amtm tool to install Entware

Installation

To install the latest version of ASUSWRT Merlin XrayUI, simply run the following command in your router’s SSH terminal:

wget -O /tmp/asuswrt-merlin-xrayui.tar.gz https://github.com/DanielLavrushin/asuswrt-merlin-xrayui/releases/latest/download/asuswrt-merlin-xrayui.tar.gz && rm -rf /jffs/addons/xrayui && tar -xzf /tmp/asuswrt-merlin-xrayui.tar.gz -C /jffs/addons && mv /jffs/addons/xrayui/xrayui /jffs/scripts/xrayui && chmod 0777 /jffs/scripts/xrayui && sh /jffs/scripts/xrayui install

How to uninstall

To uninstall and clean up run the command

/jffs/scripts/xrayui uninstall

Usage

Post-Installation Steps

• Log Out and Back In: After installing, log out from the router's browser UI and then log back in.
• Access the X-RAY Tab: Navigate to the VPN menu item in the router's web UI and look for the new tab labeled X-RAY.

Custom Scripts for Firewall Rules/IPTABLES

You can enhance the flexibility of your Xray configuration by adding custom scripts to handle specific firewall rules during Xray startup and shutdown. These scripts should be placed in the /jffs/xrayui_custom directory and named according to their purpose:

• firewall_server - Executed when Xray starts in server mode.
• firewall_client - Executed when Xray starts in client mode.
• firewall_cleanup - Executed when Xray stops. Ensure the scripts are executable (chmod +x <script>).

FAQ

Q: Telegram group?

A:

Q: What if I already have an Xray configuration?

A: If you already have an Xray configuration file that you want to use, you need to place it in the following location:

/opt/etc/xray/config.json

Once the file is placed here, the ASUSWRT Merlin XrayUI interface will automatically reflect the changes.

Q: How can I configure a simple client on my ASUS router?

A: you can refference this wiki guide

Q: How can I configure a simple xray server on my ASUS router?

A: you can refference this wiki guide

Contributing

If you have any problems with the XRAYUI, feel free to share them by opening an issue. You can also suggest/request a new feature to be created or added. Contributions are welcome and encouraged.

License

XRAYUI is licensed under (CC BY-NC-SA 4.0)