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

准备工作

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

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

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

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

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

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

   brew install docker
   brew services start docker
   

2. 拉取 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)

1. 下载 Alist：从 Alist 的 GitHub Releases 页面 下载适用于 macOS 的最新版本压缩包，解压后你会得到一个名为 alist 的可执行文件 [8]。

2. 安装 macFUSE (可选)：如果你希望将网盘挂载为本地磁盘，可以通过 Homebrew 安装 macFUSE [9]：

   brew install macfuse
   

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

   chmod +x alist
   ./alist server
   

4. 获取管理员密码：

   • Alist v3.25.0 及更高版本：首次运行后会随机生成一个密码，使用以下命令查看 [11]：

     ./alist admin random
     

   • 手动设置密码：

     ./alist admin set <你的密码>
     

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

1. 访问 Alist 管理后台：打开浏览器，访问 http://localhost:5244，使用默认用户名 admin 和你设置或获取的密码登录 [12] [13]。

2. 添加夸克网盘存储：

   • 在管理页面左侧点击“存储”，然后点击“添加” [14] [15]。
   • 驱动：选择“夸克网盘” [16] [17]。
   • 挂载路径：输入一个自定义的路径，例如 /quark 或 /夸克。这是将来在 Infuse 中看到的文件夹名称 [18]。
   • 其他选项保持默认，点击“保存”。

3. 获取并配置 Cookie：

   Alist 通过 Cookie 来认证你的夸克网盘账号，才能访问其中的文件 [19]。

   • 使用 Chrome 或 Edge 浏览器打开夸克网盘网页版 (https://pan.quark.cn/)，并登录你的账号。请务必使用普通浏览器，不要用夸克浏览器 [20]。
   • 按下键盘上的 F12 键打开开发者工具。
   • 切换到 “Network” (网络) 标签页 [21]。
   • 在 Network 标签页内，刷新一下当前网页。
   • 在出现的网络请求列表中，找到任意一个包含 list 或 sort 的请求项并点击 [22]。
   • 在右侧的 “Headers” (标头) 部分，找到 Cookie 字段，复制其完整的内容 [23] [24]。
   • 返回 Alist 管理后台，找到刚才添加的夸克网盘存储，点击“编辑”，将复制的 Cookie 粘贴到对应的输入框中 [25] [26]。
   • 点击“保存”。此时 Alist 应该开始加载你夸克网盘中的内容了。

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

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

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

1. 获取 Mac 的局域网 IP 地址：

   • 打开 Mac 的“系统设置” -> “网络”。
   • 找到你当前连接的 Wi-Fi 或有线网络，记下 IP 地址，通常为 192.168.x.x 的形式 [29]。

2. 在 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 配置文件实现开机自启。