私有网盘与云存储搭建完全指南

# 文件路径：/opt/nextcloud/docker-compose.yml
# 完整的 Nextcloud + MariaDB + Redis 三服务组合

services:

  # ── Nextcloud 应用服务 ──────────────────────────────────────────────────────
  nextcloud:
    image: nextcloud:28-apache           # 使用稳定的具体版本号，避免大版本自动升级
    container_name: nextcloud_app
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"             # 只绑定本地，配合 Nginx 反代对外提供 HTTPS
    volumes:
      - ./data:/var/www/html             # Nextcloud 程序文件 + 用户文件
    environment:
      # 数据库连接信息
      - MYSQL_PASSWORD=${MYSQL_PASSWORD}
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_HOST=db
      # Redis 缓存连接
      - REDIS_HOST=redis
      - REDIS_HOST_PASSWORD=${REDIS_PASSWORD}
    depends_on:
      - db
      - redis

  # ── MariaDB 数据库 ──────────────────────────────────────────────────────────
  db:
    image: mariadb:11                    # MariaDB 11 性能优于 10.6
    container_name: nextcloud_db
    restart: unless-stopped
    # 这些参数是 Nextcloud 官方推荐的，提升写性能和兼容性
    command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW --innodb-file-per-table=1
    volumes:
      - ./db_data:/var/lib/mysql         # 数据目录持久化（命名卷或 bind mount 均可）
    environment:
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
      - MYSQL_PASSWORD=${MYSQL_PASSWORD}
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud

  # ── Redis 缓存（显著提升 UI 响应速度和文件扫描性能）──────────────────────────
  redis:
    image: redis:7-alpine
    container_name: nextcloud_redis
    restart: unless-stopped
    command: redis-server --requirepass ${REDIS_PASSWORD}
    volumes:
      - ./redis_data:/data

# 文件路径：/opt/nextcloud/.env

MYSQL_ROOT_PASSWORD=MySQL_ROOT强密码_随机20位
MYSQL_PASSWORD=Nextcloud数据库密码_随机16位
REDIS_PASSWORD=Redis密码_随机16位

# 启动：cd /opt/nextcloud && docker compose up -d
# 首次访问 http://服务器IP:8080 完成初始化向导

# 文件路径：/etc/nginx/conf.d/nextcloud.conf
# Nextcloud 官方推荐的 Nginx 反代配置

server {
    listen 443 ssl;
    http2 on;
    server_name cloud.yourdomain.com;

    ssl_certificate     /etc/letsencrypt/live/cloud.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/cloud.yourdomain.com/privkey.pem;

    # 上传文件大小限制（根据需求调整，Nextcloud 默认 512MB）
    client_max_body_size 10G;
    client_body_timeout  300s;

    # 反代到 Docker 容器
    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;
        # WebDAV 支持所需的超时设置
        proxy_connect_timeout  3600s;
        proxy_send_timeout     3600s;
        proxy_read_timeout     3600s;
    }
}

server {
    listen 80;
    server_name cloud.yourdomain.com;
    return 301 https://$host$request_uri;
}

# 进入 Nextcloud 容器内部编辑配置文件
docker exec -it nextcloud_app bash

# 编辑 config.php 添加 Redis 缓存配置
nano /var/www/html/config/config.php

# 在 </array> 结束标签之前添加以下内容：
# 'memcache.local' => '\OC\Memcache\Redis',
# 'memcache.locking' => '\OC\Memcache\Redis',
# 'redis' => array(
#     'host' => 'redis',       # Docker 网络内用服务名通信
#     'port' => 6379,
#     'password' => '你的Redis密码',
# ),

# Nextcloud 默认用 AJAX 触发后台任务（每次打开页面才执行）
# 更可靠的方式是在宿主机设置 Cron 定时任务：

# 在宿主机执行 crontab -e，添加以下行（每 5 分钟执行一次）：
# */5 * * * * docker exec -u www-data nextcloud_app php -f /var/www/html/cron.php

# 同时在 Nextcloud 管理后台修改：
# 设置 → 基本设置 → 后台任务 → 选择 "Cron"

# 文件路径：/opt/alist/docker-compose.yml

services:
  alist:
    image: xhofe/alist:latest
    container_name: alist
    restart: unless-stopped
    volumes:
      - ./data:/opt/alist/data           # AList 配置和数据库文件
    ports:
      - "127.0.0.1:5244:5244"            # 只绑定本地，配合 Nginx 反代
    environment:
      - PUID=0                           # 容器内以 root 运行（方便挂载权限管理）
      - PGID=0
      - UMASK=022

