Anki 同步限制把「集合大小超出限制」调回可控范围【免费下载链接】ankiAnki is a smart spaced repetition flashcard program项目地址: https://gitcode.com/GitHub_Trending/an/anki同步进度条走到 90%对话框弹出「collection exceeds size limit」——你的 Anki 牌组在跨设备同步时被卡住了。这不是卡片损坏而是集合文件触发了 Anki 同步限制下面这条报错正是它生效的位置。Anki 同步限制如何生效限制值来自一个可调参数环境变量MAX_SYNC_PAYLOAD_MEGS缺省 100 MB代码在 rslib/src/sync/request/mod.rs// rslib/src/sync/request/mod.rs pub static MAXIMUM_SYNC_PAYLOAD_BYTES: LazyLockusize LazyLock::new(|| { env::var(MAX_SYNC_PAYLOAD_MEGS) .map(|v| v.parse().expect(invalid upload limit)) .unwrap_or(100) // 默认 100 MB * 1024 * 1024 });同步时服务端把它乘以 3作为解压后数据的上限。上传逻辑在 rslib/src/sync/collection/upload.rs// rslib/src/sync/collection/upload.rs let max_bytes *MAXIMUM_SYNC_PAYLOAD_BYTES_UNCOMPRESSED as usize; if new_data.len() max_bytes { return Ok(UploadResponse::Err(collection exceeds size limit.into())); }换句话说100 MB 的配置对应 300 MB 的解压后上限检查发生在服务端解压之后客户端在上传前还会先压缩数据库碎片减小要传的文件。整个同步流程的实现都集中在 rslib/src/sync/。同步成功与否直接反映在统计界面上这也是验证操作是否生效的窗口路径 A · 清理未引用的媒体文件给集合瘦身适用人群使用官方同步、无法控制服务端配置的用户。媒体文件是体积大头优先从这里入手。打开「文件」→「媒体检查」勾选移除未引用的图片和音频执行检查。导出前先看各牌组卡片数量把长期不动的小牌组合并进主牌组减少结构开销。已完成、不再复习的内容另存备份后删除。预期效果媒体检查通常可移除 20%–40% 的无用文件本地集合文件肉眼可见地变小。完成后再同步一次即可对比前后体积。路径 B · 调整 Anki 自托管同步服务器载荷上限适用人群运行自己的同步服务Anki 自托管同步服务器的用户。上限由环境变量控制无需改动代码。在 docs/syncserver/README.md 的启动命令上加一个环境变量即可提高上限# docs/syncserver/README.md docker run -d \ -e SYNC_USER1admin:admin \ -e MAX_SYNC_PAYLOAD_MEGS500 \ -p 8080:8080 \ --mount typevolume,srcanki-sync-server-data,dst/anki_data \ --name anki-sync-server \ anki-sync-server容器按 docs/syncserver/Dockerfile 构建。预期效果重启后服务端按 500 MB 压缩载荷、约 1.5 GB 解压载荷放行此前超标的集合可以在各设备间完成同步。备份、操作与验证清单⚠️ 数据安全第一任何清理之前先备份# 备份本地集合Linux 示例 cp -r ~/.local/share/Anki2 ~/Anki2_backup_$(date %Y%m%d)备份完成确认文件存在。操作前记录本地集合文件体积du -h对应文件作为对比基准。路径 A运行媒体检查完成后对比体积确认变小再同步。路径 B重建容器并传入MAX_SYNC_PAYLOAD_MEGS确认docker logs anki-sync-server无报错。验证生效客户端同步走完、统计界面刷新正常服务器侧数据目录出现新的集合文件。先备份再走「减数据」或「调参数」中的一条路同步成功、统计正常就是 Anki 同步限制被解除的信号。【免费下载链接】ankiAnki is a smart spaced repetition flashcard program项目地址: https://gitcode.com/GitHub_Trending/an/anki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
