保姆级教程，自建公网可访问的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 [email protected]付费隧道：
- Gitea-Web是给Gitea的web界面准备的隧道，方便浏览器访问web界面，以及输入账号密码的pull和push功能
- 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详细介绍：
- Domain和SSH_Domain是两个值，可以是两个不同的值；
- HTTP_PORT对应的是我们的docker-compose.yml文件中的3000端口，不用修改
- ROOT_URL是根路由，默认写Web的URL就可以了。
- SSH_PORT是SSH的显示端口，默认是22，这里应该对应docker-compose.yml中的 10022
- 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拷贝，基础步骤：
- 确认你要使用的电脑，先生成ssh秘钥对，将公钥放到gitea网站上
- 启动Gitea-SSH隧道的命令，这次的端口是Gitea-SSH隧道的28716
- 复制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 [email protected]
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 [email protected]
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以上就是两个文件内容，也就是我们用的那两个隧道命令，以及拓展了一些信息。
注意，根据这个模板做你自己的进程文件，你需要更换以下内容：
- 第一行的[program:servername]，servername自己改，这个不能和其他文件的名称重复。
- 第二行的命令，改成你的端口，你的账号，你的命令。
- 倒数第二行，gitea-web_err.log，gitea-web这个自己改掉即可，不要重复，不然日志很乱。
- 倒数第一行，gitea-web_out.log，gitea-web这个自己改掉即可，不要重复，不然日志很乱。
内容准备好了，新建文件，把内容写进去。
文件名称没有特定要求，但有一点，一定要用.conf做文件后缀。
如下图：
断开之前终端里面的隧道命令，然后重启supervisor服务，再打开IP:9001的网页，如下图：
图中，running表示正常运行；如果是红色，那就是有异常了。
有问题，找内网云的客服，提供7*24小时的手把手售后服务。
到此，Gitea的本地搭建，以及公网映射服务，都搞定了，不是区域网络出问题，99%是可以使用的，稳得一批。
使用 IP:PORT 形式可以访问，URL:PORT 形式也可以自由访问。