OpenCloud 完整安装教程（2026 最新版）

从零开始，小白也能轻松搭建属于自己的私有云！

📦 当前最新版本：v5.2.0（2026-03-09 正式发布）｜ 官网：opencloud.eu ｜ GitHub：opencloud-eu/opencloud（⭐ 5k+）

📖 一、什么是 OpenCloud？

OpenCloud 是目前 GitHub 上最火的开源私有云平台之一，由德国老牌开源公司 Heinlein Group 开发。类比就是"你自己搭建的百度网盘/iCloud"，但数据完全在你自己服务器上，无需担心隐私泄露。

主要功能一览：

• 📁 文件存储、同步、分享（支持链接分享、权限管理）

• ✍️ 多人在线协作编辑文档（可选配 Collabora 在线 Office）

• 📅 日历与联系人同步（CalDAV / CardDAV）

• 📱 支持 PC 客户端、手机 App、网页浏览器多端访问

• 🔒 数据 100% 自托管，Zero-Trust 安全架构

• 💰 完全开源免费，Apache 2.0 协议

💡 对比 Nextcloud？
OpenCloud 基于 ownCloud Infinite Scale 全新 Go 语言架构开发，性能更强、内存占用更低、部署更简单，而且官方 Docker Compose 配置完善，维护成本极低。

🖥️ 二、系统要求

最低配置（个人/小团队，1-10人）：

• 操作系统：Ubuntu 22.04 / Debian 12 / CentOS Stream 9

• CPU：2 核心及以上

• 内存：2 GB RAM（推荐 4 GB）

• 硬盘：20 GB 系统盘 + 数据存储空间

• 网络：可访问互联网（下载 Docker 镜像用）

推荐配置（企业/多用户，10人以上）：

• CPU：4 核心

• 内存：8 GB RAM

• 硬盘：SSD，系统盘 40 GB + 独立数据盘

💡 新手提示：没有服务器？可购买 VPS。国内推荐阿里云轻量应用服务器或腾讯云轻量；国外性价比高的有 Hetzner（欧洲）、Vultr（全球节点），2核4G 每月约 $6-12。

🚀 三、安装方式总览

本教程提供两种安装方式，根据你的情况选择：

1. ⚡ 一键脚本安装——适合纯小白快速体验，一条命令搞定，不适合生产环境

2. 🐳 Docker Compose 安装——官方推荐方式，支持自动 SSL、模块扩展，适合正式部署

🔧 四、准备工作：连接服务器

首先你需要通过 SSH 连接到你的服务器。

Windows 用户：下载 MobaXterm（免费，推荐），或直接用 PowerShell / CMD：

ssh root@你的服务器IP

Mac / Linux 用户：打开终端直接输入同样命令。

连接成功后你会看到命令行提示符（类似 root@server:~#），说明已成功登录。

⚡ 五、方法一：一键快速安装（测试体验专用）

⚠️ 此方法仅用于本地测试，不适合对外提供服务！

只需在服务器终端粘贴以下命令然后回车：

curl -L https://opencloud.eu/install | /bin/bash

脚本会自动完成：

• 检测系统架构（支持 AMD64 / ARM64）

• 自动下载最新版 OpenCloud 可执行文件

• 创建配置和数据目录

• 生成启动脚本并立即运行

安装完成后终端显示：

Connect to OpenCloud via https://localhost:9200

浏览器打开 https://服务器IP:9200，浏览器提示"连接不安全"是正常的（自签名证书），点击"高级 → 继续前往"即可。

默认登录信息：

• 用户名：admin

• 密码：admin（登录后请立即修改！）

下次重启 OpenCloud：

cd opencloud-sandbox-*/
./runopencloud.sh

🐳 六、方法二：Docker Compose 安装（推荐 ✅）

这是官方推荐的生产部署方式，优点：

• 自动申请 Let's Encrypt 免费 SSL 证书，自动续期

• 绑定你自己的域名，专业对外服务

• 模块化：按需开启在线文档编辑、全文搜索、日历等功能

• 数据持久化，容器重启数据不丢失

第 1 步：安装 Docker

# 更新系统
apt update && apt upgrade -y

# 安装依赖
apt install -y curl gnupg ca-certificates

# 官方一键安装脚本（Ubuntu/Debian）
curl -fsSL https://get.docker.com | sh

# 验证安装
docker --version
docker compose version

正常应看到输出：

Docker version 27.x.x
Docker Compose version v2.x.x

⚠️ 重要：必须是 Docker Compose v2（命令为 docker compose）。如果是 v1（docker-compose）会导致部署失败！

第 2 步：配置域名 DNS（无域名可跳过）

在你的域名服务商（阿里云/腾讯云/Cloudflare）控制台添加 A 记录：

• cloud.你的域名.com → 你的服务器 IP

验证 DNS 是否生效：

ping cloud.你的域名.com

能 ping 通说明 DNS 已生效（通常等待 5-30 分钟）。

第 3 步：克隆官方 Compose 仓库

cd /opt
git clone https://github.com/opencloud-eu/opencloud-compose.git
cd opencloud-compose

第 4 步：创建并编辑配置文件

cp .env.example .env
nano .env

