vrr/homeproxy-hiddify
2
0
Fork 0
mirror of https://github.com/1andrevich/homeproxy-hiddify.git synced 2026-08-05 14:52:31 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
mirror of https://github.com/1andrevich/homeproxy-hiddify
1006 commits 4 branches 48 tags 8.2 MiB
Find a file
Exact
Andrevich 0266c5e1c9 Add outbound interface binding, Direct/Proxy IP checks, YouTube test, Clash API for all routing modes, and zh-cn i18n package 
New Features
Outbound Interface Binding

Added Binded interface field to every outbound node — allows pinning a proxy node to a specific network interface. using SO_BINDTODEVICE
The bind_interface value is preserved across subscription updates and not overwritten when nodes are refreshed
Status Page — IP Check

Added Direct IP button: shows the current exit IP and latency of the direct outbound
Added Proxy IP button: shows the exit IP, latency, and active node name of the currently selected proxy in the URLTest/Fallback group
Status Page — YouTube Check

Added YouTube connectivity check alongside the existing Google, Yandex, Baidu, Speedtest checks
Clash API

sing-box Clash API now enabled on 127.0.0.1:9090 for all routing modes
Build
Added luci-i18n-homeproxy-zh-cn package to the build pipeline — Chinese Simplified translation is now distributed as a standalone installable package, for both main and legacy (OpenWRT 23.05) releases
Translations
Added Russian and Chinese Simplified translations for all new UI strings
Fixed missing Russian translation for unchecked
2026-05-25 12:20:08 +04:00
.github Add outbound interface binding, Direct/Proxy IP checks, YouTube test, Clash API for all routing modes, and zh-cn i18n package 2026-05-25 12:20:08 +04:00
htdocs/luci-static/resources Add outbound interface binding, Direct/Proxy IP checks, YouTube test, Clash API for all routing modes, and zh-cn i18n package 2026-05-25 12:20:08 +04:00
po Add outbound interface binding, Direct/Proxy IP checks, YouTube test, Clash API for all routing modes, and zh-cn i18n package 2026-05-25 12:20:08 +04:00
root Add outbound interface binding, Direct/Proxy IP checks, YouTube test, Clash API for all routing modes, and zh-cn i18n package 2026-05-25 12:20:08 +04:00
wiki Add TLS fragmentation details to docs 2026-05-17 14:36:54 +04:00
.gitignore Switch to apk mkpkg and build apk-tools in CI 2026-05-14 19:24:35 +04:00
LICENSE license: relicense under GPL-2.0-only 2023-01-10 15:48:43 +08:00
Makefile Add Mieru, Naïve, SSH, WireGuard parsing, UI fixes, missing node crash fixes, Release naming change 2026-05-19 16:44:33 +04:00
README.md Add wiki docs and link Custom JSON in READMEs 2026-05-16 23:49:54 +04:00
README_ru.md Add wiki docs and link Custom JSON in READMEs 2026-05-16 23:49:54 +04:00

README.md

Русский 🇷🇺 / English

Telegram

HomeProxy-hiddify

A modern ImmortalWrt proxy platform powered by hiddify-core.

Overview

HomeProxy Hiddify is a feature-rich proxy management system built on the ImmortalWrt platform. Multi-Protocol Support: Naive, Mieru, Hysteria, SOCKS, Shadowsocks, ShadowTLS, Tor, Trojan, VLess (XHTTP), VMess, WireGuard, SSH and more.

Key Features

  • Modern Web Interface - Clean and responsive UI for easy proxy management
  • Multi-Protocol Support - Support for various proxy protocols via hiddify-core
  • Node Management - Efficiently manage multiple proxy nodes
  • ACL (Access Control Lists) - Advanced traffic routing and filtering rules
  • NFT Rules - Network filter table rule management for fine-grained traffic control
  • Subscription Support - Built-in subscription management for proxy nodes

⚠️ Early Stage Project

This project is currently in an early stage of development. The web UI configuration is still being developed and will be improved in future versions.

Prerequisites

  • OpenWRT / ImmortalWrt 24.10 or higher (opkg)
  • OpenWRT / ImmortalWrt 25.12 or higher (apk)

Installation

80 MB of free space is necessary

OpenWRT 25.12+ (APK)

1. Install hiddify-core package

wget -O /tmp/homeproxy-hiddify.pub https://github.com/1andrevich/homeproxy-hiddify/releases/latest/download/homeproxy-hiddify.pub
cp /tmp/homeproxy-hiddify.pub /etc/apk/keys/
wget -O /tmp/hiddify-core.apk "https://github.com/1andrevich/hiddify-core/releases/latest/download/hiddify-core_$(. /etc/os-release; echo "$OPENWRT_ARCH").apk"
apk update
apk add /tmp/hiddify-core.apk

2. Install luci-app-homeproxy-hiddify package

wget -O /tmp/homeproxy-hiddify.pub https://github.com/1andrevich/homeproxy-hiddify/releases/latest/download/homeproxy-hiddify.pub
cp /tmp/homeproxy-hiddify.pub /etc/apk/keys/
wget -O /tmp/luci-app-homeproxy-hiddify.apk "$(wget -qO- 'https://api.github.com/repos/1andrevich/homeproxy-hiddify/releases' | grep -o 'https://github\.com/[^"]*luci-app-homeproxy-hiddify[^"]*\.apk' | head -1)"
apk add /tmp/luci-app-homeproxy-hiddify.apk

Once the key is in /etc/apk/keys/ it is trusted permanently — no flag needed for future updates.

OpenWRT 24.10 (opkg)

1. Install hiddify-core package

wget -O /tmp/hiddify-core.ipk "https://github.com/1andrevich/hiddify-core/releases/latest/download/hiddify-core_$(. /etc/os-release; echo "$OPENWRT_ARCH").ipk"
opkg update
opkg install /tmp/hiddify-core.ipk

2. Install luci-app-homeproxy-hiddify package

wget -O /tmp/luci-app-homeproxy-hiddify.ipk "$(wget -qO- 'https://api.github.com/repos/1andrevich/homeproxy-hiddify/releases' | grep -o 'https://github\.com/[^"]*luci-app-homeproxy-hiddify[^"]*\.ipk' | head -1)"
opkg install /tmp/luci-app-homeproxy-hiddify.ipk

Optional

Installation of Russian Language Pack

If using "Custom JSON" — see the Custom JSON Config wiki page for full details.

4. Start the service

/etc/init.d/homeproxy start

The service will auto-start on boot. Monitor logs at Services → HomeProxy-Hiddify → Status.