虚拟机手工部署Nextcloud私有云盘：Ubuntu Server+LAMP

1. 部署方案选型：为什么我把 nextcloud 塞进了虚拟机

nextcloud 这套私有云盘我前后折腾过至少五种装法，从最早的树莓派裸机、到 Docker Compose、再到直接怼在一台旧笔记本的 Ubuntu 23.10 Server 版上。最后稳定留下来的方案，反而是看起来最"笨"的那个：一台虚拟机 + Ubuntu 23.10 Server + Apache/PHP/MariaDB 手工部署。这篇文章讲的就是这套方案的完整落地过程，从按下虚拟机"开机"那一刻，到浏览器里出现 nextcloud 的登录页，全程开箱即用，也不需要你有任何 Linux 基础。

先说说这套方案解决什么问题。nextcloud 本质是一个跑在你自己设备上的网盘服务，手机相册自动备份、电脑文件多端同步、在线文档协作，这些它都能干。但它对运行环境有要求：需要 Web 服务器、需要 PHP、需要数据库，这三样缺一个都起不来。直接装在物理机上，一旦配置搞乱了想重来，就得重装系统；而装在虚拟机里，快照一拍，怎么折腾都能一键回滚。这是我坚持用虚拟机的核心理由，也是新手最该优先考虑的一点。

适合谁看？完全没接触过 Linux 的小白、想给自己家和工作室搭个私有网盘的普通用户、以及那些被各种一键脚本坑过想搞明白底层到底发生了什么的折腾党。如果你追求的是"三分钟部署完"，Docker 方案确实更快；但如果你想知道 nextcloud 到底跑在什么之上、出问题该从哪一层排查，那手工部署这条路的收获会大得多。后面第三章我会把每条命令都拆开讲清楚为什么这么写。

1.1 三种主流部署方式的真实对比

很多人一上来就纠结"用哪个方式装"，其实把这三种方式摊开对比一下，答案就很清楚了。我把它们的关键差异整理成了一张表，你可以直接按自己的需求对号入座。

对比项	虚拟机手工部署	Docker 部署	物理机裸装
上手门槛	中等，需敲命令但有完整路径	低，一条 compose 命令	中等
环境隔离	完全隔离，崩溃不影响主机	进程级隔离，共享内核	无隔离
回滚难度	快照秒回，最省心	删容器重建	极难，基本靠重装
资源开销	额外占用 1~2GB 内存	开销小	无额外开销
排查难度	层次清晰，逐层排查	网络与卷映射容易绕晕	与主机配置耦合
迁移能力	导出 ovf 直接搬走	迁移镜像即可	换机器要重装
适合人群	想学原理的、要长期跑的	熟悉容器生态的	有闲置硬件的

虚拟机方案真正的价值在于边界清晰。Web 服务器挂了、数据库炸了、PHP 配置写错了，最坏情况也就是在虚拟机内部重来一遍，主机上的东西一根毛都不会掉。而 Docker 虽然轻，但它的网络模型（bridge、host、自定义网络）和卷映射对新手来说反而是个更陡的坎——我见过太多人卡在"容器里能看到文件、主机上找不到"这种问题上。至于裸机，除非你有一台完全闲置的机器可以专门干这件事，否则我不建议。

还有一个常被忽略的点：虚拟机的快照功能本身就是最好的学习工具。你想试试升级 PHP 版本、想改数据库字符集、想装个没见过的插件，拍个快照再动手，搞坏了直接回到拍快照那一刻，一分钟的事。这种"随便试错"的安全感，是推动你把一套服务真正学明白的关键。

1.2 为什么选 Server 版而不是 Desktop 版

Ubuntu 23.10 提供了桌面版和 Server 版两种镜像，nextcloud 部署必须选Server 版，这不是偏好问题，是刚需。

桌面版自带图形界面，安装包体积大约 4~5GB，装完之后系统里跑着一堆桌面相关的服务：显示管理器、输入法框架、通知中心、文件管理器索引进程。这些东西每一个都在吃内存和 CPU，而你的虚拟机资源本来就紧张。更麻烦的是，桌面版的图形界面在虚拟机里会持续消耗显存和 CPU 做渲染，一台 4GB 内存的虚拟机装完桌面版，可用内存可能只剩 2GB 出头，再跑 Apache、PHP、MariaDB，很容易在同步大文件的时候被 OOM Killer 干掉进程。

Server 版装完大概 1.5~2GB，跑起来常驻内存占用在 200MB 左右，剩下全是给服务的。另外 Server 版默认不装图形界面，所有的操作都通过命令行完成——这看起来是缺点，实际上是优点：因为你会发现，网上关于 nextcloud 的所有教程、报错信息、配置文件路径，全部都是基于命令行的，图形界面在这里帮不上任何忙。

