┌─────────────────────────────────────────────────────────┐
│                 Nextcloud 运维规范框架                   │
│                                                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  更新管理   │  │  安全加固   │  │  监控告警   │     │
│  │             │  │             │  │             │     │
│  │ 版本跟踪   │  │ 安全基线   │  │ 指标采集   │     │
│  │ 测试流程   │  │ 定期审计   │  │ 告警规则   │     │
│  │ 回滚方案   │  │ 漏洞管理   │  │ 仪表盘    │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│                                                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  容量规划   │  │  备份策略   │  │  文档管理   │     │
│  │             │  │             │  │             │     │
│  │ 用户增长   │  │ 自动备份   │  │ 变更记录   │     │
│  │ 存储预测   │  │ 恢复测试   │  │ 操作手册   │     │
│  │ 性能基线   │  │ 异地备份   │  │ 应急预案   │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
└─────────────────────────────────────────────────────────┘

更新前准备:

□ 1. 阅读更新日志和版本说明
□ 2. 检查应用兼容性
□ 3. 备份数据库
□ 4. 备份数据目录
□ 5. 备份 config.php
□ 6. 在测试环境验证升级
□ 7. 通知用户维护窗口
□ 8. 确认回滚方案

#!/bin/bash
# nextcloud-update.sh - Nextcloud 标准更新脚本

set -euo pipefail

NC_ROOT="/var/www/nextcloud"
BACKUP_DIR="/backup/nextcloud/$(date +%Y%m%d_%H%M%S)"

echo "=== Nextcloud 更新流程 ==="

# 1. 记录当前版本
CURRENT_VERSION=$(sudo -u www-data php "$NC_ROOT/occ" status --output=json | jq -r '.versionstring')
echo "当前版本: $CURRENT_VERSION"

# 2. 创建备份
echo "创建备份..."
mkdir -p "$BACKUP_DIR"
sudo -u www-data php "$NC_ROOT/occ" maintenance:mode --on

mysqldump -u ncuser -pStrongPassword123! nextcloud | gzip > "$BACKUP_DIR/database.sql.gz"
cp -a "$NC_ROOT/config/" "$BACKUP_DIR/config/"
tar czf "$BACKUP_DIR/nextcloud-apps.tar.gz" -C "$NC_ROOT" apps themes

# 3. 下载新版本
echo "下载新版本..."
sudo -u www-data php "$NC_ROOT/occ" updater:channel stable
sudo -u www-data php "$NC_ROOT/occ" update:check

# 4. 执行更新
echo "执行更新..."
sudo -u www-data php "$NC_ROOT/occ" upgrade

# 5. 修复数据库
sudo -u www-data php "$NC_ROOT/occ" db:add-missing-indices
sudo -u www-data php "$NC_ROOT/occ" db:add-missing-columns
sudo -u www-data php "$NC_ROOT/occ" maintenance:repair

# 6. 关闭维护模式
sudo -u www-data php "$NC_ROOT/occ" maintenance:mode --off

# 7. 验证
NEW_VERSION=$(sudo -u www-data php "$NC_ROOT/occ" status --output=json | jq -r '.versionstring')
echo "新版本: $NEW_VERSION"

# 8. 更新应用
sudo -u www-data php "$NC_ROOT/occ" app:update --all

echo "=== 更新完成 ==="
echo "备份位置: $BACKUP_DIR"

#!/bin/bash
# nextcloud-rollback.sh

set -euo pipefail

NC_ROOT="/var/www/nextcloud"
BACKUP_DIR="$1"  # 传入备份目录路径

echo "=== Nextcloud 回滚 ==="
echo "回滚到备份: $BACKUP_DIR"

# 1. 维护模式
sudo -u www-data php "$NC_ROOT/occ" maintenance:mode --on

# 2. 停止 Web 服务器
sudo systemctl stop nginx

# 3. 恢复数据库
echo "恢复数据库..."
mysql -u root -pStrongPassword123! -e "DROP DATABASE IF EXISTS nextcloud;"
mysql -u root -pStrongPassword123! -e "CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"
gunzip < "$BACKUP_DIR/database.sql.gz" | mysql -u ncuser -pStrongPassword123! nextcloud

# 4. 恢复配置和应用
echo "恢复配置..."
cp -a "$BACKUP_DIR/config/" "$NC_ROOT/config/"
tar xzf "$BACKUP_DIR/nextcloud-apps.tar.gz" -C "$NC_ROOT/"

# 5. 修复权限
sudo chown -R www-data:www-data "$NC_ROOT"

# 6. 修复数据库
sudo -u www-data php "$NC_ROOT/occ" maintenance:repair

# 7. 启动服务
sudo systemctl start nginx
sudo -u www-data php "$NC_ROOT/occ" maintenance:mode --off

echo "=== 回滚完成 ==="

#!/bin/bash
# nextcloud-security-audit.sh

echo "=== Nextcloud 安全审计 ==="
echo "审计时间: $(date)"
echo ""

NC_ROOT="/var/www/nextcloud"

