使用docker-compose搭建Nextcloud个人云盘并开启https教程

一、前言

之前一直采用LANMP直接搭建服务,但后来使用docker后,搭建和迁移数据都很方便,所以将服务都容器化。

下面介绍一下使用docker-compose搭建Nextcloud,并且使用Nginx的反向代理开启https的方法。

直接搭建的文章可以参考我的这一篇博文:Centos 7.6搭建Nextcloud 17.0.0个人云盘详细教程

二、环境准备

基础环境的搭建这里不做细讲,默认环境已经安装或者拥有下面的服务和文件:

  • Nginx服务器
  • docker
  • docker-compose
  • 域名证书(Nginx适用)

docker的安装可以参考我的这一篇博文:Ubuntu使用Docker搭建编译环境完整教程

三、docker-compose配置

(一)docker-compose.yml

注意点:

  • 数据库挂载到当前./db文件夹
  • Nextcloud应用挂载到当前./app文件夹
  • 主机ports使用的是19080端口,可以自行修改,后面Nginx需要反向代理到这个端口
  • ./init_secrets文件夹每个文件里是初始化用户名、密码等参数,需要自行设置并创建
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
version: '3.2'

services:
db:
image: postgres:12
container_name: nextcloud_db
restart: always
volumes:
- ./db:/var/lib/postgresql/data
environment:
- POSTGRES_DB_FILE=/run/secrets/postgres_db
- POSTGRES_USER_FILE=/run/secrets/postgres_user
- POSTGRES_PASSWORD_FILE=/run/secrets/postgres_password
secrets:
- postgres_db
- postgres_password
- postgres_user

app:
image: nextcloud
container_name: nextcloud
restart: always
ports:
- 19080:80
volumes:
- ./app:/var/www/html
environment:
- POSTGRES_HOST=db
- POSTGRES_DB_FILE=/run/secrets/postgres_db
- POSTGRES_USER_FILE=/run/secrets/postgres_user
- POSTGRES_PASSWORD_FILE=/run/secrets/postgres_password
- NEXTCLOUD_ADMIN_PASSWORD_FILE=/run/secrets/nextcloud_admin_password
- NEXTCLOUD_ADMIN_USER_FILE=/run/secrets/nextcloud_admin_user
depends_on:
- db
secrets:
- nextcloud_admin_password
- nextcloud_admin_user
- postgres_db
- postgres_password
- postgres_user

secrets:
nextcloud_admin_password:
file: ./init_secrets/nextcloud_admin_password.txt # put admin password to this file
nextcloud_admin_user:
file: ./init_secrets/nextcloud_admin_user.txt # put admin username to this file
postgres_db:
file: ./init_secrets/postgres_db.txt # put postgresql db name to this file
postgres_password:
file: ./init_secrets/postgres_password.txt # put postgresql password to this file
postgres_user:
file: ./init_secrets/postgres_user.txt # put postgresql username to this file

(二)启动运行

docker-compose.yml所在文件夹运行下面的命令启动:

1
docker-compose up -d

可以使用下面的命令查看运行日志:

1
docker-compose logs -f

等日志显示Nexcloud安装完毕后,我们在浏览器里输入http://127.0.0.1:19080应该可以看到登陆界面,用户名密码就是./init_secrets你设置的用户名和密码。

但是我们一般使用域名访问,而且本文还开启了https,所以还需要配置Nginx反向代理。

四、Nginx配置

/etc/nginx/conf.d里创建Nextcloud.conf

注意点:

  • server_name换成你的域名
  • ssl_certificatessl_certificate_key换成你的域名证书
  • client_max_body_size设置最大上传文件大小
  • proxy_pass换成你的链接和端口号
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
server {
listen 80;
listen [::]:80;

server_name yasin.store www.yasin.store;

# redirect all HTTP requests to HTTPS with a 301 Moved Permanently response.
return 301 https://yasin.store$request_uri;
}

server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name yasin.store;

ssl on;
ssl_certificate /yasin/ssl/nginx/yasin_store/yasin.store.crt;
ssl_certificate_key /yasin/ssl/nginx/yasin_store/yasin.store.key;
client_max_body_size 10G;

add_header Strict-Transport-Security "max-age=63072000; includeSubdomains; preload";