提示：如果你实在不习惯纯命令行，可以装完 Server 版之后再补一个轻量的 Web 管理面板，但不要装完整桌面环境，这是两回事。

另外一个必须提前说清楚的事情：Ubuntu 23.10 是短期支持版本，不是 LTS。它的官方维护周期只有 9 个月，理论上到 2024 年 7 月就已经停止常规安全更新了。这意味着如果你是要长期跑的生产环境，我强烈建议换成 22.04 LTS 或者更新的 LTS 版本。但如果你只是想学习、想在内网搭个实验环境，23.10 完全够用，软件包版本还更新一些（自带的 PHP 是 8.2，MariaDB 是 10.11），兼容性上反而更省心。这个取舍你自己判断，我后面所有命令都是按 23.10 的包名写的，LTS 版本上包名基本一致，个别地方需要微调。

1.3 资源规划：内存、CPU、磁盘到底给多少

这一步决定你后面会不会因为资源不够而反复返工，值得花十分钟算清楚。先说结论，再给你推导过程。

资源项	最低可用	推荐配置	为什么
CPU	1 核	2 核	文件同步是 CPU 敏感型任务
内存	2 GB	4 GB	PHP + 数据库 + 系统缓存
系统盘	20 GB	40 GB	系统 + 程序 + 数据库
数据盘	按需	单独挂载 100GB+	数据与系统分离，方便迁移

内存这块我拆开算一下。Ubuntu Server 23.10 系统本身常驻约 200~300MB；Apache 用 mod_php 模式跑，每个 PHP 进程大概占 40~80MB，nextcloud 的请求并发一上来就是 5~10 个进程，算 500MB 左右；MariaDB 默认的 InnoDB 缓冲池是 128MB，加上各种线程开销算 400MB；再留 500MB 给文件系统缓存和系统突发占用。加起来大约是 1.7GB，所以 2GB 是"能跑起来但紧张"，4GB 是"跑得舒服"。

磁盘分两块来看。第一块是系统盘，Ubuntu Server 装完加常用工具大概占 6~8GB，PHP 相关扩展再加 200MB，Nextcloud 程序本体解压后约 500MB。给 40GB 是留出后续升级和日志增长的空间，没必要省。第二块是数据盘，这才是真正需要计算的地方。按每个用户分配 50GB 配额来算，5 个用户就是 250GB，10 个用户就是 500GB。

数据盘我给的建议是：系统盘和数据盘分开。虚拟机里挂两块虚拟磁盘，系统装在 40GB 那块上，nextcloud 的数据目录（默认就叫 data）单独挂到另一块盘上。这样做的好处是，将来想迁移数据、想扩容、想做快照，都可以只针对数据盘操作，系统盘随便折腾。如果虚拟机软件支持精简置备（Thin Provision），数据盘实际占用只按写入量增长，虚报 500GB 是完全安全的。

注意：千万不要用软链接把数据目录指向一个通过网络共享挂载的路径。nextcloud 对数据目录的文件锁有严格要求，放在网络共享上会出现"文件锁定失败"的诡异报错，而且很难排查。

2. 虚拟机创建与 Ubuntu 23.10 Server 安装实操

环境准备好了就开始动手。这一章我会把虚拟机创建的每一个关键参数都讲清楚它是干什么的，因为很多人在这一步随手点"下一步"，后面遇到网络不通、磁盘不够用的时候，又完全不知道问题出在哪。

2.1 虚拟机软件选择与安装要点

主流的虚拟机软件就那么几款，桌面端用 VMware Workstation 或者 VirtualBox，Windows 11 上还可以用自带的 Hyper-V。这三款都能完成任务，差异主要在细节体验上。

VMware Workstation 的优点是网络配置界面直观、快照管理好用、USB 设备直通稳定，缺点是个人使用需要留意授权条款。VirtualBox 完全免费开源，功能也够用，但网络配置相对绕一点，桥接模式有时候需要额外装扩展包。Hyper-V 是系统自带的，性能不错，但它和 VirtualBox 之类的软件存在底层冲突，同一台机器上一般只能启用一个。

我的建议是：手上有什么就用什么，不要把时间浪费在换软件上。如果你之前装过 VMware 的虚拟机但打不开配置界面（比如菜单里没有"设置"选项），一般是虚拟机处于运行或挂起状态，先关机再进设置就好；如果是在 Windows 上安装后提示需要管理员权限，右键用管理员身份运行一次即可，之后正常启动。

