局域网Windows环境Gitea备份方案对比：gitea dump与robocopy

优先推荐使用gitea dump命令做备份，除非你有明确的增量备份需求且能解决数据一致性问题，下面具体分析两种方案的优劣：

一、直接复制gitea/data目录（如robocopy） #

• 优势：
  • 操作门槛低，增量同步时只传输变化的文件，速度快
  • 恢复步骤简单，直接把备份的data目录覆盖到新服务器对应位置即可
• 劣势：
  • 核心问题：数据一致性无法保证——备份过程中如果Gitea正在处理用户提交、权限修改等操作，复制的文件可能处于半写入状态，恢复后大概率会出现用户角色丢失、仓库提交记录异常、数据库损坏等问题
  • 若使用外置数据库（比如MySQL），只复制data目录会漏掉数据库中的用户、角色数据；哪怕是内置SQLite，备份时的写入冲突也会导致数据库文件损坏
  • 零散文件管理麻烦，归档、跨机器传输都不如压缩包方便

二、使用gitea dump命令 #

• 优势：
  • 数据一致性可靠：dump命令会自动处理Gitea的写入锁定，确保备份的数据库、仓库文件、用户配置完全同步，恢复后不会出现数据异常
  • 一站式备份：不管是内置SQLite还是外置数据库，所有必要数据（用户、角色、仓库、系统配置）都会打包成一个压缩包，无需分开处理不同组件
  • 恢复兼容性强：新服务器部署好Gitea后，用官方的gitea restore命令就能直接导入备份包，恢复后仓库地址、用户权限完全和原来一致，局域网客户端的连接不会受任何影响
  • 压缩包便于存储、归档和传输，占用空间也比零散文件更小
• 劣势：
  • 全量备份速度比增量复制慢，尤其是仓库数量多、体积大的场景
  • 全量压缩包需要更多存储空间，但可以配合7-Zip等工具做二次压缩，或者定期清理旧备份节省空间

额外建议 #

• 如果想兼顾速度和安全性，可以混合使用：每周做一次完整的gitea dump作为基础备份，每天用robocopy增量同步gitea/repositories目录（只同步仓库的git数据），但必须保证每周的全量dump是完整一致的，恢复时先导入全量备份，再覆盖增量同步的仓库文件
• 备份后一定要做一次模拟恢复测试，确认Gitea能正常启动，用户、角色、仓库都能正常访问，客户端拉取推送无异常
• 备份文件要存到和Gitea服务器分离的存储设备（比如外接硬盘、局域网内其他机器），避免服务器故障导致备份也丢失

内容的提问来源于stack exchange，提问作者DevBee