返回教程列表

飞牛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替代方案,数据完全自主可控。

返回教程列表