配置配置文件

配置配置文件是完整的 Xray-core 配置，节点据此组装自己的工作配置。配置文件中包含 inbound、outbound 和路由规则；节点只取用其中已启用的那些 inbound。

创建配置文件

Config Profiles → Create Config Profile。指定名称（2–30 个字符），然后在编辑器中编辑配置的 JSON。

最小配置文件如下：

{
  "log": { "loglevel": "info" },
  "inbounds": [
    {
      "tag": "VLESS",
      "port": 443,
      "protocol": "vless",
      "settings": { "clients": [], "decryption": "none" },
      "streamSettings": { "network": "tcp", "security": "reality" }
    }
  ],
  "outbounds": [
    { "protocol": "freedom", "tag": "DIRECT" },
    { "protocol": "blackhole", "tag": "BLOCK" }
  ],
  "routing": { "rules": [] }
}

面板会自动解析 config.inbounds 中的 inbound：每个都会获得 tag、type、port 和 security。这些 inbound 随后会在分组和主机中被选择。

说明

配置文件不会「替您」配置 Xray——内核的语法和行为在 Xray 文档中有说明。这里重要的只是面板如何保存和下发配置。

Snippet

Snippet 是可复用的配置片段。它免去了在数十个配置文件中复制相同规则的工作。

[
  {
    "ip": ["geoip:private"],
    "outboundTag": "BLOCK"
  }
]

Snippet 按名称在 outbounds、routing.rules、 routing.balancers 和 snippets 数组中引入：

"routing": {
  "rules": [
    { "snippet": "Block Private" }
  ]
}

Snippet 对所有配置文件通用：修改一个片段会立即改变所有引入它的地方的行为。

注意

无法删除仍被使用的 snippet——面板会检查配置文件中对它的引用。

应用到节点

每个节点都有一个活动配置文件和一份活动 inbound 列表。它们可以在节点卡片（Change Profile）中修改，也可以在 Bulk actions → Profile modification 页面批量修改——一次为多个节点设置同一份 inbound 列表。

修改配置文件后，使用它的节点会在下一次同步时获得新配置；如果客户端集合没有变化，Xray 不会重启。强制重启——Restart node 按钮，参见节点。

版本与回滚

面板不保存配置文件的历史版本：配置文件只有当前状态和 updatedAt。因此回滚是您的任务，最好提前准备好：

# 修改前对数据库做快照
docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

实用做法：

在附近保留一份配置文件的副本，名称类似 Sample-backup，一旦出问题就把节点切换到它；
在进行大规模更改前，把配置文件的 JSON 导出到文件或 git；
以小步修改配置，以便弄清究竟是什么破坏了配置。

危险

节点上切换配置文件会立即生效。错误的 Xray 配置意味着该配置文件的所有节点上的代理都无法工作——请在保存前检查 JSON。

接下来

节点 —— 应用配置文件和重启。
主机 —— 订阅中的 inbound。
分组 —— 用户对 inbound 的访问。
升级 —— 备份与迁移。

创建配置文件​

Snippet​

应用到节点​

版本与回滚​

接下来​

创建配置文件

Snippet

应用到节点

版本与回滚

接下来