# 1. 检查 HTTPS
echo "1. HTTPS 检查"
PROTOCOL=$(sudo -u www-data php "$NC_ROOT/occ" config:system:get overwriteprotocol 2>/dev/null || echo "未设置")
echo "   协议配置: $PROTOCOL"

# 2. 检查安全头
echo "2. 安全头检查"
DOMAIN=$(sudo -u www-data php "$NC_ROOT/occ" config:system:get trusted_domains 0 2>/dev/null)
if [ -n "$DOMAIN" ]; then
    HEADERS=$(curl -sI "https://$DOMAIN" 2>/dev/null)
    echo "   HSTS: $(echo "$HEADERS" | grep -i 'strict-transport' | head -1 || echo '未设置')"
    echo "   X-Content-Type-Options: $(echo "$HEADERS" | grep -i 'x-content-type' | head -1 || echo '未设置')"
    echo "   X-Frame-Options: $(echo "$HEADERS" | grep -i 'x-frame' | head -1 || echo '未设置')"
fi

# 3. 检查暴力破解防护
echo "3. 暴力破解防护"
BRUTEFORCE=$(sudo -u www-data php "$NC_ROOT/occ" config:system:get auth.bruteforce.protection.enabled 2>/dev/null || echo "未设置")
echo "   防护状态: $BRUTEFORCE"

# 4. 检查维护模式
echo "4. 维护模式"
MAINTENANCE=$(sudo -u www-data php "$NC_ROOT/occ" config:system:get maintenance 2>/dev/null || echo "未知")
echo "   状态: $MAINTENANCE"

# 5. 检查版本
echo "5. 版本信息"
sudo -u www-data php "$NC_ROOT/occ" status

# 6. 检查 PHP 版本
echo "6. PHP 版本"
php -v | head -1

# 7. 检查目录权限
echo "7. 目录权限"
DATA_DIR=$(sudo -u www-data php "$NC_ROOT/occ" config:system:get datadirectory 2>/dev/null)
DATA_PERMS=$(stat -c '%a' "$DATA_DIR" 2>/dev/null || echo "无法读取")
echo "   数据目录: $DATA_DIR (权限: $DATA_PERMS)"

echo ""
echo "=== 审计完成 ==="

# 安装 Nextcloud 指标导出器
sudo -u www-data php /var/www/nextcloud/occ config:system:set \
  sharing.federation.allowSelfSignedCertificates --value=true

// config/config.php
'metrics' => true,

# prometheus.yml
scrape_configs:
  - job_name: 'nextcloud'
    metrics_path: '/ocs/v2.php/apps/serverinfo/api/v1/info'
    params:
      format: ['json']
    static_configs:
      - targets: ['cloud.example.com']

#!/bin/bash
# nextcloud-monitor.sh

NC_ROOT="/var/www/nextcloud"

# 检查 Nextcloud 状态
STATUS=$(sudo -u www-data php "$NC_ROOT/occ" status --output=json 2>/dev/null)
INSTALLED=$(echo "$STATUS" | jq -r '.installed')
MAINTENANCE=$(echo "$STATUS" | jq -r '.maintenance')

if [ "$INSTALLED" != "true" ] || [ "$MAINTENANCE" != "false" ]; then
    echo "ALERT: Nextcloud 状态异常"
    exit 1
fi

# 检查 HTTP 响应
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "https://cloud.example.com/status.php" 2>/dev/null)
if [ "$HTTP_CODE" != "200" ]; then
    echo "ALERT: HTTP 响应异常 ($HTTP_CODE)"
    exit 1
fi

# 检查数据库连接
if ! sudo -u www-data php "$NC_ROOT/occ" db:add-missing-indices > /dev/null 2>&1; then
    echo "ALERT: 数据库连接失败"
    exit 1
fi

echo "OK: Nextcloud 运行正常"

存储容量 = (用户数 × 人均存储) × 冗余系数 + 系统开销

示例 (100 用户):
├── 人均存储: 10GB
├── 冗余系数: 1.3 (30% 冗余)
├── 系统开销: 预览图 + 版本 + 缓存 ≈ 用户数据的 20%
└── 总容量 = (100 × 10GB) × 1.3 × 1.2 = 1,560GB ≈ 1.6TB

#!/bin/bash
# 性能基线测试

echo "=== Nextcloud 性能基线测试 ==="

# 1. 页面加载时间
echo "1. 页面加载时间"
for i in {1..5}; do
    TIME=$(curl -s -o /dev/null -w "%{time_total}" -u admin:password "https://cloud.example.com/" 2>/dev/null)
    echo "   尝试 $i: ${TIME}s"
done

# 2. 文件上传速度
echo "2. 文件上传速度"
dd if=/dev/zero of=/tmp/test-100mb bs=1M count=100 2>/dev/null
START=$(date +%s%N)
curl -s -u admin:password -X PUT -T /tmp/test-100mb \
  "https://cloud.example.com/remote.php/dav/files/admin/test-100mb" > /dev/null 2>&1
