保姆级教程，自建公网可访问的Git私有仓库

0.1 环境背景

互联完公司的产品项目，离不开多名工程师的协同开发，以及离不开Git仓库。

Git在线仓库众多，但是对于大点的需求，大概率要付费，最大的风险还是源码不在自己手上。

随着互联网的安全监管越来越多，越来越全，**************************

总之内，如果是个大公司，项目源码在自己手上是最安全的；

如果是小公司，搭建一个内部的Git仓库是非常方便的，降低成本。偶尔Git仓库需要外网，只需要映射到公网即可。

那我们这次就来学习，搭建一个私有Git仓库，并接入公网访问。

0.2 思路分析

私有Git仓库，需要多账号管理、多账号管理、权限管理、数据存储等等，一个Git仓库该有的功能，都应该有。

另外，还得顾忌部署简单、丰富可拓展的特点，这里直接选择开源的Gitea项目，可以直接使用，还可以二次开发。

本地仓库部署好之后，还需要从公网访问本地的Git仓库。

对比其他的服务，Git所需的网络特点：

• 不连续，只有pull和push的时候需要同步；
• 网速要求高，速度越快传输越快；
• 只有外网有需求时，才需要联网，不需要长年连接网络；

针对以上特点，推荐使用内网云(neiwangyun.net) - 基于SSH协议的内网穿透服务服务，优势有：

• 按月付费，最低一个月5元，成本低，需要时再开；
• 无客户端，每台电脑都会有ssh命令，包括win7、win10、win11；
• Gitea有两个端口，配合内网云的服务，可选ssh服务和http服务；
  • 只转发ssh，则外网可用ssh同步，但是无法访问网页，保障网页信息和仓库的安全；
  • 同时转发ssh和http，则外网有内网一样的体验；

• 单条隧道同时支持http、https、IP端口三种连接方式，即一条隧道包含：
  • 一个二级域名【免费】；
  • 一个开放的端口号【免费】；
  • 一个SSL安全证书【免费】；
  • 同时支持http和https协议【免费】；
  • 一个固定速度的网络带宽【收费】；

0.3 物料准备

服务器系统：Debian 11【只要是Linux/Macos都行，虚拟机中的Linux系统也行】

预装环境：Docker、Docker-Compose、Supervisor【进程管理工具】

Gitea程序：docker-compose.yml

version: "3"
​
networks:
  gitea:
    external: false
​
services:
  server:
    image: gitea/gitea:1.16.7
    container_name: gitea
    restart: always
    networks:
      - gitea
    volumes:
      - /root/gitea-data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "10022:22"

内网云隧道：两条隧道，请根据需要自行购买1条或2条，或者使用免费隧道测试。

免费隧道：ssh -R 80:127.0.0.1:8000 sh@sh3.neiwangyun.net

付费隧道：

1. Gitea-Web是给Gitea的web界面准备的隧道，方便浏览器访问web界面，以及输入账号密码的pull和push功能
2. Gitea-SSH是给Gitea的ssh准备的隧道，ssh方便使用秘钥实现免密的pull和push功能

1. 搭建本地Gitea仓库

首先在本地的Debian系统中，搭建Gitea仓库。

上面有个docker-compose.yml文件，具体的使用方式，是将这个文件放到一个空文件夹中，例如gitea-docker文件夹

准备就绪之后，使用docker-compose命令，docker-compose up，可以直接生成Docker镜像，以及直接运行Docker容器，如下图：

启动之后，就可以访问IP:Port，我这里是 192.168.100.33:3000，就可以看到Gitea的部署页面了

此时的终端是docker-compose运行状态，可以选择ctrl+c，先停止运行，则Gitea关闭。

因为docker-compose up会新建镜像，并运行容器，所以现在可以启动容器即可，就可以重新运行Gitea容器。

PS：docker start 3b7中的3b7，是上一行的Container ID，也叫做容器ID，可以简写，可以写全，都行。

2. Git仓库环境配

Gitea配置信息的设置，第一步就是URL。

因为Gitea是Docker访问，所以在本地，使用IP：3000的形式，可以直接访问。

那在配置的时候，为了方便起见，直接将服务器域名和基础URL都设置成Gitea-Web的网址就行了。

服务器域名，直接是一个二级域名，直接填。基础URL这个，包含http协议的，你写https可以，写https也行。

URL填好之后，看到下面的可选设置，其中管理员账号设置，这个很有必要。

打开管理员账号设置，填上用户名、管理员密码、确认密码以及一个电子邮件地址。

这个电子邮件地址不需要邮件验证码确认，能记住即可。

填完之后，点击立即安装，需要点时间等待。

等待结束，如果页面刷新不出来，别怕，网址填IP:PORT，例如我的 192.168.100.33：3000，多刷两遍。

