HTML · 项目报告

x4gKing/3x-ui-Upgrade

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

已完成 打开 GitHub
X
1,018星标
2,065Fork
1Issue
未知许可证

分析结果

项目分析

该仓库用于在 Railway 上一键部署 Heimdall(3x-ui 的改进分支)面板,并通过 nginx 反向代理将管理面板、订阅接口以及 VLESS/WebSocket 入站流量统一暴露在 Railway 分配的单一端口上。项目默认使用 SQLite,无需额外数据库,适合快速搭建轻量级 Xray/3x-ui 管理环境。

适用领域 代理服务管理面板 / Xray/VLESS/WebSocket 部署 / Railway PaaS 部署 / nginx 反向代理 / 轻量级容器化运维 / 订阅链接管理
配置难度 中等。对于熟悉 GitHub、Docker 和 Railway 的开发者,部署难度较低;但要正确理解 nginx 反向代理、WebSocket Path、VLESS 参数、持久化 Volume 和安全加固,仍需要一定网络运维经验。
商业价值 该仓库的商业价值主要体现在快速部署和运维效率上,可作为轻量级代理面板的 PaaS 部署模板,节省从零配置 Docker、nginx 和单端口转发的时间。对于个人、小团队或技术验证场景价值较高;但由于许可证不明确、平台合规风险、代理服务敏感性和可扩展性限制,不太适合作为未经改造的正式商业产品直接使用。
01

技术亮点

  • 面向 Railway 的单端口部署设计,适合 PaaS 平台限制场景。
  • 将管理面板、订阅接口和 VLESS/WebSocket 入站通过 nginx 统一反代到同一域名。
  • 默认 SQLite 部署,降低数据库配置复杂度。
  • 部署步骤相对简单,只需 GitHub 仓库加 Railway 自动构建。
  • README 给出了完整的入站配置、客户端链接模板和订阅链接路径。
  • 仓库 Star 数约 490、Fork 数约 921,说明有一定使用关注度。
  • 适合快速验证 Heimdall/3x-ui 在 Railway 上的可用性。
02

目标用户

  • 需要在 Railway 上快速部署 3x-ui/Heimdall 面板的开发者
  • 熟悉 Docker、nginx 和反向代理的运维人员
  • 需要管理 VLESS/WebSocket 入站配置的个人用户或小团队
  • 希望使用 SQLite 简化部署的轻量级服务维护者
  • 研究容器化代理面板部署方案的技术用户
03

配置要求

  • Railway 项目需要支持 Dockerfile 构建。
  • Railway Networking 的 Target Port 必须设置为 3000。
  • nginx 对外统一监听 Railway 分配的端口,容器内监听 3000。
  • Heimdall/3x-ui 面板默认路径为 /managepanel/。
  • VLESS 入站的 Listen Port 固定为 8080。
  • VLESS 入站推荐配置:Protocol 为 VLESS,Network 为 ws,Security 为 none,Listen IP 为空或 0.0.0.0。
  • WebSocket Path 需要与客户端链接中的 path 参数一致,例如 /cdn。
  • 默认数据库为 SQLite,数据存储在 /etc/x-ui。
  • 如需避免 Redeploy 后配置丢失,需要在 Railway 中为 /etc/x-ui 挂载持久化 Volume。
  • 默认账号密码为 admin/admin,首次登录后必须修改。
  • 当前版本未内置 Postgres 支持,如需高用户量或集中化数据库,需要自行修改 Dockerfile 和 start.sh。
04

适用场景

  • 在 Railway 上使用单端口运行 3x-ui/Heimdall 面板
  • 通过统一域名访问管理面板、订阅地址和 VLESS WebSocket 入站
  • 快速生成 VLESS 客户端连接配置
  • 为少量用户提供订阅链接管理
  • 测试 Heimdall/3x-ui 与 nginx 反代在 PaaS 环境中的兼容性
  • 作为自定义 Docker 部署 3x-ui 类面板的参考模板
05

部署与配置

  • 创建一个新的 GitHub 仓库。
  • 将 Dockerfile、nginx.conf.template、start.sh 放到仓库根目录。
  • 在 Railway 中选择 New Project → Deploy from GitHub repo,并选择该仓库。
  • Railway 会自动识别 Dockerfile 并构建镜像,构建过程中会下载最新版 Heimdall。
  • 部署完成后进入 Railway 的 Settings → Networking,点击 Generate Domain 生成域名。
  • 确认 Railway 的 Target Port 设置为 3000,因为 nginx 在容器内监听 3000 端口。
  • 访问 https://你的域名.up.railway.app/managepanel/ 进入管理面板。
  • 使用默认账号 admin / admin 登录,并立即修改默认密码。
  • 在面板中创建 VLESS 入站,Listen Port 固定填写 8080,Network 选择 ws,Security 选择 none,Path 可填写例如 /cdn。
  • 根据 README 中的模板生成客户端 VLESS 链接,使用 Railway 域名、443 端口、TLS、WebSocket Path 等参数。
  • 如需持久保存配置,在 Railway Volumes 中挂载 Volume 到 /etc/x-ui。
06

风险与注意事项

  • 项目用途涉及代理协议和流量转发,在不同地区、网络环境或服务商条款下可能存在合规风险,使用前需自行确认合法性和平台政策。
  • 默认账号 admin/admin 存在严重安全风险,部署后若未立即修改可能被接管。
  • Railway 免费或低配资源可能不适合高并发或大流量使用,存在性能、限流或封禁风险。
  • 默认 SQLite 适合小规模使用,高用户量场景可能出现性能和并发瓶颈。
  • 如果不挂载 Volume,容器重建或 Redeploy 后面板配置、用户和入站信息可能丢失。
  • README 中未提供完整源码结构说明,仓库主要像部署模板,长期维护和安全更新依赖上游 Heimdall/3x-ui。
  • license 字段为空,商业使用、二次分发或修改发布时存在许可证不明确风险。
  • nginx、Xray、面板三者组合部署,排查问题需要一定网络和容器知识。
  • Railway 域名和端口映射依赖平台机制,平台策略变更可能影响可用性。
  • 面板暴露在公网,若缺少访问控制、强密码和及时升级,可能成为攻击入口。

历史记录

热榜历史快照

2026-07-15 第3名 新收录 · github_search
2026-07-14 第3名 新收录 · github_search
2026-07-13 第5名 新收录 · github_search
2026-07-12 第7名 新收录 · github_search
2026-07-11 第16名 新收录 · github_search