Need help with luci-app-v2ray?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

879 Stars 223 Forks 215 Commits 98 Opened issues


LuCI support for V2Ray

Services available


Need anything else?

Contributors list

# 17,291
73 commits


Luci support for V2Ray

This branch is new LuCI for OpenWrt 19.07 and later.

For legacy version: Branch legacy

Release Version Latest Release Download Total Download


Install via OPKG (recommend)

  1. Add new opkg key:
wget -O kuoruan-public.key
opkg-key add kuoruan-public.key
  1. Add opkg repository from kuoruan:
echo "src/gz kuoruan_universal" \
  >> /etc/opkg/customfeeds.conf
opkg update
  1. Install package:
opkg install luci-app-v2ray
opkg install luci-i18n-v2ray-zh-cn

We also support HTTPS protocol.

  1. Upgrade package:
opkg update
opkg upgrade luci-app-v2ray
opkg upgrade luci-i18n-v2ray-zh-cn

Manual install

  1. Download ipk files from release page

  2. Upload files to your router

  3. Install package with opkg:

opkg install luci-app-v2ray_*.ipk


  • jshn
  • ip (ip-tiny or ip-full)
  • ipset
  • iptables
  • iptables-mod-tproxy
  • resolveip
  • dnsmasq-full (dnsmasq ipset is required)

For translations, please install


You may need to remove

before installing this package.


  1. Download V2Ray file from V2Ray release link or V2Ray ipk release link.

  2. Upload V2Ray file to your router, or install the ipk file.

  3. Config V2Ray file path in LuCI page.

  4. Add your inbound and outbound rules.

  5. Enable the service via LuCI.


Package files is in branch luci2

Download with Git:

git clone -b luci2 luci-app-v2ray

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.