news 2025/12/29 5:54:23

绿联 NAS(DH4300 Plus)上部署私有 Git 仓库

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
绿联 NAS(DH4300 Plus)上部署私有 Git 仓库

在《老登的新玩具:NAS》一文中,我简单介绍了新购置的 NAS 设备。最初入手 NAS 的主要目的,其实很单纯——备份照片,同时作为家庭影视库使用。前段时间也确实“物尽其用”,补完了不少经典电影和美剧。

但副作用也很明显:一连几周,公众号几乎停更,技术研究也被搁置到了一旁。好在待看片单已经清空,现在终于可以把注意力重新拉回到正事上,认真思考一下 NAS 还能发挥哪些价值。

NAS 的用途很多,而我首先想到的,就是用它来搭建一个私有的 Git 代码仓库。

目前市面上的 Git 托管服务非常成熟,国外有 GitHub、GitLab,国内也有 Gitee、Coding 等选择。这些平台大多提供免费的私有仓库,稳定性、可用性和运维保障都相当成熟。从“省心”的角度来看,似乎并没有自己部署 Git 服务的必要。

但问题也恰恰出在这里。

对于个人用户而言,这类托管平台通常都会对仓库容量设定上限,常见的限制是 1G,github 比较大气一些,也不超过 10 GB。而我目前基于 Chromium 进行浏览器产品开发,即便不导入完整的 Chromium Git 历史,仅保留源码本身,加上构建所需的一系列二进制工具,整体体积也早已超过 10 GB。如果要导入完整的 Chromium Git 历史,那容量要直奔 100G 了。

所以,mojo-browser项目只能长期存放在本地开发机上,既不便于多设备协作,也缺乏可靠的备份机制。

现在有了大容量的 NAS,貌似有了新的解决方案。一方面,NAS 的存储空间足够充裕,完全可以承载这类“重量级”代码仓库;另一方面,NAS 本身可以配置定期自动备份,无论是硬盘故障还是误操作,都能多一层数据安全保障。

Git 软件选择

市面上成熟的 Git 服务器实现并不少,我最先考虑的是 GitLab。一方面是因为在日常工作中在使用,对其功能比较熟悉;另一方面,GitLab 在权限管理、CI/CD、审计和生态完整性方面确实非常强大。

但在进一步调研之后,我很快意识到:GitLab 并不适合部署在 NAS 这类轻量级设备上

GitLab 并不是一个“单体服务”,而是一整套复杂的服务集群,核心组件就包括 PostgreSQL、Redis、Sidekiq、Gitaly、Prometheus 等。这些组件对 CPU 性能、内存容量以及磁盘 IOPS 都比较敏感,哪怕只是小规模自用,也很难算得上“轻量”。

官方给出的硬件要求如下:

项目

官方最低要求

实际推荐

CPU

4 核

4–8 核

内存

4 GB8 GB 及以上

硬盘

10 GB 以上

20–50 GB

而我使用的绿联 DH4300 Plus 搭载的是 ARM 架构的 RK3588C 处理器,8 核 8 线程,主频 1.8 GHz,内存为 8 GB。在这台设备上运行 GitLab,大概率会出现响应迟缓、资源占用过高,甚至稳定性问题。

何况这台 NAS 还要进行照片备份,音视频播放,不能让 Git 服务吃掉太多的内存和 CPU。

综合权衡之后,我最终选择了Gitea。相比 GitLab,Gitea 架构极为简洁,单一二进制即可运行,对 CPU 和内存的需求都要低得多;同时在代码托管、权限管理、Webhook、基础 CI 集成等方面,已经完全能够满足个人和小团队的开发需求。

安装 Gitea

绿联 NAS 原生支持 Docker,因此这里直接采用 Docker 部署 的方式,这是目前最简单、也最稳定的安装方案。

首先进入 NAS 的 Docker 管理界面,在镜像仓库中搜索 gitea,选择下载量最多、维护最活跃的官方镜像进行下载。

如果在拉取镜像过程中速度较慢或失败,可以为 Docker 配置镜像加速器,例如:https://docker.1ms.run。

镜像下载完成后,基于该镜像创建 Gitea 容器。

在容器设置中,建议勾选 “自动重启”,以确保 NAS 重启或 Docker 服务异常恢复后,Gitea 能够自动启动。

其余选项保持默认即可,无需额外修改。这里需要特别留意端口映射关系,后续访问和 Git 操作会用到该端口。

容器启动后,点击容器右侧的快速访问,即可进入 Gitea 的初始化配置页面。

