代码和配置也该有个自家仓库:用 NAS 上的 Gitea 管好你的私有项目

写程序的都知道,代码放在别人的平台上方便,但也意味着把项目的节奏和数据交给了别人。私人小项目、家里自动化脚本、给 NAS 写的小工具,常常既不想公开,又希望能像正经工程那样做版本管理、能回退、能留痕。Gitea 就是一个可以装在自己 NAS 上的轻量代码仓库,用 Go 写成,单个容器就能跑,占用资源很小。这篇文章按部署、建库、日常使用的顺序走一遍,讲讲怎么在自家里搭一个安心的 Git 服务。

为什么值得在家自建一个代码仓库

公共代码托管平台确实好用,但有些东西并不适合放上去:写了一半的私人项目、带家庭网络拓扑和内网地址的自动化脚本、记录着设备信息的配置文件。这些放进公开仓库不合适,放进私有仓库又要长期依赖平台。自建 Gitea 的价值不在于省那点钱,而在于数据完全在自己手里,断网也能提交和查看,还能顺便把家庭项目当成一个正经工程来练手。对搭了 NAS 的玩家来说,机器 24 小时开着,多跑一个轻量容器几乎感觉不到负担。

部署:一个容器就能起步

主流 NAS 的套件中心或 Docker 面板里都能找到 Gitea 镜像。部署时最关键的是把数据目录挂载出来,一般用两个卷,一个放配置文件,一个放仓库数据,这样以后升级容器或重装系统,代码都不会丢。端口映射可以按习惯来,比如把容器的 3000 端口映射到一个自建端口。数据库建议直接用自带的 SQLite,对个人和小家庭完全够用,省去再维护一个 MySQL 的麻烦。

容器起来后,通过浏览器访问对应地址和端口,会进入初始化页面。这里有几个设置务必留心:仓库根目录保持默认的数据路径即可; SMTP 邮件先可以跳过,后面需要提醒时再配;最重要的是把默认端口、域名和根 URL 填成你实际访问的样子,否则仓库里的克隆地址会生成错误。初始化完成后,第一件事就是回到管理后台关闭开放注册,避免任何人都能来建账号。

建库、配密钥、推送第一个提交

先在自己的账号下新建一个仓库,填上名称和描述,私有性质按需勾选。然后在本地生成一对 SSH 密钥,把公钥粘贴到 Gitea 的个人设置里,之后就能免密推送。克隆地址留意页面给出的 SSH 形式,端口如果改过要在地址里带上。第一次推送前,记得在本地配置好提交用的用户名和邮箱,否则提交会被拒绝。

跑通第一个提交后,就可以把家庭项目陆续搬进来:智能中控的配置文件、NAS 上脚本的版本、甚至家里的连线说明文档。文本类的东西放进 Git,改了什么、什么时候改的、想回退到哪一版,都有据可查。配合平台的 Issues 功能,还能当成一个轻量的任务清单,记录待办和踩过的坑。

安全和备份这两件事别偷懒

Gitea 本身不复杂,真正要上心的是暴露面。如果只在家里用,就把访问限制在内网,配合现有的一层反向代理和 HTTPS 对外提供访问即可,不要图省事把管理端口裸奔在公网。账号一律强密码,管理员账号最好再开两步验证。前面提到的关闭注册也很关键,这是防止被当成垃圾仓库宿主的基本功。

备份方面,代码仓库是最不能丢的数据之一。因为已经做了数据卷挂载,只要把 Gitea 的数据目录纳入现有的定时备份,跟着其他重要数据一起做多份和异地保存就行。改配置或升级版本前,先手动备份一次数据目录,出问题能快速回滚。有条件的话,偶尔从另一台设备克隆一次仓库验证完整性,确认备份真的能恢复。

写在最后

自建 Gitea 的门槛比想象中低,一个容器、一次初始化、一根 SSH 密钥就能用起来。它不会替代公共平台上的开源协作,但在存放私人代码、家庭脚本和配置文档这件事上,能给你一份实实在在的掌控感。数据在自己盘里,断网照用,改动有迹可循。如果你本来就有一台常开的 NAS,不妨找个空闲时间搭一个,把散落在各处的小项目收进自己的仓库里,慢慢养成版本管理的好习惯。

这篇文章让你感觉:
本文为原创文章,转载请注明出处。
作者:孙亮亮
原文链接:https://so.sunliangliang.cn/post/5110.html

还没有评论,快来抢沙发吧!

发表评论

😀 😂 🤔 👍 ❤️ 🔥 🎉 😢 🙏 ✨