无界互联 无界互联
使用手册

安装与首次运行

从下载安装包到确认节点连通,这一页给出完整顺序。按下面的「首次运行的五步」做完,客户端就处于可用状态。

首次打开客户端后的仪表盘
安装完成后打开客户端,第一屏就是仪表盘:先确认内核在运行、订阅与节点已就绪,再按下面的步骤继续。

系统要求

项目要求
操作系统Windows 10 / 11 64 位。
权限使用 TUN 模式需要管理员权限;开启系统代理同样需要管理员权限。日常只使用系统代理时可先以普通权限运行,遇到权限不足再以管理员身份启动。
内核无需自行安装 mihomo 内核。安装包已内含 mihomo 内核与 wintun TUN 驱动,客户端负责启动与守护。

安装

打开下载页,在 Releases 页面下载 Windows 安装包(NSIS 格式),双击运行并按提示完成安装。当前版本为 0.1.1。

首次运行时,如果数据目录不存在,客户端会依次尝试从历史目录名迁移旧配置,让从老版本升级过来的用户直接沿用原有的订阅与设置。

安装到默认目录即可

保持安装程序给出的默认目录,不要修改到其它位置。

首次启动引导

全新安装首次打开客户端时,会自动弹出一个四步引导,陪你完成最初的设置:

  1. 欢迎——一句话了解客户端:订阅管理、规则分流、流量观测全部在本地完成,无需注册账号。
  2. 导入订阅——直接在引导里粘贴订阅链接完成导入;也可以跳过,稍后在「订阅管理」中添加。
  3. 快速设置——三个推荐开关:开机自动启动、系统通知、内核看门狗,可随时在「设置」中更改。
  4. 开始使用——列出几个小技巧:Ctrl+K 打开命令面板、关闭窗口自动最小化到托盘、遇到网络问题用「网络体检」一键诊断。

每一步都可以点「上一步」回看;点「跳过」或走到最后完成引导后,它不会再自动弹出。从旧版本升级的用户不受影响,不会被动弹出。

首次运行的五步

  1. 进入「订阅管理」,点右上角「添加订阅」,粘贴 http/https 订阅链接(名称可留空,客户端会自动识别),点「确定」。
  2. 打开新增订阅卡片上的启用开关(首个订阅会自动启用)。卡片上出现蓝色「使用中」标签,说明已启用;可以同时启用多个订阅。
  3. 打开「设置 → 网络」,确认「自动启动内核」已开启(默认开启)。开启后内核会在需要时自动启动,无需手动操作。
  4. 打开「设置 → 常规 → 系统集成」,打开「系统代理」。
  5. 回到「仪表盘」,确认内核状态为运行中,并且当前节点显示延迟数值。

让流量走代理的三种方式

客户端不强制接管所有流量,你可以按需要选择覆盖范围:

方式适用场景说明
系统代理最省事,覆盖浏览器等大多数桌面程序。修改 Windows 的 Internet 设置,需要内核正在运行。
TUN 模式全流量接管,覆盖不认系统代理的程序(部分游戏、命令行工具)。需要管理员权限。
应用分流只让指定应用走代理,其余应用保持直连。在「应用分流」页按应用添加规则即可。

数据目录与备份

全部运行期数据都存放在 %APPDATA%\com.unboundlink.desktop,主要内容如下:

文件 / 目录内容
settings.json全部设置。
profiles.json订阅索引。
profiles\{id}.yaml各订阅的原文。
merge.yamlMerge 覆写。
script.js扩展脚本。
config.yaml生成的运行时配置,即内核真正读取的文件。
ui\内置 Web 面板静态文件。
rule_stats.json / traffic_history.json规则命中统计与流量历史。
core_version.txt内核版本记录。

需要整机迁移或重装前,打开「设置 → 维护 → 备份与恢复」,可以导出和导入 JSON 备份。备份内容包含设置、订阅、Merge 配置与内核版本。

补充两点

程序支持单实例,重复启动会回到已有窗口。主窗口、悬浮窗、托盘面板在关闭时都是隐藏而不是退出;需要真正退出时,用「设置 → 关于 → 退出应用」。