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

# 1. 下载 Alist（请访问 https://github.com/alist-org/alist/releases 获取最新版本链接）
# 对于 Apple Silicon Mac (M1/M2/M3/M4):
curl -L -o alist-darwin-arm64.tar.gz https://github.com/alist-org/alist/releases/download/v3.42.0/alist-darwin-arm64.tar.gz
# 对于 Intel Mac:
curl -L -o alist-darwin-amd64.tar.gz https://github.com/alist-org/alist/releases/download/v3.42.0/alist-darwin-amd64.tar.gz

# 2. 解压文件
tar -zxvf alist-darwin-*.tar.gz

# 3. 赋予执行权限
chmod +x alist

# 4. 启动 Alist 服务
./alist server
启动后，终端会显示管理员密码。默认访问地址：http://127.0.0.1:5244

方法二：Homebrew 安装（如已安装 Homebrew）
bash
brew tap alist-org/alist
brew install alist
alist server
三、配置 Alist 管理员密码并登录
Alist v3.25.0 及以上版本：

bash
# 随机生成新密码
./alist admin random

# 或手动设置密码（将 your_password 替换为你的密码）
./alist admin set your_password
Alist v3.25.0 以下版本：

bash
./alist admin
记录输出的密码，后续登录 Alist 管理后台需要使用。

四、挂载夸克网盘到 Alist
步骤 4.1：获取夸克网盘 Cookie
使用 Chrome 浏览器打开 https://pan.quark.cn 并登录

按下键盘 F12 键，打开开发者工具

点击 Network（网络）标签，筛选 Fetch/XHR 类型请求

按 F5 刷新网页

在请求列表中，找到第一个或包含 "list" 的请求

点击该请求，在 Headers（标头）中找到 Cookie 字段

完整复制整个 Cookie 值（通常是一长串字符）

步骤 4.2：在 Alist 中添加夸克网盘驱动
在浏览器中访问 Alist 管理后台：http://127.0.0.1:5244

输入用户名（默认 admin）和之前设置的密码，点击登录

点击页面底部（或侧边栏）的 管理，进入管理面板

点击左侧菜单的 存储

点击右侧的 添加 按钮

在弹出的表单中填写以下信息：

字段	填写内容
驱动	选择 夸克网盘
挂载路径	/quark（可自定义，如 /夸克网盘）
根文件夹ID	留空（表示挂载整个夸克网盘）或填写具体文件夹 ID
Cookie	粘贴步骤 4.1 中复制的完整 Cookie 值
WebDAV 策略	建议选择 本地代理（确保 Apple TV 播放器能直接访问文件）
Web 代理	默认为 本地代理
点击 添加 保存

如果网盘中视频较多，加载时间可能稍长，请耐心等待加载完成。

五、启用 Alist WebDAV 服务并配置权限
步骤 5.1：开启 WebDAV 服务
在 Alist 管理后台，点击左侧菜单 设置

切换到 全局 标签页

找到 WebDAV 服务，确认开关处于开启状态（默认已开启）

记录 Alist 服务器的局域网地址：

在 Mac 上打开「系统设置」→「网络」→ 查看当前 Wi-Fi 的 IP 地址（如 192.168.1.100）

WebDAV 完整地址为：http://192.168.x.x:5244/dav（端口号默认为 5244）

步骤 5.2：为用户启用 WebDAV 权限
在 Alist 管理后台，点击左侧菜单 用户

找到 admin 用户，点击右侧的 编辑

勾选以下权限：

☑ WebDAV 读取

☑ WebDAV 管理

点击 保存

如需要更精细的访问控制，可在「用户」页面创建新用户并为该用户单独分配 WebDAV 权限。

六、保活 Alist 后台服务（重要）
手动运行 ./alist server 后终端窗口不能关闭。推荐配置 Alist 为系统服务：

方法一：使用 launchd（推荐）
创建 plist 文件：

bash
# 注意：将 "/path/to/alist" 替换为你的实际 alist 可执行文件路径
cat > ~/Library/LaunchAgents/com.alist.server.plist << EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.alist.server</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/alist</string>
        <string>server</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/alist.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/alist.err</string>
</dict>
</plist>
EOF

# 加载服务
launchctl load ~/Library/LaunchAgents/com.alist.server.plist
launchctl start com.alist.server
方法二：使用终端挂起运行
如果不便配置 launchd，可以用 nohup 让进程在后台运行：

