【全网最全】使用 Docker 和 Rclone 挂载 Alist 存储：从入门到精通的全方位指南

已于 2025-03-24 09:37:23 修改
阅读量1.1k 收藏 6
点赞数 17
分类专栏： Linux系统 文章标签： docker Alist rclone mount 挂载 网盘
于 2025-03-22 17:26:47 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u013488276/article/details/146443271
版权

使用 Docker 和 Rclone 挂载 Alist 存储：从入门到精通的全方位指南

场景需求

通过 Docker 容器运行 Rclone，将 Alist 网盘存储挂载为本地目录，实现以下目标：

  • 持久化挂载 WebDAV 存储
  • 通过 docker-compose 管理服务
  • 支持宿主机直接访问挂载点

准备工作

环境要求

  • 操作系统：Linux 系统（推荐 CentOS 7.8 或 Ubuntu 20.04+）
  • Docker 版本：20.10.18+
  • docker-compose 版本：2.10+
  • Alist 服务：已部署并获取 WebDAV 地址和凭证

目录结构

mkdir -p ~/rclone-alist/{config,mnt}  # 推荐项目目录结构

实施步骤

1. 创建共享挂载点（关键步骤）

# 创建物理挂载点  
sudo mkdir -p /opt/alist_mnt  
sudo chmod 777 /opt/alist_mnt 

# 设置绑定挂载（解决 Docker 挂载传播问题）  
sudo mount --bind /opt/alist_mnt /opt/alist_mnt  
sudo mount --make-shared /opt/alist_mnt  # 启用共享挂载

📌 技术说明：--make-shared 确保挂载点能在容器间传播，避免出现 mount.none 不可用问题。

2. 生成 Rclone 配置文件

运行临时容器生成配置：

docker run -it --rm \
  -v "$HOME/rclone-alist/config":/config/rclone \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  --security-opt apparmor:unconfined \
  rclone/rclone:latest config

配置流程示例：

  1. 选择新建远程存储（n），命名为 alist。
  2. 选择存储类型为 WebDAV（56）。
  3. 输入 Alist 的 WebDAV URL（如 http://192.168.1.200:5244/dav）。
  4. 选择 Other 作为 WebDAV 供应商。
  5. 输入 Alist 的用户名和密码。
  6. 保存配置并退出。

验证配置文件：

cat ~/rclone-alist/config/rclone.conf

确保配置文件包含以下内容：

[alist]  
type = webdav  
url = http://192.168.1.200:5244/dav  
vendor = other  
user = admin  
pass = TY8JqGS8aMoeyZmCJnvemevdin0h0wxbPUbS

3. 通过 Docker 挂载

docker run -d \
  --name=rclone \
  -v /opt/mnt:/mnt:rshared \
  -v ~/rclone-alist/config/rclone.conf:/config/rclone/rclone.conf \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  --security-opt apparmor:unconfined \
  rclone/rclone:latest \
  mount alist:/ /mnt \
  --allow-other \
  --vfs-cache-mode writes \
  --allow-non-empty \
  --log-level DEBUG # 选填

关键参数说明：

  • rshared：挂载传播设置为递归共享。
  • security_opt：禁用 AppArmor 配置。
  • cap_add：添加系统管理权限。

查看实时日志：

docker logs -f rclone

验证与测试

容器内验证

docker exec -it rclone ls /mnt

宿主机验证

ls /opt/alist_mnt  
echo "test" | sudo tee /opt/alist_mnt/testfile.txt

调试命令

# 查看挂载详情  
docker exec rclone mount | grep /mnt 

# 检查进程状态  
docker exec rclone ps aux | grep rclone

高级配置技巧

性能优化参数

在 command 部分添加：

- --buffer-size=256M  
- --vfs-read-chunk-size=128M  
- --vfs-read-chunk-size-limit=1G  
- --vfs-cache-max-age=24h

开机自动挂载

编辑 /etc/fstab 添加：

/opt/alist_mnt /opt/alist_mnt none bind,shared 0 0

安全加固方案

environment:  
  - RCLONE_CONFIG_PASS=your_encryption_password  # 配置文件加密

故障排查指南

现象解决方案
挂载点为空检查 Alist WebDAV 路径是否正确
Permission denied添加 --allow-other 参数
fuse: device not found确保启用 --device /dev/fuse
频繁断连增加 --daemon-timeout=30m 参数

【进阶】docker-compose 部署

创建挂载目录

sudo mkdir -p /opt/mnt  
sudo mount --bind /opt/mnt /opt/mnt  
sudo mount --make-shared /opt/mnt

创建 docker-compose.yml

