Python · 项目报告

x4gKing/X4G

该仓库暂未提供 GitHub 项目描述。

已完成 打开 GitHub
X
3,827星标
7,232Fork
12Issue
未知许可证

分析结果

项目分析

X4G 是一个基于 Python 的现代化网关服务,用于部署 VLESS over WebSocket / XHTTP 隧道,并内置 HTTP Proxy 与 Web 管理面板。项目主打在 Railway 上快速部署,支持生成 VLESS 配置链接、二维码、流量限制、连接统计、实时启停链接、uTLS Fingerprint、ALPN、端口和并发 IP 限制等功能。README 主要为波斯语,项目定位偏向个人代理网关/隧道服务管理。

适用领域 代理网关 / VLESS / Xray / V2Ray 生态 / WebSocket 隧道 / HTTP Proxy / 网络隧道管理 / 流量统计 / Railway 云部署 / 个人网络工具
配置难度 中等。对熟悉 GitHub Fork、Railway 部署和 VLESS 客户端的用户来说部署较简单;但若要长期稳定、安全地运行,并实现数据持久化、访问控制、监控和合规使用,则需要一定后端和网络代理经验。
商业价值 该项目更适合个人工具、技术研究或小规模网络隧道管理,商业化价值有限。其价值主要体现在快速部署、面板化管理、多链接限流和客户端配置生成。如果要用于商业场景,需要补齐许可证、合规审查、用户认证、数据库持久化、计费系统、安全审计、日志监控、滥用防护和服务稳定性保障。
01

技术亮点

  • 部署路径简单,面向 Railway 的一键部署体验较友好。
  • 提供可视化 Dashboard,包含统计、流量图表和实时连接信息。
  • 支持为每个链接设置独立流量限制,适合多用户或多设备管理。
  • 支持二维码输出,方便移动端客户端导入。
  • 每个配置可单独启用或禁用,便于临时管控。
  • 支持自定义 uTLS Fingerprint 和 ALPN,提高客户端兼容性和可调试性。
  • 支持自定义连接端口,不局限于 443。
  • 支持限制每个配置的同时在线 IP 数。
02

目标用户

  • 熟悉 V2Ray / Xray / VLESS 配置的开发者
  • 需要快速搭建个人代理或隧道网关的用户
  • 希望通过 Railway 一键部署代理服务的用户
  • 需要按链接限制流量、管理多个用户配置的个人或小团队
  • 研究 WebSocket 隧道、HTTP Proxy、代理面板实现的 Python 开发者
03

配置要求

  • 需要 GitHub 账号用于 Fork 仓库。
  • 需要 Railway 账号用于云端部署。
  • 需要启用 Railway Public Domain,否则 RAILWAY_PUBLIC_DOMAIN 可能无法正确生成链接。
  • 客户端需要支持 VLESS over WebSocket / XHTTP,例如 v2rayNG、NekoBox、Streisand 等。
  • 如手动设置端口,目标端口必须在部署环境中真实开放并可访问。
  • Fingerprint 可配置为 chrome、firefox、safari、ios、android、edge、360、qq、random、randomized 等。
  • ALPN 可配置为默认值,或手动设置为 h2,http/1.1、http/1.1 等。
  • 并发 IP 限制可按配置单独设置,0 表示无限制。
  • 当前 README 表明链接和流量统计为内存存储,重启后会丢失;如需持久化,需要自行接入 Redis 或 PostgreSQL。
04

适用场景

  • 在 Railway 上快速部署一个 VLESS over WebSocket 网关
  • 通过管理面板生成不同的 VLESS 分享链接
  • 为不同用户或设备创建独立配置并设置流量上限
  • 通过二维码快速导入到 v2rayNG、NekoBox、Streisand 等客户端
  • 查看流量统计、连接状态和实时使用情况
  • 临时开启或关闭某个配置链接
  • 测试不同 Fingerprint、ALPN、端口参数对连接兼容性的影响
05

部署与配置

  • 1. 在 GitHub 上 Fork 该仓库到自己的账号。
  • 2. 登录 Railway.app。
  • 3. 创建 New Project,选择 Deploy from GitHub repo。
  • 4. 选择 Fork 后的 X4G 仓库。
  • 5. 等待 Railway 自动构建和部署。
  • 6. 在 Railway 项目设置中启用 Public Domain,确保应用拥有公网域名。
  • 7. 部署完成后访问 https://your-app.up.railway.app/dashboard。
  • 8. 在 Dashboard 中复制默认 VLESS 链接,导入到 v2rayNG、NekoBox、Streisand 等客户端。
  • 9. 如需创建限流链接,进入链接管理页面创建新的配置。
06

风险与注意事项

  • 项目用途涉及代理、隧道和流量转发,在部分地区或网络环境下可能存在合规风险,使用者应确保符合当地法律法规、云服务商条款和网络管理要求。
  • README 明确说明数据为 in-memory 存储,Railway 服务重启后链接、限额和统计数据会重置,不适合生产环境直接使用。
  • 未声明开源许可证,商业使用、二次分发和修改发布存在法律不确定性。
  • 仓库描述为空、topics 为空,文档较少且主要为波斯语,对中文开发者不够友好。
  • Stars 408 但 Forks 1121,Fork 数异常高于 Stars,可能与一键部署类代理项目的传播方式有关,需要谨慎评估代码安全性。
  • 代理服务若未做好鉴权、速率限制或访问控制,可能被滥用为开放代理,带来封禁、账单、法律或安全风险。
  • Railway 等 PaaS 平台可能限制代理、隧道或高流量网络服务,存在被暂停服务的可能。
  • 未从 README 看到持久化数据库、用户认证强度、审计日志、TLS 配置细节等生产级安全说明。
  • 如果生成的管理面板暴露在公网且认证不足,可能导致配置泄露或服务被他人控制。

历史记录

热榜历史快照

2026-07-11 第1名 新收录 · github_search
2026-07-10 第1名 新收录 · github_search
2026-07-09 第2名 新收录 · github_search
2026-07-08 第20名 新收录 · github_search