快速开始
XLADA 是基于 Xray-core 的代理管理面板。 它为用户、节点、订阅和 Xray 配置提供 Web 界面和 REST API。XLADA 是 Remnawave 的分支，采用 AGPL-3.0 许可证，并强化了 隐私保护和数据控制。
系统由哪些部分组成
| 组件 | 运行位置 | 用途 |
|---|---|---|
| 面板 | 管理服务器 | Web 界面和 REST API |
| 节点 | 每台代理服务器 | 运行 Xray-core，由面板管理 |
| 订阅页面 | 管理服务器 | 展示用户密钥的美化页面 |
最少需要面板和至少一个节点。订阅页面是可选的：没有它时，用户直接获得链接。
管理员浏览器
│ HTTPS
▼
┌──────────────────┐ HTTPS + mTLS + JWT ┌──────────────┐
│ 面板 (xpanel) │ ───────────────────────────────▶ │ 节点 (Xray) │
│ PostgreSQL │ ◀─────────────────────────────── │ 代理服务器 │
│ Valkey │ 仅入站连接 └──────────────┘
└──────────────────┘
▲
│ HTTPS
订阅页面 (xpanel-subpage)
安装面板
需要一台装有 Docker 的服务器，以及一个指向它的域名。
git clone https://github.com/xray-panel/deploy.git /opt/xlada
cd /opt/xlada
cp panel.env.sample .env
chmod 600 .env
# 填写 .env：
# APP_SECRET — openssl rand -hex 32，启动后不可更改
# POSTGRES_PASSWORD — openssl rand -hex 16
# PANEL_DOMAIN, FRONT_END_DOMAIN, SUB_PUBLIC_DOMAIN
# METRICS_USER, METRICS_PASS — 必填，缺少时容器无法启动
docker compose up -d
面板会在 127.0.0.1:3000 上启动。由 nginx 对外提供服务：
cp nginx/panel.conf /etc/nginx/sites-available/xlada-panel
ln -sf /etc/nginx/sites-available/xlada-panel /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d panel.example.com
必须使用 HTTPS
面板代码中有中间件，如果请求缺少 X-Forwarded-For 和
X-Forwarded-Proto: https 头，就会断开连接。没有带 TLS 的反向代理，面板无法工作。
打开 https://panel.example.com —— 面板会提示创建管理员。
密码：至少 24 个字符，必须包含小写字母、大写字母和数字。
连接节点
- 在面板中：Nodes → 创建节点 —— 面板会显示
SECRET_KEY。 - 在代理服务器上：
docker run -d \
--name xpanel-node \
--restart unless-stopped \
--network host \
--cap-add NET_ADMIN \
--ulimit nofile=1048576:1048576 \
-e NODE_PORT=2222 \
-e SECRET_KEY="<面板中的 SECRET_KEY>" \
ghcr.io/xray-panel/node:latest
一分钟后，节点会以已连接状态出现在面板中。