安装完虚拟机软件后，先做两件事：一是确认 CPU 虚拟化支持已经在 BIOS 里打开（Intel VT-x 或 AMD-V），二是确认宿主机有至少 8GB 内存，否则你自己用起来会卡。至于虚拟机文件存放位置，别放系统盘，找一个空间充裕的分区，因为后面虚拟机会越滚越大。

2.2 新建虚拟机的关键参数怎么填

新建虚拟机的向导里，这几个参数是关键，其他的一路默认即可。

CPU 分配 2 核。1 核也能跑，但 nextcloud 在生成图片预览、扫描文件、计算文件校验和的时候会明显感到卡顿。宿主机如果是 4 核以上，给 2 核是安全的，不要把所有核心都分配出去。

内存 4096MB。如果你宿主机只有 8GB 内存，那就给 2048MB，同时后续在系统里配置 2GB 的 swap 分区来补足。我下面给的所有命令在 2GB 内存下也能跑通。

磁盘 40GB，选择"拆分成多个文件"。这个选项是让虚拟磁盘随使用量增长，而不是一创建就占满 40GB 物理空间。对于 SSD 宿主机来说，这个选项几乎没有性能损失，但能省下大量空间。

网络适配器，先选 NAT。原因后面 2.4 节会详细讲，简单说就是 NAT 模式下虚拟机一定能上网，装系统时需要联网下载一些东西，这是最稳的起步配置。

固件类型选 UEFI（如果向导里有这个选项），不要选 BIOS。UEFI 启动更快，而且现在的系统镜像基本都是按 UEFI 优化的。如果虚拟机启动后卡在 "boot" 提示界面，九成是固件类型和镜像不匹配——把镜像重新挂载一次，或者切换固件类型再试。

不要勾选"启动时连接软盘"之类的选项，这些老古董留着只会让启动顺序变复杂。启动顺序里把光驱/CD-ROM 排到硬盘前面，装完系统后可以不管它，UEFI 会自动跳过空光驱。

创建完成后，先在虚拟机设置里把安装镜像（Ubuntu 23.10 Server 的 ISO 文件）挂到虚拟光驱上。Ubuntu 官方下载页面提供的是 Live Server 镜像，文件名类似ubuntu-23.10-live-server-amd64.iso，大小约 2GB。下载完记得校验一下哈希值，镜像损坏会导致安装过程随机出错，那种问题排查起来非常浪费时间。

2.3 网络模式的选择：NAT 还是桥接

这是新手最容易困惑的一个点，我用最直白的方式解释。

NAT 模式：虚拟机会被分配一个私有网段的地址（VMware 默认是 VMnet8 网段，形如 192.168.x.x）。虚拟机能访问外网，但局域网里的其他设备看不见它。宿主机可以直接访问虚拟机的网站，因为宿主机本身就是这个虚拟网络的网关。如果你只是想让宿主机自己访问 nextcloud，NAT 完全够用。

桥接模式：虚拟机会像一台独立设备一样接入你家路由器，分到一个和宿主机同网段的地址。这时候手机、平板、家里的其他电脑都能直接访问虚拟机的 IP，适合"全家人都要用"的场景。

我的实操建议是：先装系统用 NAT，装完之后再切桥接（或者反过来也行，只要记得切换后虚拟机的 IP 会变）。因为如果你一上来就用桥接，路由器分配的 IP 可能是动态的，下次重启虚拟机地址就变了，你会莫名其妙发现"网站打不开了"。所以无论用哪种模式，后面第三章我都会让你配置静态 IP，这是必须做的一步。

还有一种情况值得提一下：如果你用的是 NAT 模式，但想让宿主机之外的设备访问，需要在虚拟机软件里配置端口转发，把宿主机的 80 端口映射到虚拟机的 80 端口。不过这只是临时方案，长期跑还是桥接 + 静态 IP 更省心。

提示：如果你在虚拟机的网络适配器列表里看到 VMnet1 带黄色感叹号，那是该虚拟网卡没有正确安装或被禁用，通常重装一次虚拟网卡或者重启宿主机的虚拟网络服务即可。这个报错和你要部署的 nextcloud 没有直接关系，但如果虚拟网卡彻底失效，NAT 模式下的虚拟机就上不了网。

2.4 Ubuntu 23.10 Server 安装过程的每一步

镜像挂好，开机。下面按安装向导的顺序说，每一步只讲需要注意的地方。

启动引导：出现 GRUB 菜单时选 "Try or Install Ubuntu Server"，直接回车。如果屏幕卡住超过两分钟没反应，多半是 ISO 没挂对，关机检查虚拟光驱设置。

