mrkeyoor.com_
Tue 01 Sept 17:43 UTC
Self-Hostedevaluationupdated 25 Aug 2026

personal-edge-proxy review

Personal Edge Proxy is a Chinese-language configuration guide and example set for a private Xray proxy using Hysteria2, REALITY, Cloudflare WARP, and an optional fixed SOCKS5 exit. No English guide is included; it solves the design problem of keeping entry protocols separate from the route a destination ultimately sees.

+579stars / 7d
Verdict

Our harness could not run Personal Edge Proxy because it has no detected language ecosystem or Dockerfile, so treat it as an architecture note and sanitized configuration set, not verified software. Its inbound-versus-outbound explanation and SSH safety boundary are unusually clear for experienced Chinese-reading operators. Do not use it to make service-access promises, and do not hand the examples to an agent before replacing placeholders, narrowing routes, and proving recovery access.

We ran it

Screenshot of personal-edge-proxy (github.com/yding-git/personal-edge-proxy)

Answers from our run

Did you run personal-edge-proxy yourself?

No. GitHub reports no primary language for it, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use personal-edge-proxy?

English-only readers: the README and both topic guides are Chinese, with only the AI maintainer instructions written in English.

What are the alternatives to personal-edge-proxy?

Xray-core, Hysteria, sing-box. Its inbound-versus-outbound explanation and SSH safety boundary are unusually clear for experienced Chinese-reading operators.

Setup1/5Manual VPS, secrets, routes, clients, and optional egress services
Docs4/5Specific Chinese guides and a careful English agent-maintainer file
Community2/5Current August 2026 push, but no open issue or release history
Maturity2/5Production-audited examples without a runnable repository test path

Who it’s for

Chinese-reading self-hosters who already administer a Linux VPS and understand Xray routing.
AI-service users who need separate, policy-compliant egress paths and can verify regional availability themselves.
Operators who want Hysteria2 as the main entry, with optional TCP fallback and selected WARP routing.
People deploying with an AI agent only after a human has established and verified SSH key access.

Who it’s NOT for

English-only readers: the README and both topic guides are Chinese, with only the AI maintainer instructions written in English.
Anyone seeking a supported application or one-command installer: the repository contains examples and guidance, not a detected software ecosystem or Dockerfile.
Users expecting a guaranteed way around account checks or regional rules: the README explicitly says WARP is not residential and cannot guarantee service acceptance or prevent risk controls.
Operators who cannot safely manage root access, TLS material, UUIDs, proxy credentials, firewall ports, and route ordering on a public VPS.

Setup reality

We did not run this repository. Our harness found no supported ecosystem because GitHub reports no primary language, and the repository has no Dockerfile. There are therefore no measured install, build, test, dependency, or audit results to report.

Deployment is manual infrastructure work. The baseline needs a Linux VPS, root or sudo access, a public address, TCP and UDP reachability, Hysteria2 authentication, TLS material, and a compatible client. WARP, REALITY, a fixed SOCKS5 service, and Cloudflare Tunnel each add separate software, secrets, and routing decisions.

The documented reference host uses Ubuntu 24.04, Xray 26.3.27, UDP 24443 for Hysteria2, TCP 443 for REALITY, and a WARP local proxy on 127.0.0.1:40000. Those are examples, not lab-verified defaults. The guide requires a human to prove SSH key login before an agent changes the server.

Entry protocols and exit identity stay separate

Hysteria2, REALITY, and Cloudflare Tunnel control how a client reaches the VPS. Direct routing, WARP, and fixed SOCKS5 control how traffic leaves it. Adding TCP fallback does not change the address seen by a service when traffic still exits directly from the VPS. This distinction prevents a common design mistake.

The reference uses Xray 26.3.27 on Ubuntu 24.04. Hysteria2 listens on UDP 24443, REALITY on TCP 443, and WARP on 127.0.0.1:40000. Private and link-local destinations are blocked before service routes. These are maintainer examples, not our measurements.

Chinese-only guides limit the audience

The README, WARP guide, SOCKS guide, and configuration comments are Chinese. No English translation is present. AGENTS.md is English, but it targets AI maintainers rather than ordinary users. An English-only operator may miss warnings about route order, credentials, or failure behavior.

The 10,831-character README explains five profiles, SSH bootstrap, server requirements, ports, fail-closed routing, secrets, and official references. It tells users what to omit as well as what to add. That matters because the full example contains more components than many personal nodes require.

What happened when we ran it

