Docker一键部署OpenCloud：从零搭建企业级私有云盘全指南

举报
江湖有缘 发表于 2026/07/27 01:23:09 2026/07/27
【摘要】 Docker一键部署OpenCloud：从零搭建企业级私有云盘全指南


一、OpenCloud介绍

1.1 OpenCloud项目简介

OpenCloud 是开源轻量化文件管理、资源共享与团队协同平台，设计简洁易用，依托模块化部署模式快速搭建，支持私有化部署，用户可自主掌控全部数据，适配个人与企业内部办公协作场景。

1.2 核心特点

  1. 采用模块化部署思路，提供多种部署模式，适配不同使用环境。
  2. 支持反向代理部署，可配置免费证书，也能对接现有外部代理服务。
  3. 集成在线文档编辑功能，轻松实现多人在线协同编辑文件。
  4. 兼容多种身份认证体系，可搭建统一集中化用户权限管理。
  5. 具备全文检索能力，可完成文件内容提取与元数据解析。
  6. 开放监控指标接口，方便运维查看平台运行状态与性能数据。
  7. 内置日程与联系人服务，拓展完善办公配套实用功能。
  8. 自带病毒查杀功能，自动检测防护上传文件安全。
  9. 实现全流程文件管理，支持多端便捷互传与资源共享。
  10. 开源无版权限制，支持私有化部署与个性化二次开发。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

hostname IP地址 操作系统版本 Docker版本 部署项目 备注
jeven 192.168.3.88 Ubuntu 24.04.2 LTS 28.5.0 OpenCloud 镜像版本opencloudeu/opencloud-rolling:6.2.0

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署OpenCloud文件管理工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Thu 2026-02-05 00:27:40 CST; 1s ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 841698 (dockerd)
      Tasks: 65
     Memory: 73.5M (peak: 77.1M)
        CPU: 975ms
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取OpenCloud镜像

下载OpenCloud镜像，执行以下命令：

root@jeven:~# docker pull opencloudeu/opencloud-rolling:6.2.0
6.2.0: Pulling from opencloudeu/opencloud-rolling
84f5eff04246: Pull complete
611642209e31: Pull complete
53619b800de7: Pull complete
05b72c726c04: Pull complete
4f4fb700ef54: Pull complete
8feff5a6dd8b: Pull complete
Digest: sha256:77bd4ebc5c5d27bd6da8a5b077e3b3b18f07dc538a25597b6ed0bcc76198ecbe
Status: Downloaded newer image for opencloudeu/opencloud-rolling:6.2.0
docker.io/opencloudeu/opencloud-rolling:6.2.0

在这里插入图片描述

五、部署OpenCloud服务

5.1 创建部署目录

  • 创建部署目录
mkdir -p /data/opencloud/{config,data}  && cd /data/opencloud
  • 在测试环境中，为了方便操作，我们直接为挂载目录设置了完全权限。但在生产环境中，请务必根据实际安全需求，配置更精细、严格的权限控制方案。
chmod -R 777  /data/opencloud

5.2 初始化操作

我们执行以下命令，设置管理员密码并启动 OpenCloud 容器，从而完成系统的初始化部署。

docker run --rm -it \
  -v $(pwd)/config:/etc/opencloud \
  -v $(pwd)/data:/var/lib/opencloud \
  -e IDM_ADMIN_PASSWORD=admin \
  opencloudeu/opencloud-rolling:6.2.0 init

当出现以下禁用证书的安全提示，我们输入 yes 进行跳过。

在这里插入图片描述

当出现以下信息，则表示初始化完成。

在这里插入图片描述

5.3 编辑docker-compose.yaml文件

如果想要使用docker-cli方式部署，可参考以下命令部署。（可选）

docker run -d \
   --restart always \
   --name opencloud \
   -p 7700:9200 \
   -v $(pwd)/config:/etc/opencloud \
   -v $(pwd)/data:/var/lib/opencloud \
   -e OC_INSECURE=true \
   -e PROXY_HTTP_ADDR=0.0.0.0:7700 \
   -e OC_URL=https://192.168.3.88:7700 \
   opencloudeu/opencloud-rolling:6.2.0

本次实践我们采用 Docker Compose 方式进行部署，这也是我推荐的方式。首先我们需要创建并编辑 docker-compose.yaml 文件，请注意宿主机映射端口可根据您的实际情况自行设置，务必避免端口冲突。

vim docker-compose.yaml

version: '3'

