# 创建数据目录
mkdir -p /data/onlyoffice/{data,logs,lib,rabbitmq,redis,postgres}

# 启动 OnlyOffice Document Server
docker run -d \
  --name onlyoffice \
  -p 8080:80 \
  -v /data/onlyoffice/data:/var/www/onlyoffice/Data \
  -v /data/onlyoffice/logs:/var/log/onlyoffice \
  -v /data/onlyoffice/lib:/var/lib/onlyoffice \
  -v /data/onlyoffice/rabbitmq:/var/lib/rabbitmq \
  -v /data/onlyoffice/redis:/var/lib/redis \
  -v /data/onlyoffice/postgres:/var/lib/postgresql \
  -e JWT_ENABLED=true \
  -e JWT_SECRET=YourJWTSecretKey \
  onlyoffice/documentserver:latest

# docker-compose.yml
version: '3.8'

services:
  onlyoffice:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=YourJWTSecretKey
    volumes:
      - ./data:/var/www/onlyoffice/Data
      - ./logs:/var/log/onlyoffice
      - onlyoffice_lib:/var/lib/onlyoffice
      - onlyoffice_rabbitmq:/var/lib/rabbitmq
      - onlyoffice_redis:/var/lib/redis
      - onlyoffice_postgres:/var/lib/postgresql

volumes:
  onlyoffice_lib:
  onlyoffice_rabbitmq:
  onlyoffice_redis:
  onlyoffice_postgres:

docker compose up -d

server {
    listen 443 ssl http2;
    server_name office.example.com;

    ssl_certificate     /etc/letsencrypt/live/office.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/office.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $http_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;
        proxy_set_header X-Forwarded-Host $http_host;
        client_max_body_size 100M;
    }
}

# 安装 OnlyOffice 集成应用
sudo -u www-data php /var/www/nextcloud/occ app:install onlyoffice

# 设置 OnlyOffice 服务器地址
sudo -u www-data php /var/www/nextcloud/occ config:app:set \
  onlyoffice DocumentServerUrl --value="https://office.example.com/"

# 设置 JWT 密钥
sudo -u www-data php /var/www/nextcloud/occ config:app:set \
  onlyoffice jwt_secret --value="YourJWTSecretKey"

设置 → 管理 → OnlyOffice

Document Server URL: https://office.example.com/
Secret Key (JWT): YourJWTSecretKey

高级设置:
├── 默认打开格式: DOCX
├── 编辑器主题: 现代深色
└── 启用聊天: ✅

# 使用官方 Docker 镜像
docker run -d \
  --name collabora \
  -p 9980:9980 \
  -e "domain=cloud\\.example\\.com" \
  -e "username=admin" \
  -e "password=AdminPassword" \
  -e "extra_params=--o:ssl.enable=false" \
  --cap-add MKNOD \
  collabora/code:latest

# docker-compose.yml
version: '3.8'

services:
  collabora:
    image: collabora/code:latest
    container_name: collabora
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      - domain=cloud\.example\.com
      - username=admin
      - password=AdminPassword
      - extra_params=--o:ssl.enable=false
    cap_add:
      - MKNOD
    volumes:
      - collabora_data:/opt/collaboraoffice/user

volumes:
  collabora_data:

server {
    listen 443 ssl http2;
    server_name collabora.example.com;

    ssl_certificate     /etc/letsencrypt/live/collabora.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/collabora.example.com/privkey.pem;

    # Allow large uploads
    client_max_body_size 200M;

    # Collabora Discovery
    location /hosting/discovery {
        proxy_pass http://127.0.0.1:9980;
        proxy_set_header Host $http_host;
    }

    # Collabora WebSocket
    location ~ ^/lool/(.*)/ws$ {
        proxy_pass http://127.0.0.1:9980;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $http_host;
        proxy_read_proxy 36000s;
    }

    # Collabora Admin Console
    location /lool/adminws {
        proxy_pass http://127.0.0.1:9980;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $http_host;
    }

    # Collabora Main
    location / {
        proxy_pass http://127.0.0.1:9980;
        proxy_set_header Host $http_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;
    }
}

