Marzban-Panel 是一个专为中文及波斯语社区优化的轻量级开源部署方案,它不直接复制 Marzban 源码,而是通过智能 Docker 构建流程,在每次部署时自动拉取官方 Gozargah/Marzban 最新代码、编译前端、集成 Xray 核心,并打包成可运行镜像。它完美解决了传统面板部署中「版本滞后、仓库臃肿、升级繁琐」三大痛点,特别适合希望快速上线、长期免运维的代理服务管理员。
核心功能
- 全自动版本同步:每次部署都从官方仓库(Gozargah/Marzban)拉取最新
master或指定分支代码,确保你永远用上最稳定/最新的功能与安全修复 - 零源码依赖的极简仓库:整个 GitHub 项目仅含 Dockerfile、railway.toml 等数个配置文件,体积不足 10KB,Fork 即用,无冗余代码污染
- 开箱即用的 Railway 一键部署:深度适配 Railway 平台,支持环境变量自动注入(如端口
$PORT)、PostgreSQL 插件无缝对接,5 分钟完成生产级面板上线 - 灵活的数据库支持:默认内置 SQLite,开箱可用;只需设置
SQLALCHEMY_DATABASE_URL环境变量,即可秒切 Railway 托管的高可用 PostgreSQL - 自动化管理员创建:通过
SUDO_USERNAME和SUDO_PASSWORD变量,首次启动即生成超级管理员账号,省去手动 CLI 操作 - 可定制的 Marzban 版本控制:修改
MARZBAN_REF构建参数(如设为v1.8.0或dev分支),轻松锁定或切换任意发布版本
适合哪些人用
如果你是以下角色之一,Marzban-Panel 就是为你量身打造的「懒人友好型」部署方案:
✅ 独立搭建机场/代理服务的个人站长,追求「一次部署、长期省心」;
✅ 不熟悉 Python/Docker 深度构建,但想用上 Marzban 最新特性的技术爱好者;
✅ 使用 Railway 作为主力云平台,希望避免服务器运维、SSH 登录等复杂操作;
✅ 中文或波斯语用户,需要清晰文档与本地化友好的部署路径;
✅ 小团队或教育场景下需快速克隆、批量部署多个隔离面板实例。
快速上手
只需 4 步,5 分钟内拥有专属 Marzban 面板:
- Fork 项目:访问 GitHub 仓库,点击右上角 Fork 到你的账号
- Railway 部署:登录 railway.app → New Project → “Deploy from GitHub Repo” → 选择你 Fork 的仓库
- 配置管理员(推荐):在项目 Settings → Variables 中添加两个环境变量:
SUDO_USERNAME(如 admin)SUDO_PASSWORD(强密码) - (可选)启用 PostgreSQL:在 Railway 添加 Postgres 插件后,将生成的连接 URL 填入变量
SQLALCHEMY_DATABASE_URL即可
等待 Build 完成(约 3–5 分钟),打开 Railway 分配的域名,即可用刚设置的账号登录管理后台!
项目信息
x4gKing/Marzban-Panel
GitHub
537
Stars
938
Forks
Dockerfile
—
编程语言:Dockerfile(基于 Python/React 的 Marzban 官方镜像构建)
GitHub Star 数:537(持续增长中)
开源协议:未明确声明(建议使用前查看仓库 LICENSE 文件或联系作者)
GitHub 项目地址:https://github.com/x4gKing/Marzban-Panel
它不是另一个 Marzban 分叉,而是一把帮你「永远站在最新版起跑线」的智能钥匙——告别手动更新、代码冲突和部署焦虑,让专业代理面板真正变得简单、可靠、可持续。