location = /.well-known/carddav {
return 301 $scheme://$host:$server_port/remote.php/dav;
}
location = /.well-known/caldav {
return 301 $scheme://$host:$server_port/remote.php/dav;
}

location / {
proxy_redirect off;
proxy_pass http://127.0.0.1:19080;
proxy_set_header Host $http_host;
}
location = /.htaccess {
return 404;
}
}

重启Nginx使配置生效:

1
systemctl restart nginx

五、问题解决

按照上面的步骤一切正确的话,我们在浏览器中输入你的域名时,应该会自动跳转到https://你的域名。但是应该会出现下面的第一个错误:

(一)通过不被信任的域名访问

这是因为Nextcloud默认只能通过localhost访问,需要信任你的域名。

编辑下面的文件:

1
vim ./app/config/config.php

修改下面的内容,第二行记得换成你的域名:

1
2
3
4
5
'trusted_domains' =>
array (
0 => 'localhost',
1 => 'yasin.store',
),

(二)登陆后不自动跳转

修改完成后刷新页面,应该可以看见登陆界面了,用户名密码就是./init_secrets你设置的用户名和密码。

但是你会发现页面不会自动跳转,但是手动刷新后可以访问。

要想自动跳转,需要修改下面的文件:

1
vim ./app/config/config.php

增加下面的内容:

1
'overwriteprotocol' => 'https',

这时候你的云盘已经可以正常使用了,但是如果你是个强迫症的话,在设置里查看概览时应该还会遇到并想解决下面的两个错误。

如果你不在意的话,那么本文到这里就已经结束了。

(三)dav设置不正确

错误提示如下(为了减少操作,上面的Nginx配置文件里已添加该内容,所以你应该看不到这个错误了):

  • 您的网页服务器未正确设置以解析“/.well-known/caldav”。更多信息请参见文档。
  • 您的网页服务器未正确设置以解析“/.well-known/carddav”。更多信息请参见文档。

解决方法,nginx反向代理时添加下面的配置:

1
2
3
4
5
6
location = /.well-known/carddav {
return 301 $scheme://$host:$server_port/remote.php/dav;
}
location = /.well-known/caldav {
return 301 $scheme://$host:$server_port/remote.php/dav;
}

(四)数据库错误

错误1:

  • 数据库丢失了一些索引。由于给大的数据表添加索引会耗费一些时间,因此程序没有自动对其进行修复。您可以在 Nextcloud 运行时通过命令行手动执行 “occ db:add-missing-indices” 命令修复丢失的索引。索引修复后会大大提高相应表的查询速度。
    • 在数据表 “oc_calendarobjects_props” 中无法找到索引 “calendarobject_calid_index”。
    • 在数据表 “oc_schedulingobjects” 中无法找到索引 “schedulobj_principuri_index”。

解决方法:

进入容器:

1
docker exec -u www-data -it nextcloud bash

执行下面的命令:

1
/var/www/html/occ db:add-missing-indices

错误2:

  • 数据库中的一些列由于进行长整型转换而缺失。由于在较大的数据表重改变列类型会耗费一些时间,因此程序没有自动对其更改。您可以通过命令行手动执行 “occ db:convert-filecache-bigint” 命令以应用挂起的更改。该操作需要当整个实例变为离线状态后执行。查阅相关文档以获得更多详情。
    • mounts.storage_id
    • mounts.root_id
    • mounts.mount_id

解决方法:

进入容器:

1
docker exec -u www-data -it nextcloud bash

执行下面的命令:

1
/var/www/html/occ db:convert-filecache-bigint

选择y并且回车。

这时候再刷新网页,可以发现概览中的所有错误和警告都已经解决。

六、升级Nextcloud

当提示有新的版本可以升级时,可以使用下面的命令进行升级:

1
2
3
docker-compose down
docker-compose pull
docker-compose up -d

强烈建议升级前先备份你的数据。

七、结束

对比直接搭建,会发现使用docker会简单很多,而且比较方便数据的迁移。

需要换机器部署时,只需将当前文件夹内的所有文件打包,并且在新机器上配置好Nginx反向代理即可。

参考官方镜像的文档,甚至可以将Nginx也使用容器部署,这里就不再详细介绍了。

Enjoy it now.


使用docker-compose搭建Nextcloud个人云盘并开启https教程
https://www.shangyexin.com/2020/05/23/docker-nextcloud/
作者
Yasin
发布于
2020年5月23日
许可协议