从 GitHub 拥抱开源净土：针对“懒人”的 Codeberg 迁移实战指南

引言：为什么开发者正在寻找 GitHub 的替代方案？

长期以来，GitHub 几乎成为了 Open Source 的代名词。然而，随着 GitHub 被 Microsoft 收购，以及近年来平台重心向 Copilot 等 AI 商业化产品倾斜，许多开发者开始反思：我们是否过度依赖单一的商业平台？对于追求隐私、非营利属性和纯粹开源精神的开发者来说，Codeberg 正在成为一个极具吸引力的避风港。

什么是 Codeberg？

Codeberg 是一个由德国非营利组织 Codeberg e.V. 运营的代码托管平台。它基于 Forgejo（Gitea 的一个硬分支），完全运行在开源软件之上，且不追踪用户数据。与 GitHub 不同，Codeberg 的目标不是利润，而是为开源社区提供长期、稳定的基础设施。

针对“懒人”的迁移策略：利用自动化工具

迁移 Repository 听起来是一项繁琐的工作，但作者在文中强调，利用 Codeberg 内置的自动化功能，整个过程可以做到近乎“零操作”。

1. 一键式 Migration 导入

Codeberg 提供了强大的导入引擎，你不需要在本地执行 git clone --mirror。只需输入 GitHub 仓库的 URL，系统会自动处理：

• Git History: 完整的 Commit 记录、Tags 和 Branches。
• Metadata: 可选导入 Issues、Pull Requests、Labels、Milestones 甚至是 Releases。
• User Mapping: 自动将 GitHub 用户关联至 Codeberg 用户。

2. 设置 Mirroring（镜像同步）

如果你还没准备好彻底放弃 GitHub，或者希望将其作为备份，Codeberg 的 Mirroring 功能非常实用。你可以将 Codeberg 设置为 GitHub 的镜像，它会定期拉取最新的 Commit，确保两个平台的数据同步，无需手动干预。

技术深度：CI/CD 与生态系统的转换

虽然仓库的迁移很简单，但技术栈的深度集成仍需关注。GitHub Actions 是目前最流行的 CI/CD 工具，而 Codeberg 则主要原生支持 Woodpecker CI。

• Woodpecker CI: 同样采用 YAML 格式定义 Pipeline，虽然与 GitHub Actions 语法不完全兼容，但其轻量级和 Docker 原生支持使得迁移成本相对较低。
• SSH Keys 与 Access Tokens: 迁移后，你需要更新本地的 Git Remote URL，并重新配置 SSH Key 或使用 Codeberg 的 Personal Access Tokens。

核心要点总结 (Key Takeaways)

• 非营利性：Codeberg 不受企业 KPI 驱动，更符合开源社区的长远利益。
• 隐私友好：无广告、无追踪器，服务器位于欧洲。
• 迁移门槛极低：内置的导入工具支持一键迁移所有 Issue 和 PR。
• 社区驱动：作为一个非营利组织，你可以通过成为会员来直接参与平台的治理。

结论

从 GitHub 迁移到 Codeberg 并不是为了“自找麻烦”，而是一种对个人数据所有权和开源生态多样性的投资。通过本文介绍的“懒人”方法，你可以在几分钟内完成迁移，同时享受更加纯粹的 Coding 环境。