语言选择：选 English。不要选中文，因为 Server 版的中文语言包在部分终端环境下会出现乱码，而且所有报错信息在网上检索时都是英文的，选英文能让你搜索效率提升一个量级。系统装完后可以单独配置时区和中文输入支持，不影响使用。

键盘布局：默认 English (US) 就行。

安装类型：选 "Ubuntu Server"，不要选 "Ubuntu Server (minimized)"。精简版会省掉一些你后面要用的工具包，反而要手动补装。

网络配置：向导会自动通过 DHCP 拿到一个地址。这一步先接受，装完系统后我们再去配置文件里改成静态 IP。如果这里显示"网络未连接"，检查虚拟机的网络适配器是否勾选了"已连接"，以及是不是选了"仅主机模式"。

代理配置：留空，直接继续。

镜像源地址：默认的官方源在国内访问可能较慢。如果你的宿主机网络环境正常，直接用默认；如果下载很慢，可以在这一步填一个就近的镜像源地址，格式是完整的 URL。这一步填错了会导致安装非常慢，但不会失败，装完之后还能改。

磁盘分区：这是最关键的一步。选择 "Custom storage layout"，然后手动创建分区。我的建议方案是：

挂载点	大小	文件系统	说明
/boot/efi	512 MB	fat32	UEFI 必需
/	剩余全部	ext4	系统与程序
swap	2 GB	swap	内存不足时的缓冲

因为这一章我们只在系统盘上装系统，数据盘可以在系统装好后再挂载。如果你已经一次性挂了两块虚拟磁盘，可以在这一步顺便把第二块盘也划分好，挂载点写/var/ncdata，不过这个目录必须先创建出来。

用户信息：用户名建议用简单的英文，比如ncadmin。密码设复杂一点，因为这台机器后面会暴露在局域网里。这个用户会自动拥有 sudo 权限。

SSH 服务：勾选 "Install OpenSSH server"。这样以后你可以用宿主机的终端软件直接连进去操作，不用在虚拟机窗口里敲命令，效率高很多。

软件包选择：向导最后会问你要不要预装一些软件（比如 docker、各种服务），全部不选，直接继续。我们要自己一步步装，这样出问题才知道是哪个环节。

安装过程大约 5~10 分钟。结束后提示重启，记得先把虚拟光驱里的 ISO 卸载或者断开，否则可能又从光盘启动一遍。重启后用刚才设的账号登录，看到命令提示符，系统部分就完成了。

3. Nextcloud 服务端部署全流程

这一章是核心。我们按"系统初始化 → 装环境 → 建数据库 → 放程序 → 配 Web 服务器 → 浏览器初始化 → 命令行加固"的顺序推进，每一步都会说明它在干嘛。

3.1 系统初始化：更新、时区、主机名、静态 IP

登录后第一件事是更新系统并装几个基础工具：

sudo apt update && sudo apt full-upgrade -y sudo apt install -y curl wget unzip vim net-tools

接着设置时区和主机名。时区错了会导致日历、日志时间全乱：

sudo timedatectl set-timezone Asia/Shanghai sudo hostnamectl set-hostname cloud

然后配置静态 IP。Ubuntu Server 用 netplan 管理网络，配置文件一般在/etc/netplan/下，文件名类似00-installer-config.yaml。用ip a先看清你的网卡名（常见的是ens33、ens160、enp0s3），然后编辑：

network: version: 2 ethernets: ens33: dhcp4: false addresses: - 192.168.1.50/24 routes: - to: default via: 192.168.1.1 nameservers: addresses: [192.168.1.1, 223.5.5.5]

这里192.168.1.50是你想给虚拟机固定的地址，/24表示子网掩码 255.255.255.0，via 192.168.1.1是网关（也就是你家路由器的地址）。网关地址一定要填对，填错了虚拟机就上不了网。改完后执行：

sudo netplan apply ip a

确认地址已经生效。另外要提醒一句，这个静态地址要选在路由器的 DHCP 分配范围之外，否则可能出现地址冲突（比如路由器给别的设备也分了 .50）。如果你不确定 DHCP 范围，选一个偏大的数字，比如 .200 之后的。

注意：netplan 的 YAML 文件对缩进极其敏感，必须用空格不能用 Tab。改错了执行netplan apply会直接报错并提示行号，照着改就行。

3.2 LAMP 栈安装：Apache、PHP 8.2 与 MariaDB

Nextcloud 官方推荐的是 Apache + PHP + 数据库（MySQL/MariaDB/PostgreSQL 三选一）的组合。数据库这块，很多人第一反应会想到 Microsoft SQL Server 那套，但 nextcloud 对它的支持并不完整，官方主推的是 MariaDB 或者 PostgreSQL。MariaDB 在 Ubuntu 23.10 的仓库里是 10.11 版本，跟 nextcloud 的兼容性经过大量验证，我们用这个。

