Gitea 升级指南

来源

原始文档: article/Gitea 从旧版本安全升级到1.24.7.md

核心内容

本文档详细介绍了如何将 Gitea 从旧版本安全升级到 1.24.7 版本的完整操作流程。

升级前准备

• 必须备份: 仓库数据和配置文件(app.ini)
• 停止服务: sudo systemctl stop gitea
• 创建完整备份:
• Binary安装: sudo tar -czf gitea-backup-$(date +%F).tar.gz /var/lib/gitea /etc/gitea
• Docker安装: tar -czf gitea-backup-docker-$(date +%F).tar.gz ./gitea

升级方法

方法A: Binary安装升级

1. 下载新版: wget -O gitea https://dl.gitea.com/gitea/1.24.7/gitea-1.24.7-linux-amd64
2. 替换二进制: sudo chmod +x gitea && sudo mv gitea /usr/local/bin/gitea
3. 重启服务: sudo systemctl restart gitea

方法B: Docker安装升级

1. 拉取新镜像: docker pull gitea/gitea:1.24.7
2. 停止并移除旧容器
3. 启动新版本(保持数据卷不变)

验证升级

• 访问 http://服务器IP:3000
• 查看 About 页面确认版本号
• 或运行: gitea --version

关键要点

• tar提示"Removing leading '/'"是正常现象,不是错误
• tar默认无进度条,可通过 watch -n 1 ls -lh 查看文件大小变化
• 优先使用 Docker 方式,隔离性最好
• 每次升级前务必查看官方 Release Notes

相关实体

• Gitea - 轻量级代码托管平台
• Docker - 容器化平台
• systemd - 系统服务管理
• tar - 归档工具