返回博客
一月 19, 2026指南

如何使用 Marzban 面板安装 VLESS 代理

使用 Marzban 面板设置 VLESS 代理的完整分步指南 - 现代化、用户友好的管理界面,支持多协议。

如何使用 Marzban 面板安装 VLESS 代理

Marzban 是一个功能强大、现代化的基于 Web 的面板,用于管理 Xray 代理服务器。与其他面板不同,Marzban 提供直观的界面、多管理员支持和全面的用户管理功能。本指南将向您展示如何在您的 Hiddence VPS 上使用 Marzban 设置 VLESS 代理,以实现安全、抗审查的互联网访问。

什么是 Marzban?

Marzban 是一个开源、集成 Telegram 的代理管理面板,专为 Xray-core 构建。它提供了一个干净、现代化的仪表板,用于创建和管理代理用户、监控流量和处理订阅。Marzban 支持 VLESS、VMess、Trojan 和 Shadowsocks 协议。

为什么选择 Marzban?

  • 现代化 Web 界面:干净、响应式的仪表板,可从任何浏览器访问
  • 多管理员支持:创建具有不同权限的多个管理员账户
  • 用户管理:轻松创建、修改和删除代理用户
  • 流量监控:实时统计和每个用户的使用跟踪
  • 订阅链接:自动生成客户端的订阅网址
  • Telegram 机器人:内置机器人用于用户管理和通知
  • 多协议:支持 VLESS、VMess、Trojan 和 Shadowsocks
  • 基于 Docker:使用 Docker 轻松安装和更新

先决条件

  • 全新的 Ubuntu 22.04 或 24.04 VPS(推荐 Hiddence VPS)
  • 服务器的 root 或 sudo 访问权限
  • 指向您服务器 IP 的域名(可选但推荐用于 TLS)
  • 基本的命令行知识

步骤 1:准备您的服务器

首先,更新您的系统并安装 Docker(Marzban 在 Docker 容器中运行):

bash
# 更新系统
apt update && apt upgrade -y

# 安装 Docker
curl -fsSL https://get.docker.com | sh

# 安装 Docker Compose
apt install docker-compose -y

# 验证 Docker 安装
docker --version
docker-compose --version

步骤 2:安装 Marzban

使用官方安装脚本下载并安装 Marzban:

bash
# 创建 Marzban 目录
mkdir -p /opt/marzban
cd /opt/marzban

# 下载 docker-compose 文件
wget -O docker-compose.yml https://raw.githubusercontent.com/Gozargah/Marzban/master/docker-compose.yml

# 创建配置文件 .env
wget -O .env https://raw.githubusercontent.com/Gozargah/Marzban/master/.env.example

# 编辑 .env 以设置管理员凭据
nano .env
# 设置 SUDO_USERNAME 和 SUDO_PASSWORD

# 启动 Marzban
docker-compose up -d

# 检查是否正在运行
docker-compose ps

步骤 3:访问 Marzban 仪表板

打开浏览器并导航到端口 8000 上的服务器 IP 地址:

  • 网址:http://您的服务器IP:8000
  • 使用您在 .env 文件中设置的用户名和密码登录
  • 您将看到 Marzban 仪表板,其中包含用户、设置和统计信息的选项
  • 重要提示:首次登录后立即更改默认管理员密码

步骤 4:配置 VLESS 入站

在 Marzban 中设置 VLESS 协议:

  • 在仪表板中,转到“核心设置”或“入站”
  • 使用以下设置添加新的 VLESS 入站:
  • 端口:443(用于 TLS)或任何可用端口
  • 协议:VLESS
  • 网络:TCP 或 WS(WebSocket)
  • 安全:TLS(如果使用域名)或 Reality
  • 如果使用 Reality,将 SNI 配置为流行网站,如 www.microsoft.com
  • 保存入站配置

步骤 5:创建用户并生成链接

添加代理用户并获取连接链接:

  • 点击仪表板中的“添加用户”按钮
  • 设置用户名、流量限制和过期日期
  • 选择您创建的 VLESS 入站
  • 点击“创建”以生成用户
  • 复制订阅链接或二维码
  • 将链接导入到您的 VLESS 客户端(v2rayN、v2rayNG、Hiddify 等)
  • 通过启用代理来测试连接

Marzban 最佳实践

  • 启用 Telegram 机器人集成以便于用户管理
  • 为安全的仪表板访问设置 SSL 证书(使用 Nginx 反向代理)
  • 定期备份 Marzban 数据库(/opt/marzban/db.sqlite3)
  • 监控用户流量以防止滥用
  • 使用 Reality 协议以获得最大的抗审查能力
  • 保持 Marzban 更新:docker-compose pull && docker-compose up -d
  • 配置防火墙以仅允许必要的端口(443、8000)
  • 为管理员账户使用强密码