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

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

services:

  # ── Nextcloud 应用服务 ──────────────────────────────────────────────────────
  nextcloud:
    image: nextcloud:${NEXTCLOUD_VERSION}-apache # 在 .env 固定已复核的受支持版本
    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:${MARIADB_VERSION}   # 固定兼容版本，升级前先读双方发布说明
    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位
NEXTCLOUD_VERSION=填写已复核的受支持版本
MARIADB_VERSION=填写与该版本兼容的版本

# 启动：cd /opt/nextcloud && docker compose up -d
# 保护密钥：chmod 600 .env
# 8080 只绑定本机；通过已配置 HTTPS 的域名完成初始化
# 临时排查也可用 SSH 隧道：ssh -L 8080:127.0.0.1:8080 user@服务器

# 文件路径：/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:${ALIST_VERSION} # 在 .env 固定已复核的发布版，不使用 latest
    container_name: alist
    user: "1000:1000"                    # 替换为数据目录实际 UID:GID
    restart: unless-stopped
    volumes:
      - ./data:/opt/alist/data           # AList 配置和数据库文件
    ports:
      - "127.0.0.1:5244:5244"            # 只绑定本地，配合 Nginx 反代
    environment:
      - UMASK=027

# .env：ALIST_VERSION=v3.60.0（示例；部署前核对发布页）
# 先让 UID 1000 拥有 ./data，再启动并获取初始管理员密码：
# docker exec -it alist ./alist admin random
# 或重置密码：
# docker exec -it alist ./alist admin set 你的新密码

# 不要手写或混用 main 分支 Compose；依赖镜像和端口会随版本变化
mkdir -p /opt/immich
cd /opt/immich

# 先在发布页选择并复核一个明确版本，再下载同一版本的两个文件
export IMMICH_RELEASE=vX.Y.Z
curl -fL -o docker-compose.yml   "https://github.com/immich-app/immich/releases/download/${IMMICH_RELEASE}/docker-compose.yml"
curl -fL -o example.env   "https://github.com/immich-app/immich/releases/download/${IMMICH_RELEASE}/example.env"

# 审阅文件后创建配置；不要把密钥提交到 Git
cp example.env .env
chmod 600 .env

# 编辑 .env，确认上传目录、数据库目录和强密码后再启动
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps

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

UPLOAD_LOCATION=/opt/immich/photos     # 照片存储路径（确保磁盘空间足够）
DB_DATA_LOCATION=/opt/immich/postgres  # 数据库应放本地可靠磁盘
IMMICH_VERSION=vX.Y.Z                  # 与下载的 Compose 发布版完全一致

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

# 2283 端口和依赖以该发布版 Compose 为准
# 公网使用前先配置反向代理、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.org 下载并校验官方发布包
apt update
apt install rclone -y
rclone version

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

# ── 备份：copy 不会删除远端已有对象 ─────────────────────────────────────────
rclone copy /srv/backup-set r2:my-bucket/nextcloud/2026-07-27   --transfers 4   --checkers 8   --checksum   --progress

# 传输完成后做单向完整性检查；保留策略交给对象存储生命周期规则
rclone check /srv/backup-set r2:my-bucket/nextcloud/2026-07-27   --one-way   --checksum

# sync 会删除目标端多余文件；只有做镜像且已 dry-run 审核时才使用
rclone sync --dry-run --interactive /source remote:mirror

# 挂载仅适合访问层，不作为数据库或 Immich 原始图库的主存储
rclone mount remote:bucket /mnt/cloud   --daemon   --vfs-cache-mode full   --cache-dir /var/cache/rclone

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

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