version: '3.8'  
services:  
  alist:  
    image: xhofe/alist:latest  
    container_name: alist  
    restart: unless-stopped  
    volumes:  
      - /opt/docker/alist/data:/opt/alist/data  
      - ./alist/volumes:/mnt  
    ports:  
      - "5244:5244"  
    environment:  
      - PUID=0  
      - PGID=0  
      - UMASK=022  
    command: server --no-prefix  

  rclone:  
    image: rclone/rclone:latest  
    container_name: rclone  
    restart: unless-stopped  
    depends_on:  
      - alist  
    volumes:  
      - /opt/mnt:/mnt:rshared  
      - ./rclone/config:/config/rclone  
    devices:  
      - /dev/fuse  
    cap_add:  
      - SYS_ADMIN  
    security_opt:  
      - apparmor:unconfined  
    command: >
      mount alist:/ /mnt  
      --allow-other  
      --vfs-cache-mode writes  
      --allow-non-empty  
      --log-level DEBUG
volumes:  
  alist-data:  
  rclone-config:

使用说明

  1. 准备目录结构：

    mkdir -p {./alist/data,./rclone/config} && sudo mkdir -p /opt/mnt

  2. 设置共享挂载（只需执行一次）：

    sudo mount --bind /opt/mnt /opt/mnt && sudo mount --make-shared /opt/mnt

  3. 配置 Rclone：

    cat > ./rclone/config/rclone.conf <<EOF  
[alist]  
type = webdav  
url = http://alist:5244/dav  
vendor = other  
user = admin  
pass = $(alist password)  # 替换为实际密码  
EOF

  4. 启动服务：

    docker compose up -d

验证方法

  1. 检查 Alist 是否运行：

    curl http://localhost:5244

  2. 查看 Rclone 日志：

    docker logs rclone | grep -i "mount"

  3. 验证宿主机挂载点：

    ls /opt/mnt  # 应该看到 Alist 中的文件

  4. 检查容器内挂载点：

    docker exec rclone ls /mnt

常见问题处理

  1. 挂载目录为空：

    • 确认已执行 mount --make-shared。
    • 检查 rclone.conf 中的密码是否正确。
    • 增加 --log-level DEBUG 查看详细错误。

  2. 权限问题：

    sudo chmod -R 777 /opt/mnt  # 临时调试用

  3. 更新配置：

    docker compose restart rclone

  4. 开机自动创建挂载点

sudo tee /etc/systemd/system/cloud-mount.service <<EOF
[Unit]
Description=Persistent mount binding

[Service]
Type=oneshot
ExecStart=/bin/mount --bind /opt/alist_mnt /opt/alist_mnt
ExecStart=/bin/mount --make-shared /opt/alist_mnt
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload && sudo systemctl enable --now cloud-mount

通过本方案可实现：
✅ 容器化隔离部署
✅ 配置版本化管理
✅ 快速水平扩展
✅ 挂载状态监控

建议搭配 systemd 或 supervisord 实现服务保活，生产环境建议启用 TLS 加密 WebDAV 连接。