# 启动后获取初始管理员密码：
# docker exec -it alist ./alist admin random
# 或重置密码：
# docker exec -it alist ./alist admin set 你的新密码

# 文件路径：/opt/immich/docker-compose.yml
# 官方 Compose（简化版），完整版参考 https://immich.app/docs/install/docker-compose

services:
  # ── Immich 主服务 ───────────────────────────────────────────────────────────
  immich-server:
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    container_name: immich_server
    restart: unless-stopped
    ports:
      - "127.0.0.1:2283:3001"
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload  # 照片存储目录（设置为大容量路径）
    env_file: .env
    depends_on:
      - redis
      - database

  # ── 机器学习服务（人脸识别/物体分类）────────────────────────────────────────
  immich-machine-learning:
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
    container_name: immich_ml
    restart: unless-stopped
    volumes:
      - model_cache:/cache                        # 模型文件缓存
    env_file: .env

  # ── Redis 缓存 ──────────────────────────────────────────────────────────────
  redis:
    image: redis:7-alpine
    container_name: immich_redis
    restart: unless-stopped

  # ── PostgreSQL 数据库（Immich 官方要求 PG，不支持 MySQL）──────────────────────
  database:
    image: tensorchord/pgvecto-rs:pg16-v0.2.0    # 带向量扩展的 PG，支持 AI 相似度搜索
    container_name: immich_postgres
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD:  ${DB_PASSWORD}
      POSTGRES_USER:      ${DB_USERNAME}
      POSTGRES_DB:        ${DB_DATABASE_NAME}
    volumes:
      - ./pg_data:/var/lib/postgresql/data

volumes:
  model_cache:

# 文件路径：/opt/immich/.env

UPLOAD_LOCATION=/opt/immich/photos     # 照片存储路径（确保磁盘空间足够）
IMMICH_VERSION=release

DB_PASSWORD=Immich数据库密码_随机16位
DB_USERNAME=immich
DB_DATABASE_NAME=immich

# 启动后访问 http://服务器IP:2283 完成初始化
# 配合 Nginx 反代并开启 HTTPS 使用（移动端 App 需要 HTTPS）

# ── Linux 命令行挂载 WebDAV（davfs2）──────────────────────────────────────────
apt install davfs2 -y
mkdir -p /mnt/nextcloud

# 编辑 /etc/davfs2/secrets 添加认证信息（格式：地址 用户名 密码）
# https://cloud.yourdomain.com/remote.php/dav/files/username/  username  password

# 挂载
mount -t davfs https://cloud.yourdomain.com/remote.php/dav/files/username/ /mnt/nextcloud

# 开机自动挂载（/etc/fstab）：
# https://cloud.yourdomain.com/remote.php/dav/files/username/ /mnt/nextcloud davfs user,auto,_netdev 0 0

# ── Windows 客户端推荐工具 ────────────────────────────────────────────────────
# RaiDrive：最易用，图形界面，挂载为 Windows 盘符（如 Z:）
# CloudDrive2：支持多协议，性能较好，有免费版
# 原生 WebDAV：Windows 内置支持，但性能较差，仅适合小文件

# ── macOS 原生挂载 ────────────────────────────────────────────────────────────
# Finder → 前往 → 连接服务器 → 输入：
# https://cloud.yourdomain.com/remote.php/dav/files/username/

# ── 移动端（iOS / Android）────────────────────────────────────────────────────
# iOS：Files App → 添加存储位置 → WebDAV
# Android：推荐使用 Solid Explorer 或 X-plore 挂载 WebDAV

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

# ── 配置云存储连接（交互式引导）──────────────────────────────────────────────
rclone config
# 按照提示选择存储类型：
# n（新建配置）→ 选择编号（如 s3 对应 AWS S3 / 对象存储）
# 输入密钥和配置信息，完成后 q 退出

# ── 常用同步命令 ────────────────────────────────────────────────────────────
# 将本地目录同步到 Cloudflare R2（单向同步：本地→云端）
rclone sync /opt/nextcloud/data r2:my-bucket/nextcloud-backup   --transfers=4            # 并发传输数
  --checkers=8             # 并发校验数
  --progress                # 显示进度

# 双向同步（谨慎使用，可能覆盖文件）
rclone bisync /local/dir remote:bucket/dir --create-empty-src-dirs

# 挂载 WebDAV / S3 为本地目录（实验性，生产慎用）
rclone mount remote:bucket /mnt/cloud   --daemon                 # 后台运行
  --vfs-cache-mode full    # 完整本地缓存（读写性能最好）
  --cache-dir /tmp/rclone  # 缓存目录

# 查看已配置的远程存储列表
rclone listremotes

# 测试连接和列出文件
rclone ls r2:my-bucket/ | head -20