# Ubuntu / Debian
sudo add-apt-repository ppa:nextcloud-devs/client -y
sudo apt update
sudo apt install -y nextcloud-client

# Fedora
sudo dnf install -y nextcloud-client

# Arch Linux
sudo pacman -S nextcloud-client

# macOS (Homebrew)
brew install --cask nextcloud

┌──────────────────────────────────────────────────┐
│              Nextcloud 桌面客户端                  │
│                                                  │
│  服务器地址: https://cloud.example.com            │
│                                                  │
│  [ 登录 ]                                        │
│                                                  │
│  或者使用应用密码登录                               │
└──────────────────────────────────────────────────┘

~/Nextcloud/
├── Documents/                    ← 实际同步
│   ├── report.pdf               ← 实体文件
│   └── notes.md                 ← 实体文件
├── Photos/                      ← 虚拟文件
│   ├── vacation.jpg.nextcloud   ← 占位符（几 KB）
│   └── sunset.jpg.nextcloud     ← 占位符
└── Videos/                      ← 未同步
    └── (不在本地显示)

# 安装命令行客户端
sudo apt install -y nextcloud-desktop-cmd

# 添加账户
nextcloudcmd --path / \
  /home/user/Nextcloud \
  https://cloud.example.com \
  admin password

# 仅同步特定目录
nextcloudcmd --path /Documents \
  /home/user/Nextcloud/Documents \
  https://cloud.example.com \
  admin password

Google Play Store: 搜索 "Nextcloud"
F-Droid: https://f-droid.org/packages/com.nextcloud.client/
APK 直接下载: https://github.com/nextcloud/android/releases

设置 → 自动上传

照片上传:
├── 源目录: DCIM/Camera
├── 远程目录: /Photos/Phone
├── 仅 WiFi: ✅
├── 充电时上传: ❌（可选）
└── 上传后删除: ❌

核心功能:
├── 文件管理
├── 照片自动备份（后台上传需要开启后台刷新）
├── Face ID / Touch ID 解锁
├── Files App 集成
└── Shortcuts 快捷指令支持

WebDAV URL: https://cloud.example.com/remote.php/dav/files/username/

# 安装
sudo apt install -y davfs2

# 创建挂载点
sudo mkdir -p /mnt/nextcloud

# 挂载
sudo mount -t davfs https://cloud.example.com/remote.php/dav/files/admin/ /mnt/nextcloud

# 持久化挂载（/etc/fstab）
echo "https://cloud.example.com/remote.php/dav/files/admin/ /mnt/nextcloud davfs user,noauto 0 0" | sudo tee -a /etc/fstab

# 配置凭据（~/.davfs2/secrets）
echo "/mnt/nextcloud admin your-password" >> ~/.davfs2/secrets
chmod 600 ~/.davfs2/secrets

Finder → 前往 → 连接服务器
服务器地址: https://cloud.example.com/remote.php/dav/files/admin/
用户名: admin
密码: your-password

此电脑 → 映射网络驱动器
文件夹: https://cloud.example.com/remote.php/dav/files/admin/
勾选 "使用其他凭据连接"

# 安装 rclone
curl https://rclone.org/install.sh | sudo bash

# 配置
rclone config
# 选择 WebDAV，输入服务器地址和凭据

# 使用
rclone ls nextcloud:
rclone copy /local/file.txt nextcloud:Documents/
rclone sync /local/backup/ nextcloud:Backup/

# 列出文件
curl -s -u admin:password \
  -X PROPFIND \
  "https://cloud.example.com/remote.php/dav/files/admin/" \
  -H "Depth: 1" | xmllint --format -

# 上传文件
curl -s -u admin:password \
  -X PUT \
  "https://cloud.example.com/remote.php/dav/files/admin/test.txt" \
  --data-binary @local-file.txt

# 下载文件
curl -s -u admin:password \
  -X GET \
  "https://cloud.example.com/remote.php/dav/files/admin/test.txt" \
  -o downloaded-file.txt

# 创建目录
curl -s -u admin:password \
  -X MKCOL \
  "https://cloud.example.com/remote.php/dav/files/admin/NewFolder/"

# 删除文件
curl -s -u admin:password \
  -X DELETE \
  "https://cloud.example.com/remote.php/dav/files/admin/test.txt"

┌──────────┐         ┌──────────────┐         ┌──────────┐
│  本地文件  │ ──────→ │  同步客户端  │ ──────→ │  服务端   │
│  变更    │ ←────── │  (变更检测)  │ ←────── │  文件    │
└──────────┘         └──────────────┘         └──────────┘

同步步骤:
1. 客户端扫描本地文件变更
2. 通过 ETag 检测服务端变更
3. 对比本地与远程差异
4. 解决冲突（如有）
5. 执行同步操作

ETag 是文件的唯一标识符（类似 MD5），用于检测文件是否变更：

初始状态:
  本地 ETag: abc123
  远程 ETag: abc123  → 一致，无需同步

文件被修改:
  本地 ETag: def456 (变更)
  远程 ETag: abc123  → 本地较新，上传

多人修改:
  本地 ETag: def456 (用户 A 修改)
  远程 ETag: ghi789 (用户 B 修改)  → 冲突！

客户端设置 → 同步协议 → 选择要同步的文件夹:

☑ /Documents           ← 同步
☑ /Photos              ← 同步
☐ /Videos              ← 不同步（太大）
☑ /Work                ← 同步
☐ /Archive             ← 不同步

场景 1: 离线编辑冲突
├── 用户 A 离线编辑 report.docx
├── 用户 B 在线编辑同一文件
└── 用户 A 上线后产生冲突

场景 2: 多设备冲突
├── 电脑端编辑文件
├── 手机端同时编辑
└── 同步时产生冲突

场景 3: 网络中断
├── 上传过程中网络断开
└── 部分写入导致冲突

冲突文件命名:
  report.docx              ← 最新版本（按修改时间）
  report (冲突副本 2026-05-10 14:30:00).docx  ← 冲突版本

通知区域弹出冲突提示:
┌─────────────────────────────────────────────┐
│ ⚠️ 同步冲突                                │
│                                             │
│ report.docx 存在冲突                        │
│                                             │
│ [ 保留本地版本 ] [ 保留远程版本 ] [ 两者都保留 ] │
└─────────────────────────────────────────────┘

# 通过 Web 界面
# 个人设置 → 安全 → 设备与活动 → 创建新应用密码

# 通过命令行
sudo -u www-data php /var/www/nextcloud/occ user:auth-token:add admin "My Script"

# 列出用户的所有应用密码
sudo -u www-data php /var/www/nextcloud/occ user:auth-token:list admin

# 删除应用密码
sudo -u www-data php /var/www/nextcloud/occ user:auth-token:delete admin <token_id>

客户端设置 → 网络:

上传限制:
├── 不限制 (默认)
├── 限制: 10 MB/s
└── 自动调节

下载限制:
├── 不限制 (默认)
├── 限制: 50 MB/s
└── 自动调节

客户端设置 → 常规:

并行同步任务数: 3 (默认，可调整为 1-10)

大文件上传过程:
1. 将文件分块（默认 10MB/块）
2. 逐块上传
3. 上传失败时从断点继续
4. 所有块上传完成后合并