极空间NAS搭建Gitea私有代码仓库全攻略

1. 为什么要在极空间NAS上搭建私有代码仓库？

如果你和我一样，是个喜欢折腾的开发者，或者是一个小团队的负责人，肯定遇到过这样的烦恼：代码放哪里才安心？用公共的Git服务，比如GitHub、Gitee，免费版有仓库数量或协作人数的限制，而且代码毕竟是放在别人的服务器上，心里总有点不踏实。尤其是涉及一些内部工具、未公开的项目，或者只是想有个纯粹、无干扰的代码备份地，一个完全由自己掌控的私有代码仓库就成了刚需。

这时候，你手头的极空间NAS就派上大用场了。它不仅仅是个存电影、放照片的家庭数据中心，更是一个潜力巨大的个人服务器。通过Docker，我们可以在上面轻松部署各种服务，Gitea就是其中之一。Gitea是一个用Go语言写的、轻量级的自托管Git服务，你可以把它理解成一个开源的、可以自己部署的“迷你GitHub”。它的界面友好，功能齐全，支持Issue、Pull Request、Webhook等，对于个人或小团队来说完全够用。

在极空间上搞这个，好处太多了。首先是数据完全私有，你的所有代码资产都躺在自家的硬盘里，安全感和掌控感是云服务给不了的。其次是成本极低，除了电费和设备折旧，几乎没有额外开销。最后是高度集成，你的代码仓库可以和NAS上其他服务（比如自动备份、内网文件共享）无缝结合，打造一个完全属于你自己的开发工作流。

不过，极空间的Docker环境和我们常见的Linux服务器有点不一样。它做了很多图形化封装，对新手友好，但同时也“隐藏”了一些底层细节。这就导致网上很多标准的Docker命令行教程，在极空间上不能直接照搬。我当初也是折腾了一晚上，踩了好几个坑才成功。所以这篇攻略，我会把每一步的操作、每一个配置项的含义，以及我踩过的那些坑，都掰开揉碎了讲清楚，保证你跟着做就能成功搭建起自己的私有Git服务器。

2. 准备工作：获取正确的Docker镜像

万事开头难，在极空间上部署Gitea，第一步“获取镜像”就可能是个拦路虎。因为极空间NAS的CPU架构大多是ARM（比如常见的瑞芯微RK3568），而我们在电脑上默认拉取的Docker镜像通常是x86_64架构的，直接使用会报“架构不匹配”的错误。所以，我们必须获取ARM64版本的镜像。这里我提供了三种方法，总有一种适合你。

2.1 首选方案：尝试极空间自带镜像库

最省事的方法当然是直接用极空间Docker应用自带的“镜像”功能。你打开极空间客户端，进入Docker，找到“镜像”标签页，在右上角的搜索框里直接搜索 gitea/gitea 和 mysql。

如果运气好，能直接搜到并成功下载，那恭喜你，可以跳过后面所有麻烦的步骤，直接进入配置环节。但根据我的经验（以及很多网友的反馈），这个自带的镜像源有时候不太稳定，或者搜不到我们需要的特定镜像。如果你搜不到，或者下载失败，别慌，我们还有备选方案。

2.2 备用方案A：从其他系统下载并上传

如果极空间自带的镜像库不好用，我们可以“曲线救国”。找一台能正常访问Docker Hub的电脑（比如一台Windows或Mac电脑），在上面用命令行下载好正确的镜像，然后打包上传到极空间。

关键操作在这里： 在你电脑的终端（Windows用CMD或PowerShell，Mac/Linux用Terminal）里，执行拉取命令时，必须指定平台为 arm64。这是整个操作成败的核心。

docker pull gitea/gitea:latest --platform=arm64
docker pull mysql:latest --platform=arm64

这两条命令中的 --platform=arm64 参数就是告诉Docker：“别给我默认的x86版本，我要ARM64的。” 下载完成后，我们可以用 docker images 命令查看一下，确认镜像已经躺在本