文档首页

配置生成：预览、下载和让设备使用配置

本页目录：先分清保存与发布 · 第一次生成 · 按钮和结果区 · 各软件入口 · 下载和配置地址 · 发布到 Agent · 常见问题 · 下一步

先分清保存与发布

进入路径：先在顶部选择配置空间，再打开左侧 配置生成。

这里把该配置空间的策略组、规则和各软件基础设置合成客户端能读取的文件。订阅、节点和规则库来自共享资源；被当前配置引用后才参加生成。切换配置空间，相当于切换一套组合方案。

操作	做了什么	什么时候影响设备
保存草稿	保存到 ConfigFlow，供以后编辑、生成和发布	不会立即下发；设备之后主动更新配置地址，也可能读到这些已保存内容
生成 / 预览	按已保存内容生成并显示文本	不修改设备，不代表目标核心已经成功运行
复制 / 下载	把生成内容交给你	你导入客户端并应用后生效
配置 URL	给客户端一个可以再次获取配置的地址	客户端拉取并应用时生效；不是自动推送通知
推送 / 保存并发布	通过 Agent 生成、检查和下发当前配置	以发布结果和设备状态为准；“已提交”不等于“已激活”

不要把未保存的编辑器内容当作工作台的输入。先在相应页面保存，再重新生成。设备已下载的旧文件也不会因为你关闭编辑窗而自动更新。

第一次生成

1. 确认顶部配置空间正确，并已添加可用的订阅或节点。
2. 在策略组中选入节点来源，在规则中指定访问应走哪个策略组。
3. 在“生成软件”选择真实使用的软件，例如 Mihomo。打开“基础配置”或“设置”，按核心设置调整并保存草稿。
4. 点击 生成。查看结果和报错，确认规则顺序、策略组名称、监听地址符合预期。
5. 手动管理客户端时，下载或复制配置 URL；已经接入 Agent 时，确认目标设备和配置绑定后发布。
6. 在客户端确认配置加载成功，再测试一个应直连、一个应代理的实际网站。生成成功只说明文件生成成功，不能证明网络可达。

只部署 DNS 的用户可以直接选择 MosDNS 或 OxiDNS；这两类文件负责域名查询流程，不会代替 Mihomo 等软件建立代理隧道。

按钮和结果区

界面项	用途、推荐操作和结果
生成软件	切换 Mihomo、Surge、Loon、MosDNS、OxiDNS。手机版在下拉框中选择；切换目标不会把一种软件的语法直接搬给另一种软件
基础配置 / 设置	编辑当前配置空间下该软件的设置。先保存再生成；具体字段见核心设置
生成	请求新的生成结果。修改资源或基础配置后需要重做；生成中部分操作不可用是为了避免重复请求
步骤与资源数量	帮助理解当前配置由什么组成。步骤动画不是远端核心逐项检查的实时日志；以最终结果或错误为准
文件名、行数、文本区	显示当前生成的文件。文本区用于查看，不能在这里直接修改并发布；请回到资源、规则或基础配置修改
复制	复制当前已经生成的文本。适合粘贴到客户端或排错；修改设置后先重新生成，避免复制旧结果
下载	下载该软件的生成文件或完整包。下载会按当前已保存数据重新生成；先保存再下载，编辑期间再次核对
预览	部分软件入口打开只读预览窗；可复制、关闭。关闭仅关窗，不会撤销此前已保存的设置
配置 URL / 复制地址	复制当前配置空间对应的软件地址。应让目标客户端能访问其中的域名、端口及协议
推送	先生成结果才能使用；向当前配置空间绑定的、类型相符且在线的 Agent 发布，可能有多个目标。已有发布进行时需等待。范围见下节
返回、关闭	返回页面；有未保存修改时按提示决定保存还是放弃。不要把关闭当作保存

各软件入口

软件	可见入口	适用方式
Mihomo	基础配置、Linux 网关、预览、下载	基础配置写 YAML；节点、策略组和规则由面板合并。Linux 网关属于透明网关部署设置，需结合真实网卡、网段和系统路由使用
Surge	基础配置、Smart、预览、下载	基础配置写 INI；Smart 可给选定策略组设置 Surge 专用优先级，不会改变 Mihomo 策略组类型
Loon	基础配置、预览、导入 Loon、下载	基础配置写 INI；“导入 Loon”调用客户端链接，需要所在设备能够打开 Loon
MosDNS	设置、预览、下载	设置 DNS 上游、规则、缓存等；首次手动部署建议下载完整 ZIP
OxiDNS	设置、下载	常用设置、完整参数和 YAML 是同一份草稿的不同编辑方式；首次手动部署建议下载完整 ZIP