services:
  opencloud:
    image: opencloudeu/opencloud-rolling:6.2.0
    container_name: opencloud
    restart: always
    ports:
      - "9200:9200"
    volumes:
      - /data/opencloud/config:/etc/opencloud        
      - /data/opencloud/data:/var/lib/opencloud      
    environment:
      - IDM_ADMIN_PASSWORD=admin      
      - OC_INSECURE=true             
      - PROXY_HTTP_ADDR=0.0.0.0:9200
      - OC_URL=https://192.168.3.88:9200

相关配置项解释：

  • 📂 挂载目录 (Volumes)
配置项 解释说明
/data/opencloud/config:/etc/opencloud 配置文件持久化。将容器内 /etc/opencloud 的配置目录，映射到宿主机的 /data/opencloud/config 路径。这样即使容器重启或删除，你的配置文件（包括生成的 jwt_secret）也不会丢失。
/data/opencloud/data:/var/lib/opencloud 核心数据持久化。将容器内 /var/lib/opencloud 的数据目录，映射到宿主机的 /data/opencloud/data 路径。这里会存放你上传的所有文件、用户数据以及系统数据库等核心资产。
  • ⚙️ 环境变量 (Environment)
配置项 解释说明
IDM_ADMIN_PASSWORD=admin 管理员密码设置。将 OpenCloud 默认管理员账号（通常是 admin）的初始登录密码设置为 admin。
OC_INSECURE=true 允许不安全连接。开启后，允许系统通过 HTTP 协议或在没有有效 SSL 证书的情况下运行。这在本地测试或内网部署（未配置 HTTPS 证书）时是必须的。
PROXY_HTTP_ADDR=0.0.0.0:9200 服务监听地址。指定 OpenCloud 的代理服务在容器内部监听 0.0.0.0:9200 地址，确保服务能正常接收来自宿主机端口的转发请求。
OC_URL=https://192.168.3.88:9200 系统对外访问地址。告诉 OpenCloud 它自己被外界访问的完整 URL 是什么。这会影响系统生成的分享链接、重定向地址等。

5.4 创建OpenCloud容器

执行以下命令，创建OpenCloud容器。

docker compose up -d

在这里插入图片描述

5.5 查看OpenCloud容器状态

检查OpenCloud容器运行状态，确保OpenCloud容器正常启动。

root@jeven:/data/opencloud# docker compose ps
WARN[0000] /data/opencloud/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME        IMAGE                                 COMMAND                   SERVICE     CREATED              STATUS              PORTS
opencloud   opencloudeu/opencloud-rolling:6.2.0   "/usr/bin/opencloud …"   opencloud   About a minute ago   Up About a minute   0.0.0.0:9200->9200/tcp, [::]:9200->9200/tcp

在这里插入图片描述

六、访问OpenCloud服务

6.1 访问OpenCloud初始页

浏览器地址： https://<个人的服务器IP>:9200，访问OpenCloud初始页，注意使用HTTPS访问。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

在这里插入图片描述

6.2 登录OpenCloud

使用我们设置的账号密码admin/admin，登录OpenCloud即可

在这里插入图片描述

七、基本使用

7.1 设置中文

点击账号下的Preferences模块，选择语言为中文，系统自动报错配置。

在这里插入图片描述

7.2 创建文件夹

点击“新建”——文件夹，输入文件夹名称，即可创建文件夹。

在这里插入图片描述

7.3 上传文件

在新建选项中，点击“Files Upload”，即可上传本地文件。

在这里插入图片描述

7.4 创建在线文件

选择【新建】——【Markdowm file】，输入文档名称，即可在线编辑markdown文件。

在这里插入图片描述

文档编辑完成后，点击保存。

在这里插入图片描述

在线浏览刚才编辑的文档，效果如下：

在这里插入图片描述

八、总结

本文详细介绍了在 Docker 环境下部署 OpenCloud 文件管理工具的完整流程。从环境检查、镜像拉取，到使用 Docker Compose 编排服务并完成初始化配置，每一步都提供了具体的命令和操作截图。部署成功后，我们通过浏览器访问并验证了 OpenCloud 的核心功能，包括中文设置、文件夹管理、文件上传以及在线文档编辑。整个过程清晰明了，为个人或团队快速搭建一个私有化、功能全面的文件管理与协作平台提供了实用参考。

【声明】本内容来自华为云开发者社区博主，不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源（华为云社区）、文章链接、文章作者等基本信息，否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱： cloudbbs@huaweicloud.com
Ubuntu 服务器 运维
  • 点赞
  • 收藏
  • 关注作者

评论（0）

0/1000
抱歉，系统识别当前为高风险访问，暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称，即可参与社区互动！

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

确认 取消

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入