3. Gitea接入公网访问

前面在Gitea的配置界面，已经把公网URL写进了配置文件，但是还不能直接访问，因为还没把端口接入公网。

首先打开内网云的控制台，控制台左侧的内容栏，找到可用隧道并点击，也就是上面的第三个图。

看到Gitea-Web的卡片，操作那里有个查看，点击查看按钮，弹出一个新的界面。

图中框中的部分，一个是域名，也就是写进Gitea配置信息的；另一个就是Gitea所在主机接入公网的命令。

复制命令，将里面的8000改成3000，因为Gitea的web界面是3000端口。

命令改好之后，到Gitea所在的主机上，打开终端Terminal，粘贴命令并运行，如下图：

终端中展示出了username、http、https，说明接入公网成功，可以使用浏览器打开公网的域名了，如下：

如果有报错，或者正常运行但是打不开，请联系内网云的客服，内网云提供7*24小时的手把手技术支持。

4. Git仓库配置更改

在进入web和ssh端口测试，以及端口公网测试的时候，先来说一下Gitea配置完成之后的配置信息修改。

Gitea是Docker形式部署，所以Gitea端口有Docker一套，宿主主机一套。

当前我的Gitea-Docker部署，端口对应情况是：

• 宿主主机是3000的web端口，对应Docker中的3000端口；
• 宿主主机是10022的ssh端口，对应Docker中的22端口；

Docker中的端口通常是不能改的，宿主主机的端口，在Docker启动后也是不能改的。

内置的配置无法改动，这是正常运行的配置；但是显示界面的内容是可以改动的，我们需要自定义。

例如域名：http://xayxfmsh3.neiwangyun.net；

现在来打开Gitea的配置文件，文件位置在docker-compose.yml写明了，在/root/gitea-data:/data这里。

具体路径是：/root/gitea-data/gitea/conf/，文件名是app.ini。

打开app.ini，开始备注特定的字段，并修改成我们需要的内容。

APP_NAME = 内网云-Gitea
RUN_MODE = prod
RUN_USER = git
​
[repository]
ROOT = /data/git/repositories
​
[repository.local]
LOCAL_COPY_PATH = /data/gitea/tmp/local-repo
​
[repository.upload]
TEMP_PATH = /data/gitea/uploads
​
[server]
APP_DATA_PATH    = /data/gitea
DOMAIN           = xayxfmsh3.neiwangyun.net  # WEB的域名
SSH_DOMAIN       = xayxfmsh3.neiwangyun.net  # SSH的域名
HTTP_PORT        = 3000  #  不建议修改
ROOT_URL         = http://xayxfmsh3.neiwangyun.net/  # 根路由
DISABLE_SSH      = false
SSH_PORT         = 10022  # SSH的端口，可以修改，这里应该对应docker-compose.yml中的 10022
SSH_LISTEN_PORT  = 22  # SSH的监听端口，不要修改
LFS_START_SERVER = true
LFS_CONTENT_PATH = /data/git/lfs
LFS_JWT_SECRET   = DANys3I8hRddYjaMYd1ky7aiZ-8uxE1f1OxtKM2tagY
OFFLINE_MODE     = false

详细介绍：

1. Domain和SSH_Domain是两个值，可以是两个不同的值；
2. HTTP_PORT对应的是我们的docker-compose.yml文件中的3000端口，不用修改
3. ROOT_URL是根路由，默认写Web的URL就可以了。
4. SSH_PORT是SSH的显示端口，默认是22，这里应该对应docker-compose.yml中的 10022
5. SSH_LISTEN_PORT是监听端口，这里不能修改

其他的未备注信息的字段，使用默认的配置即可，不改动。

重点说明：更改了配置文件，一定要重启Gitea这个Docker，一定要重启。

配置信息就介绍到此，当然这个app.ini中的这几个字段，只是我截取的一部分，下面还有很多可配置字段信息。

5. HTTP和SSh的仓库同步测试

URL配置好了，SSH的10022端口也配置好了，现在开始测试了。

预处理：新建一个仓库，里面有文件即可。

使用本地IP:PORT，即192.168.100.33:3000，仓库名称随意，里面选择包含一个.gitignore文件，如下图：

配置完成之后，点击生成仓库，然后自动跳转到新仓库地址。

第一个是HTTP形式的仓库同步，这个用的是URL，也就是上图中的Gitea-Web隧道。

开始测试前，把Gitea-Web的隧道重启一次，就是在终端中，断开之前的链接，然后再次运行，确保隧道在运行中。

然后访问http或者http是的网址，检测下能否打开网页。

正常访问没问题，然后进入仓库，拷贝http的url，测试使用git clone命令，拷贝到本地。