一条命令把需要的包全装上：

sudo apt install -y apache2 mariadb-server \ libapache2-mod-php php-gd php-mysql php-curl php-mbstring \ php-intl php-gmp php-bcmath php-xml php-imagick php-zip \ php-apcu php-redis imagemagick

这里面每个 PHP 扩展都有它的用处，我把关键的几个列出来，这样你以后看到 "PHP module xxx is missing" 的提示就知道该装哪个：

扩展	作用	缺了会怎样
php-gd	图片缩略图处理	相册不显示预览图
php-intl	国际化与本地化	页面语言混乱
php-gmp	大数运算	部分加密功能异常
php-bcmath	精确数学运算	配额计算可能出错
php-imagick	高级图像处理	无法生成视频缩略图、图片预览变差
php-xml	XML 解析	安装向导直接报错
php-mbstring	多字节字符处理	中文文件名乱码
php-zip	压缩包处理	无法下载文件夹为 zip

现实验证下来，php-imagick和php-intl这两个是最容易被忽略但又最影响体验的，一定要装。装完之后重启 Apache 让 PHP 模块生效：

sudo systemctl restart apache2 sudo systemctl enable apache2

3.3 数据库规划与建库建号

MariaDB 装好后，在 Ubuntu 上 root 用户默认走 unix_socket 认证，也就是说你只要用 sudo 就能直接进数据库，不需要密码：

sudo mysql

进去之后创建数据库和专用账号。这里有个细节，字符集必须用 utf8mb4，而且排序规则要用 general_ci 或者 unicode_ci，否则中文文件名、emoji 表情都会出问题：

CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'ncuser'@'localhost' IDENTIFIED BY '换成你的强密码'; GRANT ALL PRIVILEGES ON nextcloud.* TO 'ncuser'@'localhost'; FLUSH PRIVILEGES; EXIT;

有几个点要注意。第一，不要把数据库账号设成 root，也不要用 root 去连 nextcloud，权限太大反而危险，而且 MariaDB 的 root 走 socket 认证模式，PHP 用 TCP 连是连不上的，很多人卡在这一步就是因为填了 root 账号。第二，密码里别用特殊符号中的引号类字符，容易在配置文件转义时出问题。第三，localhost不能改成127.0.0.1之外的其他地址，除非你的数据库在另一台机器上。

创建完之后立刻验证一下能不能连：

mysql -u ncuser -p -h localhost nextcloud -e "SELECT 1;"

能返回结果就说明账号没问题，可以进入下一步。

3.4 下载 Nextcloud、目录规划与权限设置

目录规划我建议这样：

路径	用途
/var/www/nextcloud	程序本体
/var/ncdata	用户数据与配置数据

把数据目录放在 Web 根目录外面是个重要的安全习惯，这样即使 Web 服务器被配置错误暴露了目录列表，数据文件也不会被直接下载。

下载并解压：

cd /tmp wget https://download.nextcloud.com/server/releases/latest.zip unzip latest.zip sudo mv nextcloud /var/www/

创建数据目录并设置权限：

sudo mkdir -p /var/ncdata sudo chown -R www-data:www-data /var/www/nextcloud sudo chown -R www-data:www-data /var/ncdata sudo chmod -R 755 /var/www/nextcloud sudo chmod -R 750 /var/ncdata

这里解释一下为什么是 www-data。Apache 在 Ubuntu 下默认以www-data用户运行，它必须有权限去读写这些目录。755 表示"所有者可读写执行，其他人可读可执行"，750 表示"其他人完全没权限"，数据目录用更严格的权限。

注意：每次执行 occ 命令时都必须用sudo -u www-data php occ，因为 occ 会在数据目录下写文件。如果你直接用 root 跑，会生成一批 root 属主的文件，然后 Web 页面就会报"无法写入 config 目录"，而且这个错误很难从表面看出来原因。

3.5 Apache 虚拟主机配置与 PHP 参数调优

先启用需要的 Apache 模块：

sudo a2enmod rewrite headers env dir mime ssl sudo systemctl restart apache2

新建配置文件/etc/apache2/sites-available/nextcloud.conf：

<VirtualHost *:80> ServerName cloud.lab.local DocumentRoot /var/www/nextcloud <Directory /var/www/nextcloud/> Require all granted AllowOverride All Options FollowSymLinks MultiViews </Directory> ErrorLog ${APACHE_LOG_DIR}/nextcloud_error.log CustomLog ${APACHE_LOG_DIR}/nextcloud_access.log combined </VirtualHost>

