macOS 安装 Alist + 夸克网盘驱动配置 + WebDAV + Apple TV 观影完整教程

准备工作

在开始之前，请确保你拥有以下设备和账号：

一台运行 macOS 的电脑，用于安装和运行 Alist 服务。
一台 Apple TV (建议使用网口版，网络更稳定) \[1\]。
一个夸克网盘账号 (用于存储影视资源) \[2\]。
良好的网络环境，确保所有设备在同一局域网内。

第一阶段：在 macOS 上安装并配置 Alist

Alist 是一个支持多种存储的文件列表程序，通过它可以将你的夸克网盘转换为 WebDAV 协议，方便 Infuse 连接 \[3\] \[4\]。

方法一：使用 Docker 安装 (推荐)

安装 Docker：在终端中运行以下命令通过 Homebrew 安装 Docker \[5\]：

  brew install docker
  brew services start docker

拉取 Alist 镜像并创建容器：创建一个目录来存储 Alist 的数据，然后运行容器 \[6\]： mkdir ~/AlistData docker run -d --name alist -v ~/AlistData:/data --restart unless-stopped -p 5244:5244 xhofe/alist

-v ~/AlistData:/data 将本地目录挂载到容器内，用于持久化存储配置数据，避免容器更新后配置丢失。 -p 5244:5244 将容器的 5244 端口映射到本机的 5244 端口，Alist 的 Web 管理界面将通过此端口访问 \[7\]。

方法二：直接安装 (不使用 Docker)

下载 Alist：从 Alist 的 GitHub Releases 页面下载适用于 macOS 的最新版本压缩包，解压后你会得到一个名为 alist 的可执行文件 \[8\]。
安装 macFUSE (可选)：如果你希望将网盘挂载为本地磁盘，可以通过 Homebrew 安装 macFUSE \[9\]：

  brew install macfuse

运行 Alist：进入解压后的目录，在终端中运行以下命令 \[10\]：

  chmod +x alist
  ./alist server

获取管理员密码：
- Alist v3.25.0 及更高版本：首次运行后会随机生成一个密码，使用以下命令查看 \[11\]： ./alist admin random
- 手动设置密码： ./alist admin set <你的密码>

第二阶段：配置 Alist 并挂载夸克网盘

