Marzban-Node 是 Marzban(一款现代化、基于 Web 的 Xray/V2Ray 管理面板)的后端节点服务,负责与代理核心(如 Xray)通信并上报运行状态。但官方 Marzban-Node 默认依赖固定端口和 TLS 配置,在云托管平台(如 Railway)上直接部署常因端口绑定、证书管理等问题失败。x4gKing/Marzban-Node 正是为此而生——它不是简单复制代码,而是通过智能构建时拉取上游源码 + 自动打补丁的方式,让 Marzban-Node 原生适配 Railway 的运行环境,真正实现「点几下就跑起来」。
核心功能
- 零配置适配 Railway:构建时自动克隆 Gozargah 官方 Marzban-Node 仓库,并注入 Railway 兼容补丁,无需修改源码或维护分支
- 动态端口监听:自动读取 Railway 注入的
$PORT环境变量,彻底告别端口冲突和硬编码问题 - 免 TLS 模式开箱即用:默认启用
SERVICE_TLS=false,利用 Railway 边缘 TLS 终止能力,省去证书申请、挂载、续期等繁琐操作 - 安全可选的全链路 TLS:如需更高安全性,仅需设置
SERVICE_TLS=true并上传客户端证书,即可恢复标准双向 TLS 认证 - 自动同步上游更新:每次在 Railway 重新部署,都会拉取最新版 Marzban-Node 源码,永远保持功能与安全同步,无需人工 cherry-pick 补丁
- 极简运维体验:全程通过 Railway Web 控制台操作,无须 SSH、Docker CLI 或 CI/CD 配置,小白也能 5 分钟完成节点接入
适合哪些人用
如果你是以下角色之一,这个项目就是为你量身打造的:
- Marzban 管理员:正为多区域节点部署发愁,希望快速扩展新加坡、东京、法兰克福等地区节点,又不想每台服务器都装 Docker 和配置 Nginx
- 个人代理爱好者:想用 Marzban 统一管理多个 VPS 或云函数节点,但缺乏 Linux 运维经验,讨厌反复调试 TLS 和反向代理
- 开发者/技术博主:需要演示 Marzban 多节点架构,或为用户提供「开箱即用」的节点模板,提升部署成功率和用户体验
- 教育/测试场景用户:临时搭建测试节点验证路由规则、流量统计或订阅分发逻辑,要求快速启停、按需付费、无资源残留
快速上手
- Fork 项目:访问 GitHub 页面,点击右上角 Fork 按钮,将仓库复制到你的账号下
- 一键部署到 Railway:登录 railway.app → 新建项目 → 选择「Deploy from GitHub」→ 找到你 Fork 的仓库 → 点击 Deploy
- 配置 Marzban 面板:部署成功后,在 Railway 服务详情页复制 Public URL(如
https://xxx.up.railway.app),进入 Marzban 后台 → 「Node Settings」→ 添加新节点 → 填入该 URL(无需协议前缀,例如填xxx.up.railway.app:443) - (可选)启用 TLS:若需端到端加密,在 Railway 环境变量中添加
SERVICE_TLS=true和SSL_CLIENT_CERT_FILE=/app/cert.pem,并将从 Marzban 导出的客户端证书内容粘贴为CERT_CONTENT变量值
项目信息
x4gKing/Marzban-Node
GitHub
编程语言:Dockerfile|Star 数:632|开源协议:未明确声明(建议使用前确认)|GitHub 项目地址
对于追求「开箱即用」和「长期免维护」的 Marzban 用户来说,这可能是目前最省心的节点部署方案——它把复杂性留在构建阶段,把简洁性留给每一次部署。