AllowOverride All这一行是关键，nextcloud 自带.htaccess文件来做 URL 重写和安全防护，如果这里是AllowOverride None，页面会直接报 500 错误。启用站点并禁用默认站点：

sudo a2ensite nextcloud.conf sudo a2dissite 000-default.conf sudo systemctl reload apache2

接着调 PHP。编辑/etc/php/8.2/apache2/php.ini，找到并修改这几项：

memory_limit = 512M upload_max_filesize = 16G post_max_size = 16G max_execution_time = 3600 max_input_time = 3600 output_buffering = 0 date.timezone = Asia/Shanghai

这里的数值不是随便填的。upload_max_filesize和post_max_size必须配套，一般post_max_size要略大于等于upload_max_filesize，因为上传时除了文件本身还有表单数据。memory_limit设 512M 就够了，因为 nextcloud 用的是分块上传，不会把整个 16GB 文件读进内存——这是很多人误解的地方，以为要传大文件就得设一个巨大的 memory_limit，其实设置过大反而容易把服务器拖垮。

再单独建一个 opcache 配置文件/etc/php/8.2/apache2/conf.d/99-nextcloud-opcache.ini：

opcache.enable=1 opcache.enable_cli=1 opcache.memory_consumption=256 opcache.interned_strings_buffer=32 opcache.max_accelerated_files=10000 opcache.save_comments=1 opcache.revalidate_freq=60

opcache.save_comments=1必须开，nextcloud 的很多功能依赖代码注释里的注解信息，关掉之后会出现一些非常隐蔽的报错。改完重启：

sudo systemctl restart apache2

3.6 浏览器完成初始化向导

到这一步，打开宿主机浏览器访问http://192.168.1.50（换成你设的静态 IP），应该能看到 nextcloud 的安装向导了。如果打不开，先跳到第五章排查。

向导里填这些：

• 管理员账号：用户名和密码自己定，密码要强。这个账号是超级管理员，别用 admin 这种容易被猜到的名字。
• 数据目录：改成/var/ncdata，不要用默认的/var/www/nextcloud/data。
• 数据库：类型选 MySQL/MariaDB，地址填localhost，数据库名nextcloud，用户ncuser，密码填刚才设的，表前缀保持默认的oc_。

点安装，等一两分钟。安装过程会创建几十张表，如果卡在这一步超过三分钟，多半是数据库连接有问题，去/var/log/apache2/nextcloud_error.log看具体报错。

安装完成后会跳转到登录页。这时候先别急着传文件，还有几项必须的配置要做。

3.7 occ 命令行收尾与安全加固

occ是 nextcloud 的命令行管理工具，位于程序根目录下。先进入维护模式：

cd /var/www/nextcloud sudo -u www-data php occ maintenance:mode --on

添加信任域名。默认配置只信任localhost，用 IP 访问会提示 "Access through untrusted domain"：

sudo -u www-data php occ config:system:set trusted_domains 1 --value=192.168.1.50

如果你还打算用域名访问，继续加2、3这样的序号。序号 0 是 localhost，不要覆盖它。

设置默认电话区域和强制 HTTPS 前的准备：

sudo -u www-data php occ config:system:set default_phone_region --value="CN" sudo -u www-data php occ config:system:set overwrite.cli.url --value="http://192.168.1.50/"

顺手加上 APCu 缓存和几个后台任务配置：

sudo -u www-data php occ config:system:set memcache.local --value="\OC\Memcache\APCu" sudo -u www-data php occ config:system:set filelocking.enabled --value=true sudo -u www-data php occ background:cron

最后一步是配置系统 cron 来跑后台任务。nextcloud 默认用 AJAX 方式触发后台任务，用户不打开页面就不干活，缩略图、文件扫描都会滞后。改用系统 cron 更靠谱：

sudo crontab -u www-data -e

加入这一行（每 5 分钟执行一次）：

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

退出维护模式：

sudo -u www-data php occ maintenance:mode --off sudo -u www-data php occ maintenance:repair

maintenance:repair会修复一些数据库结构和文件缓存的问题，装完跑一次是个好习惯。

4. 让主机和局域网设备访问这台虚拟机

服务跑起来了，但如果只有宿主机的浏览器能打开，那这个私有云盘的价值就丢了一大半。这一章解决访问问题，顺便把 HTTPS 补上。

4.1 三种网络模式下的访问路径

分情况说。

