NextCloud私有云部署

服务器上部署 Nextcloud 主要有三种主流方式：

手动部署（LNMP/LAMP）：最灵活，可定制性最强，适合对服务器有完全控制权、希望深入理解各组件运行原理的用户
Docker Compose 部署：部署和迁移方便，环境隔离，适合希望快速上线、易于维护的用户
Nextcloud All-in-One (AIO)：官方推荐的最简单方式，一个命令启动所有服务，包含备份、办公室套件等，适合新手或不想操心细节的用户

本笔者有一台 Ubuntu 22.04的云服务器，选择手动部署方式

那么下面是使用 Nginx + PHP-FPM + MariaDB + Redis 组合的详细手动部署教程

一、前提准备

一台运行 Ubuntu 22.04 或 24.04 LTS 的服务器
具有 sudo 权限的非 root 用户
（可选）已解析到服务器 IP 的域名

硬件最低建议：2GB 内存 / 2 vCPU

二、更新、安装基础组件和 Nginx

1
sudo apt update && sudo apt upgrade -y
2
sudo apt install -y wget curl unzip gnupg2 nginx
3

4
sudo systemctl enable --now nginx

验证 Nginx 是否运行：

1
sudo systemctl status nginx

应显示 active (running)

三、安装 PHP 8.2 及所有必须扩展

Nextcloud 目前要求 PHP 8.1 ~ 8.3，以 PHP 8.2 为例：

1. 安装PHP 8.2

1
# 添加 PPA源 并更新
2
sudo apt update
3
sudo apt install -y software-properties-common
4
sudo add-apt-repository ppa:ondrej/php
5
sudo apt update
6

7
# 安装 PHP 8.2
8
sudo apt install -y php8.2-fpm php8.2-cli
9

10
# 验证安装
11
php -v

2. 安装必须扩展

1
sudo apt update
2
sudo apt install -y php8.2-xml php8.2-mbstring php8.2-gd php8.2-zip php8.2-curl php8.2-bcmath php8.2-gmp php8.2-imagick php8.2-redis php8.2-mysql

插件安装不完整则无法正常使用

3. 配置 PHP 上传限制

Nextcloud 默认需要处理大文件，修改 PHP-FPM 配置：

1
sudo sed -i 's/^upload_max_filesize = .*/upload_max_filesize = 10G/' /etc/php/8.2/fpm/php.ini
2
sudo sed -i 's/^post_max_size = .*/post_max_size = 10G/' /etc/php/8.2/fpm/php.ini

验证修改：

1
grep -E 'upload_max_filesize|post_max_size' /etc/php/8.2/fpm/php.ini

应显示两项均为 10G（与 Nginx 的 client_max_body_size 10G 保持一致）

4. 配置 OPcache

Nextcloud 管理后台会对未正确配置 OPcache 的环境显示性能警告。修改两个文件：

php.ini — 取消注释并调整：

1
sudo sed -i \
2
  -e 's/^;opcache.enable=1/opcache.enable=1/' \
3
  -e 's/^;opcache.memory_consumption=128/opcache.memory_consumption=128/' \
4
  -e 's/^;opcache.interned_strings_buffer=8/opcache.interned_strings_buffer=8/' \
5
  -e 's/^;opcache.max_accelerated_files=10000/opcache.max_accelerated_files=10000/' \
6
  -e 's/^;opcache.revalidate_freq=2/opcache.revalidate_freq=1/' \
7
  -e 's/^;opcache.save_comments=1/opcache.save_comments=1/' \
8
  /etc/php/8.2/fpm/php.ini

10-opcache.ini — 启用 JIT（PHP 8.x 特有）：

1
sudo vim /etc/php/8.2/fpm/conf.d/10-opcache.ini

将 opcache.jit=off 改为：

1
opcache.jit=1255
2
opcache.jit_buffer_size=128M

revalidate_freq=1 表示每秒检查一次文件变更，生产环境推荐值；开发环境可设为 0 1255 是 PHP JIT 的 disable_specializer 模式，兼顾兼容性与性能

5. 可选扩展

以下扩展非必须但推荐按需安装：

1
sudo apt install -y php8.2-intl php8.2-smbclient

php8.2-intl：国际化支持，Nextcloud 官方推荐，缺少会导致管理后台警告
php8.2-smbclient：支持挂载 SMB/CIFS 外部存储

