vrr/homeproxy-hiddify
2
0
Fork 0
mirror of https://github.com/1andrevich/homeproxy-hiddify.git synced 2026-08-22 23:26:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
mirror of https://github.com/1andrevich/homeproxy-hiddify
1010 commits 4 branches 48 tags 8.2 MiB
Find a file
Andrevich 577e96b436
Delete .gitignore
2026-06-22 13:00:28 +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 generate_client: emit transport host with the correct JSON type per transport 2026-06-16 10:56:50 +04:00
wiki Add TLS fragmentation details to docs 2026-05-17 14:36:54 +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.