在大多数个人使用场景下,直接采用默认配置即可,点击 “立即安装” 完成初始化。需要注意的是:

第一个注册的用户将自动成为 Gitea 的系统管理员。

安装完成后,即可看到熟悉的 Gitea 管理界面:

这里需要特别说明一个容易踩到的问题。

绿联 NAS 提供的内网穿透服务,本质上只支持浏览器访问,并且需要经过登录认证。当尝试通过外网地址进行 Git 克隆时,无论是 SSH 还是 HTTPS,都会失败,例如:

$ git clone git@app-39639-mojo.cn24.ugdocker.link:mogoweb/mojo-browser.git mojo-browser-gitea 正克隆到 'mojo-browser-gitea'... ssh: connect to host app-39639-mojo.cn24.ugdocker.link port 22: Connection refused 致命错误:无法读取远程仓库。 请确认您有正确的访问权限并且仓库存在。 $ git clone https://app-39639-mojo.cn24.ugdocker.link/mogoweb/mojo-browser.git mojo-browser-gitea 正克隆到 'mojo-browser-gitea'... 致命错误:无法访问 'https://app-39639-mojo.cn24.ugdocker.link/mogoweb/mojo-browser.git/':Failed to connect to mojo.cn24.ug.link port 80 after 10562 ms: Could not connect to server

这是由于内网穿透并未对 Git 协议(SSH / HTTP)提供直通支持所导致的。

解决办法也很简单:在局域网环境下,直接使用 NAS 的内网 IP 地址和映射端口进行访问,例如:

$ git clone http://192.168.3.7:39639/mogoweb/mojo-browser.git mojo-browser-gitea

至此,一个运行在绿联 NAS 上的私有 Git 仓库就已经成功部署完成了。

NAS 远不只是一个“存照片和电影的盒子”,围绕开发和基础设施还有不少值得折腾的玩法,后续如果有新的实践,也会继续记录。敬请关注,欢迎交流。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2025/12/24 1:33:39

如何通过WisdomSSH在服务器执行一些运维任务,例如部署jenkins

Wisdom SSH 是一款集成了 AI 运维助手的远程 SSH 客户端工具,专为提升服务器管理效率和完成复杂运维任务而设计。虽然您的来源中没有直接提供部署 Jenkins 的具体教程,但我们可以根据 Wisdom SSH AI 助手的核心功能和提供的示例(例如 MySQL 备…

作者头像 李华
网站建设 2025/12/24 5:51:05

零代码构建企业级AI知识库实战指南

零代码构建企业级AI知识库实战指南 在一家中型科技公司,新入职的客户支持专员小李花了整整三天才勉强搞懂产品的核心功能。他翻遍了网盘里的PDF手册、飞书文档和历史聊天记录,却始终找不到一份清晰完整的操作指引。而与此同时,资深同事每天要…

作者头像 李华
网站建设 2025/12/26 12:48:03

ipv6动态域名解析和Ipv6静态域名解析的区别

IPv6 动态域名解析(DDNS)和静态域名解析的核心区别在于域名与 IPv6 地址的绑定关系是否固定,以及适用场景的不同。以下是两者的详细对比和关键特性分析:一、核心定义与绑定关系IPv6 静态域名解析是将域名与固定不变的 IPv6 地址进…

作者头像 李华
网站建设 2025/12/24 17:25:35

Excalidraw API详解与实战使用示例

Excalidraw API详解与实战使用示例 在现代团队协作中,可视化表达已成为沟通的核心方式。无论是产品原型设计、系统架构讨论,还是教学演示和头脑风暴,一张“能说清楚问题”的草图往往胜过千言万语。而 Excalidraw 正是为此而生——它不仅以独特…

作者头像 李华
网站建设 2025/12/24 18:56:15

HunyuanVideo-Foley支持Docker部署,实现AI音效自动化

HunyuanVideo-Foley 支持 Docker 部署,实现 AI 音效自动化 🎧⚡ 你有没有经历过这样的窘境:视频剪辑已经进入尾声,画面节奏完美、转场丝滑,结果卡在了“缺个关门声”“少点风声氛围”这种细节上?找音效库翻…

作者头像 李华
网站建设 2025/12/24 10:52:03

LangFlow在CRM系统智能化升级中的价值

LangFlow在CRM系统智能化升级中的价值 在客户体验成为企业竞争核心的今天,如何让CRM系统真正“懂”客户,而不是仅仅记录客户信息,已成为数字化转型的关键命题。传统CRM依赖预设规则和人工介入处理客户请求,面对复杂多变的服务场景…

作者头像 李华