OneDev自托管开发平台完整实战从零搭建Git仓库与CI/CD流水线【免费下载链接】onedevThe Unified and Autonomous Development Platform项目地址: https://gitcode.com/gh_mirrors/on/onedev把 Git 托管、自动化构建、任务管理分别放在三套系统里是很多团队痛苦的源头。OneDev 这款开源的自托管开发平台把这些能力收进同一套软件让你在自有服务器上同时获得代码仓库、CI/CD 流水线和项目协作能力。本文从 Docker 部署讲起带你一步步上手项目托管、流水线配置与团队协作全程不需要写一行后端代码。先算一笔账拼装三件套到底贵在哪回想一下你现在的开发流程代码放在 Git 服务上构建交给 CI 工具任务又记在看板工具里。三套账号、三套权限、三套通知数据之间靠手工搬运。这套拼装方案至少有四个隐性成本授权与运维成本每套商业工具单独付费还要分别维护服务器和版本升级账号体系割裂成员入职要在多个系统里逐个开通离职又要逐个关闭数据孤岛合并请求、构建结果和任务状态互不相通复盘时全靠截图新人学习曲线新同事要同时熟悉多套工具的交互上手周期被拉长。如果你的团队正在经历这些不妨换一个思路把整个研发链路收进一台自托管开发平台。OneDev是什么一台装得下代码、构建与协作的自主平台OneDev 的官方定位是 The Unified and Autonomous Development Platform翻译过来就是统一且自主的开发平台。它把三个高频场景合并到同一个界面里代码托管支持 Git 协议、合并请求、分支保护与代码注解CI/CD 流水线提供可视化编辑器可配置多阶段作业、服务依赖和构建产物项目管理内置看板、问题查询、时间跟踪与服务台工单。更难得的是OneDev 对自主二字非常认真项目完整开源你既可以跑官方镜像也可以从源码构建自己的版本。它的构建逻辑在 buildspec 模块中定义代码搜索能力集中在 search 模块想深入研究的读者可以直接读源码。三步完成安装用 Docker 把 OneDev 跑起来第一步准备一台满足最低要求的机器运行 OneDev 不需要高配硬件满足以下条件即可2GB 以上内存、20GB 可用磁盘装了 Docker 的 Linux 服务器个人体验时本机安装也完全可行。第二步拉取镜像并启动容器打开终端执行下面的命令docker run -d \ --name onedev \ -p 6610:6610 \ -v /opt/onedev:/opt/onedev \ -v /var/run/docker.sock:/var/run/docker.sock \ 1dev/server命令里的关键点用注释说明一下-p 6610:6610把 Web 界面映射到主机的 6610 端口-v /opt/onedev:/opt/onedev持久化数据目录重启容器不丢数据-v /var/run/docker.sock:...透传 Docker socket让 OneDev 能在容器里拉起构建作业。如果你习惯编排工具仓库里也提供了现成的 docker-compose.yaml一条docker compose up -d就能连同 PostgreSQL 一起启动。第三步完成首次初始化浏览器打开http://localhost:6610按引导设置管理员账号、站点地址和邮件服务几秒钟后你就拥有了一台完全属于团队的开发平台。把仓库交给它项目树、代码注解与符号导航首次登录后先创建一个项目并推送你的代码。OneDev 支持父子项目结构大型团队可以用一个顶层项目把子模块、容器镜像和构建配置统一管起来界面上的项目树一眼就能看清全部层级代码阅读体验也值得一提。你可以在代码行上直接写注解并指派给同事注解会像讨论串一样挂在对应行上符号搜索和代码导航则基于语言分析实现点击变量名即可跳转定义与引用处。对新人来说这相当于内置了一个轻量级的代码阅读器理解陌生仓库的速度会明显加快。让构建自动化真正跑起来流水线编辑器与执行器CI/CD 是 OneDev 的重头戏。你可以在可视化编辑器里拖拽配置作业、设置依赖、声明服务和产物同时它会自动生成对应的 YAML 配置两种方式随时切换不会写配置的人也能把流水线搭出来。构建任务最终由执行器Job Executor承载。OneDev 支持本机 Docker、远程 Docker、Kubernetes 集群以及通过 agent 接入的各类机器生产、测试、Mac、Windows 等不同环境可以各挂一个执行器互不干扰构建过程中你还能通过内置的 Web 终端实时查看日志、进入容器排查问题不再需要 SSH 到构建机上翻日志。质量与安全防线依赖漏洞扫描与分支保护开发平台好不好用安全底线同样关键。OneDev 会在构建阶段对依赖做漏洞扫描把高危问题按严重程度分级展示并标注可用的修复版本让安全修复有据可依同时分支保护规则可以限制谁有权限推送或合并配合合并请求评审流程保证主分支的质量。值得一提的是OneDev 还提供了 AI 代码评审能力提交代码后可以自动获得机器给出的审查意见作为人工评审的补充。让协作看得见看板、查询语法与服务台任务管理不再需要另开一个工具。OneDev 的问题系统支持自定义状态流转的看板视图更实用的是它的查询语法在搜索框里输入issues.会弹出语法提示可以组合状态、指派人、里程碑、优先级等条件复杂筛选一次成型还能存成常用查询反复使用如果你的团队还要面对外部用户的反馈内置的服务台功能可以把邮件转成工单支持设置负责人、类型和优先级让用户问题和开发任务在同一个平台里闭环流转。进阶玩法MCP、AI 助手与资源体检对爱折腾的团队OneDev 还准备了两个进阶特性。第一个是 MCP 支持。OneDev 把queryIssues、getIssue、createPullRequest等能力以 MCP 服务的形式暴露出来AI 编程助手可以直接调用这些接口读写项目数据实现让 AI 真正操作你的仓库第二个是资源体检。在服务器信息页面你能直接看到内存、磁盘、JVM 运行状态必要时一键触发垃圾回收把运维工作前移到日常而不是等出问题再救火。相关 AI 能力与 MCP 实现在 ai 目录下想二次开发也有现成线索可循。写在最后给新手的三条行动建议如果你决定试一试给你三条循序渐进的建议先用最小配置跑通在本机用 Docker 起一个实例创建项目并推送代码体验完整的提交、评审、构建闭环把一条核心流水线搬过来挑团队最常用的构建流程用可视化编辑器重做一遍对比新旧流程的维护成本再把问题管理迁入从看板和查询语法开始逐步替代现有的任务工具让研发数据重新聚拢。如果团队已有现成代码需要迁移也可以git clone https://gitcode.com/gh_mirrors/on/onedev参考它的组织方式或者直接基于源码做定制。OneDev 的价值不在于某一项功能有多炫而在于它用一套自托管开发平台把代码、构建与协作重新连成了整体让团队把精力放回写代码本身。现在就打开终端跑起第一台 OneDev从一条流水线开始感受统一平台带来的顺畅节奏吧。【免费下载链接】onedevThe Unified and Autonomous Development Platform项目地址: https://gitcode.com/gh_mirrors/on/onedev创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考