UNRAID使用rclone挂在alist网盘
Hot_Ant的博客
10-03 1716
使用user config。
K8S深度解析：从入门到精通的全方位指南
weixin_54533548的博客
04-24 4790
K8S，全称Kubernetes，是一个开源的容器编排系统，它旨在自动化容器化应用程序的部署、扩展和管理。随着云原生技术的兴起，K8S已成为现代应用开发和运维领域的重要工具之一。K8S的出现背景在于，随着云计算和容器技术的快速发展，企业面临着越来越多的挑战，如如何高效地管理大量容器、如何确保应用程序的高可用性和可扩展性、如何简化复杂的部署和运维流程等。K8S通过提供一套强大的容器编排功能，帮助企业解决了这些问题。Harbor是一个用于存储和分发Docker镜像的企业级Registry服务器。
rclone：具有rclone的docker映像
03-03
alist+emby+rclone+auto-symlink+各种网盘搭建视频流媒体平台docker-compose集成版
最新发布
09-24
简而言之，就是把网盘里面的视频资源，挂载到支持docker的设备上，作为一个外挂盘，使用emby来搭建一个流媒体平台，alist是开源工具，可以集成多个网盘，115，百度，阿里，夸克等国内常见网盘都支持。这里提供的就是本人在用的配置，alist集成emby使用的 https://github.com/bpking1/embyExternalUrl 的方案，如果后续不可用，可以到这个网站去更新一下最新的配置，使用者需要改写一些东西，在 nginx/conf.d/constant.js和 rclone/rclone.conf，constant.js 需要修改alist的地址和token和emby的一些信息，便于 nginx拦截器修改官方emby的响应，以及调用alist的结果来替换播放地址。rclone.conf主要是用于把alist关联的网盘挂载到本地，所以需要填入alist的地址，模板中已经填了个大概。auto_symlink主要是把网盘里面的视频文件创建一个 strm文件，提升emby扫描速度，并且也是为了避免频繁扫描网盘库，被风控。
Alist挂载百度网盘
快乐的小跳蛙的博客
08-07 9801
Alist挂载百度网盘，进行对百度网盘的管理
linux下 Rclone+Alist实现挂载网盘（天翼云盘为例）
幻空的博客
05-11 8364
利用rclone+alist+fuse实现将网盘挂载到本地
AList 网盘挂载，在线浏览各种网盘资源，部署并挂载到本地——教程（Linux+Windows）
m0_69594200的博客
04-27 9081
Alist部署，在线浏览各种网盘数据加 下载，并挂载到本地使用
RClone挂载有阿里云的AList
空名的博客——云深知处
06-28 1214
RClone挂载一般的AList可以直接使用mount命令，但是阿里云需要使用指定头部。，只要你的ALIst包含阿里云都需要加上这个头部参数。
Docker 深度解析：从入门到精通
2301_77695569的博客
07-22 2462
Docker 是一个开源的应用容器引擎，它允许开发者将应用及其依赖环境打包到一个可移植的容器中。Docker 使用 Linux 容器（LXC）技术，但与 LXC 相比，Docker 提供了更易用的接口和更高效的资源利用。EXPOSE 80"]Docker 作为容器化技术的代表，极大地简化了应用的部署和管理。通过本文的介绍，希望你能对 Docker 有一个全面的了解，并能够开始使用 Docker 来管理和部署你的应用。Docker 的世界非常广阔，还有很多高级功能等待你去探索和使用。
Docker从入门到精通学习指南
10-21
docker入门学习文档
服务器 Docker Alist挂载到本地磁盘（Mac版）夸克网盘
热门推荐
赵同学的博客
07-27 1万+
我电脑是mac，所以使用的是CloundMounter这个软件，如果你是windows的话可以使用其他的挂在软件，CloundMounter这个软件目前在appStore就可以下载。https://alist.nn.ci/zh/guide/#support-storage 这个地址里面有所有支持网盘的设置，这里我只演示下夸克网盘。这段意思是alist中的数据映射到docker 主机的文件夹，/home/alist就是我主机的文件夹，这个文件夹必须先创建。可以看到本地已经有挂载的网盘啦。
[实用工具] AList + rclone实现百度网盘本地挂载
大峰的零零碎碎
05-13 8411
使用alist+rclone实现对百度网盘本地挂载
Docker部署Alist全平台网盘神器结合内网穿透实现无公网IP访问云盘资源_alist docker mysql
2401_84159813的博客
04-13 2558
使用上面的Cpolar https公网地址,在手机或任意设备的浏览器进行登录访问,即可成功看到 Alist 界面,这样一个公网地址且可以远程访问就创建好了,使用了cpolar的公网域名,无需自己购买云服务器,即可到公网访问 Alist 了！用上面的Cpolar https公网地址,在手机或任意设备的浏览器进行登录访问,即可成功看到 Alist 界面,这样一个公网地址且可以远程访问就创建好了,使用了cpolar的公网域名,无需自己购买云服务器,即可到公网访问 Alist 了！点击进入cpolar官网，点击。
使用rclone挂载alist到本地磁盘
weixin_46487184的博客
08-02 1525
如果后面挂载出现failed to mount FUSE fs: fusermount: exec: "fusermount3": executable file not found in $PATH错误。#这里我将alist的两个盘挂载到我的 /home/remote下，&在后台持续挂载。这里看到配置是成功的，显示我alist连接了是有两个盘的(阿里和天翼的)#alist是你刚刚远程配置的名称。
Alist部署及挂载阿里云盘
CarolLiu的博客
11-14 1万+
3.25.0以上版本将密码改成加密方式存储的hash值，无法直接反算出密码，如果忘记了密码只能通过重新 随机生成。上面已经讲解了如何部署alist和挂载使用阿里云盘，这里主要讲解如何搭配群晖的CloudSync套件实现自动下载。因为我的是群晖系统，下面以群晖举例，别的系统可以直接使用。因为管理员信息是服务内生成的，需要进入容器内部进行查看。挂载路径：填写刚才创建的文件夹的路径（要求完整路径）Web代理：默认关闭，建议开启，该配置会影响群晖的。，实际想要挂载哪个盘的资源就选择哪个盘，不能多选。
Docker部署Alist全平台网盘神器结合内网穿透实现无公网IP访问云盘资源_alist实现内网穿透(1)
2401_84862220的博客
05-16 2839
用户名：admin密码：上方Log中复制的密码首次访问会出现 **“failed get storage:storage not found;please add a storage first"**错误信息，点击页面底部的管理按钮，进入alist管理页面，在存储菜单下添加你自己的网盘后就可以了。
AList挂载工具安装搭建使用教程，快速访问多个网盘的资源（保姆级图文）
MZH
05-21 1万+
AList挂载工具安装搭建使用教程，快速访问多个网盘的资源（保姆级图文）
2024最新Alist开源挂载本地磁盘教程（保姆级教程）
weixin_43326918的博客
07-02 1万+
Alist参考文档链接: Alist官网文档安装对应安装包：本教程使用【alist-linux-musl-amd64.tar.gz】目前最新安装包 官网安装链接: Alist安装包 三、登录Alist网页 四、添加本地存储 挂载路径根据Linux当中你本地磁盘挂载的路径 添加本地磁盘完成
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序员阿谷

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值