sudo -u www-data php /var/www/nextcloud/occ app:install richdocuments

# 设置 Collabora 服务器地址
sudo -u www-data php /var/www/nextcloud/occ config:app:set \
  richdocuments wopi_url --value="https://collabora.example.com"

# 添加可信域名
sudo -u www-data php /var/www/nextcloud/occ config:system:set \
  richdocuments wopi_allowlist --type=array --value="10.0.0.0/8"

┌─────────────────────────────────────────────────────────┐
│                   实时协作编辑模式                       │
│                                                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐             │
│  │  用户 A  │  │  用户 B  │  │  用户 C  │             │
│  │  光标红  │  │  光标蓝  │  │  光标绿  │             │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘             │
│       │             │             │                     │
│       └─────────────┼─────────────┘                     │
│                     │                                   │
│              ┌──────┴──────┐                            │
│              │  协作服务器  │                            │
│              │(OnlyOffice/ │                            │
│              │ Collabora)  │                            │
│              └──────┬──────┘                            │
│                     │                                   │
│              ┌──────┴──────┐                            │
│              │  Nextcloud  │                            │
│              │   存储      │                            │
│              └─────────────┘                            │
└─────────────────────────────────────────────────────────┘

文件变更过程:
├── v1: report.docx (初始版本)
├── v2: report.docx (第 1 次修改)
├── v3: report.docx (第 2 次修改)
└── ... (最多保留配置的版本数)

// config/config.php

// 版本保留间隔（秒）- 使用指数退避
'versions_retention_obligation' => 'auto,60',
// 格式: 'min,max'
// auto = 根据文件大小自动决定
// 数字 = 天数

// 示例：最少保留 7 天，最多保留 60 天
// 'versions_retention_obligation' => '7,60',

// 禁用版本管理（不推荐）
// 'versions_retention_obligation' => 'disabled',

// 版本最大数量
// 'file_storage.save_version_files' => true,

# 查看文件版本（通过 API）
curl -s -u admin:password \
  "https://cloud.example.com/remote.php/dav/versions/admin/versions/12345" \
  -X PROPFIND -H "Depth: 1" | xmllint --format -

# 恢复文件版本
# 通过 Web 界面：文件详情 → 版本 → 点击恢复按钮

# 手动触发版本清理
sudo -u www-data php /var/www/nextcloud/occ versions:cleanup

# 清理所有用户的旧版本
sudo -u www-data php /var/www/nextcloud/occ versions:cleanup --all

锁定类型:
├── 协作锁 (Collaborative Lock) - OnlyOffice/Collabora 编辑时自动锁定
├── 手动锁 (Manual Lock) - 用户手动锁定文件
└── 系统锁 (System Lock) - 系统操作时锁定

# 通过 WebDAV 锁定文件
curl -s -u admin:password \
  -X LOCK \
  "https://cloud.example.com/remote.php/dav/files/admin/report.docx" \
  -H "Timeout: Second-3600" \
  -d '<?xml version="1.0" encoding="UTF-8"?>
<D:lockinfo xmlns:D="DAV:">
  <D:lockscope><D:exclusive/></D:lockscope>
  <D:locktype><D:write/></D:locktype>
  <D:owner>admin</D:owner>
</D:lockinfo>'

// config/config.php
// 文件锁定已默认启用，配合 Redis 使用效果最佳
'filelocking.enabled' => true,
'memcache.locking' => '\\OC\\Memcache\\Redis',

配置步骤:
1. 安装 OnlyOffice 或 Collabora
2. 创建团队群组文件夹
3. 设置共享权限（读写）
4. 团队成员直接在 Web 界面编辑文档
5. 利用版本历史追踪变更
6. 使用评论功能进行文档评审

流程:
1. 创建合同模板（OnlyOffice 模板）
2. 指定编辑者填写合同内容
3. 启用跟踪修订功能
4. 审批人查看修订并添加评论
5. 批准后锁定文件（防篡改）
6. 下载 PDF 最终版本

集成方案:
1. Talk 创建视频会议
2. 会议中共享文档链接
3. 参会者同时编辑议程/纪要
4. Deck 创建行动项
5. 日历安排下次会议