Muse
f6d652019d
Design as decided 2026-10-21 (replaces the raw-JSON egress editor idea): the forwarding form lives on the inbound, and the entry agent's egress entries are compiled from it on every config pull — never snapshotted. - model: Inbound.Forwarding (JSON text) via AutoMigrate; panel-side metadata only, never reaches xray itself - service/forwarding.go: ForwardingSpec (mode direct/forward; landing managed|manual), save-time validation (managed target must exist and be a SOCKS-family landing — the fork's SK5 inbound is 'mixed'; no self-forward; manual endpoint/protocol sanity), live resolution (managed: concrete listen IP wins, else hosting node's address; credentials from the target's first account), and the compiler that appends one socks/http outbound (tag fwd-<inboundId>) plus a prepended inboundTag rule per forwarding inbound - buildXrayConfig agent path: compile runs after applyAgentEgress, so entries ride on the live template (or stored egress override) and template edits keep flowing; unresolvable entries skip with a warning instead of failing the whole config - UpdateInbound's field-merge now carries Forwarding (its absence was caught by the smoke: adds worked, updates silently kept the old spec) - GET /panel/api/inbounds/forwardTargets: managed-landing candidates (id/remark/tag/listen/port/node name) — credentials never exposed - frontend: new Forwarding tab in the inbound form (mode, landing type, managed picker, manual endpoint with link import incl. base64 form), adapter round-trips the spec as a JSON string like settings; en/zh strings; generated API types refreshed Acceptance: unit tests for parse/validate/resolve/compile incl. the dynamic-recompile proof (template edit + spec edit both reflected), and an end-to-end smoke (real binary, two agent nodes, all inbound writes in browser form-urlencoded format): 22/22 PASS — see P9-REPORT.md.
3x-ui-agent
基于上游 3x-ui v3.7.0 的二次开发 fork：节点 agent 化。节点鸡不再跑完整面板，只跑一个轻量 agent（约 60MB 内存），由主控统一管理、下发 xray 配置。
本仓库托管在自建 Gitea：https://git.881218.xyz/rogue/3x-ui-agent，二进制从本仓库的 Releases 下载。不要使用上游的一键安装脚本/命令（install.sh、update.sh 等仍指向原版，会装成上游原版，与本 fork 不兼容）。
架构
- 主控：完整 3x-ui 面板，唯一的配置可信源。管理节点、入站、客户端，下发完整 xray 配置（含出站、路由）到各 agent。
- Agent：跑在节点鸡上，通过注册 token 向主控注册。定时拉取主控下发的 xray 配置并应用，上报心跳和流量。节点下发仅支持 VLESS / SS2022 两类入站（本 fork 的取向）。
同一个二进制、两种角色：不带参数运行是主控面板，x-ui agent --config /etc/x-ui/agent.json 运行是 agent。
安装
二进制下载：本仓库 Releases，按架构选 x-ui-linux-amd64 或 x-ui-linux-arm64。
仓库根目录的
install-master.sh/install-agent.sh是一键脚本，下载源已迁至本仓 Gitea Releases（tagv3.7.0-agent.1），可直接使用；也可按下面步骤手动部署。
主控
mkdir -p /usr/local/x-ui/bin /etc/x-ui
# 1. 放主控二进制（Releases 下载的 x-ui-linux-<架构>）
cp x-ui-linux-amd64 /usr/local/x-ui/x-ui && chmod +x /usr/local/x-ui/x-ui
# 2. 放 xray 二进制与 geo 文件到 bin/ 子目录
# 纯控制面部署（节点全走 agent）可禁用本机 xray：不放，或放了之后 chmod -x
cp xray-linux-amd64 /usr/local/x-ui/bin/
cp geoip.dat geosite.dat /usr/local/x-ui/bin/
启动（二选一）：
- Debian/Ubuntu（systemd）：把仓库的
x-ui.service.debian复制为/etc/systemd/system/x-ui.service，然后systemctl daemon-reload && systemctl enable --now x-ui。 - OpenWrt（procd）：用 init 脚本以
/usr/local/x-ui/x-ui为命令启动，工作目录/usr/local/x-ui。
数据库在 /etc/x-ui/x-ui.db。面板端口按设置，默认 2053，首次登录默认账号 admin / admin，请登录后立即修改。
Agent（节点鸡）
先在主控侧为该节点生成注册 token（建节点 → 用面板 API Token 签发绑定该节点的 agent token，完整步骤见 docs/AGENT.md），然后在节点鸡上：
mkdir -p /usr/local/x-ui/bin /etc/x-ui
# 1. 放同一个 x-ui 二进制（与主控同版本）
cp x-ui-linux-amd64 /usr/local/x-ui/x-ui && chmod +x /usr/local/x-ui/x-ui
# 2. 放 xray 二进制与 geo 文件（agent 不负责下载，需手动放置）
cp xray-linux-amd64 /usr/local/x-ui/bin/xray && chmod +x /usr/local/x-ui/bin/xray
cp geoip.dat geosite.dat /usr/local/x-ui/bin/
# 3. 写 agent 配置
cat > /etc/x-ui/agent.json <<'EOF'
{
"master_url": "http://主控地址:2053",
"token": "<主控签发的注册 token>",
"node_name": "节点名"
}
EOF
chmod 600 /etc/x-ui/agent.json
master_url走内网用http://；走https://需可信证书（自签连不上）。- agent 另有独立的运行时配置
config-agent.json（生成于bin/）；agent.json可选api_port指定 xray stats API 端口（部署口径 62790，metrics 端口为其下一位 62791）。 - 启动：Debian 把仓库的
systemd/x-ui-agent.service复制到/etc/systemd/system/后systemctl enable --now x-ui-agent；OpenRC 用仓库的openrc/x-ui-agent放到/etc/init.d/x-ui-agent。
agent 约 30 秒后拉到配置并启动 xray，节点在面板显示在线。更细的 agent 说明（出站/路由下发、验证、故障排查）见 docs/AGENT.md。
卸载
主控
# 先停服务：systemctl disable --now x-ui（或 /etc/init.d/x-ui stop）
rm -f /etc/systemd/system/x-ui.service # 或删掉对应的 procd init 脚本
rm -rf /usr/local/x-ui /etc/x-ui
Agent
# 先停服务：systemctl disable --now x-ui-agent（或 rc-service x-ui-agent stop）
rm -f /etc/systemd/system/x-ui-agent.service # 或 /etc/init.d/x-ui-agent
rm -rf /usr/local/x-ui /etc/x-ui
（/etc/x-ui 里含数据库与 token 配置，确认不再需要再删。）
使用流程
- 主控侧建节点并签发 agent 注册 token（见 docs/AGENT.md）
- 节点鸡按上面步骤部署 agent，填入主控地址和 token
- 在「入站列表」创建入站（VLESS / SS2022），「部署到」选择在线的 agent 节点
- 主控自动把完整 xray 配置下发到节点，客户端即可连接
内存占用（实测）
| 内存 | |
|---|---|
| agent + xray | 约 63MB |
| 完整 3x-ui 面板 | 130–160MB |
另有路由器主控精简版构建（剥离 xray-core 库，见仓库内 PANEL-LITE-SPEC.md），面向纯控制面部署，内存显著更低。
与原版的区别
- 节点不再需要安装完整面板
- 主控是唯一可信源，节点配置全部由主控下发
- 节点在线状态由 agent 心跳维持
- 添加节点支持 Agent 类型，使用注册 token 接入
License
GPL-3.0（继承上游 3x-ui）