We did not run Personal Edge Proxy. GitHub reports no primary language, our harness found no supported ecosystem, and the repository has no Dockerfile. It contains Markdown and sanitized examples rather than a package with detectable install or test commands. We have no measured dependency count, build, test, timing, or audit result.

A JSONC file can parse while its network behavior remains wrong for one host, Xray version, firewall, or client. The example calls for 1 vCPU, 1 GB RAM, Ubuntu 24.04 or Debian 12+, public IPv4, TCP, and UDP. Our sandbox did not provision or verify those requirements.

Hysteria2 is the smallest useful profile

The maintainer recommends Hysteria2 as the everyday entry and says users can stop when UDP works and direct egress is acceptable. REALITY is an optional TCP backup. Cloudflare Tunnel is an emergency entry. The public example is a menu rather than a mandatory stack.

A minimal host still exposes UDP 24443 and needs authentication plus TLS material. Provider policy and client compatibility matter. The README suggests 1 vCPU and 1 GB RAM, then says line quality, packet loss, peak-hour behavior, and UDP availability matter more than an advertised speed.

WARP affects selected traffic only

The WARP guide leaves the Linux default route on the VPS network. Xray sends only selected traffic to the local SOCKS5 listener. SSH, system updates, ordinary downloads, and fixed upstream connections keep their intended routes. A WARP failure therefore has a smaller effect.

The example uses port 40000 and tells operators to compare direct and proxied exit addresses. It warns that warp-svc and its socket can remain present while requests fail. Monitoring should test an outbound request. Domain rules also need maintenance as service endpoints change.

Fixed SOCKS5 is stable but unencrypted

An optional route pins selected Claude or Anthropic domains to a fixed exit. The guide says Claude does not require residential IP, WARP is not residential, and no route guarantees account acceptance. Fixed egress only makes sense when one public address must survive VPS moves or WARP reconnections.

SOCKS5 does not encrypt the proxy hop. A remote upstream on port 1080 is not a VPN, even when HTTPS protects application content. Use a trusted provider or controlled encrypted path. Keep credentials out of shell history, process lists, logs, chats, and issues.

AI deployment begins after human SSH setup

The agent guide requires a human to log in, generate an Ed25519 key locally, install only the public key, and verify key login. Password access stays enabled until that succeeds. The agent should use an existing SSH agent or configuration rather than reading private keys.

The full example has placeholders for UUIDs, REALITY keys, Hysteria2 passwords, TLS files, Cloudflare tokens, and upstream credentials. A leaked value or wrong route can be costly. Keep provider-console recovery and make staged changes, even on the suggested 1 GB host.

The August 2026 push has no release history

The repository was pushed on August 25, 2026. GitHub showed no open issues or pull requests, and the latest-release endpoint returned no release. The README pins current versions and directs readers to official Xray and Cloudflare docs where commands can change. Users still have to reconcile versions.

Operational confidence must come from staged route verification because no public issue history shows how mistakes are handled. The MIT tree is easy to read, but our lab could not supply runtime evidence without a supported target.

Use the architecture, then own the result

Chinese-reading administrators get a useful reference for separating Hysteria2, REALITY, WARP, and fixed egress roles. Xray-core is the official schema source. Hysteria is simpler when one UDP proxy is enough. sing-box suits operators who prefer a different general proxy core.

No repository can guarantee access to OpenAI, Gemini, Claude, or a regional service. Confirm availability at the exit location and follow service terms. Personal Edge Proxy is a set of examples, not an operated product. Because we could not run it, final proof belongs to the administrator.

Alternatives

ProjectWhat it isPick it when
Xray-core gh↗The underlying proxy platform with protocol, routing, transport, and outbound primitives.pick this instead when you want official software and schemas rather than one maintainer's deployment opinion.
HysteriaA QUIC-based proxy focused on performance over unreliable or lossy networks.pick this instead when Hysteria2 alone solves the connection problem and layered egress routing is unnecessary.
sing-box gh↗A general proxy platform supporting many inbound, outbound, DNS, and routing configurations.pick this instead when you prefer one actively developed proxy core and can design the policy yourself.

What people are saying

  1. [velocity-scout] yding-git/personal-edge-proxy

Sources

  1. Personal Edge Proxy repository and Chinese README
  2. WARP outbound guide
  3. Fixed SOCKS5 guide
  4. AI maintainer and deployer guide

More self-hosted reviews

v2 · OpenShell · wigolo · Mindwtr · club-3090 · reclip · the whole board →