Cloudreve默认监听127.0.0.1:5212，需配置host=0.0.0.0、正确端口映射-p 5212:5212、放行防火墙及云平台安全组，且容器内UID 1001须匹配宿主机目录权限，首次启动走/install页面初始化，勿用latest镜像而应指定v3.8.3等稳定版本。
Cloudreve 不是 Clowder——这是两个完全不同的项目，名字相近但功能、作者、代码库均无关联。如果你搜的是“Clowder”，那大概率是拼写错误或混淆了项目名。
实际想部署的，极大概率是 Cloudreve（开源私有云盘），因为：
- “Clowder” 在主流 Linux 软件生态中并不存在成熟、广泛使用的文件管理系统；
- GitHub 上无活跃维护的
clowder项目匹配“Linux 文件管理系统”定位； - 所有可靠教程、镜像源、Docker Hub 和中文社区讨论均指向
cloudreve； - 错误拼写（c-l-o-w-d-e-r）与正确名（c-l-o-u-d-r-e-v-e）仅差一个字母，极易手误。
docker run 启动后打不开 http://IP:5212？检查 host 绑定和端口映射
Cloudreve 默认只监听 127.0.0.1:5212，容器外无法访问。
- 必须显式配置
host = 0.0.0.0：Docker 部署时无需改配置文件，靠-p 5212:5212映射即可，但前提是镜像内配置没被硬编码锁死——cloudreve/cloudreve:3.8.3及之后版本已默认支持外部绑定 - 确认端口映射正确：
docker ps输出中，PORTS列应显示0.0.0.0:5212->5212/tcp，而非127.0.0.1:5212->5212/tcp - 宿主机防火墙放行：
sudo ufw allow 5212（Ubuntu）或sudo firewall-cmd --add-port=5212/tcp --permanent && sudo firewall-cmd --reload（CentOS/RHEL） - 云服务器务必检查安全组：阿里云/腾讯云/华为云控制台中，需手动添加入方向规则，协议 TCP，端口
5212
/data/cloudreve/uploads 权限报错 permission denied？认准 uid=1001
Docker 容器内 cloudreve 进程以用户 ID 1001 运行，宿主机目录权限不匹配会导致上传失败、预览空白、甚至启动退出。
- 执行
ls -ld /data/cloudreve/uploads，第三列必须是1001 - 若不是，运行
sudo chown -R 1001:1001 /data/cloudreve/uploads - 严禁用
chmod 777：Cloudreve 启动时会主动拒绝，日志报错unsafe permission on upload directory - SQLite 数据库文件（如
/data/cloudreve/conf.db）也需同属1001，否则初始化失败
为什么 docker logs cloudreve 看不到账号密码？
首次启动时，Cloudreve 检测到数据库未初始化，会跳过登录页，直接重定向到 /install 页面——此时日志不会输出默认账号密码。
- 浏览器访问
http://你的IP:5212/install，完成图形化初始化（填邮箱、密码、SMTP 可选） - 初始化成功后，页面会提示“安装完成”，自动跳转至登录页，账号即你刚填的邮箱
- 若反复跳回
/install，说明/data/cloudreve/conf.db权限不对或被清空，删掉它再重启容器 -
docker logs cloudreve仅在**非首次启动且数据库已存在**时才打印 admin@cloudreve.org 密码
latest 镜像千万别直接拉？版本滞后可能引发已知 bug
cloudreve/cloudreve:latest 镜像长期未同步 GitHub Release，当前最新稳定版是 v3.8.3（截至 2026 年 6 月），而 latest 标签仍停留在 v3.4.2，已知问题包括：WebDAV 认证失效、OneDrive v2 token 刷新失败、SQLite 并发写入崩溃。
- 明确指定版本：
docker run -d --name cloudreve -p 5212:5212 -v /data/cloudreve:/cloudreve cloudreve/cloudreve:3.8.3 - 查看可用版本：
curl -s https://api.github.com/repos/cloudreve/Cloudreve/releases | grep '"tag_name":' | head -5 - 升级时不要覆盖
/data/cloudreve目录，只换镜像标签，配置和数据自动继承
真正麻烦的从来不是命令敲几行，而是权限归属、监听地址、镜像版本这三处细节——漏查任意一项，服务就卡在“能跑但不能用”的状态。