在 .env 文件中修改以下三个必填项：

# 你的域名（没有域名先填 cloud.opencloud.test）
OC_DOMAIN=cloud.你的域名.com

# 管理员初始密码（必须设置，否则服务无法启动！）
INITIAL_ADMIN_PASSWORD=你的超强密码

# Let's Encrypt 免费 SSL 证书申请邮箱
TRAEFIK_LETSENCRYPT_EMAIL=你的邮箱@example.com

nano 编辑器快捷键：Ctrl+X 退出 → 按 Y 保存 → 回车确认

第 5 步：选择功能组合

在 .env 中找到 COMPOSE_FILE 这行，按需配置：

基础版（仅文件管理）：

COMPOSE_FILE=docker-compose.yml:traefik/opencloud.yml

完整版（含 Collabora 在线文档编辑，推荐）：

COMPOSE_FILE=docker-compose.yml:weboffice/collabora.yml:traefik/opencloud.yml:traefik/collabora.yml

完整版需额外在 DNS 添加：

• collabora.你的域名.com → 服务器 IP

• wopiserver.你的域名.com → 服务器 IP

第 6 步：创建持久化数据目录

mkdir -p /opt/opencloud-data/{config,data}
chown -R 1000:1000 /opt/opencloud-data

然后在 .env 中添加：

OC_CONFIG_DIR=/opt/opencloud-data/config
OC_DATA_DIR=/opt/opencloud-data/data

第 7 步：防火墙端口放行

# Ubuntu/Debian 系统
ufw allow 80
ufw allow 443
ufw reload

💡 阿里云/腾讯云用户：还需要在云控制台的「安全组」中手动开放 80 和 443 端口，否则外网无法访问！

第 8 步：启动服务

cd /opt/opencloud-compose
docker compose up -d

首次运行会自动拉取 Docker 镜像（约 70-200MB，需要几分钟，耐心等待）。

看到以下输出说明启动成功：

[+] Running 3/3
 

✔

Container opencloud-compose-traefik-1 Started ✔ Container opencloud-compose-opencloud-1 Started ✔ Container opencloud-compose-certdumper-1 Started

查看启动日志（等待 server started 字样）：

docker compose logs -f opencloud

按 Ctrl+C 退出日志查看。

第 9 步：访问并初始配置

浏览器打开：https://cloud.你的域名.com

登录信息：

• 用户名：admin

• 密码：你在 .env 中设置的 INITIAL_ADMIN_PASSWORD

登录后建议操作：

1. 右上角头像 → 设置 → 安全 → 修改密码

2. 左侧导航 → 用户管理 → 创建普通用户

3. 用户管理 → 点击用户 → 设置存储配额

🛠️ 七、常用管理命令

# 查看服务状态
docker compose ps

# 实时查看日志
docker compose logs -f

# 仅看 OpenCloud 日志
docker compose logs -f opencloud

# 停止服务
docker compose stop

# 重启服务
docker compose restart

# 升级到最新版本
docker compose pull && docker compose up -d

# 停止并删除容器（数据不丢失）
docker compose down

⬆️ 八、如何升级

cd /opt/opencloud-compose
git pull                    # 拉取最新 compose 配置
docker compose pull         # 拉取最新镜像
docker compose up -d        # 重新启动

📱 九、客户端下载

• Windows / macOS 桌面客户端：GitHub releases 页面下载

• iPhone / iPad：App Store 搜索 OpenCloud

• Android：Google Play 搜索 OpenCloud

• 网页端：直接浏览器访问你的域名即可

客户端填写服务器地址：https://cloud.你的域名.com

❗ 十、常见问题排查

问题 1：容器启动后一直重启

最常见原因是 INITIAL_ADMIN_PASSWORD 未设置。

# 查看错误详情
docker compose logs opencloud | tail -50

# 确认密码已设置
grep INITIAL_ADMIN_PASSWORD .env

问题 2：无法访问网页

# 检查容器状态
docker compose ps

# 检查端口（确保 80/443 已开放）
ufw status

💡 云服务器别忘了控制台安全组也要放行 80、443！

问题 3：SSL 证书申请失败

• 确认域名 DNS 已正确指向服务器

• 确认 80 端口未被其他服务占用

docker compose logs traefik | grep -i error

问题 4：忘记管理员密码

docker compose exec opencloud sh
/opencloud/opencloud idm resetpassword --username admin

问题 5：文件上传超时

在 .env 中添加：

PROXY_WRITE_TIMEOUT=3600
PROXY_READ_TIMEOUT=3600

🔒 十一、安全建议

1. 安装后立即修改 admin 默认密码

2. 开启两步验证（2FA）：设置 → 安全 → 两步验证

3. 定期备份数据目录 /opt/opencloud-data/

4. 保持定期更新版本以获取安全补丁

5. 服务器防火墙只开放必要端口（80、443）

📚 十二、更多资源

• 官方文档：docs.opencloud.eu

• 管理员文档：docs.opencloud.eu/docs/admin/

• GitHub 主仓库：opencloud-eu/opencloud

• Docker Compose 配置库：opencloud-eu/opencloud-compose

• 社区讨论：GitHub Discussions

• 最新版本发布：Releases 页面