NAT 模式：宿主机可以直接访问虚拟机的 IP，但局域网里其他设备不行。VMware 的 NAT 网络默认是 VMnet8 段，你的虚拟机 IP 就在这个网段里。如果想让手机也能访问，需要在虚拟机的网络设置里添加一条端口转发规则，把宿主机的 8080 端口映射到虚拟机的 80 端口，然后手机访问http://宿主机IP:8080。这个方案能用，但每次宿主机 IP 变了都要改，不太适合长期。

桥接模式：虚拟机拿到和宿主机同网段的地址，家里所有设备都能直接访问。这是我最推荐的方案。切换方法是：先关掉虚拟机，在虚拟机设置里把网络适配器从 NAT 改成桥接（桥接到宿主机实际联网的那块网卡，不要桥接到虚拟网卡），开机后重新配置 netplan 里的静态 IP，注意要换成新网段的地址。

仅主机模式：虚拟机和宿主机组成一个独立网络，只能互相访问，完全不能上外网。适合纯实验，不推荐日常使用。

切换网络模式后，记得回头修改trusted_domains，把新的 IP 加进去，否则又会报 untrusted domain。

4.2 自签名证书与强制 HTTPS

内网环境用 HTTP 其实问题不大，但 nextcloud 的客户端（尤其是手机 App）对 HTTPS 有要求，很多功能在没有加密的情况下会被限制。内网没有公网域名，申请正式证书不现实，用自签名证书是最实际的方案。

生成证书：

sudo openssl req -x509 -nodes -days 825 -newkey rsa:2048 \ -keyout /etc/ssl/private/nextcloud.key \ -out /etc/ssl/certs/nextcloud.crt \ -subj "/C=CN/ST=Local/L=Local/O=HomeLab/CN=192.168.1.50"

这里把CN设置成 IP 地址，因为浏览器访问时用的就是 IP。825 天这个数值是苹果系设备对证书有效期的上限，超过之后 iOS 客户端会拒绝连接。

再建一个 HTTPS 的虚拟主机配置/etc/apache2/sites-available/nextcloud-ssl.conf：

<VirtualHost *:443> ServerName 192.168.1.50 DocumentRoot /var/www/nextcloud SSLEngine on SSLCertificateFile /etc/ssl/certs/nextcloud.crt SSLCertificateKeyFile /etc/ssl/private/nextcloud.key <Directory /var/www/nextcloud/> Require all granted AllowOverride All Options FollowSymLinks MultiViews </Directory> Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains" ErrorLog ${APACHE_LOG_DIR}/nextcloud_ssl_error.log CustomLog ${APACHE_LOG_DIR}/nextcloud_ssl_access.log combined </VirtualHost>

启用并重载：

sudo a2ensite nextcloud-ssl.conf sudo systemctl reload apache2

然后在 nextcloud 里告诉它自己跑在 HTTPS 后面：

sudo -u www-data php occ config:system:set overwriteprotocol --value=https

浏览器访问https://192.168.1.50，会提示证书不受信任，这是自签名证书的正常现象，点"高级 → 继续访问"即可。手机客户端连接时也会提示，选择信任就行。

注意：如果你后面把 IP 改了，证书里的 CN 就对不上了，需要重新生成一次证书。这是自签名方案的最大不便之处，如果介意，可以考虑用内网的 DNS 给自己解析一个固定域名再签证书。

4.3 桌面端和手机端首次连接

浏览器登录成功后，建议先装桌面客户端。在客户端里填服务器地址https://192.168.1.50，然后会跳到浏览器做一次授权登录，授权完成后客户端就接管了。桌面客户端的核心价值是选择性同步和虚拟文件功能，前者让你只同步指定子文件夹，后者让你在本地只看到文件名、点开才下载，对硬盘小的机器特别友好。

手机端同理，装完填服务器地址，授权登录，然后打开相册自动备份。这里有个实操经验：第一次自动备份千万不要一次性全开，如果你的相册里有几万张照片，服务器会被瞬间打满，PHP 进程数和数据库连接数都会爆。建议先设置只备份最近一个月的照片，观察服务器负载，稳定之后再逐步放开。

5. 踩坑实录与常见问题速查

前面几章都是"顺利路径"，但实际部署中一定会遇到问题。这一章把我踩过的坑整理出来，你遇到报错的时候可以直接对照。

5.1 安装阶段最常翻车的四个点

第一个坑：Apache 起来了但页面 500。九成是.htaccess没生效，检查虚拟主机配置里的AllowOverride All有没有写，以及rewrite模块有没有启用（sudo a2enmod rewrite）。极少数情况是 SELinux/AppArmor 拦截，Ubuntu 默认不启用 SELinux，可以忽略。

