← 返回项目库

OxiCloud 中文自托管云盘

OxiCloud 是一款面向个人与小团队的轻量自托管云盘，提供文件管理、预览、分享、回收站、搜索、收藏和最近使用等核心能力。

项目使用 Rust 与 Axum 提供云盘服务，以 PostgreSQL 保存元数据，并通过本地或兼容对象存储保存文件；同时集成 WebDAV、CalDAV、CardDAV、OIDC/SSO 与 WOPI 等自托管能力。本次交付补齐中文核心界面，并以真实本地数据验证文件夹、文件、照片、音乐、分享和回收站流程。

真实界面

项目截图

共 8 张

文件
演示数据·项目资料
收藏
最近
照片
音乐
回收站
共享

Capabilities

核心功能

✓文件夹与文件网格浏览、上传、下载和在线预览
✓本地存储、S3 兼容存储与 Azure Blob 存储适配
✓缩略图、图片库、音频播放列表和媒体元数据
✓收藏、最近使用、全文搜索和回收站恢复/永久删除
✓共享链接、权限控制、密码与过期策略
✓WebDAV、CalDAV、CardDAV 标准协议接入
✓JWT/Argon2id 登录、管理员角色、配额与 OIDC/SSO
✓WOPI 接入 Collabora 或 OnlyOffice 的办公编辑能力

适用场景

为个人或小团队搭建轻量私有文件空间
研究 Rust 云服务、PostgreSQL 元数据和对象存储适配
通过标准 DAV 协议连接桌面、移动端和日历通讯录客户端
使用共享链接、回收站和搜索完成日常文件协作

适合谁

适合希望掌握自托管云盘、标准 DAV 协议、Rust Web 服务、PostgreSQL 文件元数据和轻量团队协作工作流的个人、小团队、开发者与社群学习者。

商业化思路

用于社群学习与研究自托管基础设施、文件协作和标准协议接入；也可作为个人或小团队的私有文件服务基础。

你会拿到什么

  • ✓固定提交版本的完整源码包，保留 README、MIT License 与上游版权声明
  • ✓中文核心界面适配、演示边界提示和缺失前端脚本引用修复
  • ✓8 张来自同一真实本地运行实例的中文功能页面截图
  • ✓可复核的 release 构建、API 回归、包完整性与发布前置检查证据

部署流程

  1. 1准备 Rust 1.93+、PostgreSQL 与现代浏览器，复制示例环境配置并设置数据库连接与 JWT 密钥。
  2. 2执行 cargo build --release，使用 Docker Compose 或进程管理器启动 OxiCloud 服务。
  3. 3首次打开 Web 界面完成管理员初始化，再按部署需求配置本地、S3 或 Azure Blob 存储。
  4. 4如需办公编辑或单点登录，按仓库配置文档启用 WOPI 或 OIDC，并在反向代理后使用 HTTPS。

真实验证结果

已通过 8 个真实运行中文界面、HTTP、可见正文、控制台、坏图和横向溢出质量门。

部署前须知

本地预览使用本地 PostgreSQL 与本地存储，未接入外部对象存储、OIDC 或 Collabora/OnlyOffice；这些集成保留在源码与配置能力中。HTTP 本地预览关闭 Secure Cookie 仅用于本机验收，不代表生产部署配置。

部署难度

中等

最低配置

Rust 1.93+、PostgreSQL、现代浏览器；使用 Docker Compose 部署时需 Docker 与 Docker Compose。

开源许可证

MIT License

最后验证

2026-08-31

技术栈

RustAxumPostgreSQLSQLx原生 JavaScriptWebDAV / CalDAV / CardDAV

授权说明

上游源码包包含 MIT License 文件。本交付保留原许可证与版权声明，并披露本次中文界面适配、演示提示和缺失脚本引用修复；上游版权及其他权利归相应权利人所有。

Release notes

版本记录

1 个已发布版本

vcn-60dbc6a342fa 当前推荐

中文社群学习交付版本：补齐核心中文 locale，增加本地预览边界提示，修复缺失 multiSelect 脚本引用，并完成真实文件、媒体、分享与回收站证据采集。

部署要求：Rust 1.93+、PostgreSQL、现代浏览器；可选 Docker Compose、S3/Azure 存储、OIDC 身份提供商与 WOPI 办公套件。

已知问题：当前目录证据针对本地存储与本地数据库；外部对象存储、OIDC 和 WOPI 办公套件未在本地预览中接入，生产启用前需按源码文档配置 HTTPS、密钥、反向代理和对应外部服务。

登录后领取