数字音频志 · Est. 2020 数播 · Roon · 古典唱片 · 磁带文化

Epoch Audio

Music will keep us alive — 又一个音乐的起点

其他 · 2026.10.21

WenLink 使用指南

WenLink 现在是内测版。安装包暂时不公开下载，想试的朋友，在主页的群里私信我索取。用的时候遇到问题，按第六节告诉我。

WenLink 能做什么、为什么这样做、和 AirPlay、RAAT 这些方案比怎么样，在介绍文章里写过了。这一篇只讲怎么用：先把卡农设好，再在电脑上装播放端。

电脑上的播放器 → WenLink 声卡 ──网线──▶ 卡农 ──USB──▶ DAC
   （播放端：Mac、Windows）              （接收端）

最少步骤

在家里，电脑和卡农接在同一个路由器下时，只要三步。两边都没有「确认」这一步：

  1. 卡农：在网页的「切换音源」里选 WenLink，点「应用」（第一节）。
  2. 电脑：装好 WenLink（Mac 见第二节；Windows 目前是测试版，见第三节）。
  3. 电脑：在声音输出或播放器的输出设备里选 WenLink，开始播放。

局域网里只有一台卡农时，电脑会自己找到它。下面几种情况要多做一步：

情况多做的一步见
局域网里有好几台卡农在 Mac 上用 wnlctl receiver <名字> 选一台，只需一次第二节第 2 步
卡农设成了「只允许我批准的设备」每台电脑第一次连接时，到卡农网页上点一次「允许」第一节第 3 步
电脑和卡农不在同一网段两边各填一次对方的 IP第四节
Mac 上用 Apple Music、浏览器等没有独占模式的应用，又想原样输出在「音频 MIDI 设置」里把 WenLink 的采样率改成和歌曲一样第二节第 4 步

准备

要求
接收端卡农 Canon，固件 3.57 或更新
DACUSB DAC，插在卡农上
网络卡农和电脑接在同一个路由器下，都用网线。Wi-Fi 没有测过，不推荐。不在同一网段见第四节
MacmacOS 12 或更新，Apple 芯片、Intel 芯片都可以
Windows测试版，见第三节

一、接收端：卡农

1. 接线、升级固件

  1. DAC 用 USB 线插在卡农上，卡农用网线接路由器，接通电源。
  2. 用浏览器打开卡农的网页（平时设置卡农的那个页面）。首页「系统」一栏能看到固件版本，低于 3.57 时点「检查更新」，升级完按提示重启。

2. 打开 WenLink

  1. 在首页「音频」旁边点「切换音源 →」。
  2. 在「其他音源」里选 WenLink，点页面底部的「应用」。WenLink 这一行显示「运行中」，就打开了。

几点说明：

  • 其他音源只能开一个。 AirPlay、DLNA、Spotify Connect、HQPlayer NAA 等和 WenLink 互斥，选了 WenLink，原来那个就停了。
  • Roon Ready 可以和 WenLink 同时开着，但 Roon 优先。 Roon 一开始经 Roon Ready 往卡农播放，WenLink 就会被停掉；Roon 播完，WenLink 不会自己恢复。想再用 WenLink，回到这一页重新选 WenLink，点「应用」。
  • 首页「输出」里的「输出模式」是给 Roon Ready、DLNA 这些音源用的，对 WenLink 不起作用，不用为它改。

3. 访问控制：谁可以用这台卡农

「切换音源」这一页往下，有「WenLink 访问控制」，两种方式选一种：

方式适合要做什么
同一网段的设备都可以使用（默认，推荐）家里什么都不用做。电脑上装好 WenLink、选中这台卡农就能播放，和 AirPlay 一样
只允许我批准的设备合租、办公室等和别人共用的网络每台电脑第一次连接时，到卡农网页上点一次「允许」