bash
nohup ./alist server > alist.log 2>&1 &
七、Apple TV 配置播放器（Infuse 版本）
确保 Apple TV 与 Mac 连接至同一局域网（同一 Wi-Fi 或有线网络）

在 Apple TV 上打开 Infuse 应用

点击右上角的 设置 ⚙️

选择 共享

下拉找到 可用的共享，选择 其他

在添加共享页面填写：

字段	填写内容
名称	Alist（可自定义）
通讯协议	选择 WebDAV
位址	Mac 的局域网 IP 地址（如 192.168.1.100）
端口	5244
路径	/dav
用户名	admin（或你创建的其他用户名）
密码	你在步骤三设置的 Alist 密码
点击 添加 或 保存

添加成功后，返回主界面即可看到 Alist 中的夸克网盘目录，点击影片即可播放

八、Apple TV 配置播放器（VidHub 版本）
VidHub 是免费替代方案，支持 iPhone、iPad、Mac 和 Apple TV 全平台：

在 Apple TV 上打开 VidHub 应用

选择 文件源

点击 ➕ 号添加文件源

选择 添加网络存储(SMB/WebDav/AList)

切换至 WebDav/AList 网络选项

填写连接信息：

字段	填写内容
服务器地址	http://192.168.x.x:5244（Mac 的局域网 IP + 端口）
WebDAV 路径	/dav
用户名	admin
密码	你在步骤三设置的 Alist 密码
点击 添加，然后选择共享的文件夹，即可在 VidHub 上播放 Mac 端 Alist 挂载的夸克网盘视频

九、常见问题与排障
Q1：WebDAV 连接失败
检查 IP 地址：在 Mac 的「系统设置」→「网络」中确认当前 IP 地址

检查防火墙：确保 Mac 防火墙允许 5244 端口的入站连接（「系统设置」→「网络」→「防火墙」→「防火墙选项」→「添加」）

检查 Alist 是否正在运行：在终端运行 curl http://127.0.0.1:5244 确认有响应

确认 WebDAV 路径：Infuse 中路径应填写 /dav，端口为 5244

Q2：夸克 Cookie 过期
夸克的 Cookie 有效期为 1-2 个月，过期后 Alist 将无法访问网盘。解决方法：

按步骤 4.1 重新获取新的 Cookie

在 Alist 管理后台的「存储」列表中编辑夸克网盘条目，粘贴新的 Cookie 后保存

刷新 Alist 首页即可恢复访问

Q3：视频播放卡顿 / 频繁缓冲
检查网络：建议 Apple TV 使用有线网络连接

WebDAV 策略：在 Alist「存储」设置中将「WebDAV 策略」改为「302 重定向」或「本地代理」进行对比测试

视频编码兼容性：确认视频格式为 mp4/mkv 等 Apple TV 原生支持的格式

Q4：Alist 端口被占用
若 5244 端口已被占用，可以在启动 Alist 时指定其他端口：

bash
./alist server --port 8080
相应地，Apple TV 播放器中的端口也需同步修改。

Q5：外网访问（可选）
如需在家庭网络以外访问 Alist：

在路由器中设置端口转发，将公网端口（如 5244）指向 Mac 的内网 IP 和 5244 端口

获取家庭网络的外网 IP（注意：运营商可能分配动态 IP）

使用 DDNS 服务绑定域名

在 Apple TV 播放器中用域名 + 端口号进行连接

十、资源链接
资源	链接
Alist GitHub Releases	https://github.com/alist-org/alist/releases
Alist 官方文档	https://alist.nn.ci
Alist 夸克网盘添加指引	https://alist.nn.ci/zh/guide/drivers/quark
Infuse 官网	https://firecore.com/infuse
VidHub 官网	https://okaapps.com
WebDAV 调试工具	https://www.webdavserver.com（备用方案）
附录：完整终端命令速查
bash
# ========== 安装 Alist ==========
# Apple Silicon Mac:
curl -L -o alist-darwin-arm64.tar.gz https://github.com/alist-org/alist/releases/download/v3.42.0/alist-darwin-arm64.tar.gz
# Intel Mac:
curl -L -o alist-darwin-amd64.tar.gz https://github.com/alist-org/alist/releases/download/v3.42.0/alist-darwin-amd64.tar.gz

tar -zxvf alist-darwin-*.tar.gz
chmod +x alist
./alist server

# ========== 设置密码 ==========
./alist admin random

# ========== 后台运行 ==========
nohup ./alist server > alist.log 2>&1 &

# ========== 查看 Alist 运行状态 ==========
curl http://127.0.0.1:5244