用Nextcloud和Docker搭建私有云,先满足三个前提
搭建私有云最省事的入门方式,是在一台有公网 IP 的服务器上用 Docker 部署 Nextcloud。
它把文件存储、网页访问和客户端同步打包好了,不需要自己写后端。
但开始之前,先确认三个前提:服务器至少 2 核 4G、系统是 Ubuntu 22.04 或相近版本、你有一个已解析到这台服务器的域名。
下面按安装顺序讲清楚每一步做什么、怎么检查。
先确认服务器和域名到位
私有云要长期跑,配置太低会在上传大文件或多人同时访问时卡住。
建议起步 2 核 4G、系统盘 40G 以上,数据盘单独挂载。
系统用 Ubuntu 22.04 LTS,软件源和 Docker 支持都比较稳。
域名方面,在 DNS 服务商处添加一条 A 记录,把 cloud.你的域名.com 指向服务器公网 IP。
解析生效后,用 ping cloud.你的域名.com 确认返回的是这台服务器的 IP。
如果服务器在国内,域名需要完成备案才能用 80 和 443 端口对外提供网页访问。
登录服务器后先更新系统:
sudo apt update && sudo apt upgrade -y
再检查时间是否准确,证书和登录验证都依赖系统时间:
date
timedatectl status
如果时间偏差大,执行 sudo timedatectl set-ntp true 开启自动同步。
安装 Docker 并准备数据目录
用 Docker 官方脚本安装,避免系统自带版本过旧:
curl -fsSL https://get.docker.com | sudo sh
sudo systemctl enable --now docker
装完后用 docker --version 确认能输出版本号。
接着创建数据目录,把数据库、应用配置和用户文件分开存放,以后备份和迁移都方便:
sudo mkdir -p /opt/nextcloud/{db,app,data}
sudo chown -R 33:33 /opt/nextcloud/app /opt/nextcloud/data
33 是容器内 www-data 用户的 UID,权限不对会导致安装时提示目录不可写。
数据目录最好放在独立磁盘上,挂载点例如 /data,再把 /opt/nextcloud/data 指向那里。
用 Docker Compose 启动数据库和 Nextcloud
在 /opt/nextcloud 下新建 docker-compose.yml,内容如下(密码换成你自己的强密码):
services:
db:
image: mariadb:10.11
restart: always
volumes:
- ./db:/var/lib/mysql
environment:
MYSQL_ROOT_PASSWORD: 换成强密码
MYSQL_PASSWORD: 换成强密码
MYSQL_DATABASE: nextcloud
MYSQL_USER: nextcloud
app:
image: nextcloud:27-apache
restart: always
ports:
- "8080:80"
volumes:
- ./app:/var/www/html
- ./data:/var/www/html/data
environment:
MYSQL_HOST: db
MYSQL_DATABASE: nextcloud
MYSQL_USER: nextcloud
MYSQL_PASSWORD: 换成强密码
depends_on:
- db
启动容器:
cd /opt/nextcloud
sudo docker compose up -d
用 sudo docker compose ps 查看两个容器是否都是 running。
如果 app 反复重启,先看日志:
sudo docker compose logs --tail=50 app
常见原因是数据库还没就绪或密码不一致,按日志提示修正后重新 up -d。
配置反向代理和 HTTPS
直接暴露 8080 端口不安全,也不方便记。
用 Nginx 做反向代理,让用户通过 https://cloud.你的域名.com 访问。
先安装 Nginx 和 Certbot:
sudo apt install -y nginx certbot python3-certbot-nginx
新建站点配置 /etc/nginx/sites-available/nextcloud:
server {
listen 80;
server_name cloud.你的域名.com;
client_max_body_size 10G;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
启用配置并检查语法:
sudo ln -s /etc/nginx/sites-available/nextcloud /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
然后申请证书,Certbot 会自动改写配置加上 443:
sudo certbot --nginx -d cloud.你的域名.com
申请成功后访问 https://cloud.你的域名.com,应该能看到 Nextcloud 的初始化页面。
按提示创建管理员账号,数据库主机填 db,数据库用户和密码与 compose 文件中一致。
验证私有云是否真的可用
安装完成后不要只看首页能不能打开,按下面几项检查:
- 用管理员账号登录,在“设置”里确认安全与设置警告,重点看 HTTPS、数据目录权限和数据库版本是否报错。
- 上传一个几百 MB 的文件,确认进度条走完且文件出现在文件列表。如果卡在上传,检查 Nginx 的
client_max_body_size和 PHP 上传限制。 - 在手机或电脑上安装 Nextcloud 客户端,用域名和账号登录,测试同步一个文件夹。
- 执行
sudo docker compose logs --tail=30 app,看有没有持续报错。
如果客户端提示证书无效,检查域名是否和证书一致、Certbot 是否成功续期。
可以用 sudo certbot renew --dry-run 模拟续期。
容易踩坑的几个地方
数据目录权限是新手最常卡住的一步。
容器内 Web 服务以 UID 33 运行,宿主机目录如果属于 root,安装时会提示“目录不可写”。
用 sudo chown -R 33:33 /opt/nextcloud/data 修正,不要直接给 777。
数据库连接失败时,先确认 docker-compose.yml 里 MYSQL_HOST 写的是服务名 db,不是 localhost。
容器之间通过服务名通信,写 localhost 会连到应用容器自己。
反向代理后如果页面样式丢失或跳转成内网地址,需要在 Nextcloud 的 config/config.php 里补充可信域名:
'trusted_domains' => array (
0 => 'cloud.你的域名.com',
),
'overwriteprotocol' => 'https',
改完重启应用容器:sudo docker compose restart app。
私有云的数据都在自己手里,备份也要自己负责。
至少定期备份 /opt/nextcloud/db 和 /opt/nextcloud/data,并测试恢复流程。
做到这一步,一套能日常使用的私有云就算搭好了。