访问 Alist 管理后台：打开浏览器，访问 http://localhost:5244，使用默认用户名 admin 和你设置或获取的密码登录 \[12\] \[13\]。
添加夸克网盘存储：
- 在管理页面左侧点击“存储”，然后点击“添加” \[14\] \[15\]。
- 驱动：选择“夸克网盘” \[16\] \[17\]。
- 挂载路径：输入一个自定义的路径，例如 /quark 或 /夸克。这是将来在 Infuse 中看到的文件夹名称 \[18\]。
- 其他选项保持默认，点击“保存”。
获取并配置 Cookie： > Alist 通过 Cookie 来认证你的夸克网盘账号，才能访问其中的文件 \[19\]。
- 使用 Chrome 或 Edge 浏览器打开夸克网盘网页版 (https://pan.quark.cn/)，并登录你的账号。请务必使用普通浏览器，不要用夸克浏览器%EF%BC%8C%E5%B9%B6%E7%99%BB%E5%BD%95%E4%BD%A0%E7%9A%84%E8%B4%A6%E5%8F%B7%E3%80%82%E8%AF%B7%E5%8A%A1%E5%BF%85%E4%BD%BF%E7%94%A8%E6%99%AE%E9%80%9A%E6%B5%8F%E8%A7%88%E5%99%A8%EF%BC%8C%E4%B8%8D%E8%A6%81%E7%94%A8%E5%A4%B8%E5%85%8B%E6%B5%8F%E8%A7%88%E5%99%A8) \[20\]。
- 按下键盘上的 F12 键打开开发者工具。
- 切换到 “Network” (网络) 标签页 \[21\]。
- 在 Network 标签页内，刷新一下当前网页。
- 在出现的网络请求列表中，找到任意一个包含 list 或 sort 的请求项并点击 \[22\]。
- 在右侧的 “Headers” (标头) 部分，找到 Cookie 字段，复制其完整的内容 \[23\] \[24\]。
- 返回 Alist 管理后台，找到刚才添加的夸克网盘存储，点击“编辑”，将复制的 Cookie 粘贴到对应的输入框中 \[25\] \[26\]。
- 点击“保存”。此时 Alist 应该开始加载你夸克网盘中的内容了。

第三阶段：开启 Alist 的 WebDAV 服务

在 Alist 管理后台左侧，点击“设置” -> “全局”。
找到并开启 “WebDAV 服务” 的开关 \[27\]。
在左侧“用户”菜单下，点击 admin 用户，确保 “WebDAV 读取” 和 “WebDAV 管理” 权限已被勾选 \[28\]。

第四阶段：在 Apple TV 上使用 Infuse 连接

获取 Mac 的局域网 IP 地址：
- 打开 Mac 的“系统设置” -> “网络”。
- 找到你当前连接的 Wi-Fi 或有线网络，记下 IP 地址，通常为 192.168.x.x 的形式 \[29\]。
在 Infuse 中添加 WebDAV 资源：
- 在 Apple TV 上打开 Infuse 应用。
- 进入“设置” -> “共享” \[30\] \[31\]。
- 点击“添加共享” -> “其他” \[32\]。
- 名称：随意填写，如“夸克网盘”。
- 通讯协议：选择 WebDAV \[33\] \[34\]。
- 地址：输入 http:// 加上你 Mac 的 IP 地址和 Alist 端口号 5244，例如 http://192.168.1.100:5244 \[35\]。
- 用户名：admin。
- 密码：你设置或获取的 Alist 管理员密码。
- 路径：填写 /dav 或留空 \[36\] \[37\]。
- 点击“高级” -> “通过安全连接 (HTTPS)”：确保关闭此项。
- 设置完成后，点击“保存”。Infuse 会尝试连接并加载你在 Alist 中挂载的夸克网盘内容 \[38\]。

高级进阶：互联网远程访问

局域网内的流畅观影体验很好，但最方便的场景还是出门在外时也能访问，实现真正的云端影库。这需要将 Alist 服务暴露到公网。

要实现这一点，主要有两种主流方案：

方案一：DDNS + 路由器端口转发
1. 获取公网IP：向你的宽带运营商确认是否能获取独立的公网IPv4地址（家庭宽带通常需要申请）。
2. 设置DDNS：使用 frp, ddns-go（由Alist作者开发，与Alist配合很好）等工具，将你变化的公网IP绑定到一个固定的域名上，例如 alist.example.com。
3. 端口转发：登录路由器管理后台，设置一条规则，将所有访问你路由器某个特定端口（如 10086）的请求，转发到 Mac 的内网 IP 和 Alist 的端口 5244 上。
方案二：内网穿透工具 如果无法获得公网IP，可以使用 frp, ZeroTier, Tailscale 等内网穿透工具。其中 Tailscale 体验极佳，它会在你的 Mac 和 Apple TV 之间创建一个加密的私有虚拟局域网，就像它们始终在同一个房间一样。这样，你在外网时，只需在 Infuse 里填入 Tailscale 分配的 Mac 虚拟 IP 地址，就能享受到和在局域网内一样稳定、高速的连接体验。

将 Alist 通过以上任一方案暴露到公网后，你就拥有了一个真正可随时随地访问的私人云影库。

故障排查与常见问题

Infuse 连接失败 (提示找不到服务器)：
- 检查 Apple TV 和 Mac 是否连接在同一个路由器下，处于同一个局域网 \[39\]。
- 确认 Mac 的防火墙没有阻止 5244 端口。
- 在 Apple TV 的 Infuse 设置中，确认没有开启“通过安全连接 (HTTPS)”选项，因为 Alist 默认使用的是 HTTP 协议。
Infuse 能连接但看不到文件：
- 确认你在 Alist 存储配置中填写的“挂载路径”（如 /quark）是正确的。
- 尝试在 Infuse 共享设置的“路径”一栏填写 /dav 或 / 后再试一次。
夸克网盘加载失败或 Cookie 失效：
- 夸克网盘的 Cookie 大约 1-2 个月会失效一次，届时需要按照上述步骤重新获取并更新 Cookie \[40\]。
- 获取 Cookie 时，请确保在浏览器中登录的是网页版夸克网盘，并完整复制。
Alist 无法开机自启动：
- 可以设置 Alist 容器自动重启：--restart unless-stopped \[41\]。
- 或创建 launchctl 配置文件实现开机自启。