{"id":13565689,"url":"https://github.com/yichya/luci-app-xray","last_synced_at":"2026-01-17T02:12:32.442Z","repository":{"id":37027197,"uuid":"311127080","full_name":"yichya/luci-app-xray","owner":"yichya","description":"(Almost) full feature Xray client for OpenWrt","archived":false,"fork":false,"pushed_at":"2026-01-13T21:10:52.000Z","size":185,"stargazers_count":798,"open_issues_count":36,"forks_count":1050,"subscribers_count":18,"default_branch":"master","last_synced_at":"2026-01-13T22:25:04.956Z","etag":null,"topics":["openwrt"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yichya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-11-08T18:25:02.000Z","updated_at":"2026-01-13T21:10:55.000Z","dependencies_parsed_at":"2024-02-27T10:25:24.981Z","dependency_job_id":"7c6c9720-8f11-4d31-a8a6-74e826a69424","html_url":"https://github.com/yichya/luci-app-xray","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/yichya/luci-app-xray","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yichya%2Fluci-app-xray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yichya%2Fluci-app-xray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yichya%2Fluci-app-xray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yichya%2Fluci-app-xray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yichya","download_url":"https://codeload.github.com/yichya/luci-app-xray/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yichya%2Fluci-app-xray/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28492080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T00:50:05.742Z","status":"online","status_checked_at":"2026-01-17T02:00:07.808Z","response_time":85,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["openwrt"],"created_at":"2024-08-01T13:01:53.053Z","updated_at":"2026-01-17T02:12:32.436Z","avatar_url":"https://github.com/yichya.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","📱 Clients"],"sub_categories":["OpenWrt"],"readme":"# luci-app-xray\n\nFocus on making the most of Xray (HTTP/HTTPS/Socks/TProxy inbounds, multiple protocols support, DNS server, bridge (reverse proxy), even HTTPS proxy server for actual HTTP services) while keeping thin and elegant.\n\n## Warnings\n\n* For security concerns, global SOCKS / HTTP inbound (listen on 0.0.0.0, port 1080 / 1081 by default) is deprecated and will be removed in next major version (4.0.0).\n    * These settings are moved to preview app\n    * Use Extra Inbound to manually add ports (avoid using common ports like 1080, also set listen addresses carefully) and adjust related workloads to use that.\n* Since version 3.2.0 sniffing and global custom settings are deprecated.\n    * These settings are moved to preview app. See below for details to enable preview app.\n    * Global custom settings will be removed in version 4.0.0. Use \"Custom Configuration Hook\" for global custom settings.\n    * Sniffing might get completely reimplemented later. Use FakeDNS instead of sniffing to avoid incompatibilities.\n* This project **DOES NOT SUPPORT** the following versions of OpenWrt because of the requirements of firewall4 and cilent-side rendering LuCI:\n    * LEDE / OpenWrt prior to 22.03\n    * [Lean's OpenWrt Source](https://github.com/coolsnowwolf/lede) (which uses a variant of LuCI shipped with OpenWrt 18.06)\n\n    If this is your case, use Passwall or similar projects instead (you could find links in [XTLS/Xray-core](https://github.com/XTLS/Xray-core/)).\n* About experimental REALITY support\n    * it may change quite frequently (before the release of official documents about the protocol). Keep in mind for (maybe) breaking changes.\n* If you see `WARNING: at least one of asset files (geoip.dat, geosite.dat) is not found under /usr/share/xray. Xray may not work properly` and don't know what to do:\n    * try `opkg update \u0026\u0026 opkg install v2ray-geoip v2ray-geosite`\n    * if that doesn't work, see [#52](https://github.com/yichya/luci-app-xray/issues/52#issuecomment-856059905)\n* This project may change its code structure, configuration files format, user interface or dependencies quite frequently since it is still in its very early stage.\n\n## Installation (Manually building OpenWrt)\n\nChoose one below:\n\n* Add `src-git-full luci_app_xray https://github.com/yichya/luci-app-xray` to `feeds.conf.default` and run `./scripts/feeds update -a; ./scripts/feeds install -a`\n* Clone this repository under `package`\n\nThen find `luci-app-xray` under `Extra Packages`.\n\n## Installation (Use GitHub actions to build ipks)\n\nFork this repository and:\n\n* Create a release by pushing a tag\n* Wait until actions finish\n* Use `opkg -i *` to install all ipks from Releases.\n\n## Enable preview app\n\nSome features are deprecated / unstable so they are placed in preview app. To enable preview app:\n\n* Select `Preview or Deprecated` in `Extra Settings` tab\n* Reboot your router\n* There will be a new menu option `Xray (preview)` in `Services`\n\n## Changelog since 3.7.0\n\n* 2026-01-14 chore: bump version\n\n## Changelog since 3.6.0\n\n* 2025-05-13 feat: geodata reader\n* 2025-07-20 feat: geoip in manual transparent proxy\n* 2025-07-24 fix: geosite browser search\n* 2025-07-27 fix: dynamic direct: only cover global servers; increase default timeout\n* 2025-08-20 fix: dynamic direct connection tracking\n* 2025-08-26 fix: dnsmasq global integration mode\n* 2026-01-13 feat: vless encryption; minor DNS tweaks; code cleanups\n* 2026-01-14 feat: hysteria outbound\n\n## Changelog since 3.5.0\n\n* 2024-11-26 chore: bump status version\n* 2024-11-27 chore: use OpenWrt SDK 23.05.5 to avoid using apk\n* 2025-01-05 fix: direct output; remove unused check of geoip direct list\n\n## Changelog since 3.4.0\n\n* 2024-02-18 chore: optimize code style; bump version\n* 2024-02-19 fix: several DNS related validation\n* 2024-02-20 fix: domain match priority; stricter resolve options; socks / http auth\n* 2024-02-23 chore: bump version to 3.4.1\n* 2024-02-27 fix: block requests when leastPing not ready\n* 2024-03-08 feat: multiple ports for one outbound\n* 2024-03-11 feat: expectIPs for outbound domain resolving; restart on dnsmasq config change\n* 2024-03-14 feat: add version info display in status\n* 2024-03-17 fix: add ACL for version info\n* 2024-04-23 fix: use zstd for OpenWrt SDK decompression\n* 2024-05-03 fix: reality deserialization issue\n* 2024-06-26 feat: support ext in geoip direct codes\n* 2024-07-26 chore: minor code and style fixes\n* 2024-11-22 fix: dnsmasq jail adaptation; firewall improvements\n* 2024-11-25 feat: basic splithttp support\n* 2024-11-26 feat: httpupgrade support; avoid overriding mark\n\n## Changelog since 3.3.0\n\n* 2024-01-19 chore: bump version\n* 2024-01-24 feat: add alias to LAN Hosts Access Control\n* 2024-02-04 fix: avoid firewall restart failure \u0026 some minor adjustments\n* 2024-02-16 feat: dns hijacking preview; deprecate global http / socks inbound\n* 2024-02-17 feat: add username / password for extra socks / http inbound\n\n## Changelog since 3.2.0\n\n* 2023-12-20 chore: bump version\n* 2023-12-22 chore: optimize list folded format; add roundRobin balancer\n* 2024-01-04 chore: start later than sysntpd; change firewall include file path\n* 2024-01-18 feat: make \"Resolve Domain via DNS\" available to all outbounds\n* 2024-01-19 feat: socks / http outbound\n\n## Changelog since 3.1.0\n\n* 2023-10-24 chore: bump version\n* 2023-10-25 fix: set required for some fields; remove unused code\n* 2023-10-26 fix: allow empty selection for extra inbound outbound balancer\n* 2023-10-30 fix: blocked as nxdomain for IPv6\n* 2023-10-31 chore: bump version to 3.1.1\n* 2023-11-01 feat: custom configuration hook\n* 2023-11-02 feat: specify DNS to resolve outbound server name\n* 2023-11-30 fix: dialer proxy tag\n* 2023-12-14 fix: default gateway\n* 2023-12-20 chore: deprecate sniffing; move some preview features to main app; add custom configuration hook; refactor web files\n\n## Changelog since 3.0.0\n\n* 2023-09-26 Version 3.0.0 merge master\n* 2023-09-27 fix: sniffing inboundTag; fix: upstream_domain_names\n* 2023-10-01 fix: default configuration\n* 2023-10-06 chore: code cleanup\n* 2023-10-19 feat: detailed status page via metrics\n* 2023-10-20 feat: better network interface control. **Requires reselection of LAN interfaces in** `Xray (preview)` -\u003e `LAN Hosts Access Control`\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=yichya/luci-app-xray\u0026type=Date)](https://star-history.com/#yichya/luci-app-xray\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyichya%2Fluci-app-xray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyichya%2Fluci-app-xray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyichya%2Fluci-app-xray/lists"}