第二个坑：安装向导卡在数据库那一步。最常见的原因是数据库用户填了root。MariaDB 的 root 走 socket 认证，PHP 通过 TCP 连不上。换成我们创建的ncuser就好。其次是数据库主机名填了127.0.0.1之外的地址，或者密码里带了引号类字符。

第三个坑：装完之后提示"无法写入 config 目录"。这是权限问题，而且往往是你之前用 root 跑过一遍 occ 命令导致的。解决办法是统一改回 www-data：

sudo chown -R www-data:www-data /var/www/nextcloud sudo chown -R www-data:www-data /var/ncdata

第四个坑：上传大文件失败，进度条到某个百分比就断。检查三处：php.ini里的upload_max_filesize和post_max_size、Apache 的反向代理设置（如果你用了）、以及虚拟机的磁盘空间。还有一个隐蔽原因是/tmp分区太小，PHP 上传时会先写到临时目录，如果临时目录装不下分块，就会失败。

5.2 运行阶段报错速查表

现象	最可能的原因	处理方向
提示访问不受信任的域名	trusted_domains 未加当前 IP	occ 添加对应序号
页面样式全乱、按钮无反应	静态资源没加载，URL 重写失效	检查 rewrite 模块与 AllowOverride
手机客户端连不上	无 HTTPS 或证书被拒	配置自签名证书并信任
后台任务一直显示"上次运行 X 小时前"	仍在使用 AJAX 模式	配置系统 cron 并切换模式
缩略图不显示	缺 php-imagick 或 imagemagick	补装并重启 Apache
中文文件名乱码	数据库字符集不是 utf8mb4	重建数据库，指定字符集与排序规则
系统时间显示异常	时区未设置	timedatectl 设置并重启 PHP
上传速度慢、CPU 打满	图片预览生成占用资源	限制预览尺寸或关闭视频预览
磁盘空间莫名其妙满了	日志或版本文件堆积	检查 /var/log 与 data 下的临时目录
页面打开空白	PHP 内存不足或 opcache 异常	查 error log，重启 Apache

这张表覆盖了八成以上的日常问题。遇到没见过的报错，第一步永远是去看/var/log/apache2/nextcloud_error.log和/var/log/mysql/error.log，nextcloud 自己的日志在/var/ncdata/nextcloud.log。这三个文件看下来，基本没有查不出的问题。

5.3 快照、备份与后续升级的取舍

部署完成之后，第一件事是给虚拟机拍快照。这时候是一个干净的、可用的基线状态，后面不管怎么折腾，都能退回这里。我给这台虚拟机的快照命名习惯是带上日期和状态描述，比如2024-05-10-clean-install，这样一眼就知道退回的是哪个阶段。

日常备份分两层。系统层用虚拟机快照，每周或者每次做重大变更之前拍一次，快照不要超过三天的使用周期，因为它会占用磁盘空间，而且长期保留大量快照会拖慢虚拟机性能。数据层用 nextcloud 自带的方式：occ里有导出配置的命令，数据目录直接复制就行。如果数据量大，用rsync做增量同步到另一块盘或者 NAS 上是更实际的方案。

备份的时候要特别注意三样东西必须一起备份，缺一个都恢复不了：数据目录（含 config）、数据库导出、以及occ的当前版本号。数据库可以用mysqldump导出：

mysqldump -u ncuser -p --single-transaction --routines --triggers nextcloud > nextcloud-db-$(date +%F).sql

--single-transaction保证导出期间不会锁表，服务可以继续运行。

升级这件事我要泼一盆冷水：nextcloud 的跨大版本升级必须逐级进行，不能跳版本。比如你现在装的是 27，想升到 29，必须 27 → 28 → 29 这样走，而且每个大版本的最后一个小版本才允许升级到下一个大版本。升级过程中数据目录一旦损坏，恢复成本极高。所以我的实操原则是：能不动就不动，要升级先拍快照，升级前做好数据库和数据的完整备份。

至于occ upgrade之外的那些"一键升级脚本"，我建议谨慎使用。它们大多会跳过版本检查直接替换文件，短期看着方便，长期容易留下数据库结构和代码不匹配的隐患，而这种问题往往在几个月后才以奇怪的方式暴露出来。

我个人在这套环境上跑了挺长时间，最大的体会是：把最初始的安装过程完整走一遍，比事后看一百篇排查文章都管用。因为当你亲手敲过每一条命令、见过每一个配置文件在什么地方，后面遇到任何报错，你脑子里都能大致定位到是哪一层出了问题——是网络、是 Web 服务器、是 PHP 还是数据库。这种"层次感"才是手工部署虚拟机方案最有价值的部分，也是我到现在还不用一键脚本的原因。