Docker-Gitea(代码托管平台)

## Gitea_Docker(服务器)
**相关链接：**
- [Gitea Docker](https://hub.docker.com/r/gitea/gitea)
- [Gitea官方中文文档](https://docs.gitea.com/zh-cn/next/)
- [反向代理](https://docs.gitea.com/zh-cn/next/administration/reverse-proxies)

### 群辉Docker安装
`gitea/gitea`
![](/media/202208/image-553a2fdb92df4e71914d750f5ee1c1a0.png)
高权限执行容器
![](/media/202208/image-6339bd3938d749d289ee8974b857b119.png)
转载`/data`，Git数据都会存在这
![](/media/202208/image-8f695267b43f434dbcbb068f9966ece0.png)
开放端口，容器端口可以修改，要和之后配置的一致

### Dcoker run
```bash
#直接拉取最新版本，需要其它版本自己去https://hub.docker.com/找
docker pull gitea/gitea

》》》注意防火墙或安全组中放开用到的端口（例如1022和3000）
官网启动方式
docker run -d --name=gitea -p 1022:22 -p 3000:3000 -v $PWD:/data gitea/gitea:latest
本次启动方式(新增两个参数，可以根据需要选择)
docker run -d --privileged=true --restart=always --name=gitea -p 1022:22 -p 3000:3000 -v $PWD:/data gitea/gitea:latest
# --privileged=true 使用该参数，container内的root拥有真正的root权限（可根据需要选择是否要该参数）
# --restart=always  自动重启容器（可根据需要选择是否要该参数）
# -p 端口映射（宿主机端口：容器端口）
# -v 容器卷挂载 （宿主机目录 ：容器目录）
```

### [docker-compose](https://docs.gitea.cn/installation/install-with-docker-rootless)
```bash
mkdir gitea		# 创建所需文件夹
nano docker-compose.yml
```
`docker-compose.yml`
```yaml
version: "3"
services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    volumes:
      - ./gitea:/data
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "1022:22"
```
执行 `docker-compose up -d` 运行

### 配置文件
Gitea 配置文件： `.../conf/app.ini`，[官方配置说明](https://docs.gitea.cn/administration/config-cheat-sheet)
```ini
APP_NAME = mixly库  ; 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           = nas.918178.xyz  ; 域名
SSH_DOMAIN       = nas.918178.xyz  ; SSH 域名
HTTP_PORT        = 3000  ; HTTP 端口
ROOT_URL         = http://nas.918178.xyz:3000/  ; 根 URL
DISABLE_SSH      = false  ; 是否禁用 SSH
SSH_PORT         = 22  ; SSH 端口
SSH_LISTEN_PORT  = 22  ; SSH 监听端口
LFS_START_SERVER = true  ; 是否启动 LFS 服务器
LFS_CONTENT_PATH = /data/git/lfs  ; LFS 内容目录
LFS_JWT_SECRET   = 48ONPW634Nw-ql_Dk4MncchkxrdouxGP4hOwOO-r1fM  ; LFS JWT 密钥
OFFLINE_MODE     = false  ; 是否离线模式

[database]  ; 数据库配置
PATH     = /data/gitea/gitea.db  ; 数据库文件路径
DB_TYPE  = sqlite3  ; 数据库类型
HOST     = localhost:3306  ; 数据库主机
NAME     = gitea  ; 数据库名称
USER     = root  ; 数据库用户名
PASSWD   =   ; 数据库密码
LOG_SQL  = false  ; 是否记录 SQL
SCHEMA   =   ; 数据库模式
SSL_MODE = disable  ; 数据库 SSL 模式
CHARSET  = utf8  ; 数据库字符集

[indexer]  ; 索引器配置
ISSUE_INDEXER_PATH = /data/gitea/indexers/issues.bleve  ; 问题索引器路径

[session]  ; 会话配置
PROVIDER_CONFIG = /data/gitea/sessions  ; 会话提供者配置路径
PROVIDER        = file  ; 会话提供者

[picture]  ; 图片配置
AVATAR_UPLOAD_PATH            = /data/gitea/avatars  ; 头像上传路径
REPOSITORY_AVATAR_UPLOAD_PATH = /data/gitea/repo-avatars  ; 仓库头像上传路径
DISABLE_GRAVATAR              = false  ; 是否禁用 Gravatar
ENABLE_FEDERATED_AVATAR       = true  ; 是否启用联合头像

[attachment]  ; 附件配置
PATH = /data/gitea/attachments  ; 附件路径

[log]  ; 日志配置
MODE      = file  ; 日志模式
LEVEL     = info  ; 日志级别
ROUTER    = console  ; 日志路由
ROOT_PATH = /data/gitea/log  ; 日志根路径

[security]  ; 安全配置
INSTALL_LOCK                  = true  ; 是否启用安装锁
SECRET_KEY                    = f5vO164YvZ9ww2Ehpgbpg40PJXAAeb2Ww2kOJaXgxLB5NwwXWLvhehzEgeYTIatQ  ; 密钥
REVERSE_PROXY_LIMIT           = 1  ; 反向代理限制
REVERSE_PROXY_TRUSTED_PROXIES = *  ; 反向代理受信任代理
INTERNAL_TOKEN                = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYmYiOjE2NjU2NjI0MTR9.DJwQMK6R2WLC1FJp3ff53MVj8mrCEkAmv-AKq6O8og4  ; 内部令牌
PASSWORD_HASH_ALGO            = pbkdf2  ; 密码哈希算法

[service]  ; 服务配置
DISABLE_REGISTRATION              = true  ; ⭐是否禁用注册
REQUIRE_SIGNIN_VIEW               = true  ; 是否需要登录查看
REGISTER_EMAIL_CONFIRM            = false  ; 是否需要注册邮箱确认
ENABLE_NOTIFY_MAIL                = false  ; 是否启用通知邮件
ALLOW_ONLY_EXTERNAL_REGISTRATION  = false  ; 是否只允许外部注册
ENABLE_CAPTCHA                    = false  ; 是否启用验证码
DEFAULT_KEEP_EMAIL_PRIVATE        = false  ; 默认是否保持邮箱私有
DEFAULT_ALLOW_CREATE_ORGANIZATION = true  ; 默认是否允许创建组织
DEFAULT_ENABLE_TIMETRACKING       = true  ; 默认是否启用时间追踪
NO_REPLY_ADDRESS                  = noreply.localhost  ; 没有回复地址

[mailer]  ; 邮件配置
ENABLED = false  ; 是否启用邮件
; PROTOCOL = smtp  ; 邮件协议(smtp、smtps、smtp+starttls、smtp+unix、sendmail、dummy)
; SMTP_ADDR = localhost  ; SMTP 地址
; SMTP_PORT = 25  ; SMTP 端口
; USE_CLIENT_CERT = false  ; 是否使用客户端证书
; CLIENT_CERT_FILE =   ; 客户端证书文件路径
; CLIENT_KEY_FILE =  ; 客户端证书密钥文件路径
; FORCE_TRUST_SERVER_CERT = false  ; 是否强制信任服务器证书
; USER =  ; 邮件用户名
; PASSWD =  ; 邮件密码
; FROM =  ; 发件人
; ENVELOPE_FROM =  ; 邮件发件人(设置为 <> 以发送一个空地址)
; SUBJECT_PREFIX =  ; 邮件主题前缀

[openid]  ; 开放身份验证配置
ENABLE_OPENID_SIGNIN = true  ; 启用 OpenID 登录
ENABLE_OPENID_SIGNUP = true  ; 启用 OPENID 注册
```

### web配置
安装完成后打开 `http://IP:3000`
![](/media/202208/image-384651afeedf48e3b21802c0e27f80e5.png)
数据库无特殊需求，默认即可
![](/media/202208/image-ab7ee7cddd324a4ba6bc480bfd14327d.png)

![](/media/202209/image-ab9aef6ecb8142558f4741be52c1030a.png)
可以设置邮件服务
> 邮箱的SMTP主机为 域名:端口，不加端口无效
![](/media/202208/image-01e8856f4b8e4e2da2d5d980d0bfabe8.png)
管理员可以不设置，`第一个注册的用户会默认为管理员`

提交后重新打开这个页面，如果进不去就再等等，服务器需要执行配置
默认配置文件在`/data/gitea/conf/app.ini`

### Git新建项目
新建的项目是无法直接添加文件的，可以使用命令重新创建或是推送一个已创建的

## Git安装
[Git官网](https://git-scm.com/)
官网下载对应版本
`如没特殊需求，可以一直默认安装`

### 选择安装组件
![](/media/202208/image-6a6479df01704f4794b478acb78252d1.png)

### 选择开始菜单文件夹
开始文件菜单名
![](/media/202208/image-04d770457a974c5699b7f29f6262c957.png)

### 选择 Git 默认编辑器
![](/media/202208/image-8a13d5a472f845e68251dc6248010519.png)
Git 安装程序里面内置了 10 种编辑器供你挑选，比如 Atom、Notepad、Notepad++、Sublime Text、Visual Studio Code、Vim 等等，默认的是 Vim ，选择 Vim 后可以直接进行到下一步，但是 Vim 是纯命令行，操作有点难度，需要学习。如果选其他编辑器，则还需要去其官网安装后才能进行下一步。

### 项目(仓库)的主干名字
![](/media/202208/image-dde57c86d45b489ca7a9df4f2046e7f4.png)

1. Git 自己选择，名字是 master ，但是未来也有可能会改为其他名字
2. 我们自行决定，默认是 main，当然，你也可以改为其他的名字
> 第二个选项下面有个 NEW！，说很多团队已经重命名他们的默认主干名为 main . 这是因为2020 年非裔男子乔治·弗洛伊德因白人警察暴力执法惨死而掀起的 Black Lives Matter(黑人的命也是命)运动，很多人认为 master 不尊重黑人，呼吁改为 main.

### 调整 path 环境变量
![](/media/202208/image-b5e9c98dc0f14112b991fea0d98cef6c.png)
> 1. 仅从 Git Bash 使用 Git。这个的意思就是你只能通过 Git 安装后的 Git Bash 来使用 Git ，其他的什么命令提示符啊等第三方软件都不行
> 2. 是从命令行以及第三方软件进行 Git。这个就是在第一种基础上进行第三方支持，你将能够从 Git Bash，命令提示符(cmd) 和 Windows PowerShell 以及可以从 Windows 系统环境变量中寻找 Git 的任何第三方软件中使用 Git。推荐使用这个
> 3. 从命令提示符使用 Git 和可选的 Unix 工具。选择这种将覆盖 Windows 工具，如 “ find 和 sort ”。只有在了解其含义后才使用此选项。一句话，适合比较懂的人折腾

### 选择HTTPS后端传输
![](/media/202208/image-6c3396d4a445456180b07294bb679f60.png)
```
use the OpenSSL library 
Server certificates will be validated using the ca-bundle. crt file.
使用 OpenSSL 库
服务器证书将使用 ca-bundle.crt 文件进行验证。

Use the native Windows Secure Channel library
Server certificates will be validated using Windows Certificate Stores.
This option also allows you to use your company's internal Root CA certificates distributed e.g. via Active Directory Domain Services.
使用本机 Windows 安全通道库
服务器证书将使用 Windows 证书存储进行验证。
此选项还允许您使用公司内部分发的内部根 CA 证书，例如通过 Active Directory 域服务。
```

### 配置行尾符号转换
![](/media/202208/image-a70942c074034130b2bc12b93d0fe5ed.png)
```
1. 签出 Windows 样式，提交 Unix 样式的行结尾。
2. 按原样签出，提交Unix样式的行结尾。
3. 按原样签出，按原样提交。
```

### 配置终端模拟器以与 Git Bash 一起使用
![](/media/202208/image-3039b42a72bb4a4b941be8d14091a1cd.png)
```
使用 MinTTY（MSYS2的默认终端）
Git Bash 将使用 MinTTY 作为终端仿真器，该仿真器具有可调整大小的窗口非矩形选择和 Unicode 字体。
Windows 控制台程序（例如交互式 Python）必须通过 "winpty" 启动才能在 MinTTY 中运行。

使用 Windows 的默认控制台窗口
Git 将使用 Windows 的默认控制台窗口（"cmd.exe"），该窗口可与 Win32 控制台程序（例如交互式Python 或 
node.js）一起使用，但默认回滚非常有限，需要将其配置为使用 Unicode 字体才能正确显示非 ASCII 字符，并且在 
Windows 10 之前，其窗口不可随意调整大小，并且仅允许选择矩形文本。
```
推荐第一个

### 选择默认的 “git pull” 行为
![](/media/202208/image-9a7521da83e14d5693e7784a3e18002e.png)
```
默认（快进或合并）
这是 "git pull" 的标准行为：在可能的情况下将 当前分支 快进到 获取的分支，否则创建合并提交。

变基将当前分支变基到获取的分支上。如果没有本地提交要变基，则等同于快进。

只能快进快进到获取的分支。如果不可能，则失败。
```
1. merge(推荐)
2. rebase
3. 直接获取

### 选择一个凭证帮助程序
![](/media/202208/image-628d000ab93e49f18fbee1a51a86c6dd.png)
1. Git 凭证管理核心
2. Git 凭证管理
3. 不使用凭证助手

### 配置额外的选项
![](/media/202208/image-7cbf62da6bd341e991afe7a9a65dee05.png)
1. 启用文件系统缓存就是将批量读取文件系统数据并将其缓存在内存中以进行某些操作，可以显著提升性能。这个选项默认开启。
2. 启用符号链接 ，符号链接是一类特殊的文件， 其包含有一条以绝对路径或者相对路径的形式指向其它文件或者目录的引用，类似于 Windows 的快捷方式，不完全等同 类Unix（如 Linux） 下的 符号链接。因为该功能的支持需要一些条件，所以默认不开启。

### Git功能介绍
![](/media/202208/image-dec9b4c56c3444c1b0b12ac4f5d02b82.png)

## Tortoisegit(小乌龟，Git图形化)
[Tortoisegit官网](https://tortoisegit.org/download/)
支持中文，先安装主体，再安装语言包

### 提交代码到服务器
![](/media/202209/image-006697fab6ae4ca69b29992344637c06.png)
1. 修改项目文件
2. 提交本地，在本地项目的空白处点击鼠标右键，选择 【Git提交(C) -> "master"...】

> ![](/media/202209/image-5a9f3fa277874ef88c32046df66efae5.png)
在弹出提交（Commit）对话框中完成提交说明信息，和选择需要提交的文件，可根据需要新建分支，然后点击 【提交】 按钮，将修改提交到**本地仓库：**
![](/media/202209/image-4baf8d3dc26741a18a909c84925bc406.png)
弹出提交进度窗口，提交成功后还需要“推送”将本地仓库的修改推送到**远程仓库**
> ![](/media/202209/image-4af3f6215ebf4753a4e6b5733b57563c.png)

3. 同步拉取，在实际工作中，如果多人协作或者多个客户端进行修改，那么我们还要拉取别人推送到在线仓库的内容，所以在推送之前需要先执行同步拉取(Pull ...)操作

> 在本地仓库文件夹上【右击鼠标】→【Git同步】
> ![](/media/202209/image-18f5a7323d3d46edab069d1274485583.png)
> 打开Git同步窗口（包括常规操作及日志，同右击菜单快捷操作一样），点击【拉取(P)】，将远程分支拉取到本地
![](/media/202209/image-416f060afc61452f8af36ea203c23b27.png)

4. 冲突解决

> 如果服务器上的文件没有被修改过，就会直接提示已经更新到最新，那你就可以直接进行下一步“推送(H)”操作了：
![](/media/202209/image-6803ecf063a34c1ab93ce78f59190466.png)
反之，如果服务器上的文件被修

5. 编译OK

> 改过了（本地文件修改前不是最新版本)，就会提示冲突。先要解决冲突，然后再提交结果
> ![](/media/202209/image-c4bfadc755af4af7aec52a7512a73c9e.png)
> 需要注意的是，和使用TFS、SVN的习惯一样，你在修改本地内容之前，最好先 拉取（pull)一下，减少冲突的可能。

6. ***\*推送远程\****，将提交到本地仓库的修改推送到远程仓库，可以直接在提交成功后的提示窗口上点击【推送(H)...】，或者在Git同步窗口点击【推送(H)...】，鼠标右击的菜单上也有相应的快捷操作：选择 【TortoiseGit(T)】→【推送(H)...】

> 弹出推送(push)对话框：
> ![](/media/202209/image-07b84d253f4a43d885b8fff8c42cbbee.png)
> 一般保持默认,点击 “确定” 按钮
> 然后弹出推送进度界面，可能要求你输入用户名，点击【确定】，然后要求输入密码，密码输入正确后，显示推送成功界面：
> ![](/media/202209/image-7a7f93b44dcd43c38d76f8c680699bf1.png)
> 如果你按照上一小节**Tortoisegit 配置**的设置操作，则输入密码以后会记住密码。密码会明文保存在C:\Users\用户名\.git-credentials 这个文件中，请小心保存

### 设置中文
右键任何一个文件夹
![](/media/202208/image-e5fc32a4de9445d9b644f1639ea39693.png)
设置
![](/media/202208/image-8eb82ff616df440ca9ecb82f5127783c.png)

### Git文件上角标符号说明
![](/media/202209/image-114059f3567f4035b94bf13ff5ee4feb.png)

### 修复状态图标不显示问题
#### 方法1
1. 按Win+R键打开运行对话框，输入 regedit ，打开注册表；
2. 找到 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer；
3. 新建一个“字符串值”名称为 “Max Cached Icons” 值是 “2000”；
4. 重启一下电脑，看图标是否显示。

#### 方法2
1. 在弹出的注册表编辑器中找到HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers这一项
2. 找到后可以发现在该项下有很多个，而Windows Explorer Shell 支持的 Overlay Icon 最多 15 个，Windows 自身使用了 4 个，只剩 11 个可扩展使用
![](/media/202209/image-cb146f1bbfe142199c7972cd0d80e7ae.png)
3. 编辑HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers，修改tortoise相关的名称（如在名称前加一个空格前缀，并加数字）。
![](/media/202209/image-c676f56fa78d49a39ea787de7b69060d.png)
4. 重启一下电脑

### 设置邮箱
提交的话需要设置邮箱，只是克隆就不需要
![](/media/202208/image-35f7c210666d4a71ac3625173b9323c0.png)

### Git克隆
右键——Git克隆
![](/media/202208/image-e553415971114395b1c7535d5839ae48.png)

### Git提交
![](/media/202208/image-067b76de8130402388762accf5658c1b.png)
![](/media/202208/image-99a892fc8a644a4e81003de31b09aca0.png)
一定要有日志信息才能成功提交(提交并不代表文件上传了)

### Git推送
`注意，正常多人同时修改时，提交后会再克隆一下，然后处理好冲突再进行提交`
![](/media/202208/image-bec22c5ae7af4344855c8fce7b684f47.png)
不清楚可以不改
![](/media/202208/image-462e21702ffc4d81acfdae81a1da4428.png)
填写账号密码
![](/media/202208/image-ed77d43b584e4995b8962cd883fd5f5b.png)
推送成功

刷新下就可以看到我们刚推送的文件了
![](/media/202208/image-cd356b453fd94713bbaf3705403b1bf3.png)

## Gitea 更换服务器
可以吧整个映射目录保存，换到新的服务器上就行了

如果只是想要保留项目，可以仅仅保存项目
![](/media/202201/image-8bea59587a0e4a1880aca3cb2e4be9db.png)
导出这个，新服务器用户创建好了，把这些项目再放进去，重启服务
![](/media/202201/image-76e070b469a041e3a3c00b97b0b4ea2d.png)
登录，用户设置，仓库列表，里面会显示出之前移动过来的项目
收录，默认是私有库，可以更改为公有的