6. imagick 安全策略加固

php8.2-imagick 依赖的 ImageMagick 默认允许处理 SVG、MSL 等格式，存在 XXE、SSRF 和任意文件读写风险。需要编辑策略文件禁用危险编码器：

1
sudo vim /etc/ImageMagick-6/policy.xml

在 </policymap> 前添加：

1
  <!-- 安全加固：禁用危险编码器 -->
2
  <policy domain="coder" rights="none" pattern="MSL" />
3
  <policy domain="coder" rights="none" pattern="SVG" />
4
  <policy domain="coder" rights="none" pattern="MVG" />
5
  <policy domain="coder" rights="none" pattern="URL" />
6
  <policy domain="coder" rights="none" pattern="HTTPS" />
7
  <policy domain="coder" rights="none" pattern="HTTP" />
8
  <policy domain="coder" rights="none" pattern="EPHEMERAL" />
9
  <policy domain="coder" rights="none" pattern="LABEL" />

这些编码器 Nextcloud 不需要，禁用后不影响正常图片处理（GIF/JPEG/PNG/WEBP/HEIC/TIFF 均保留）

启动 PHP-FPM：

1
sudo systemctl enable --now php8.2-fpm

四、安装MariaDB数据库

1
sudo apt install -y mariadb-server
2
sudo systemctl enable --now mariadb

安全初始化（设置 root 密码等）：

1
sudo mysql_secure_installation

登录数据库并创建 Nextcloud 专用库和用户：

1
sudo mysql -u root -p

1
CREATE DATABASE nextcloud;
2
CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY '你的强密码';
3
GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';
4
FLUSH PRIVILEGES;
5
EXIT;

五、安装 Redis 缓存

1
sudo apt install -y redis-server
2
sudo systemctl enable --now redis-server

配置 Redis 使用 Unix Socket（比 TCP 更快）：

1
sudo nano /etc/redis/redis.conf

找到并修改/添加：

1
unixsocket /var/run/redis/redis-server.sock
2
unixsocketperm 770

将 www-data 用户加入 redis 组，然后重启：

1
sudo usermod -aG redis www-data
2
sudo systemctl restart redis-server

六、下载并安装 Nextcloud

1. 下载最新版本

1
cd /tmp
2
wget https://download.nextcloud.com/server/releases/latest.zip

2. 解压到 Web 目录

1
sudo unzip -q latest.zip -d /var/www/
2
sudo rm /tmp/latest.zip

3. 创建数据目录（放在 Web 根目录外，更安全）

1
sudo mkdir -p /var/nextcloud-data

4. 设置正确的权限

1
sudo chown -R www-data:www-data /var/www/nextcloud
2
sudo chown -R www-data:www-data /var/nextcloud-data

七、配置 Nginx

注意：将 your-domain.com 替换为你的实际域名/子域名或 IP 地址

1. DNS解析

先将 子域名 A记录指向服务器IP，确保解析生效后再继续。

2. 安装 certbot

1
sudo apt install certbot python3-certbot-nginx

3. 先用 HTTP 配置启动站点（用于申请证书）

创建一个临时的 HTTP-only 配置：

1
sudo vim /etc/nginx/sites-available/nextcloud

写入以下临时配置：

1
server {
2
    listen 80;
3
    listen [::]:80;
4
    server_name your-domain.com;
5

6
    root /var/www/nextcloud;
7
    index index.php index.html;
8

9
    # certbot 验证路径
10
    location /.well-known/acme-challenge/ {
11
        allow all;
12
    }
13

14
    location / {
15
        return 301 https://$host$request_uri;
16
    }
17
}

4. 启用站点

1
# 删除默认站点，避免冲突
2
sudo rm /etc/nginx/sites-enabled/default 2>/dev/null
3
# 软链接 nextcloud 站点
4
sudo ln -s /etc/nginx/sites-available/nextcloud /etc/nginx/sites-enabled/
5

6
sudo nginx -t
7
sudo systemctl reload nginx

5. 申请 SSL 证书

1
sudo certbot certonly --nginx -d your-domain.com

6. 替换为完整的 Nextcloud Nginx 配置

证书申请成功后，将临时配置替换为完整配置：