选了「只允许我批准的设备」，新电脑这样放行：

  1. 在电脑上装好 WenLink，选中这台卡农（见第二节）。
  2. 回到卡农的网页，点「等待允许」旁边的「刷新」，这台电脑就会出现在列表里，显示的是电脑的名字。音源列表里 WenLink 那一行也会提示「1 台设备等待允许」。
  3. 点「允许」，马上就能播放。
  • 批准一次就够了。电脑换了 IP、WenLink 升级了，都不用重新批准。
  • 不想再让某台电脑用，在「已允许」里点「移除」。正在播放的这一次不会被打断，之后它就要重新允许。
  • 切换访问控制方式会重启 WenLink，正在播放的会中断。
  • 最下面的「高级：手填电脑的地址」一般用不到，只有电脑和卡农不在同一网段时才需要（见第四节）。

WenLink 没有加密，访问控制只防别人误用，挡不住有意的攻击。请只在自己信任的家庭网络里用。

二、播放端：Mac

装好后，Mac 的声音输出里会多出一个叫 WenLink 的设备，Roon、Apple Music、浏览器等都可以选它。

1. 安装

安装包暂时不公开下载：在主页的群里私信我，我会把 WenLink.pkg 和 WenLink.pkg.sha256 发给你。安装包没有经过 Apple 公证，所以第一次打开时 macOS 可能会拦一下，放行一次就好：

  1. 把收到的 WenLink.pkg 和 WenLink.pkg.sha256 存到「下载」文件夹，双击 WenLink.pkg。直接打开了安装器的话，跳到第 4 步。
  2. 系统提示无法打开，点「完成」。不要点「移到废纸篓」。
  3. 放行一次：
    • macOS 15 及以后：打开「系统设置 → 隐私与安全性」，往下翻到「安全性」，在「已阻止 WenLink.pkg」旁边点「仍要打开」，输入密码，再点一次「仍要打开」。
    • macOS 12–14：在访达里按住 Control 点 WenLink.pkg，选「打开」，在弹出的对话框里再点「打开」。
  4. 安装器打开后一路点「继续」，最后输入 Mac 的登录密码。

安装器会重启系统的音频服务，正在播放的声音会中断一两秒。想核对文件在传送中没有被改动，可以在终端运行下面这条命令，显示 WenLink.pkg: OK 就对了（可选）：

cd ~/Downloads && shasum -a 256 -c WenLink.pkg.sha256

2. 连接卡农

局域网里只有一台卡农时，什么都不用做，WenLink 会自己找到它。

有好几台时，在终端里列出来，再按名字选一台：

wnlctl list
wnlctl receiver EpochCanon-AB12

EpochCanon-AB12 换成 list 列出的名字，也就是卡农在 AirPlay、DLNA 里显示的那个名字。选过一次之后，卡农换了 IP 也能自动找回。

如果卡农设成了「只允许我批准的设备」，这时到卡农的网页上点「允许」（见第一节第 3 步）。

3. 选 WenLink 播放

系统声音、浏览器、视频：打开「系统设置 → 声音 → 输出」（macOS 12 是「系统偏好设置 → 声音 → 输出」），选 WenLink。看视频时声画同步不用另外设置，WenLink 会把延迟报给系统。

提示音：在「声音」设置里，把播放提示音（音效）的设备设成 Mac 自带的扬声器。这样新消息的提示音不会混进正在听的音乐。

Roon：

  • 只听 Roon 曲库的话，直接用卡农的 Roon Ready 更省事，信号路径也最清楚。WenLink 留给 Roon 以外的声音。
  • 要让 Mac 上的 Roon 走 WenLink：在「设置 → 音频」里启用 WenLink；DSD 的播放方式选 DoP（WenLink 会在 Mac 上把它拆回原生 DSD 再发出）；在 Device Setup 里把 Resync Delay 设为 500 ms 或更长。
  • Roon 开着独占模式（Exclusive Mode）时，其他应用的声音出不来，见第五节。

Audirvana、TIDAL、Qobuz 等播放器：能开独占模式就开，并让它按曲目切换采样率；DSD 选 DoP。

