进阶指南

快速开始：安装 → 导入 → 选节点 → 接管 → 验证

第一次使用按这五步走；双内核、JS 覆写等进阶内容都在后面的章节，可以先跳过。

双内核引擎：mihomo ↔ sing-box

Crossbow 支持 mihomo 与 sing-box 两种内核。选择时请确认订阅中的节点协议与规则被目标内核支持。配置会按引擎自动转换格式，切换即热重启。

JS 覆写：把订阅改成你想要的样子

配置 → 覆写链 → 新建覆写 → 选择「JS 脚本」，编写 function main(config)， 返回改造后的配置。沙箱执行、无网络无文件副作用，保存时自动试运行。

• 前提：订阅中存在名字含「香港」或「JP」的节点，否则过滤后为空。
• 示例规则引用的「自动选择」组需真实存在于订阅；若组名不同，请同步改写规则或删除该引用——保存时的试运行会当场暴露悬空引用。

function main(config) {
  // 只保留名字含「香港」或「JP」的节点
  config.proxies = config.proxies.filter(p =>
    /香港|JP/.test(p.name)
  );

  // 规则：流媒体走「自动选择」，其余 MATCH 兜底
  config.rules = [
    "DOMAIN-SUFFIX,netflix.com,自动选择",
    "GEOIP,CN,DIRECT",
    "MATCH,自动选择",
  ];
  return config;
}

深链接导入：从任意页面一键订阅

网页上放一个这样的链接，已安装 Crossbow 的用户点击即弹出导入确认：

crossbow://import?url=https%3A%2F%2Fexample.com%2Fsub

url 参数需要 URL 编码。未安装的用户可回落到官网下载页——适合机场/自建服务者在文档里引用。

菜单栏实时速率

内核运行时，菜单栏图标旁实时显示 ↑ 上行 / ↓ 下行（每秒刷新，双行紧凑排版，宽度恒定不抖动）。 轻量模式下照常工作；内核停止自动消失。该功能目前仅 macOS 提供。

混合端口与绕过

混合监听端口供 HTTP 与 SOCKS5 共用，默认 7897。在「设置 → 网络与内核」点击端口旁的「修改」，编辑后点击「应用」或按 Enter；Escape 可取消，失去焦点不会保存。运行中的内核可能短暂重启，系统代理绕过本机与局域网地址。

提示：若 7897 被其他代理工具占用（常见于 Clash Verge 等），开启时会明确报错——换一个端口即可。

需要给同一网络的设备提供代理时，可开启「允许局域网连接」，使用本机局域网 IP 与混合端口。该选项会监听 0.0.0.0，请仅在可信网络开启，并确认系统防火墙规则。

Linux 实验版：先确认支持范围

社区已提供 x86_64 归档，主要在 CachyOS + niri / Wayland 验证。感谢 YangYuS8 的适配与实机反馈。其他发行版和桌面环境尚未全面验收。

发布与开发进展分开看：Linux 关窗后的后台任务、冷启动深链接与原生系统通知改进已合入 main，是否包含在你下载的版本中请核对 发布说明。详细验收记录见 Linux 测试文档。

系统代理与 TUN 怎么选

macOS / Windows 日常浏览可先使用首页的系统代理；需要代理不读取系统代理设置的应用时，在设置中开启 TUN。 本应用的两种方式可同时开启、独立控制。关闭 TUN 后请检查系统代理状态和网络连接。

轻量模式与托盘

设置 → 轻量模式开启后：点关闭窗口 = 代理照常、界面内存释放、托盘常驻。再点托盘图标即恢复窗口。 彻底退出请走托盘菜单「退出」。内核运行时关闭窗口，内核会以交接模式保留，重新打开自动接管。

用通知中心追踪需要处理的问题

点击顶部铃铛查看最近通知。未读与待处理是不同状态：全部已读不会解决故障；进入诊断或设置完成修复后，原记录会显示已恢复。

主题、语言与普通设置成功时不再重复提醒。进度通知收起后任务继续，出错时可查看脱敏详情。记录仅在本次会话中保留，排查长期问题请同时查看日志。

订阅更新：知道更新了什么

在「配置 → 配置来源」选择订阅，先看更新状态，再决定是否手动更新。

从配置快照恢复

配置保存前自动保留最近五份快照。在「配置」页面点击「配置恢复」，按时间和内容选择恢复点。

连接不通时，按证据排查

内核运行、接管配置与网络连通性是不同状态。首页显示运行中，不代表浏览器已经可以访问目标网站。

应用内更新：检查、下载与安装

macOS / Windows 在「设置 → 应用与更新」检查版本。Linux 实验版需手动下载新归档。

Windows 安装与 TUN 服务

Windows x64 安装包附带 CrossbowService，TUN 依赖该服务。安装或更新提示文件被占用时，先关闭其他 Crossbow 实例，按安装器提示重试；服务缺失时使用完整安装包修复。安装包签名与支持范围以发布说明为准。

查看 Windows 安装、服务与升级说明 ↗

配置与数据的位置

macOS 数据在 ~/Library/Application Support/com.richard.crossbow/： store.json（订阅/设置/覆写，保存前自动快照保留 5 份）、runtime/（内核运行时与日志）、binaries/（内核本体）。 旧版 com.crossbow.app 数据会自动迁移；升级前可备份新目录。