1
sudo vim /etc/nginx/sites-available/nextcloud

写入以下完整配置：

1
upstream php-handler {
2
    server unix:/run/php/php8.2-fpm.sock;
3
}
4

5
# ========== Nextcloud 主服务器（443） ==========
6
server {
7
    listen 443 ssl http2;
8
    listen [::]:443 ssl http2;
9
    server_name your-domain.com;
10

11
    # SSL 证书（Let's Encrypt 路径）
12
    ssl_certificate     /etc/letsencrypt/live/your-domain.com/fullchain.pem;
13
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
14

15
    # SSL 优化
16
    ssl_protocols TLSv1.2 TLSv1.3;
17
    ssl_prefer_server_ciphers off;
18
    ssl_session_cache shared:SSL:10m;
19
    ssl_session_timeout 10m;
20

21
    # gzip 压缩（放在 server 顶层，全局生效）
22
    gzip on;
23
    gzip_vary on;
24
    gzip_comp_level 4;
25
    gzip_min_length 256;
26
    gzip_proxied expired no-cache no-store private no_last_modified no_etag auth;
27
    gzip_types application/atom+xml application/javascript application/json application/ld+json application/manifest+json application/rss+xml application/vnd.geo+json application/vnd.ms-fontobject application/x-font-ttf application/x-web-app-manifest+json application/xhtml+xml application/xml font/opentype image/bmp image/svg+xml image/x-icon text/cache-manifest text/css text/plain text/vcard text/vnd.rim.location.xloc text/vtt text/x-component text/x-cross-domain-policy;
28

29
    root /var/www/nextcloud;
30
    index index.php index.html index.htm;
31

32
    client_max_body_size 10G;
33
    client_body_timeout 300s;
34

35
    # 去除不必要的头
36
    fastcgi_hide_header X-Powered-By;
37

38
    location = / {
39
        if ( $http_user_agent ~ ^DavClnt ) {
40
            return 302 /remote.php/webdav/$is_args$args;
41
        }
42
        try_files $uri $uri/ /index.php$request_uri;
43
    }
44

45
    location = /robots.txt {
46
        allow all;
47
        log_not_found off;
48
        access_log off;
49
    }
50

51
    location ^~ /apps/rainloop/app/data {
52
        deny all;
53
    }
54

55
    location ~ ^\/(?:build|tests|config|lib|3rdparty|templates|data)(?:$|\/) {
56
        return 404;
57
    }
58

59
    location ~ ^\/(?:\.|autotest|occ|issue|indie|db_|console) {
60
        return 404;
61
    }
62

63
    location ~ \.php(?:$|\/) {
64
        rewrite ^/(?!index|remote|public|cron|core\/ajax\/update|status|ocs\/v[12]|updater\/.+|oc[ms]-provider\/.+|.+\/vendor\/) /index.php$request_uri;
65

66
        fastcgi_split_path_info ^(.+?\.php)(\/.*|)$;
67
        try_files $fastcgi_script_name =404;
68
        set $path_info $fastcgi_path_info;
69

70
        include fastcgi_params;
71
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
72
        fastcgi_param PATH_INFO $path_info;
73
        fastcgi_param HTTPS on;
74
        fastcgi_param modHeadersAvailable true;
75
        fastcgi_param front_controller_active true;
76
        fastcgi_pass php-handler;
77
        fastcgi_intercept_errors on;
78
        fastcgi_request_buffering off;
79
        fastcgi_read_timeout 300s;
80
    }
81

82
    # 长期缓存的静态资源（图片/CSS/JS/字体/媒体）
83
    # 安全头必须在每个 location 中重复声明，Nginx 的 add_header 不会从 server 继承
84
    location ~* \.(?:css|js|svg|gif|png|jpg|ico|wasm|tflite|map|woff2?|eot|ttf|otf|mp4|webm|ogg)$ {
85
        try_files $uri /index.php$request_uri;
86
        add_header Cache-Control "public, max-age=15778463, immutable" always;
87
        add_header Referrer-Policy "no-referrer" always;
88
        add_header X-Content-Type-Options "nosniff" always;
89
        add_header X-Download-Options "noopen" always;
90
        add_header X-Frame-Options "SAMEORIGIN" always;
91
        add_header X-Permitted-Cross-Domain-Policies "none" always;
92
        add_header X-Robots-Tag "noindex, nofollow" always;
93
        add_header X-XSS-Protection "1; mode=block" always;
94
        add_header Strict-Transport-Security "max-age=15768000; includeSubDomains" always;
95
        access_log off;
96
    }
97

98
    # 短期缓存（RSS/Atom）
99
    location ~* \.(?:rss|atom)$ {
100
        try_files $uri /index.php$request_uri;
101
        add_header Cache-Control "public, max-age=3600" always;
102
        add_header Referrer-Policy "no-referrer" always;
103
        add_header X-Content-Type-Options "nosniff" always;
104
        add_header X-Download-Options "noopen" always;
105
        add_header X-Frame-Options "SAMEORIGIN" always;
106
        add_header X-Permitted-Cross-Domain-Policies "none" always;
107
        add_header X-Robots-Tag "noindex, nofollow" always;
108
        add_header X-XSS-Protection "1; mode=block" always;
109
        add_header Strict-Transport-Security "max-age=15768000; includeSubDomains" always;
110
        access_log off;
111
    }
112

113
    # 文本文件
114
    location ~* \.(?:html|htm|txt|md|log)$ {
115
        try_files $uri /index.php$request_uri;
116
        add_header Referrer-Policy "no-referrer" always;
117
        add_header X-Content-Type-Options "nosniff" always;
118
        add_header X-Download-Options "noopen" always;
119
        add_header X-Frame-Options "SAMEORIGIN" always;
120
        add_header X-Permitted-Cross-Domain-Policies "none" always;
121
        add_header X-Robots-Tag "noindex, nofollow" always;
122
        add_header X-XSS-Protection "1; mode=block" always;
123
        add_header Strict-Transport-Security "max-age=15768000; includeSubDomains" always;
124
        access_log off;
125
    }
126

127
    # remote WebDAV 相关文件
128
    location ~* ^/remote/(.*)\.(txt|xml|json)$ {
129
        try_files $uri /index.php$request_uri;
130
        add_header Referrer-Policy "no-referrer" always;
131
        add_header X-Content-Type-Options "nosniff" always;
132
        add_header X-Download-Options "noopen" always;
133
        add_header X-Frame-Options "SAMEORIGIN" always;
134
        add_header X-Permitted-Cross-Domain-Policies "none" always;
135
        add_header X-Robots-Tag "noindex, nofollow" always;
136
        add_header X-XSS-Protection "1; mode=block" always;
137
        add_header Strict-Transport-Security "max-age=15768000; includeSubDomains" always;
138
        access_log off;
139
    }
140

141
    location ~ ^\/(?:updater|oc[ms]-provider)(?:$|\/) {
142
        try_files $uri $uri/ =404;
143
        index index.php;
144
    }
145

146
    location = /.well-known/carddav {
147
        return 301 $scheme://$host/remote.php/dav;
148
    }
149

150
    location = /.well-known/caldav {
151
        return 301 $scheme://$host/remote.php/dav;
152
    }
153

154
    location = /.well-known/webfinger {
155
        return 301 $scheme://$host/index.php/.well-known/webfinger;
156
    }
157

158
    location = /.well-known/nodeinfo {
159
        return 301 $scheme://$host/index.php/.well-known/nodeinfo;
160
    }
161

162
    location ~ /\.ht {
163
        deny all;
164
    }
165

166
    location / {
167
        try_files $uri $uri/ /index.php$request_uri;
168
    }
169
}
170