Apple Music、浏览器等没有独占模式的应用：采样率要自己在「音频 MIDI 设置」里改，见下一步。播放时也尽量别让别的应用出声。

4. 采样率：在「音频 MIDI 设置」里改

Mac 上，WenLink 以什么采样率播放，由 macOS 决定：

  • 开了独占模式的播放器（Roon、Audirvana 等）会按每首歌自己切换，不用管。
  • 其他应用（Apple Music、浏览器、视频软件等）不会切换。macOS 按 WenLink 当前设定的格式输出，歌曲的采样率和它不一样时，会先重采样再送出去，就不再是原来的比特了。WenLink 装好后默认是 48 kHz，而 CD 和大部分无损音乐是 44.1 kHz。

这时要手动改：

  1. 打开「音频 MIDI 设置」：在「应用程序 → 实用工具」里，或者按 ⌘ 空格，输入「音频 MIDI 设置」。
  2. 在左边的列表里选 WenLink。
  3. 在右边的「格式」里，选和歌曲一样的采样率，例如 CD 选 44.1 kHz；位深选 24 位。
  • 列表里只有 DAC 能原样播放的采样率。
  • 这个设置不会跟着歌曲变。换听不同采样率的歌，要回来再改。
  • 现在的格式可以用 wnlctl status 核对，见第 6 步。重启 Mac 或重装 WenLink 后，也看一眼是不是还是你设的值。

5. 音量

WenLink 没有系统音量，键盘上的音量键对它不起作用。请在功放或 DAC 上调音量。在播放器里调音量会改动数据，声音就不再是原样送出的了。

6. 查看状态

wnlctl status

它会显示：是否在线、连着哪台卡农、DAC 型号、当前格式，以及正在播放的这一路是否原样送出（bit-perfect）。

想改这台 Mac 在卡农网页上显示的名字，用 wnlctl name "客厅的 MacBook"；wnlctl name "" 恢复为电脑名。

7. 升级、卸载

升级：拿到新版本后，用和第一次相同的方法安装，直接覆盖即可。选好的卡农、这台 Mac 的名字和身份都会保留，不需要重新设置，也不需要重新批准。

升级时如果 Roon 开着，装完后 Roon 往 WenLink 播放会提示「音频设备初始化出错」。按 ⌘Q 完全退出 Roon，再重新打开就好；这台 Mac 上跑的是 RoonServer 的，重启 RoonServer。原因是安装器重启了系统的音频服务，Roon 还记着重启前的设备。

卸载：在终端运行下面这条命令，会提示输入密码：

sudo wenlink-uninstall

它会删除 WenLink 和 wnlctl，并重启音频服务。设置会留在系统里，以后重新安装时沿用。

三、播放端：Windows

正式版还在开发。 测试版已经能装，但驱动还没有正式签名，要先把 Windows 切到测试模式，步骤见《WenLink Windows 测试版安装说明》。安装包同样在主页的群里私信索取。

卡农从固件 3.57 起去掉了 Scream，由 WenLink 取代。原来在 Windows 上用 Scream 的，升级后到 Windows 版出来之前，暂时没有替代。

已经定下来的有这些：

  • 系统要求：Windows 10 2004 或更新。
  • 用法和 Mac 一样：装好后多出一块系统声卡，在声音设置或播放器的输出设备里选它。
  • 播放器用 WASAPI 独占模式：Roon、foobar2000、JRiver 都支持。DSD 选 DoP，WenLink 会在电脑上拆回原生 DSD 再发出。
  • 不提供 ASIO 驱动：WASAPI 独占本身就是 bit-perfect，原因在介绍文章第八节。

正式版出来后，我会在这里补上安装步骤。

四、电脑和卡农不在同一网段时

