直接用 alist serve 启动后无法访问 Web 界面,是因为默认监听 127.0.0.1:5244,必须显式改为 0.0.0.0:5244 才能外部访问;Docker 部署需正确映射端口并挂载配置文件,防火墙须放行 5244 端口。

直接用 alist serve 启动后访问不了 Web 界面,是因为默认只监听 127.0.0.1:5244;必须改监听地址为 0.0.0.0:5244,否则外部无法连接,挂载也就无从谈起。
安装 Alist 二选一:Docker 最稳,手动安装要留意 musl
推荐优先用 Docker,省去 glibc 兼容性问题:
sudo docker run -d --restart=unless-stopped -v /etc/alist:/opt/alist/data -p 5244:5244 --name=alist xhofe/alist:latest- 首次启动后,用
sudo docker exec -it alist ./alist admin random获取初始密码 - 若用手动安装(比如 Debian/Ubuntu),下载
alist-linux-musl-amd64.tar.gz更稳妥——glibc 版本低的系统跑原版会报 “No such file or directory” 错误 - 解压后
chmod +x alist,再运行./alist server --address 0.0.0.0:5244(--address参数不能省)
配置 WebDAV 前必须改 conf.yml 或加启动参数
Alist 的 WebDAV 功能默认开启,但前提是服务本身能被外部访问。关键不是“开没开 WebDAV”,而是“能不能连上 Alist”:
- 编辑
~/.alist/conf.yml(Docker 用户改/etc/alist/conf.yml),把address:行改成address: 0.0.0.0:5244 - 如果用 systemd 管理,确保
ExecStart=后带--address 0.0.0.0:5244 - 防火墙放行端口:
sudo ufw allow 5244(Ubuntu)或sudo firewall-cmd --add-port=5244/tcp --permanent(CentOS/RHEL) - Nginx 反代时,必须加这两行,否则登录页无限重定向:
proxy_set_header Host $host;和proxy_set_header X-Real-IP $remote_addr;
rclone 挂载前,先确认 Alist WebDAV 地址可 curl 通
别急着配 rclone config,先验证底层链路是否正常:
- 在挂载机上执行:
curl -I http://YOUR_ALIST_IP:5244/dav/,应返回HTTP/1.1 401 Unauthorized(有响应即通) - 如果超时或 Connection refused,说明 Alist 没暴露成功,回退检查上一步的
address和防火墙 -
rclone mount用的 remote 类型是webdav,URL 必须以/dav/结尾,例如:http://192.168.1.100:5244/dav/,少斜杠会报404 Not Found - 中文路径乱码?不是 rclone 问题,是 Alist 返回头缺
Content-Type: application/xml; charset=utf-8—— 升级到 Alist v3.28+ 可自动修复
真正容易被忽略的是:Alist 的 WebDAV 路径和存储挂载路径是两层映射。你在 Alist 后台添加的百度网盘叫 /baidu,它在 WebDAV 下实际暴露为 /dav/baidu/,而 rclone mount 出来的本地目录看到的才是 /baidu/ —— 这个层级关系错一环,文件就找不着。


















