Xray In Chrome

A minimalist Xray core manager built for Chrome Side Panel. Professional, efficient, and 100% local-first.

Setup Guide

Step 1: Prepare Environment

Download the latest bridge-windows.zip from Releases and extract it. Ensure the folder contains:

/XrayInChrome-Bridge
  ├── xray.exe               # Xray-core executable
  ├── xray-bridge.exe        # Bridge binary
  └── install.bat            # Setup script

Step 2: Register Native Host

On Windows, double-click install.bat and provide the path to xray.exe. This registers the secure communication bridge with Chrome.

Step 3: Load Extension

1. Open Chrome and navigate to chrome://extensions/
2. Enable Developer mode (top right toggle)
3. Click Load unpacked
4. Select the extension folder in the project directory

Step 4: Activation

Click the extension icon in the toolbar to open the Side Panel. Use the Health Check feature to verify the connection status.

Architecture

[Chrome Sidepanel] <-> [Service Worker] <-> [JSON/Stdio] <-> [Go Bridge] <-> [Xray Core]
        |                  |                 |               |               |
   (User Interface)   (State Mgmt)   (Native Messaging) (Process Control)  (Networking)