必须用原生arm64镜像+明确卷映射+UID 33权限控制搭建Nextcloud；创建~/nextcloud/{config,data,apps2}目录并sudo chown -R 33:33，运行docker容器后访问http://localhost:8080完成SQLite安装，再通过官方macOS客户端同步~/Sync/Nextcloud文件夹，经五步验证确认双向实时同步生效。
要在Mac家庭内网中搭建私有Nextcloud云盘，并实现与Mac本地文件夹的无缝双向同步，必须绕过“all-in-one”单容器陷阱，用原生arm64镜像+明确卷映射+正确UID权限控制，否则安装页面卡在“无法写入config目录”就再也进不去。
准备宿主机环境与数据目录
打开终端，执行以下命令创建Nextcloud专用目录结构：
mkdir -p ~/nextcloud/{config,data,apps2}
这一步不能跳过，也不能用其他路径（如/Desktop或/Downloads），因为Nextcloud容器默认只信任/var/www/html下的子路径；若映射到临时目录，后续升级或重启后配置可能丢失。
【必须执行】运行：
sudo chown -R 33:33 ~/nextcloud
不执行这句，容器内www-data用户（UID 33）将无权写入config和data目录，Web安装向导直接报错退出，且错误提示极其模糊，容易误判为端口或网络问题。
拉取并运行Nextcloud容器（arm64原生）
在M1/M2 Mac上，直接执行：
docker run -d \
--name nextcloud \
-p 8080:80 \
--user 33:33 \
-v ~/nextcloud/config:/var/www/html/config \
-v ~/nextcloud/data:/var/www/html/data \
-v ~/nextcloud/apps2:/var/www/html/custom_apps \
-e TZ=Asia/Shanghai \
--restart unless-stopped \
nextcloud:latest
注意：不要加--platform参数——官方镜像已自动适配arm64，显式指定linux/amd64反而导致容器启动失败，报“exec format error”。
等待约20秒，访问 http://localhost:8080 ，看到Nextcloud安装页面即表示容器运行成功。
完成Web安装并获取管理员凭证
第一步：在“设置管理员账户”区域输入你想要的用户名和强密码；
第二步：向下滚动，找到“数据库配置”，选择“SQLite (不推荐用于生产)”即可——家用内网场景无需额外部署MariaDB，SQLite足够稳定且零运维；
第三步：点击“安装完成”，页面跳转至登录页；
第四步：用刚设的账号登录，进入主界面。
此时不要急着装插件或改设置，先确认右上角头像→“设置”→“管理”→“常规”里，“站点URL”显示为http://localhost:8080，说明服务地址识别正确。若显示172.x.x.x等Docker内部IP，说明容器网络配置异常，需删掉容器重跑。
安装macOS客户端并绑定同步文件夹
方法一：官网下载原生客户端
访问 https://nextcloud.com/install/#install-clients → 点击“macOS”图标下载.dmg，双击安装Nextcloud Desktop Client。
方法二：用Homebrew（适合命令行偏好者）
brew install --cask nextcloud
安装完成后启动应用，在首次向导中填入：
Server address: http://localhost:8080
Username / Password: 你刚才在Web安装时设定的管理员凭据
勾选“记住密码”，点击“连接”。
下一步选择同步文件夹——强烈建议选一个空的新目录，例如 ~/Sync/Nextcloud，不要选已有大量文件的Documents或Desktop，否则首次同步会触发数千次文件扫描，卡住Finder达数分钟。
最后一步：点击“连接”后，客户端会在后台静默同步config和data目录里的初始结构，状态栏图标变为蓝色对勾即表示双向通道已建立。
验证双向同步是否真正生效
① 在Mac桌面新建一个文本文件 test-sync.txt，把它拖进 ~/Sync/Nextcloud 文件夹；
② 等待10秒，打开浏览器访问 http://localhost:8080 → 登录 → 进入“文件”页，确认 test-sync.txt 已出现；
③ 在网页端右键该文件 → “重命名”为 test-sync-OK.txt；
④ 切回Mac本地 ~/Sync/Nextcloud 文件夹，等待5秒，文件名自动更新为 test-sync-OK.txt；
⑤ 在本地删除该文件，网页端回收站立即出现它——说明删除操作已反向同步。
这五步全部通过，代表双向同步链路闭环成立。此时可放心把工作文档、照片库、笔记附件等放入该文件夹，所有修改实时穿透到Nextcloud服务端，也实时反射回本地。
