返回教程列表
飞牛NAS部署Gitea自建私有Git代码仓库
2026-07-22
Gitea是一个轻量级的自托管Git服务,界面跟GitHub很像但完全跑在你自己的NAS上,代码不经过任何第三方服务器。对于开发者来说在NAS上搭一个私有Git仓库既安全又方便,下面讲讲怎么部署。
一、为什么用Gitea而不是GitLab
GitLab功能强大但太重了,跑起来吃内存吃CPU,NAS跑着可能会影响其他服务。Gitea是Go语言写的,编译后只有一个二进制文件,资源占用极低,256MB内存就能跑起来。界面清爽功能够用,支持仓库管理、Issue追踪、Pull Request、CI/CD(配合Drone)、LDAP认证等。个人或者小团队用Gitea完全够了。
二、Docker部署Gitea
打开飞牛NAS的Docker管理器,拉取镜像并创建容器:
镜像:gitea/gitea:latest
容器名:gitea
端口映射:
- 3000 → 本地3000(Web界面)
- 222 → 本地22(SSH克隆端口,避免跟NAS本身的SSH冲突)
存储卷映射:
- /docker/gitea/data → 容器内 /data(数据目录,仓库、配置都在这里)
- /docker/gitea/config → 容器内 /etc/gitea(配置文件目录)
环境变量:
- GITEA__database__DB_TYPE=sqlite3(用SQLite最简单,不需要额外装数据库)
- GITEA__server__ROOT_URL=http://你的NAS内网IP:3000/(浏览器访问地址)
- GITEA__server__SSH_PORT=222(SSH克隆端口)
- TZ=Asia/Shanghai
创建启动后访问 http://NAS内网IP:3000 进入初始化页面。
三、初始化配置
首次打开会进入安装向导:
1. 数据库选SQLite3,保持默认路径
2. 填写站点名称(比如「大禹代码库」)
3. 设置管理员用户名和密码
4. SSH端口填222
5. 点击「安装Gitea」等待完成
安装完成后自动跳转到登录页面,用刚才设置的管理员账号登录。
四、基本使用
创建仓库:点右上角加号→新建仓库→填名称和描述→勾选「初始化仓库」→创建。仓库创建好后可以用HTTPS或SSH方式克隆到本地。SSH克隆地址格式是 ssh://git@你的NASIP:222/用户名/仓库名.git。
添加SSH密钥:点右上角头像→设置→SSH公钥→粘贴你电脑的公钥(终端执行 cat ~/.ssh/id_rsa.pub 获取)。添加后就能用SSH方式免密码拉取推送代码了。
创建组织和团队:如果你有多个项目或者跟朋友一起开发,可以创建组织把大家加进来设置不同的仓库权限。
五、实用功能
1. Fork和Pull Request:支持类似GitHub的协作流程,提交代码→创建PR→代码审查→合并。
2. Issue和里程碑:用Issue跟踪Bug和需求,用里程碑管理版本进度。
3. Webhook:配置Webhook可以实现代码推送后自动触发构建、部署等操作。
4. LFS支持:大文件用Git LFS管理,Gitea原生支持不需要额外配置。
5. 私有仓库:所有代码都在你NAS本地,不用担心GitHub封号或者代码泄露的问题。
对于个人开发者来说Gitea加上飞牛NAS就是一个完美的私有GitHub替代方案,数据完全自主可控。
返回教程列表