什么是 Forgejo？
Forgejo 是一款自托管轻量级软件代码托管平台。易于安装、维护成本低，可以轻松胜任工作。Forgejo 是以安全、隐私和民主治理为核心的 Gitea 社区驱动 fork，为您提供完全自主掌控的 GitHub 或 GitLab 自托管替代方案。
🚀 为什么最新版本很重要：Forgejo 定期发布更新，包含安全补丁、新功能和性能改进。最新版本包括 Forgejo Actions（兼容 GitHub Actions 的 CI/CD）、改进的软件包仓库支持以及增强的联邦功能。
⚡ Forgejo 的核心功能
📦 Git 仓库托管
托管无限数量的公开和私有 git 仓库。完整支持 Git LFS 大文件存储，以及从 GitHub、GitLab 等平台镜像仓库。
🔄 Pull Request 与代码审查
内置 Pull Request 工作流，支持行内代码审查、审查人分配、必要审查人设置，以及 squash 和 rebase 等合并策略。
🐛 问题追踪
功能完整的问题追踪器，支持标签、里程碑、项目看板、自定义字段和跨仓库引用。
⚙️ Forgejo Actions
内置 CI/CD 引擎，兼容 GitHub Actions 工作流。可在自托管 runner 上使用 GitHub Actions 市场中的现有 action。
📚 软件包仓库
托管您自己的软件包：npm、PyPI、Maven、Docker/OCI 镜像、Debian/RPM 包、Helm chart 等——全部集中在一处。
🔐 安全与访问控制
细粒度权限管理、双因素身份验证、OAuth2 提供者、LDAP/SAML 集成、SSH 和 HTTPS 访问，以及分支保护规则。
🏆 为什么选择 Forgejo？
- 自托管：您的数据保留在您的服务器上，由您完全掌控
- 轻量级：可在树莓派或每月 5 美元的 VPS 上运行
- 兼容 Gitea：无缝替换，完整 API 兼容性
- 社区驱动：民主治理，无厂商锁定
- 兼容 GitHub Actions：复用现有工作流和市场 action
🚀 永久免费，安全修复立即发布：Debian 和 Ubuntu 在发布时会冻结软件包版本——本免费镜像提供发布至少 2 个月的最新版本，永久免费；安全修复立即发布。如需在上游发布后数小时内获取每个版本，请使用主仓库 deb.griffo.io。只需
apt upgrade 即可获取免费通道内的最新构建。
📦 从 deb-free.griffo.io 安装
步骤 1：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
sudo apt update
install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
apt update
步骤 2：安装 Forgejo
# Install latest Forgejo (also installs git and git-lfs)
sudo apt install forgejo
# Verify installation
forgejo --version
# Install latest Forgejo (also installs git and git-lfs)
apt install forgejo
# Verify installation
forgejo --version
📋 安装后需完成初始配置：Forgejo 是一个 Web 服务器——安装完成后需要启动服务并通过 Web 界面完成初始配置。请参阅下方的配置步骤。
🚀 初始配置
软件包会自动创建 git 系统用户、/var/lib/forgejo 数据目录以及 /etc/forgejo 配置目录。请按以下步骤完成配置：
# Start the Forgejo service
sudo systemctl start forgejo
# Open http://localhost:3000 in your browser to complete initial configuration
# (configure database, admin account, domain, etc.)
# After the web setup is complete, enable Forgejo on boot:
sudo systemctl enable forgejo
# Check service status
sudo systemctl status forgejo
🛡️ 配置完成后的安全加固
完成基于 Web 的初始配置后，将配置文件设为只读以增强安全性：
# Lock down the config directory and app.ini after initial configuration
sudo systemctl stop forgejo
sudo chmod 750 /etc/forgejo
sudo chmod 640 /etc/forgejo/app.ini
sudo systemctl start forgejo
🔧 命令行管理
Forgejo 提供 CLI 用于管理任务。请以 git 用户身份运行命令：
# List all users
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list
# Create admin user
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \
--username admin --password changeme --email admin@example.com --admin
# Regenerate Git hooks (useful after upgrades)
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks
🚀 为什么选择 deb-free.griffo.io？
📊 仓库对比：
- 官方 Ubuntu：官方仓库中没有 Forgejo 软件包
- 手动安装：需要手动下载并部署二进制文件
- deb.griffo.io（主仓库）：最新版本（15.0.2+），提供正规打包、安装后自动配置和 apt 更新支持
- ✅ 最新安全补丁：安全修复立即发布，常规版本更新最多延迟上游 2 个月
- ✅ 自动配置：安装后脚本自动创建用户、目录和 systemd 服务
- ✅ 正确的依赖管理：自动安装 git 和 git-lfs
- ✅ 自动更新：
apt upgrade即可保持 Forgejo 最新 - ✅ 多架构支持：支持 amd64、armhf（树莓派）和 arm64
- ✅ 多发行版支持：支持 Jammy 和 Noble
📦 软件包构建仓库
Ubuntu 软件包在此 GitHub 仓库中自动构建和维护：
- ⚒️ forgejo-debian - Latest release builds
🔗 相关软件包
也可从 deb-free.griffo.io 获取：
- lazygit - Terminal UI for Git（git 工作流的绝佳伴侣）
- lazydocker - Terminal UI for Docker（在容器中运行 Forgejo 时很有用）
- eza - Modern ls replacement
🎯 适用人群：希望完全掌控源代码的开发者和团队、有数据隐私要求的组织、家庭实验室爱好者，以及任何寻找能在最低配置硬件上运行的轻量级 GitHub/GitLab 自托管替代方案的用户。
💝 支持此项目
如果这个仓库为您节省了时间和精力，请考虑支持它！