END=$(date +%s%N)
DURATION=$(( (END - START) / 1000000 ))
SPEED=$(( 100000 * 1000 / DURATION ))
echo "   100MB 上传: ${DURATION}ms (${SPEED} KB/s)"
rm /tmp/test-100mb

# 3. 文件下载速度
echo "3. 文件下载速度"
START=$(date +%s%N)
curl -s -u admin:password -o /dev/null \
  "https://cloud.example.com/remote.php/dav/files/admin/test-100mb" 2>/dev/null
END=$(date +%s%N)
DURATION=$(( (END - START) / 1000000 ))
SPEED=$(( 100000 * 1000 / DURATION ))
echo "   100MB 下载: ${DURATION}ms (${SPEED} KB/s)"

# 4. 并发测试
echo "4. 并发测试"
ab -n 100 -c 10 -A admin:password \
  "https://cloud.example.com/remote.php/dav/files/admin/" 2>/dev/null | grep "Requests per second"

echo "=== 测试完成 ==="

# nextcloud-deploy.yml
---
- hosts: nextcloud_servers
  become: true
  vars:
    nc_version: "29"
    nc_domain: "cloud.example.com"
    db_password: "{{ vault_db_password }}"

  tasks:
    - name: Install dependencies
      apt:
        name:
          - nginx
          - php{{ nc_version }}-fpm
          - php{{ nc_version }}-mysql
          - redis-server
          - mariadb-server
        state: present

    - name: Configure Nginx
      template:
        src: templates/nginx-nextcloud.conf.j2
        dest: /etc/nginx/sites-available/nextcloud

    - name: Configure PHP
      template:
        src: templates/php-nextcloud.ini.j2
        dest: /etc/php/{{ nc_version }}/fpm/conf.d/90-nextcloud.ini

    - name: Download Nextcloud
      get_url:
        url: "https://download.nextcloud.com/server/releases/latest.tar.bz2"
        dest: /tmp/nextcloud.tar.bz2

    - name: Deploy Nextcloud
      unarchive:
        src: /tmp/nextcloud.tar.bz2
        dest: /var/www/
        remote_src: yes

    - name: Set permissions
      file:
        path: /var/www/nextcloud
        owner: www-data
        group: www-data
        recurse: yes

#!/bin/bash
# nextcloud-daily-report.sh

REPORT_FILE="/var/log/nextcloud/daily-report-$(date +%Y%m%d).txt"
NC_ROOT="/var/www/nextcloud"

{
    echo "=== Nextcloud 每日巡检报告 ==="
    echo "日期: $(date)"
    echo ""

    echo "--- 系统状态 ---"
    sudo -u www-data php "$NC_ROOT/occ" status
    echo ""

    echo "--- 存储使用 ---"
    sudo -u www-data php "$NC_ROOT/occ" user:report
    echo ""

    echo "--- 用户数量 ---"
    USER_COUNT=$(sudo -u www-data php "$NC_ROOT/occ" user:list | wc -l)
    echo "总用户数: $USER_COUNT"
    echo ""

    echo "--- 系统资源 ---"
    echo "CPU: $(uptime | awk -F'load average:' '{print $2}')"
    echo "内存: $(free -h | grep Mem | awk '{print $3"/"$2}')"
    echo "磁盘: $(df -h / | tail -1 | awk '{print $5}')"
    echo ""

    echo "--- 最近错误 ---"
    grep '"level":"error"' /var/log/nextcloud/nextcloud.log 2>/dev/null | tail -10
    echo ""

    echo "--- 暴力破解尝试 ---"
    grep "Login failed" /var/log/nextcloud/nextcloud.log 2>/dev/null | wc -l
    echo " 次登录失败"

} > "$REPORT_FILE" 2>&1

echo "报告已生成: $REPORT_FILE"

□ 检查系统负载和资源使用
□ 检查 Nextcloud 服务状态
□ 检查备份是否成功执行
□ 查看错误日志
□ 检查磁盘空间

□ 检查安全更新
□ 审查登录失败日志
□ 检查 SSL 证书有效期
□ 验证备份可恢复性
□ 检查数据库性能
□ 清理过期分享链接

□ 运行安全扫描
□ 更新系统和依赖
□ 审查用户权限
□ 检查存储容量趋势
□ 审查并更新文档
□ 测试灾难恢复流程

影响: 所有用户无法访问
恢复时间目标 (RTO): 30 分钟
恢复点目标 (RPO): 最近一次备份

处理步骤:
1. 确认数据库状态
2. 尝试重启数据库服务
3. 如果无法恢复，切换到备用数据库（如有）
4. 从最新备份恢复数据库
5. 通知用户恢复情况

影响: 文件上传失败，系统可能不可用
处理步骤:
1. 清理临时文件
2. 清理旧版本和回收站
3. 扩容磁盘
4. 监控存储使用趋势

影响: 数据可能泄露
处理步骤:
1. 立即开启维护模式
2. 保留日志证据
3. 评估影响范围
4. 重置所有管理员密码
5. 吊销所有应用密码
6. 从已知安全的备份恢复
7. 修补安全漏洞
8. 恢复服务