术士木星使用Docker部署Alist WebDav服务，并接入Cherry Studio WebDav备份
type
status
date
slug
summary
tags
category
icon
password
本文将详细介绍如何使用Docker部署Alist WebDAV服务，并配置Cherry Studio的数据备份功能，实现AI助手的云端数据同步。
前言
我上一次下载并使用CherryStudio，是在今年上旬，三四月份左右，当时的CherryStudio其实已经比较完备了，只不过还没有cli之类的工具，mcp也还在测试阶段。不过在当时我的使用感受是不如直接在浏览器开ChatGPT。
最近一段时间，我在X冲浪的时候经常能看到CherryStudio相关咨询，发现他们的开发社群十分活跃，且功能越来越完善，特别是对于 MCP（Model Context Protocol）的支持已经相当成熟，还开发了CLI工具，开始测试移动端App。这让我重新燃起了对这款工具的兴趣。
因此，时隔半年，我再一次下载并使用了CherryStudio。在使用后发现现在的CherryStudio完全可以当成一个全能的、有agent能力的AI工作站来使用，因此我准备深入探索一下CherryStudio的玩法。
首先，我选择探索的就是备份功能。我对Favorite、收藏、数据保存相关问题特别敏感，一直对此有些许焦虑。我希望能够将所有提示词和AI API key配置安全地保存在自己的服务器云端，同时确保数据的私密性和可控性。
CherryStudio支持WebDAV协议来实现云端同步（其实这个很早就有了，只不过我是最近才开始捣鼓服务器）。这意味着我可以搭建自己的自托管WebDAV服务，完全掌控数据的存储位置和访问权限。
而Alist作为一个优秀的文件列表程序，天然支持WebDAV协议，成为了我的首选方案。
(其实选这个最主要是因为这个项目貌似是stars最多的webdav项目,将近50k，恐怖如斯)
Docker部署Alist完整教程
和Docker部署说明使用 Docker | AList文档
readme文档给出的docker链接是xhofe/alist镜像，而AList文档中直接给出的是alist666/alist镜像，另有说明：alist666是开发版镜像，xhofe是最新版镜像。
打开dockerhub也能看到xhofe的镜像下载次数最多，因此这里选择xhofe。
得到完整的docker compose配置文件：
配置说明：
volumes: 数据持久化，将宿主机/etc/alist目录映射到容器内/opt/alist/data
ports: 端口映射，宿主机5244端口映射到容器5244端口
environment: 设置容器权限，确保文件读写正常
restart: 自动重启策略
将配置保存到文件夹，命名为
docker-compose.yml，然后在这个文件夹下面运行：
部署完成，现在可以打开5244端口访问Alist服务。
Alist管理员密码设置
这里如果尝试直接登陆，会报错无用户记录。需要先设置管理员密码：
设置完成后就能正常登陆了。
登陆后可以在用户栏添加新用户，实现多用户管理。
配置本机存储
在docker compose文件中，我们可以看到volumes配置：
这行配置的含义是将宿主机的
/etc/alist 目录映射到容器内的 /opt/alist/data 目录。数据持久化存储在宿主机上，即使容器被删除，数据也不会丢失。接下来我们需要在Alist中配置本地存储，使其能够访问和管理这些文件。在Alist管理界面中，进入"存储"设置页面，添加新的存储驱动。
如图所示，添加本机存储，并填入挂载路径和根路径。
这里的根路径写了
/opt/alist/data，就在宿主机的/etc/alist 位置，这个路径是用来放配置相关数据的，不太严谨，暂时先这么用着，后续再改善。点击添加完成存储配置。
CherryStudio配置WebDav
现在是最关键的一步，在CherryStudio中配置WebDAV备份：
- 打开CherryStudio设置
- 进入"数据设置" → "WebDav"配置页面
- 配置WebDav地址、用户名、密码、路径等参数
配置参数说明：
- WebDav地址:
http://your-server:5244/dav/(支持HTTPS)
- 用户名: Alist管理员用户名
- 密码: Alist管理员密码
- 路径: 备份文件存储路径（可选）
内网穿透部署
其中，WebDav可无痛内网穿透部署到公网，我使用cloudflared做内网穿透，也可以使用内网做url，webDav路径写http[s]://domain:port/dav/就可以了。
推荐的WebDAV地址格式：
- 局域网：
http://192.168.1.100:5244/dav/
- 公网服务器：
http://your-domain.com:5244/dav/
- 内网穿透：
https://your-tunnel-domain.com/dav/
备份测试
用户名和密码我为了省事直接用了管理员，用自己添加的用户好像有些还没解决的权限问题，有待探索。
配置完成后进行测试：
- 点击"备份到WebDav"，看到备份成功提示
- 点击"从WebDav恢复"，可以看到之前备份的文件列表
总结
通过这套Docker + Alist + CherryStudio的组合，我们实现了：
✅ 完全自托管的备份方案：数据完全存储在自己的服务器上
✅ 自动化数据同步：CherryStudio支持WebDAV协议的云端备份
✅ 多设备数据一致性：可以在多个设备间同步AI助手配置
✅ 零成本解决方案：使用开源软件，无需额外付费
✅ 高度可定制性：支持多种存储后端和部署方式
这套方案完美解决了AI工具数据的备份和同步需求，让你可以安心使用CherryStudio进行AI创作，再也不用担心数据丢失的问题。
参考资料
Prev
Ubuntu UFW防火墙规则与命令示例
Next
zsh 安装教程，在Linux中使用 oh-my-zsh 美化终端
Loading...