Xray In Chrome

Tracking since Apr 1, 2026.

Changelog

• Apr 16, 2026
  description

  "Xray In Chrome"是一个小巧轻量并完整开源的前端插件，让你告别那些沉重的客户端软件和框架。
  
  Xray In Chrome is an open-source extension designed to bridge the gap between the Chrome browser and the powerful Xray-core. It allows users to manage proxy servers, subscriptions, and connection states without needing external heavy GUI clients.
    
  Key Features:
     Native Bridge Integration:* seamlessly connects to a local Xray executable using Chrome's secure Native Messaging API.
     Side Panel UI:* A convenient, persistent interface to monitor logs and switch nodes.
     Proxy Management:* Automatically configures Chrome's proxy settings via the PAC/Fixed Servers API based on your active node.
     Subscription Support:* Parse and import VLESS, VMess, Trojan, and Shadowsocks links from subscriptions.
     Privacy Focused:* All configurations are stored locally. No user data is sent to our servers.
    
  Full source code and transparency report are available on our GitHub repository. (https://github.com/warriorrage/XrayInChrome)

  **XrayInChrome** is a powerful tool that integrates Xray core control directly into the browser's side panel. By leveraging the Chrome Native Messaging mechanism, it achieves a seamless connection between the browser UI and system-level network processes, allowing users to manage network proxies efficiently without dealing with complex command lines or tedious configuration files.
  
  ---
  
  ## ⚖️ Disclaimer
  - **Compliance**: The user is solely responsible for ensuring that the use of this project and its derivatives complies with all applicable local laws and regulations.
  - **Assumption of Liability**: Any and all legal liabilities, disputes, or consequences arising from the use of this project and its derivatives shall be borne exclusively by the user.
  
  ---
  
  ## ✨ Core Features
  
  - **🚀 Minimalist Control Center**: Real-time control of Xray core startup, shutdown, and status monitoring via the Chrome Side Panel.
  - **📦 Intelligent Subscription Management**: Support for one-click import of node links, automatically parsing and syncing them to local state without manual JSON editing.
  - **📜 Real-time Log Stream**: View Xray runtime logs directly in the browser interface for rapid connection troubleshooting.
  - **⚙️ Automated Deployment**: Built-in Go-based Native Host with one-click registry installation for secure communication between the extension and system processes.
  - **🛡️ Privilege Separation Architecture**: Employs a low-privilege frontend + high-privilege backend architecture to ensure the security of the browser environment.
  
  ---
  
  ## 📐 System Architecture
  
  XrayInChrome adopts a typical **Privilege Separation** architecture to ensure both operational convenience and system security:
  
  ```text
  [ Chrome Browser ] 
         │
         ▼
  [ Sidepanel UI ]  <───>  [ Background Script ]
                                   │
                                   │ (Chrome Native Messaging API)
                                   ▼
                           [ Go Native Host ]  <───>  [ Windows Registry ]
                                   │
                                   │ (Process Management)
                                   ▼
                           [ Xray Core Process ]  <───>  [ Network Traffic ]
  ```
  
  - **Frontend (Extension)**: Responsible for UI interaction, subscription parsing, and configuration orchestration.
  - **Native Host (Go)**: Responsible for Xray process lifecycle management, physical generation of config files, and system calls.
  - **Xray Core**: The actual binary executing the network proxy logic.
  
  ---
  
  ## 🚀 Quick Start
  
  ### 👤 User Installation Guide
  
  Follow these steps to get XrayInChrome up and running:
  
  1. **Get and Start Setup**: Visit the [GitHub Repository](https://github.com/warriorrage/XrayInChrome/tree/main/native-host) to download and run the setup guide `xray-bridge.exe`.
  2. **Confirm Intent**: Select **'Yes'** in the popup dialog to start installing or updating the bridge.
  3. **Link Core**: Select the `xray.exe` core file on your computer and click OK. This registers the bridge in the Windows Registry, granting Chrome permission to call Xray.
  4. **Verify Connection**: Restart your browser and click the **'Xray in Chrome'** extension button to open the side panel. The bridge will start automatically; confirm that `xray-bridge.exe` status becomes **'Running'**.
  5. **Configure Nodes**: Import proxy nodes in the **'Server'** page and click to select a target node (marked with ✅) as the active configuration.
  6. **Start Core**: Enable the toggle in the top right of the **'Home'** page. This will officially start the `xray.exe` core process. Once the status is **'Running'** and logs are clear, it is started successfully.
  7. **Route Traffic**: In the **'Others'** (System Settings) page, check **'Use Xray Proxy'** and click **'Apply'**. Browser traffic will now be forwarded via Xray.
  
  ---
  
  ## 📂 Project Structure
  
  ```text
  XrayInChrome/
  ├── extension/              # Chrome Extension source code
  │   ├── manifest.json       # Extension manifest (V3)
  │   ├── background.js       # Background service, maintains Native Host connection
  │   ├── sidepanel.js        # Side panel main logic
  │   ├── state.js            # Centralized state management
  │   ├── ui-core.js          # UI base components
  │   ├── log-manager.js      # Log stream processing
  │   └── utils.js            # General utility functions
  └── native-host/            # Go Backend source code
      ├── main.go             # Entry point, handles Native Messaging protocol
      └── pkg/                # Core packages
          ├── messaging/      # Message serialization & communication protocol
          ├── xray/           # Xray process lifecycle management
          ├── platform/       # Platform-specific implementations (Windows Registry, etc.)
          ├── config/         # Xray config generation & parsing
          └── installer/      # Install & uninstall logic
  ```
  
  ---
  
  ## ⚠️ Security Note
  
  This project operates via Chrome's officially supported `Native Messaging` mechanism. This means:
  - **Controlled Communication**: The extension cannot arbitrarily access your file system; all system operations must pass strict validation by the `native-host`.
  - **Explicit Authorization**: Installing the backend requires administrator privileges (modifying the registry), ensuring that installation is a user-perceived and authorized action.
  - **Least Privilege**: The extension only requests necessary API permissions and does not run any third-party remote scripts.
  
  ---
  
  ## 📄 License
  
  MIT License

Permissions & access

Permissions

nativeMessagingsidePanelstorageproxy

Host access

<all_urls>

Screenshots

Similar extensions

Alternatives to Xray In Chrome, ranked by description similarity.

X-Proxy

A modern proxy switcher for Chrome with HTTP(S) and SOCKS5 support

2.0K

★ 4.3

Chrome Xtractor

Extracts browser information, including version, memory usage, installed plugins, permissions, download history, and more.

62

Click switch socks5

Chrome extension: one-click per-page switch between SOCKS5 proxy and direct connection (no proxy). Autosave, S/D/E badge.

1.0K

★ 4.2

911Proxy

911Proxy-使用Chrome代理扩展程序，快速、轻松配置和管理代理服务器。

15

ProxyMaster - 智能代理管理器

更强大的代理管理工具，支持智能切换、规则学习和性能优化

27

ProxySwitch

Professional Proxy Manager.

272

★ 5.0

CRX File Downloader Pro

Effortlessly download CRX files as zip or crx format. The ultimate tool for Chrome extension management and extraction.

291

★ 3.7

Minimal X - Hide X.com Right Sidebar

Hide the right sidebar and some other distracting elements on X.com for a cleaner, distraction-free browsing experience

164

★ 5.0