171
# ========== HTTP 强制跳转 HTTPS ==========
172
server {
173
    listen 80;
174
    listen [::]:80;
175
    server_name your-domain.com;
176

177
    location /.well-known/acme-challenge/ {
178
        allow all;
179
    }
180

181
    return 301 https://$host$request_uri;
182
}

7. 测试并重载 Nginx

1
sudo nginx -t
2
sudo systemctl reload nginx

8. 配置防火墙（UFW）

如果服务器启用了 UFW，需要放行 HTTP/HTTPS 流量：

1
sudo ufw allow 'Nginx Full'
2
sudo ufw status

如果使用的是阿里云、腾讯云等云服务器，安全组规则中也需要放行 80 和 443 端口

八、通过浏览器完成安装

在浏览器中访问 https://你的子域名/域名
按照引导页面操作：
- 创建管理员账户：设置用户名和密码
- 数据库配置：
  - 数据库类型：选择 `MariaDB
  - 数据库名：nextcloud
  - 数据库用户：nextcloud
  - 数据库密码：设置的密码
  - 数据库主机：localhost
- 数据目录：填入 /var/nextcloud-data
点击 “完成安装”，等待安装完成
安装完成后补充 HTTPS 覆写配置

1
sudo -u www-data php /var/www/nextcloud/occ config:system:set overwrite.cli.url --value=https://your-domain.com
2
sudo -u www-data php /var/www/nextcloud/occ config:system:set overwriteprotocol --value=https

接入 Redis 缓存

之前安装了 Redis 但还未接入 Nextcloud，现在编辑 config.php 添加配置：

1
sudo vim /var/www/nextcloud/config/config.php

在 $CONFIG = array ( ); 之前添加以下内容：

1
  'memcache.local' => '\OC\Memcache\Redis',
2
  'memcache.distributed' => '\OC\Memcache\Redis',
3
  'redis' => array(
4
    'host' => '/var/run/redis/redis-server.sock',
5
    'port' => 0,
6
  ),

port => 0 表示使用 Unix Socket 而非 TCP，性能更好

重启 PHP-FPM 使配置生效：

1
sudo systemctl restart php8.2-fpm

验证 Redis 已接入（管理后台 → 基本设置 → 性能，应显示 Redis 作为本地缓存）

配置 Cron 定时任务

Nextcloud 后台任务默认使用 AJAX，效率低且依赖浏览器访问。切换为系统 cron：

1
# 编辑 www-data 用户的 crontab
2
sudo -u www-data crontab -e

添加以下内容：

1
*/5 * * * * php -f /var/www/nextcloud/cron.php

设置 Nextcloud 使用 cron 模式：

1
sudo -u www-data php /var/www/nextcloud/occ background:cron

验证：

1
sudo -u www-data crontab -l

应显示 */5 * * * * php -f /var/www/nextcloud/cron.php

管理后台 → 基本设置 → 后台任务，应显示「Cron」而非「AJAX」

九、常见问题排查

问题	解决方法
页面 502 Bad Gateway	检查 PHP-FPM 是否运行：`sudo systemctl status php8.2-fpm`
页面 403 Forbidden	检查目录权限：`sudo chown -R www-data:www-data /var/www/nextcloud`
上传文件大小受限	修改 Nginx 中 `client_max_body_size` 和 PHP 中 `upload_max_filesize`、`post_max_size`
Redis 连接失败	检查 Redis 是否运行：`sudo systemctl status redis-server`，确认 socket 路径正确

1. 浏览器白屏

说明 Nginx 已成功响应请求，但 PHP 执行阶段发生了致命错误且未输出任何内容 (1) 检查 Nginx 和 PHP-FPM 错误日志

1
# 查看 Nginx 错误日志最后 50 行
2
sudo tail -50 /var/log/nginx/error.log
3

4
# 查看 PHP-FPM 错误日志最后 50 行
5
sudo tail -50 /var/log/php8.2-fpm.log
6

7
# 如果上面没有有用信息，查看 Nextcloud 自身日志
8
sudo tail -50 /var/www/nextcloud/data/nextcloud.log

(2) 确认文件所有权和权限

1
# 修复整个 Nextcloud 目录的所有权
2
sudo chown -R www-data:www-data /var/www/nextcloud/
3
# 确保 config 目录可写（安装过程需要写入 config.php）
4
sudo chmod 750 /var/www/nextcloud/config/
5
sudo chmod 750 /var/nextcloud-data/

2. 快速诊断命令汇总

1
echo "=== Nginx Error ===" && sudo tail -20 /var/log/nginx/error.log
2
echo "=== PHP-FPM Status ===" && sudo systemctl is-active php8.2-fpm
3
echo "=== Socket ===" && ls -la /run/php/php8.2-fpm.sock
4
echo "=== Config Dir ===" && ls -la /var/www/nextcloud/config/
5
echo "=== Data Dir ===" && ls -la /var/www/nextcloud/data/

至此， Nextcloud 手动部署已经完成，enjoy！

J i y ' s 数 字 花 園