比如电脑连的是路由器的访客网络，或者两边分在不同的 VLAN。这时电脑自动找不到卡农，「同一网段的设备都可以使用」也放行不了它，所以两边要各填一次对方的 IP：

  1. 卡农：在「切换音源」这一页的「WenLink 访问控制」里，展开最下面的「高级：手填电脑的地址」，填上电脑的 IP（多台电脑用空格分开），点「保存」。这里填的地址在两种访问控制方式下都能播放。保存会重启 WenLink，正在播放的会中断。
  2. Mac：在终端里按地址指定卡农，把 IP 换成卡农的：
wnlctl receiver 192.168.0.194

Mac 的 IP 在「系统设置 → 网络」里能看到；卡农的 IP 就是你打开它网页时用的那个地址。

  • 按地址填写，换了 IP 就要重填。 任何一边的 IP 变了，都要回来改。最好在路由器里给两边都设成固定 IP（DHCP 保留）。
  • 网段之间要能互通。 路由器要允许电脑访问卡农的 UDP 4020 端口。很多路由器的访客网络默认和主网络隔离，这时怎么填都连不上，请把电脑接回主网络。

五、常见情况

看到的情况怎么办
电脑上显示「离线」先看卡农网页上 WenLink 是不是「运行中」：Roon 经 Roon Ready 播放过之后，它会被停掉（见第一节第 2 步）。再确认电脑和卡农接在同一个路由器下。中间隔着访客网络、VLAN 等不同网段时，按第四节两边各填一次 IP
显示「等待批准」卡农设成了「只允许我批准的设备」。打开卡农的网页，在「等待允许」里找到这台电脑（显示的是电脑名），点「允许」
显示「被其他播放端占用」另一台电脑正在用这台卡农。先到先得：那台停下约 2 秒后，这台才能接手；它切歌、短暂暂停时不会被抢走
提示局域网里有好几台接收端在 Mac 上 wnlctl list，再 wnlctl receiver <名字> 选一台
断网、卡农重启、Mac 睡眠唤醒不用管，网络恢复后会自己续上
声音输出里没有 WenLink重启 Mac
升级 WenLink 后，Roon 播放时提示「音频设备初始化出错」按 ⌘Q 完全退出 Roon 再打开（Mac 上跑的是 RoonServer 的，重启 RoonServer），见第二节第 7 步
Roon 播放时，其他应用的声音出不来Roon 的独占模式占着 WenLink。需要系统声音时，在 Device Setup 里关掉 Exclusive Mode，或退出 Roon。播 DSD 时建议保持独占，否则其他声音混进来会破坏 DoP
Roon 换歌时采样率升高（例如 44.1k → 96k），偶尔播放变快，或 DSD 没声音这是 Roon 自身的已知问题。把 Resync Delay 调长可以减少，但不能消除

六、反馈问题

遇到问题，或者觉得哪里不对劲，欢迎在主页的群里告诉我。附上下面这些，能帮我很快找到原因：

  1. 什么时候、做了什么：大概几点几分，用的哪个播放器、播的什么格式（例如 44.1 kHz FLAC、DSD64），看到或听到了什么。
  2. Mac：型号和芯片（苹果菜单 →「关于本机」），macOS 版本。
  3. 卡农和 DAC：卡农的固件版本（网页首页「系统」一栏），DAC 的型号。
  4. 状态：在终端运行下面这条命令，把输出整段复制给我。
wnlctl status
  1. 日志：在终端运行下面这条命令，它会把最近 30 分钟的 WenLink 日志存成桌面上的 wenlink-log.txt，把这个文件发给我。问题出在更早的时候，把 30m 改大，例如 2h。
/usr/bin/log show --last 30m --predicate 'subsystem == "cn.epochaudio.wenlink"' > ~/Desktop/wenlink-log.txt

日志里只有 WenLink 自己的记录：卡农的名字和局域网地址、这台 Mac 的名字和 WenLink 给它生成的 id、播放的格式和连接状态，没有其他应用的内容。

想了解卡农 Canon，门耳朵淘宝小店随时开门。