opencloud
SHA-256自建云存储后端，无需数据库，直接存储文件系统，支持 OpenID Connect 认证。
一个没有数据库的轻量云存储后端，部署简单，适合自建文件同步。
核心功能
- 完全基于文件系统存储，无需安装和配置任何数据库
- 支持 OpenID Connect 统一认证，可对接 Keycloak 等身份服务
- 内置 LibreGraph Connect 身份提供商，开箱即用
- 支持文件同步、分享、多用户管理
- Go 语言编写，二进制部署，无运行时依赖
避坑指南
- •首次使用需通过 init 命令生成配置，不要手动创建目录,默认监听 9200 端口，需确保防火墙开放此端口,因为不使用数据库，文件的元数据搜索功能弱于 Nextcloud 等传统方案,生产环境建议使用反向代理（如 Nginx）提供 HTTPS 并配置公网域名
适用场景
- 个人或小团队搭建私有云盘，简化部署流程
- 边缘节点或物联网设备的本地文件同步
- 需要低资源消耗的轻量级文件存储服务
详细介绍
OpenCloud 是一款用 Go 语言编写的轻量级自建云存储后端。它直接将所有数据存储在文件系统中，完全不需要数据库，部署和维护都非常简单。身份认证采用 OpenID Connect 协议，支持接入 Keycloak 等外部身份提供商，也能使用内置的 LibreGraph Connect。作为 OpenCloud 生态的核心服务，它提供文件同步、分享和管理功能。相比 Nextcloud 或 ownCloud，OpenCloud 最大的优势是去掉了数据库依赖，大大降低了部署复杂度和启动时间。不过它的功能也相对精简，没有数据库搜索或插件扩展机制，更适合小型团队、个人使用或资源受限的边缘场景。
常见问题与排障 (1)
故障排除如何修复在OpenCloud中下载文件名包含%20的文件时出现的404错误？
在 OpenCloud 4.0.7 中，一个已知 bug 会导致从个人存储或空间下载文件时 URL 解码错误，从而出现 404 错误。解决方法：共享该文件（即使私下共享）并使用共享链接下载，因为共享文件不会出现此问题。或者，重命名文件以避开百分号编码字符（例如，将 %20 替换为空格）。永久修复预计将在未来版本中提供。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：从 GitHub Releases 页面下载对应操作系统的二进制文件
步骤2：运行 ./opencloud init 初始化配置（默认生成配置文件在 ~/.opencloud）
步骤3：执行 ./opencloud server 启动服务，默认监听 9200 端口
- 步骤1：从 GitHub Releases 页面下载对应操作系统的二进制文件
- 步骤2：运行 ./opencloud init 初始化配置（默认生成配置文件在 ~/.opencloud）
- 步骤3：执行 ./opencloud server 启动服务，默认监听 9200 端口
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
fc605f21c4a710a43b71fa1a8d28c24926aef68ff3ece96abfbbba4189215778该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止服务后，删除二进制文件并执行 rm -rf ~/.opencloud 移除所有配置文件和数据。注意数据不可恢复，请提前备份。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