Gogs
用单个 Go 二进制文件轻松自托管 Git 服务,支持代码托管、浏览、协作与自动化。
- 源仓库
- gogs/gogs
- Star 数
- ★ 48k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- Go
- FA 评分
- 56/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 个人开发者想在一台树莓派或 5 美元云主机上搭建私有 Git 仓库。
- 不适合
- 希望零运维直接使用托管代码平台的团队
- 需要完整成熟 Actions/包托管能力的团队(相关功能仍在开发中)
- 官网
- gogs.io ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v0.14.4(2026-11-12)近 7 天每天 +5.7 ★
- 源码审查
- 56/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Gogs 是一个用 Go 编写的自托管 Git 服务,目标是让搭建私有代码托管变得尽可能省事。它以独立二进制形式分发,可运行在 Linux、macOS、Windows 和 ARM 设备上,也提供 Docker 与 Kubernetes 部署方式。功能覆盖 SSH/HTTP(S) 协议 v2 代码托管、内置 SSH 服务器、SHA-256 仓库、部署密钥与 LFS,浏览器内代码浏览与编辑、全库搜索、Markdown/Notebook/PDF/Mermaid 渲染,以及 Issue、Pull Request、Wiki、发布和项目等协作能力。后台支持 PostgreSQL、MySQL 或 SQLite3,并提供 OpenTelemetry 追踪、Prometheus 指标和命令行备份恢复。界面支持 31 种以上语言、明暗主题和命令面板,适合小团队或个人在低配硬件上运行。
Gogs 以服务端进程形式读取 Git 仓库数据,对外暴露 Git over SSH 和 HTTP(S)(含协议 v2)以及内置 SSH 服务器,接收推送并维护仓库状态。它渲染网页界面供用户浏览和在线编辑代码、查看 blame、执行仓库内与全局代码搜索,并把 Markdown、Jupyter Notebook、PDF 和 Mermaid 图表渲染成可读结果。协作层面它管理 Issue 模板与表单、Pull Request 的 merge commit/rebase/squash 合并策略、受保护分支、Wiki、发布和项目。自动化层面提供 Webhook(Slack、Discord、DingTalk 等)与服务端 Git 钩子,并暴露实验性的 REST API。运维层面它把数据写入 PostgreSQL、MySQL 或 SQLite3,输出 OpenTelemetry 追踪(带内置追踪查看器)和 Prometheus 指标,并支持从命令行执行备份与恢复。
- 个人开发者想在一台树莓派或 5 美元云主机上搭建私有 Git 仓库。
- 小团队需要 Issue、Pull Request、Wiki 和代码搜索一体化的内网代码托管。
- 企业要求代码不出内网,用 LDAP、PAM、OAuth 2.0 或 SAML 2.0 对接现有账号体系。
- 运维团队希望用 Docker 或 Kubernetes 部署 Git 服务,并通过 Prometheus 指标和 OpenTelemetry 追踪接入监控。
- 需要从其他代码托管平台迁移仓库并配置镜像同步的团队。
如何安装或部署这个 Agent?
README 未给出逐步安装命令,只说明支持三种交付方式:独立二进制、Docker 和 Kubernetes。README 指向 https://gogs.io 获取用户文档,并提示可先在 https://try.gogs.io/gogs/gogs 在线试用。安装前需要准备 PostgreSQL、MySQL 或 SQLite3 之一作为数据库。具体下载地址、镜像名称与启动参数未在来源中给出,属于缺失信息,需查阅官方文档确认。
如何使用这个 Agent?
部署完成后通过浏览器访问 Web 界面进行仓库管理、Issue 与 Pull Request 协作,并使用命令面板导航。自动化集成可通过 Webhook 或服务端 Git 钩子触发,API 为实验性 REST 接口,文档位于 https://gogs.io/api-reference。备份与恢复通过命令行执行,具体子命令未在来源中列出。
这个 Agent 有哪些优点和局限?
- 单个 Go 二进制即可分发,覆盖 Linux、macOS、Windows 与 ARM,资源占用低,树莓派或 512MB 内存即可起步。
- 内置 SSH 服务器并支持 Git 协议 v2、SHA-256 仓库、部署密钥和 LFS(本地或 S3)。
- 数据库可选 PostgreSQL、MySQL 或 SQLite3,部署形态覆盖二进制、Docker 与 Kubernetes。
- 自带 OpenTelemetry 追踪与内置追踪查看器、Prometheus 指标以及命令行备份恢复,运维可观测性完整。
- 界面支持 31 种以上语言、明暗主题和命令面板,移动端可窄至 375px。
- Actions、Packages、代码所有者、签名提交、内联评审、SAML 2.0 等重要功能在 README 中标注为仍在开发中,生产采用需评估成熟度。
- REST API 仍为实验性支持,接口稳定性存在风险。
- 需要自行准备并维护数据库(PostgreSQL/MySQL/SQLite3)和服务器,属于自托管运维成本。
- 安装步骤未在来源中给出,需依赖外部文档,首次部署信息不完整。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示这是自托管 Git 服务本体,而非受限权限的 Agent 产品:AGENTS.md/CLAUDE.md 授予 gh CLI、Chrome DevTools MCP、git push/PR 等广泛能力,且无逐操作确认机制,故 least_privilege 与 user_confirmation 仅 1。数据流方面,react-doctor 技能通过 curl 拉取远程 playbook 并执行 npx react-doctor@latest,属未固定版本的远程代码执行路径,透明度不足,data_flow_transparency 与 external_effects 各 1。敏感数据处理有部分亮点(SECRET_KEY 拒绝不安全默认、${ENV} 注入避免明文),但 LDAP Bind Password 明文存储、PAM 需读 /etc/shadow 被文档明确承认,故 1。依赖安全有 go.mod 固定版本、CI 中 trivy 扫描与 action 按 SHA 固定,但未见漏洞审计报告,给 2。回滚方面仅 README 提及 backup/restore 命令,无具体流程证据,给 1。来源归属有 LICENSE 与致谢,给 2。
self_consistency:AGENTS.md 与 CLAUDE.md 内容一致,README 与安装文档描述一致,给 2。dependency_availability:go.mod 依赖版本明确、CI 覆盖多平台与多数据库,给 2。failure_messages:troubleshooting 文档给出具体错误文本与解决方案,main.go 有 FatalContext 错误输出,给 2;但未见运行时错误分类的完整证据,未给满分。
audience_and_scenarios:文档覆盖部署、管理、开发多场景,给 2。capability_boundaries:README 用星号标注“开发中”功能,但边界描述较粗,给 1。trigger_precision:技能触发依赖 /ghsa、/doctor 等命令,描述较宽泛,给 1。environment_fit:明确支持 Linux/macOS/Windows/ARM、多数据库、Docker/K8s,给 2。
install_notes 详尽(前置条件、数据库初始化、四种安装方式、配置示例),给 3。license 为完整 MIT 文本,给 3。information_architecture 有 docs 分层与 FAQ,给 2。naming_stability 有版本号 0.15.0+dev 与 CHANGELOG 引用,但未见 CHANGELOG 内容,给 2。examples_and_faq 有 FAQ 与示例,给 2。known_limitations 有星号标注与 troubleshooting,给 2。versioning_changelog 仅引用 CHANGELOG.md 未提供内容,给 2。maintenance_responsibility:SECURITY.md 说明支持版本与流程,但发布者身份未验证,给 1。
output_usability:作为 Git 服务产品输出可用,文档可直接指导部署,给 2。marginal_value:自托管 Git 服务有明确价值,但市场同类多,给 2。cost_benefit:单二进制、低硬件要求,成本效益好,给 2;但未执行验证,未给 3。
claim_traceability:README 大量功能声明(Actions、Packages 等)标注开发中但无对应代码证据,给 1。cross_source_corroboration:README、安装文档、CI 工作流相互印证,给 2。fact_inference_separation:文档混合事实与愿景,未明确区分,给 1。
- react-doctor 技能通过 curl 拉取远程 playbook 并执行 npx react-doctor@latest,属未固定版本的远程代码执行,需谨慎。
- LDAP Bind Password 明文存储,PAM 认证需读取 /etc/shadow,部署时须限制权限。
- AGENTS.md/CLAUDE.md 授予 gh CLI、Chrome DevTools MCP、git push/PR 等广泛能力,无逐操作确认。
- README 中 Actions、Packages、SAML 等功能标注为开发中,生产使用前需核实实际可用性。
- 发布者身份未经 FollowAgents 验证,维护责任与更新路径需自行确认。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Changed - Lowering [auth] ACTIVATE_CODE_LIVES or [auth] RESET_PASSWORD_CODE_LIVES now also shortens the lifetime of activation, email confirmation, and password reset links already sent. [#8478](https://github.com/gogs/gogs/pull/8478) Fixed - _Security:_ On Windows hosts, a user creating a repository with initial files or initializing its labels could read files on the server, including the configuration file. [#8488](https://github.com/gogs/gogs/pull/8488) - [GHSA-fv2v-vwmj-j74p](https://github.com/gogs/gogs/security/advisories/GHSA-fv2v-vwmj-j74p) …在 GitHub 查看 ↗ -
v0.14.3 0.14.3
发布说明摘录
ℹ️ Heads up! There is a new patch release [0.14.4](https://github.com/gogs/gogs/releases/tag/v0.14.4) available, we recommend directly installing or upgrading to that version. Fixed - _Security:_ Reverse proxy authentication header was honored from any remote address, allowing user impersonation when Gogs was reachable directly. The header is now only trusted from addresses listed in [auth] TRUSTED_PROXY_IPS. [#8264](https://github.com/gogs/gogs/pull/8264) - [GHSA-w6j9-vw59-27wv](https://github.com/gogs/gogs/security/advisories/GHSA-w6j9-vw59-27wv) …在 GitHub 查看 ↗ -
v0.14.2 0.14.2
常见问题
Gogs 需要付费吗?
最低硬件要求是多少?
哪些功能还不适合生产使用?
支持哪些数据库?
浏览器兼容性如何?
Gogs 官网是什么?
Gogs 开源吗?
Gogs 安全吗?
Gogs 还在维护吗?
Gogs 是谁开发的?
谢谢反馈,我们会据此改进页面。