服务端部署说明

这份文档只说明通用部署结构，不包含任何真实服务器信息。

运行方式

服务端建议由进程管理器托管，监听本机回环地址，再由反向代理提供 HTTPS 入口。

gunicorn -c deploy/gunicorn.conf.py capcut_server:app

单进程运行

草稿缓存在进程内存中，服务必须保持单 worker，使用多线程提高并发。多 worker 会导致后续请求找不到之前创建的草稿。

反向代理

反向代理只暴露 /api/，其余请求交给文档静态目录：

server {
    listen 443 ssl;
    server_name your-domain.example;

    root /path/to/docs;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass http://127.0.0.1:9001/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_read_timeout 600s;
        proxy_buffering off;
    }
}

配置项

{
  "draft_profile": "jianying_pro_10",
  "draft_domain": "https://your-domain.example/api",
  "drafts_root": "/path/to/drafts",
  "api_key": "<长随机串>",
  "enable_preview": false,
  "enable_desktop": false,
  "enable_local_download": true,
  "keep_draft_folder": false,
  "allowed_media_hosts": []
}

字段	说明
draft_profile	目标剪映版本，可选 jianying_pro_10、jianying_legacy、capcut_legacy
draft_domain	生成下载链接用的对外地址
drafts_root	草稿写入根目录，请求无法写到该目录之外
enable_preview	网页实时预览
enable_desktop	桌面版自动重载，仅 Windows 有意义
keep_draft_folder	打包后是否保留草稿目录，默认 false 只留 zip
allowed_media_hosts	素材域名白名单，留空则只拦内网地址

健康检查

curl -s https://your-domain.example/api/health

返回 {"success": true, "output": "ok", "error": ""} 即为正常。