各目标支持的节点协议、策略组和规则语法不同。例如链式代理不能假定在 Surge、Loon 中与 Mihomo 等价。出现转换错误时，按错误定位具体资源，不要通过删掉无关配置试错。

Linux 网关、DNS 安装和绑定设备从首次使用开始；OxiDNS 双机部署另见OxiDNS 高可用。

下载和配置地址

下载文件	内容与用法
mihomo.yaml	Mihomo 完整生成配置；导入后仍需客户端能访问其中引用的订阅和规则地址
surge.conf	Surge 生成配置，交给 Surge 加载
配置空间名称.lcf	Loon 生成配置，文件名取清理后的当前配置空间名称，可下载或使用“导入 Loon”
mosdns-config.zip	MosDNS 配置及配套规则文件；解压后保留目录关系
oxidns-config.zip	OxiDNS 配置、生成的规则和附加文件；保留相对路径，不要只抽出 config.yaml

MosDNS、OxiDNS 的配置 URL 提供主 YAML，不等于 ZIP 中的全部配套文件。已有部署若依赖相对路径文件，必须同时安排这些文件的更新。Agent 发布会走对应部署流程；手动导入者需要自己核对文件是否齐全。

地址中的服务域名由系统设置控制。浏览器能打开面板，不代表远端客户端能访问相同地址；例如 127.0.0.1 在客户端看来是它自己。修改域名后，已经复制出去的旧地址不会自己变成新地址。

配置地址可能包含访问令牌，也可能返回代理凭据；把它作为私人订阅地址保管。若要长期自动更新，使用配置 URL 比反复下载静态文件方便；具体更新周期由客户端及相关订阅设置决定。

发布到 Agent

工作台的 推送 按当前配置空间查找已绑定、在线且软件类型匹配的 Agent。当前空间绑了两台 OxiDNS，工作台推送可能同时覆盖两台；发布前检查Agent 管理中的绑定。Loon 不提供这种 Agent 推送。

核心设置窗口底部的 保存并发布 则提供目标设备选择。它先保存当前草稿，再向所选目标发布；没有可用目标仍可“保存草稿”。从某台 Agent 打开设置时，以窗口显示的配置空间和设备为准，不要只凭背景页面判断。

状态 / 操作	正确理解
保存草稿	仅保存供未来使用的配置；同一配置空间内、同一种软件的多个 Agent 共用这份草稿
目标选择	只选本次需要发布的设备。若原设备绑定改变或已不可用，应重新确认，不能假定会自动换到另一台
保存并发布	保存后生成新内容，检查并发送。不会把工作台之前显示的旧预览直接原样发送
已提交 / 发布中	设备正在处理，需要等待最终结果
已校验待激活	校验完成但还未成为运行配置；到 Agent 页面继续查看和执行允许的激活动作
发布成功	再检查服务在线状态和实际查询/访问；网络、上游账号与客户端指向仍可能有问题
超时、结果未知	不代表一定失败，也不代表已成功。先查看 Agent 事务和运行状态，避免立即重复发布
检查失败	按具体错误修复，如 YAML、缺失文件、重复监听端口或目标版本不支持；保存草稿成功不能代替目标核心检查

同时修改代理规则及 OxiDNS 的“DNS 去向”时，Mihomo 与 OxiDNS 是两个运行服务，应分别发布需要变更的一方。只发布其中一个，另一方可能仍使用旧配置。

常见问题

现象	先检查什么
生成结果没有刚新增的订阅	订阅是否启用、已拉取成功，策略组是否选入该来源，筛选条件是否把所有节点排除了
保存后设备仍用旧设置	是否只保存草稿；客户端是否重新拉取并应用；Agent 发布是否真正完成
预览能生成，核心却启动失败	目标核心版本、文件路径、端口占用、运行权限以及目标核心检查输出
OxiDNS 规则生成了，IP 规则却未参与 DNS	IP 地址规则不能直接变成“查询哪个域名”的条件；见规则中的 DNS 去向
配置 URL 无法访问	服务域名是否从客户端可达，令牌是否有效，反向代理路径与协议是否正确
DNS 工作，网页仍无法代理	DNS 只回答地址；继续检查代理核心、策略组、网关和客户端代理设置

下一步

逐项设置请看核心设置；设备发布和回滚看Agent 管理；尚未安装服务从首次使用开始。