> For the complete documentation index, see [llms.txt](https://docs.imdcinsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imdcinsights.com/ying-yong-zhong-xin/xie-zuo-yu-sheng-chan-li/owncloud-kuai-su-ru-men.md).

# OwnCloud快速入门

<br>

<figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/owncloud/owncloud-gui-websoft9.png" alt=""><figcaption></figcaption></figure>

### 准备[​](https://support.websoft9.com/docs/owncloud#%E5%87%86%E5%A4%87) <a href="#zhun-bei" id="zhun-bei"></a>

部署 创达睿通 提供的 ownCloud 之后，需完成如下的准备工作：

1. 在云控制台获取您的 **服务器公网IP地址**
2. 在云控制台安全组中，确保 **Inbound（入）规则** 下的 **TCP:80** 和 **TCP:9002** 端口已经开启
3. 在服务器中查看 ownCloud 的 **默认账号和密码**
4. 若想用域名访问 ownCloud **域名五步设置** 过程

### ownCloud 初始化向导[​](https://support.websoft9.com/docs/owncloud#init) <a href="#init" id="init"></a>

#### 详细步骤[​](https://support.websoft9.com/docs/owncloud#%E8%AF%A6%E7%BB%86%E6%AD%A5%E9%AA%A4) <a href="#xiang-xi-bu-zhou" id="xiang-xi-bu-zhou"></a>

1. 使用本地电脑的 Chrome 或 Firefox 浏览器访问网址：*<http://域名>* 或 *<http://服务器公网IP>*, 就进入引导首页&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/owncloud/owncloud-init1-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 填写登陆信息
3. 点击【login】，开始体验后台&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/zh/owncloud/owncloud-installcomplete-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 设置文档预览与编辑功能（非必要）

> 需要了解更多 ownCloud 的使用，请参考官方文档：ownCloud admin\_manual

#### 出现问题？[​](https://support.websoft9.com/docs/owncloud#%E5%87%BA%E7%8E%B0%E9%97%AE%E9%A2%98) <a href="#chu-xian-wen-ti" id="chu-xian-wen-ti"></a>

若碰到问题，请第一时刻联系 **技术支持**。也可以先参考下面列出的问题定位或 **FAQ** 尝试快速解决问题：

**ownCloud 是否支持采用对象存储作为网盘使用**

支持，但需要额外配置

**ownCloud 是否支持在线文档编辑与预览**

镜像预装了 OnlyOffice Docs，可以通过配置实现在线文档编辑与预览

### ownCloud 使用入门[​](https://support.websoft9.com/docs/owncloud#owncloud-%E4%BD%BF%E7%94%A8%E5%85%A5%E9%97%A8) <a href="#owncloud-shi-yong-ru-men" id="owncloud-shi-yong-ru-men"></a>

下面以 **ownCloud 构建企业网盘系统** 作为一个任务，帮助用户快速入门：

### ownCloud 常用操作[​](https://support.websoft9.com/docs/owncloud#owncloud-%E5%B8%B8%E7%94%A8%E6%93%8D%E4%BD%9C) <a href="#owncloud-chang-yong-cao-zuo" id="owncloud-chang-yong-cao-zuo"></a>

#### 配置 SMTP[​](https://support.websoft9.com/docs/owncloud#smtp) <a href="#smtp" id="smtp"></a>

1. 在邮箱管理控制台获取 SMTP 相关参数
2. 登录OwnCloud后，打开【admin】>【设置】>【个人】>【常规】，填写发件邮箱地址&#x20;

   <figure><img src="/files/aadQjucYYYrUH0bBKIIA" alt=""><figcaption></figcaption></figure>
3. 打开【设置】>【管理】>【常规】，依次填写 SMTP 信息&#x20;
   * 发送模式选择“SMTP”，加密方式选择“SSL/TLS”;
   * 输入发送方邮箱地址；
   * 认证方式选择“登录”，并勾选“需要认证”选项；
   * 输入SMTP服务器地址和SMTP服务器的端口号；
   * 输入和发件人邮箱一致的邮箱地址；
   * 输入该邮箱地址的SMTP服务的授权码或密码；
   * 存储凭据；

     <figure><img src="/files/mEiIbitm9yJJgJol90Jj" alt=""><figcaption></figcaption></figure>
4. 点击“发送邮件”即可测试SMTP是否设置正确。

#### 域名额外配置（修改 URL）[​](https://support.websoft9.com/docs/owncloud#dns) <a href="#dns" id="dns"></a>

**域名五步设置** 完成后，需设置 ownCloud 的 URL:

1. 修改 Owncloud 配置文件 中的域名值

   ```
   'overwrite.cli.url' => 'owncloud.yourdomain.com', # 修改为新域名
   ```
2. 重启服务后生效

#### 设置语言[​](https://support.websoft9.com/docs/owncloud#%E8%AE%BE%E7%BD%AE%E8%AF%AD%E8%A8%80) <a href="#she-zhi-yu-yan" id="she-zhi-yu-yan"></a>

登录 ownCloud，在后台 【Personal】>【General】中设置语言

![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/owncloud/owncloud-zh-websoft9.png)

#### 安装扩展[​](https://support.websoft9.com/docs/owncloud#%E5%AE%89%E8%A3%85%E6%89%A9%E5%B1%95) <a href="#an-zhuang-kuo-zhan" id="an-zhuang-kuo-zhan"></a>

ownCloud Marketplace 包含大量的扩展（也叫apps），下面介绍如何安装它们

1. 访问 Marketplace ，搜索所需的应用（以 OwnBackup 为例）&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/owncloud/owncloud-searchapps-websoft9.jpg" alt=""><figcaption></figcaption></figure>
2. 下载并解压
3. 上传到 ownCloud 应用目录：/var/lib/docker/volumes/owncloud\_owncloud/\_data/apps，并通过chown 命令，改变扩展目录（如 ownbackup）的拥有者和关联组用户为 www-data&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/owncloud/owncloud-ftp-websoft9.png" alt=""><figcaption></figcaption></figure>
4. 启用 OwnBackup<br>

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/owncloud/owncloud-enableapps-websoft9.png" alt=""><figcaption></figcaption></figure>

> 除了下载安装之外，也可以通过 ownCloud 后台在线安装 Marketplace 应用

#### 连接外部存储[​](https://support.websoft9.com/docs/owncloud#oss) <a href="#oss" id="oss"></a>

ownCloud 支持多种流行的企业存储服务，具体使用步骤如下：

1. 登录 ownCloud 后台，安装 **External storage support** 扩展&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/owncloud/owncloud-enablestorage-websoft9.png" alt=""><figcaption></figcaption></figure>
2. 打开：【Admin】>【Add storage】>【External Storage】，选择一个外部存储服务&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/owncloud/owncloud-enablestorage002-websoft9.png" alt=""><figcaption></figcaption></figure>
3. 根据实际情况进行设置&#x20;

   <figure><img src="https://libs.websoft9.com/Websoft9/DocsPicture/en/owncloud/owncloud-auth_mechanism-websoft9.png" alt=""><figcaption></figcaption></figure>

更多详情参考官方文档：External Storage

#### 数据转移[​](https://support.websoft9.com/docs/owncloud#%E6%95%B0%E6%8D%AE%E8%BD%AC%E7%A7%BB) <a href="#shu-ju-zhuan-yi" id="shu-ju-zhuan-yi"></a>

ownCloud 的程序和数据文件默认均存在系统盘，你要转移到数据盘（或对象存储），步骤如下：

**转移到对象存储**[**​**](https://support.websoft9.com/docs/owncloud#%E8%BD%AC%E7%A7%BB%E5%88%B0%E5%AF%B9%E8%B1%A1%E5%AD%98%E5%82%A8)

1. 将 ownCloud 数据目录复制一份到目录：*/data/backup/owncloud*
2. 在服务器所在的云平台上购买对象存储，新建一个 **bucket**
3. 将对象存储的 bucket **mount** 到 ownCloud 数据目录，并设置开机自动挂载（具体参考对象存储文档）
4. 将 ownCloud 备份文件拷贝到 ownCloud 数据目录
5. 连接到 ownCloud 容器，重建 ownCloud 索引

   ```
   occ files:scan --all
   ```

**转移到数据盘**[**​**](https://support.websoft9.com/docs/owncloud#%E8%BD%AC%E7%A7%BB%E5%88%B0%E6%95%B0%E6%8D%AE%E7%9B%98)

转移到数据盘的操作与转移到对象存储非常类似，只是 2-3 步骤操作略有差异

> 以上两种数据转移方案中，**mount** 操作对新手来说是几乎是不可能独立完成的任务。另外，如果转移的数据超过10G，会存在拷贝失败的风险

### ownCloud 参数[​](https://support.websoft9.com/docs/owncloud#parameter) <a href="#parameter" id="parameter"></a>

ownCloud 应用中包含 PHP, Apache, Nginx, Docker, Redis, MySQL, phpMyAdmin, ONLYOFFICE Docs 等组件，可通过 **通用参数表** 查看路径、服务、端口等参数。

通过运行`docker ps`，可以查看到 ownCloud 运行时所有的 Container：

```
CONTAINER ID   IMAGE                              COMMAND                  CREATED             STATUS                       PORTS                                                  NAMES
47ea9a709b5d   onlyoffice/documentserver:latest   "/app/ds/run-documen…"   About an hour ago   Up About an hour             443/tcp, 0.0.0.0:9002->80/tcp, :::9002->80/tcp         onlyofficedocs
cd2792a962d0   phpmyadmin:latest                  "/docker-entrypoint.…"   About an hour ago   Up About an hour             0.0.0.0:9090->80/tcp, :::9090->80/tcp                  phpmyadmin
c2cce00268eb   ownCloud/server:latest             "/usr/bin/entrypoint…"   About an hour ago   Up About an hour (healthy)   0.0.0.0:9001->8080/tcp, :::9001->8080/tcp              ownCloud
bdfde6911911   mysql:5.7                          "docker-entrypoint.s…"   About an hour ago   Up About an hour (healthy)   0.0.0.0:3306->3306/tcp, :::3306->3306/tcp, 33060/tcp   ownCloud-db
59fa97a29571   redis:6                            "docker-entrypoint.s…"   About an hour ago   Up About an hour (healthy)   6379/tcp                                               ownCloud-redis
```

#### 路径[​](https://support.websoft9.com/docs/owncloud#path) <a href="#path" id="path"></a>

ownCloud 安装目录： */data/apps/ownCloud*\
ownCloud 数据目录： */data/apps/ownCloud/data/ownCloud*\
ownCloud 配置文件： */data/apps/ownCloud/data/ownCloud/config/config.php*\
Onlyofficedocs 安装目录：*/data/apps/onlyofficedocs*

#### 端口[​](https://support.websoft9.com/docs/owncloud#port) <a href="#port" id="port"></a>

| 端口号  | 用途                        | 必要性 |
| ---- | ------------------------- | --- |
| 9002 | OnlyOffice Docs on Docker | 可选  |

#### 版本[​](https://support.websoft9.com/docs/owncloud#version) <a href="#version" id="version"></a>

```
docker exec -i ownCloud occ -Version
```

#### 服务[​](https://support.websoft9.com/docs/owncloud#service) <a href="#service" id="service"></a>

```
sudo docker start | stop | restart | stats ownCloud
sudo docker start | stop | restart | stats ownCloud-db
sudo docker start | stop | restart | stats ownCloud-redis
sudo docker start | stop | restart | stats onlyofficedocs
```

#### 命令行[​](https://support.websoft9.com/docs/owncloud#cli) <a href="#cli" id="cli"></a>

ownCloudcmd 命令是 ownCloud 的命令行工具

```
ownCloudcmd -h
```

#### API[​](https://support.websoft9.com/docs/owncloud#api) <a href="#api" id="api"></a>

[Provisioning API](https://doc.owncloud.com/server/next/developer_manual/core/apis/provisioning-api.html)