因为我之前运行过git clone拷贝http链接，所以这次并未提示我输入账号密码。

正常情况下，输入账号密码是常规流程，而且很多系统或Git工具中，git会保留账号密码。

当前HTTP的git拷贝测试，没问题。接下来是SSH的拷贝测试。

6. SSH链接的Git clone拷贝测试

要使用SSH的Git clone拷贝，基础步骤：

1. 确认你要使用的电脑，先生成ssh秘钥对，将公钥放到gitea网站上
2. 启动Gitea-SSH隧道的命令，这次的端口是Gitea-SSH隧道的28716
3. 复制ssh的网址，到电脑终端中，git clone ssh网址，并回车

先生成一个SSH密钥对，命令式 ssh-keygen -t rsa -C "这里任意"，然后一路回车，就可以。

生成完成之后，生成的文件，就在你的用户主目录下的.ssh文件夹中，如下图：

生成的秘钥是一对，id_rsa和id_rsa.pub，pub后缀的文件就是公钥。

cat id_rsa.pub意思是显示这个文件的内容，把这个内容，复制，粘贴到Gitea里面，如下图示：

如上图示，三步搞定。

搞定之后，启动隧道，注意这次的隧道，是转发的服务器端口是10022端口，公网端口则是28716端口，如下：

隧道启动了，现在可以测试拷贝了，首先进到仓库，点击SSH的按钮，就会显示SSH的链接，然后复制：

回到你的电脑上，打开终端，写命令git clone ssh-link：

完成，SSH链接的公网clone测试顺利。

7. 持久化内网穿透服务

目前，Docker运行的Gitea很稳定，Gitea-Web和Gitea-SSH都是终端里面运行的，如果断开连接，则公网服务也就断了。

要想持久化，就需要借助其他工具，保持持久连接，在网络出现波动的时候，即使断了也可以自动重连。

这里推荐SuperVisor工具，简单易用。

首先在Docker所在的宿主主机进行安装，安装命令apt install supervisor，如下图：

图中显示，已安装并正常启动。

然后进到配置文件，文件位置 /etc/supervisor。

这里有一个配置文件/etc/supervisor/supervisord.conf，可以给配置文件加点内容，这样我们就可以通过web进行supervisor的管理。

打开supervisord.conf文件，往内容的底部，添加一段内容：

[inet_http_server]
port=0.0.0.0:9001
username=neiwangyun
password=neiwangyun

记住账号密码，然后重启服务，命令service supervisor restart。

如果没有报错，就打开浏览器，访问宿主主机的IP:9001，这个端口是固定的，如下图：

当前supervisor进程管理内，没有可管理的服务，因为还没添加。

现在进到/etc/supervisor/conf.d目录内，这里是存放服务的地方，我们需要新建两个文件，内容如下：

[program:gitea-web]
command=ssh -R 80:127.0.0.1:3000 buladou041@sh3.neiwangyun.net
autostart=true
autorestart=true
numprocs=1
killasgroup=true
stopasgroup=true
stderr_logfile=/etc/supervisor/conf.d/gitea-web_err.log
stdout_logfile=/etc/supervisor/conf.d/gitea-web_out.log




[program:gitea-ssh]
command=ssh -R 80:127.0.0.1:10022 buladou042@sh3.neiwangyun.net
autostart=true
autorestart=true
numprocs=1
killasgroup=true
stopasgroup=true
stderr_logfile=/etc/supervisor/conf.d/gitea-ssh_err.log
stdout_logfile=/etc/supervisor/conf.d/gitea-ssh_out.log

以上就是两个文件内容，也就是我们用的那两个隧道命令，以及拓展了一些信息。

注意，根据这个模板做你自己的进程文件，你需要更换以下内容：

1. 第一行的[program:servername]，servername自己改，这个不能和其他文件的名称重复。
2. 第二行的命令，改成你的端口，你的账号，你的命令。
3. 倒数第二行，gitea-web_err.log，gitea-web这个自己改掉即可，不要重复，不然日志很乱。
4. 倒数第一行，gitea-web_out.log，gitea-web这个自己改掉即可，不要重复，不然日志很乱。

内容准备好了，新建文件，把内容写进去。

文件名称没有特定要求，但有一点，一定要用.conf做文件后缀。

如下图：

断开之前终端里面的隧道命令，然后重启supervisor服务，再打开IP:9001的网页，如下图：

图中，running表示正常运行；如果是红色，那就是有异常了。

有问题，找内网云的客服，提供7*24小时的手把手售后服务。

到此，Gitea的本地搭建，以及公网映射服务，都搞定了，不是区域网络出问题，99%是可以使用的，稳得一批。

使用 IP:PORT 形式可以访问，URL:PORT 形式也可以自由访问。