x4gKing/X4G · 上手攻略
- 仓库：x4gKing/X4G
- 链接：https://github.com/x4gKing/X4G
- 分类：engineering / trending
- 作者：Tom
- 更新：2026-07-10
这是什么
X4G 是一个现代化的 VLESS 代理网关（Gateway），用于在 Railway 等平台上快速部署个人代理节点。它提供 Web 管理面板 + Telegram 机器人双入口，支持为每个连接配置流量上限、限速、IP 并发限制和到期时间，适合自建科学上网节点并分享给多人使用。⚠️ 注意：该项目属于网络代理工具，请确保在合法合规的场景下使用。
解决什么问题： 手动管理 VLESS 节点配置繁琐、难以批量管理多人访问权限。X4G 通过图形化面板和 Telegram 机器人，把节点管理、订阅分发、流量统计全部自动化。
核心特性
| 特性 | 说明 |
|---|---|
| 传输协议 | VLESS over WebSocket（vless-ws）、XHTTP（packet-up / stream-up） |
| 内置 HTTP Proxy | 附带 HTTP 代理，无需额外搭建 |
| 管理面板 | Web Dashboard，含流量图表、在线连接、错误日志 |
| 订阅分组 | 将多个配置打包为一个美化的公开订阅页（含 QR Code） |
| 流量/限速 | 每条配置独立设置流量上限（KB/MB/GB）和速率上限（Mbps） |
| IP 限制 | 每条配置可限制同时允许的 IP 数量 |
| TLS 指纹 | 支持 uTLS（chrome / firefox / safari / ios / android / edge 等） |
| ALPN 设置 | 支持手动配置 ALPN |
| Telegram 机器人 | 通过 Bot 管理所有配置，无需打开 Web 面板 |
| 数据持久化 | 状态写入磁盘（需挂载 Volume），重启不丢失 |
快速安装（Railway 一键部署）
第一步：Fork 仓库
点击 GitHub 仓库页面右上角 Fork 按钮，将仓库复制到自己账户。
第二步：Railway 部署
- 登录 Railway.app
- 点击 New Project → Deploy from GitHub repo
- 选择刚才 Fork 的仓库
- Railway 会自动检测并部署
第三步：开启公网域名
在 Railway 项目设置中启用 Public Domain（*.up.railway.app），确保 RAILWAY_PUBLIC_DOMAIN 环境变量被正确填充。
第四步：挂载持久化 Volume（关键步骤）
⚠️ 重要：配置数据默认写入容器内
/data目录。必须为此目录挂载一个持久化 Volume，否则容器重启后所有配置会丢失！
在 Railway 服务设置 → Volumes 中创建 Volume，并挂载到 /data。
第五步：访问 Dashboard
部署成功后访问：https://<your-app>.up.railway.app/dashboard
默认管理密码：X4GKING
核心用法
默认 VLESS 链接
部署完成后，在 Dashboard 主页直接复制默认的 VLESS 链接（无限制配置），在 v2rayNG、NekoBox、Streisand 等客户端中导入使用。
创建带限制的配置
在 Dashboard 中创建新配置时，可设置以下参数：
| 参数 | 说明 | 示例 |
|---|---|---|
| 协议/传输 | vless-ws / xhttp-packet-up / xhttp-stream-up | vless-ws |
| Fingerprint | uTLS 指纹，模拟真实浏览器 | chrome |
| ALPN | 传输层协议协商 | h2,http/1.1 |
| 连接端口 | 任意 1-65535，非仅限 443 | 443 |
| 流量上限 | KB/MB/GB，0=不限 | 10GB |
| 限速 | Mbps，0=不限 | 100 |
| IP 并发 | 同时允许的 IP 数，0=不限 | 3 |
| 有效期 | 天数，空白=永久 | 30 |
Telegram 机器人管理
添加以下环境变量启用 Telegram 管理：
TELEGRAM_BOT_TOKEN=<从 @BotFather 获取>
TELEGRAM_ADMIN_IDS=<你的数字 ID，多个用逗号分隔>
配置后向机器人发送 /start，即可通过聊天界面管理配置。
Telegram 机器人支持： - 📋 查看/开关/删除配置 - ➕ 创建新配置（交互式向导） - 🔗 获取 VLESS 链接和订阅链接 - 🗂 管理订阅分组
订阅分组（Subscription Groups）
不想分享单独的配置链接？可以创建订阅分组：
- 在 Dashboard 或 Telegram 机器人中创建新分组
- 把多个配置加入该分组
- 获得一个公开的订阅页面链接
/p/{uuid_key}，包含图形化配置列表、流量状态和 QR Code - 可为页面设置密码保护
环境变量一览
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
ADMIN_PASSWORD |
否 | X4GKING | Dashboard 登录密码 |
SECRET_KEY |
否 | 自动生成 | Session 签名密钥 |
DATA_DIR |
否 | /data | 数据存储路径（需 Volume） |
TELEGRAM_BOT_TOKEN |
否 | — | Telegram 机器人 Token |
TELEGRAM_ADMIN_IDS |
否 | — | Telegram 管理员数字 ID |
RAILWAY_PUBLIC_DOMAIN |
自动 | localhost | Railway 公网域名（自动） |
典型适用场景
- 自建节点分享：为朋友或小团队搭建代理，通过流量/限速控制公平使用
- 多设备管理：手机、电脑、路由器分别用不同配置，统一从 Dashboard 管控
- 限时访问：生成临时配置（如一天/一周有效），用于短期项目合作
- 流量控制：不想让单一用户耗尽流量？为每人创建独立配置并设上限
坑与注意
⚠️ Volume 丢失配置：如果忘记挂载 Volume，容器重启后所有配置清空，每次重启都要重新来过。第一时间挂载 Volume！
⚠️ 端口并非随意可用：虽然理论上可设置任意 1-65535 端口，但该端口必须在你的服务上实际可达。推荐使用 443 或 80 配合 HTTPS。
⚠️ 订阅链接泄漏：分组订阅页面链接如公开则任何人可访问，可设置密码保护。
⚠️ Railway 冷启动：Railway 免费套餐有休眠机制，长时间不用可能需要重新唤醒节点。
⚠️ uTLS 指纹：在敏感网络环境下，选用 chrome 或 firefox 指纹能提升兼容性，但并非百分百伪装成功。
与同类对比
| 项目 | 协议支持 | 管理面板 | Telegram | 流量控制 | 部署难度 |
|---|---|---|---|---|---|
| X4G | VLESS (ws/xhttp) | ✅ | ✅ | ✅ 每配置独立 | ⭐ 一键部署 |
| v2rayA | 多种 | ✅ | ❌ | ⚠️ 基础 | ⭐⭐ 需要 Docker |
| X-UI | 多种 | ✅ | ✅ | ⚠️ 基础 | ⭐⭐ 需要 VPS |
| sprov-ui | VLESS/VMess | ✅ | ❌ | ⚠️ 基础 | ⭐⭐ 需要 VPS |
X4G 的优势在于 Railway 免 VPS、一键部署 + Telegram 机器人 + 每配置细粒度流量控制，适合不想折腾服务器的用户。
一句话推荐结论
不想买 VPS、想快速在 Railway 上搭一个可管理、可限速、可分享的 VLESS 节点？X4G 是目前门槛最低的方案。 一行代码不用写，Fork + Deploy，10 分钟跑起来。