深海游弋的鱼 – 默默的点滴

GitLab的替代者-轻量级Gitea安装与配置-Windows 11

前置条件

Windows 11 专业版 24H2

podman desktop 1.17.2 x64

Gitea 1.23.6

动手实践

Windows 的本质是是安装一个 Linux 虚拟机，然后在虚拟机中安装 Gitea ，所以会出现后面需要进行端口数据转发。

# 禁用 Hyper-V 功能 
$ DISM /Online /Disable-Feature /FeatureName:Microsoft-Hyper-V 

# 启用 VirtualMachinePlatform 功能 
$ DISM /Online /Enable-Feature /All /FeatureName:VirtualMachinePlatform

# 启用 Microsoft-Windows-Subsystem-Linux 功能
$ DISM /Online /Enable-Feature /All /FeatureName:Microsoft-Windows-Subsystem-Linux 

$ wsl --update

# 使用 WSL 2.0 或者 Hyper-V 版本，但是不要通过 -v 参数进行目录映射。目录映射使用9P协议，该协议性能低下，造成严重性能问题，并且高负载，高并发下文件系统不稳定。
# 但是 WSL 1.0 文件权限不正确，默认创建的文件权限都是 777，导致权限问题。
# 建议优先使用 WSL 2.0。
# Windows 11 默认就是 WSL 2.0 但是 Windows 10 默认是 WSL 1.0 需要手工设置成 WSL 2.0。
$ wsl --set-default-version 2

$ wsl --install --no-distribution

# 由于我们的磁盘 E: 是主要的数据磁盘，因此通过软链接的方式，把 Podman 虚拟机的目录链接到E盘
$ mkdir 'E://.containers'

# 软链接到 Podman 容器目录
$ New-Item -ItemType SymbolicLink -Path ~/.local/share/containers -Target 'E://.containers'

# 指定给出 12个CPU核心 内存 50GB，磁盘2TB 此处如果不指定，默认是核心数/内存的一半，磁盘默认100GB
# 不要通过 -v 参数进行 Windows 目录映射，两者文件系统格式不同，需要通过9p协议转换，性能损失巨大，不如直接给出足够大的磁盘空间，文件直接存储在虚拟机内部
$ podman machine init --cpus 12 -m 51200 --disk-size 2000

$ podman machine start

# 配置开机自启动

# 进入容器虚拟机
$ podman machine ssh

# If your VM is rootful, run `sudo systemctl enable podman-restart.service`; if it's rootless, run `sudo systemctl --global enable podman-restart.service`; if in doubt, do both

$ sudo systemctl enable podman-restart.service

$ sudo systemctl --global enable podman-restart.service

# 创建容器目录
$ mkdir .containers

$ mkdir .containers/gitea

# 退出容器虚拟机
$ exit

$ podman pull docker.gitea.com/gitea:latest

# 此处我们 默认不导出 ssh 访问，只允许 http 访问
# 不要通过 -v 参数进行 Windows 目录映射，两者文件系统格式不同，需要通过9p协议转换，性能损失巨大，还不如直接给出足够大的磁盘空间，文件直接存储在虚拟机内部
$ podman run -d --restart always --name gitea -p 10890:3000 -v /home/user/.containers/gitea:/data gitea

# 端口转发
# 参数说明  
#    v4tov4 : IPV4协议转发到IPV4协议
#    listenport : 对外暴露的端口，其他设备访问本机的端口
#    listenaddress : 监听地址，一般都是设置成 0.0.0.0 允许任何服务器访问服务
#    connectport : podman提供的Docker容器的对外暴露端口
#    connectaddress : podman提供的Docker容器的IP地址，由于podman每次重启都可能改变容器IP，但是本机都可以通过 127.0.0.1（localhost） 访问，所以干脆直接写成 127.0.0.1
$ netsh interface portproxy add v4tov4 listenport=10880 listenaddress=0.0.0.0 connectport=10890 connectaddress=127.0.0.1 

# 防火墙放行端口，只需要允许外部访问进入即可
$ netsh advfirewall firewall add rule name="Gitea Port 10880" dir=in action=allow protocol=TCP localport=10880

# 禁用 Hyper-V 功能

$ DISM /Online /Disable-Feature /FeatureName:Microsoft-Hyper-V

# 启用 VirtualMachinePlatform 功能

$ DISM /Online /Enable-Feature /All /FeatureName:VirtualMachinePlatform

# 启用 Microsoft-Windows-Subsystem-Linux 功能

$ DISM /Online /Enable-Feature /All /FeatureName:Microsoft-Windows-Subsystem-Linux

$ wsl --update

# 使用 WSL 2.0 或者 Hyper-V 版本，但是不要通过 -v 参数进行目录映射。目录映射使用9P协议，该协议性能低下，造成严重性能问题，并且高负载，高并发下文件系统不稳定。

# 但是 WSL 1.0 文件权限不正确，默认创建的文件权限都是 777，导致权限问题。

# 建议优先使用 WSL 2.0。

# Windows 11 默认就是 WSL 2.0 但是 Windows 10 默认是 WSL 1.0 需要手工设置成 WSL 2.0。

$ wsl --set-default-version 2

$ wsl --install --no-distribution

# 由于我们的磁盘 E: 是主要的数据磁盘，因此通过软链接的方式，把 Podman 虚拟机的目录链接到E盘

$ mkdir 'E://.containers'

# 软链接到 Podman 容器目录

$ New-Item -ItemType SymbolicLink -Path ~/.local/share/containers -Target 'E://.containers'

# 指定给出 12个CPU核心内存 50GB，磁盘2TB 此处如果不指定，默认是核心数/内存的一半，磁盘默认100GB

# 不要通过 -v 参数进行 Windows 目录映射，两者文件系统格式不同，需要通过9p协议转换，性能损失巨大，不如直接给出足够大的磁盘空间，文件直接存储在虚拟机内部

$ podman machine init --cpus 12 -m 51200 --disk-size 2000

$ podman machine start

# 配置开机自启动

# 进入容器虚拟机

$ podman machine ssh

# If your VM is rootful, run `sudo systemctl enable podman-restart.service`; if it's rootless, run `sudo systemctl --global enable podman-restart.service`; if in doubt, do both

$ sudo systemctl enable podman-restart.service

$ sudo systemctl --global enable podman-restart.service

# 创建容器目录

$ mkdir .containers

$ mkdir .containers/gitea

# 退出容器虚拟机

$ exit

$ podman pull docker.gitea.com/gitea:latest

# 此处我们默认不导出 ssh 访问，只允许 http 访问

# 不要通过 -v 参数进行 Windows 目录映射，两者文件系统格式不同，需要通过9p协议转换，性能损失巨大，还不如直接给出足够大的磁盘空间，文件直接存储在虚拟机内部

$ podman run -d --restart always --name gitea -p 10890:3000 -v /home/user/.containers/gitea:/data gitea

# 端口转发

# 参数说明

# v4tov4 : IPV4协议转发到IPV4协议

# listenport : 对外暴露的端口，其他设备访问本机的端口

# listenaddress : 监听地址，一般都是设置成 0.0.0.0 允许任何服务器访问服务

# connectport : podman提供的Docker容器的对外暴露端口

# connectaddress : podman提供的Docker容器的IP地址，由于podman每次重启都可能改变容器IP，但是本机都可以通过 127.0.0.1（localhost）访问，所以干脆直接写成 127.0.0.1

$ netsh interface portproxy add v4tov4 listenport=10880 listenaddress=0.0.0.0 connectport=10890 connectaddress=127.0.0.1

# 防火墙放行端口，只需要允许外部访问进入即可

$ netsh advfirewall firewall add rule name="Gitea Port 10880" dir=in action=allow protocol=TCP localport=10880

后续如果想修改配置文件，那么需要通过 podman machine ssh 进入容器进行修改。

另外虚拟机整个被默认WSL2 挂载到 \\wsl.localhost\ 目录下，可以直接在 Windows 系统下访问，但是修改的时候可能会没有权限，还是需要通过命令行修改。

如果 Podman Desktop 没有开机自启动，确认如下如下配置是否已经勾选：

注意：如果对大型项目进行镜像部署，比如 chromium 。登录之前可以正常使用，登录特别慢，注意观察 Podman 的 Logs 项，如果观察到如下内容，特别是 [Slow SQL Query] 相关的日志输出：

2025/04/04 12:36:38 ...eb/routing/logger.go:102:func1() [I] router: completed GET /mirrors/v8/commit/bf6a80f34c17cad8f648c1305fe774d64f149b52 for 111.225.148.57:0, 404 Not Found in 2.9ms @ context/repo.go:401(context.RepoAssignment)
2025/04/04 12:41:50 ...s/repository/push.go:96:pushUpdates() [W] [Slow SQL Query] UPDATE `repository` SET `size` = ?, `git_size` = ?, `lfs_size` = ? WHERE `id`=? [1510601333 1510601333 0 9] - 26m4.248004645s
2025/04/04 12:41:50 ...ron/tasks_actions.go:51:func1() [W] [Slow SQL Query] BEGIN TRANSACTION [] - 26m22.525253949s
2025/04/04 12:41:50 ...ces/feed/notifier.go:340:PushCommits() [W] [Slow SQL Query] INSERT INTO `action` (`user_id`,`op_type`,`act_user_id`,`repo_id`,`comment_id`,`is_deleted`,`ref_name`,`is_private`,`content`,`created_unix`) VALUES (?,?,?,?,?,?,?,?,?,?) [1 push_tag 1 9 0 false refs/tags/5.4.499 false {"Commits":null,"HeadCommit":{"Sha1":"352c9d652b5920e568c8cc8298e6f786aef20653","Message":"Version 5.4.499\n\nPerformance and stability improvements on all platforms.\n\nCr-Commit-Position: refs/heads/5.4.499@{#1}\nCr-Branched-From: 6fe0b39b0167a71a1d9265c035c245c30b71b573-refs/heads/master@{#38837}\n","AuthorEmail":"v8-autoroll@chromium.org","AuthorName":"v8-autoroll@chromium.org","CommitterEmail":"v8-autoroll@chromium.org","CommitterName":"v8-autoroll@chromium.org","Timestamp":"2016-08-23T10:40:26-07:00"},"CompareURL":"v8/v8/compare/0000000000000000000000000000000000000000...352c9d652b5920e568c8cc8298e6f786aef20653","Len":0} 1743768927] - 26m22.760161949s
2025/04/04 12:41:50 ...ces/feed/notifier.go:340:PushCommits() [W] [Slow SQL Query] INSERT INTO `action` (`user_id`,`op_type`,`act_user_id`,`repo_id`,`comment_id`,`is_deleted`,`ref_name`,`is_private`,`content`,`created_unix`) VALUES (?,?,?,?,?,?,?,?,?,?) [1 push_tag 1 9 0 false refs/tags/5.6.129 false {"Commits":null,"HeadCommit":{"Sha1":"7d2ac2e7f629d23f3c775764e0ff6fdf586a25fc","Message":"Version 5.6.129\n\nPerformance and stability improvements on all platforms.\n\nCr-Commit-Position: refs/heads/5.6.129@{#1}\nCr-Branched-From: 14be3846bd12c3930027af2fe1192fe301806ef9-refs/heads/master@{#40497}\n","AuthorEmail":"hablich@chromium.org","AuthorName":"Michael Hablich","CommitterEmail":"hablich@chromium.org","CommitterName":"Michael Hablich","Timestamp":"2016-10-21T14:56:50+02:00"},"CompareURL":"v8/v8/compare/0000000000000000000000000000000000000000...7d2ac2e7f629d23f3c775764e0ff6fdf586a25fc","Len":0} 1743768927] - 26m22.814803949s
2025/04/04 12:41:50 ...ces/feed/notifier.go:340:PushCommits() [W] [Slow SQL Query] INSERT INTO `action` (`user_id`,`op_type`,`act_user_id`,`repo_id`,`comment_id`,`is_deleted`,`ref_name`,`is_private`,`content`,`created_unix`) VALUES (?,?,?,?,?,?,?,?,?,?) [1 push_tag 1 9 0 false refs/tags/5.7.324.2 false {"Commits":null,"HeadCommit":{"Sha1":"65e3722a1995fbbdb266d19e717d65749c9444e5","Message":"Version 5.7.324.2 (cherry-pick)\n\nMerged aa8a208a473af43e7aa97626d8d2a4a81667850c\n\nRevert of [TypeFeedbackVector] Root literal arrays in function literals slots (patchset #11 id:370001 of https://codereview.chromium.org/2504153002/ )\n\nTBR=jgruber@chromium.org\n\nReview-Url: https://codereview.chromium.org/2592393002 .\nCr-Commit-Position: refs/heads/5.7.324@{#3}\nCr-Branched-From: 2041c504025d706041e50e52d9e8c7221667492d-refs/heads/master@{#41902}\n","AuthorEmail":"hablich@chromium.org","AuthorName":"Michael Hablich","CommitterEmail":"hablich@chromium.org","CommitterName":"Michael Hablich","Timestamp":"2016-12-22T11:31:14+01:00"},"CompareURL":"v8/v8/compare/0000000000000000000000000000000000000000...65e3722a1995fbbdb266d19e717d65749c9444e5","Len":0} 1743768928] - 26m22.019961149s
2025/04/04 12:41:50 ...ces/feed/notifier.go:340:PushCommits() [W] [Slow SQL Query] INSERT INTO `action` (`user_id`,`op_type`,`act_user_id`,`repo_id`,`comment_id`,`is_deleted`,`ref_name`,`is_private`,`content`,`created_unix`) VALUES (?,?,?,?,?,?,?,?,?,?) [1 push_tag 1 9 0 false refs/tags/5.8.294 false {"Commits":null,"HeadCommit":{"Sha1":"376fd4b2eb6a1ff398d4a8b58ce1ce9feb5273db","Message":"Version 5.8.294\n\nPerformance and stability improvements on all platforms.\n\nCr-Commit-Position: refs/heads/5.8.294@{#1}\nCr-Branched-From: d747855e23c28d74593bb272cd629aaab4c379ca-refs/heads/master@{#43469}\n","AuthorEmail":"v8-autoroll@chromium.org","AuthorName":"v8-autoroll","CommitterEmail

2025/04/04 12:36:38 ...eb/routing/logger.go:102:func1() [I] router: completed GET /mirrors/v8/commit/bf6a80f34c17cad8f648c1305fe774d64f149b52 for 111.225.148.57:0, 404 Not Found in 2.9ms @ context/repo.go:401(context.RepoAssignment)

2025/04/04 12:41:50 ...s/repository/push.go:96:pushUpdates() [W] [Slow SQL Query] UPDATE `repository` SET `size` = ?, `git_size` = ?, `lfs_size` = ? WHERE `id`=? [1510601333 1510601333 0 9] - 26m4.248004645s

2025/04/04 12:41:50 ...ron/tasks_actions.go:51:func1() [W] [Slow SQL Query] BEGIN TRANSACTION [] - 26m22.525253949s

2025/04/04 12:41:50 ...ces/feed/notifier.go:340:PushCommits() [W] [Slow SQL Query] INSERT INTO `action` (`user_id`,`op_type`,`act_user_id`,`repo_id`,`comment_id`,`is_deleted`,`ref_name`,`is_private`,`content`,`created_unix`) VALUES (?,?,?,?,?,?,?,?,?,?) [1 push_tag 1 9 0 false refs/tags/5.4.499 false {"Commits":null,"HeadCommit":{"Sha1":"352c9d652b5920e568c8cc8298e6f786aef20653","Message":"Version 5.4.499\n\nPerformance and stability improvements on all platforms.\n\nCr-Commit-Position: refs/heads/5.4.499@{#1}\nCr-Branched-From: 6fe0b39b0167a71a1d9265c035c245c30b71b573-refs/heads/master@{#38837}\n","AuthorEmail":"v8-autoroll@chromium.org","AuthorName":"v8-autoroll@chromium.org","CommitterEmail":"v8-autoroll@chromium.org","CommitterName":"v8-autoroll@chromium.org","Timestamp":"2016-08-23T10:40:26-07:00"},"CompareURL":"v8/v8/compare/0000000000000000000000000000000000000000...352c9d652b5920e568c8cc8298e6f786aef20653","Len":0} 1743768927] - 26m22.760161949s

2025/04/04 12:41:50 ...ces/feed/notifier.go:340:PushCommits() [W] [Slow SQL Query] INSERT INTO `action` (`user_id`,`op_type`,`act_user_id`,`repo_id`,`comment_id`,`is_deleted`,`ref_name`,`is_private`,`content`,`created_unix`) VALUES (?,?,?,?,?,?,?,?,?,?) [1 push_tag 1 9 0 false refs/tags/5.6.129 false {"Commits":null,"HeadCommit":{"Sha1":"7d2ac2e7f629d23f3c775764e0ff6fdf586a25fc","Message":"Version 5.6.129\n\nPerformance and stability improvements on all platforms.\n\nCr-Commit-Position: refs/heads/5.6.129@{#1}\nCr-Branched-From: 14be3846bd12c3930027af2fe1192fe301806ef9-refs/heads/master@{#40497}\n","AuthorEmail":"hablich@chromium.org","AuthorName":"Michael Hablich","CommitterEmail":"hablich@chromium.org","CommitterName":"Michael Hablich","Timestamp":"2016-10-21T14:56:50+02:00"},"CompareURL":"v8/v8/compare/0000000000000000000000000000000000000000...7d2ac2e7f629d23f3c775764e0ff6fdf586a25fc","Len":0} 1743768927] - 26m22.814803949s

2025/04/04 12:41:50 ...ces/feed/notifier.go:340:PushCommits() [W] [Slow SQL Query] INSERT INTO `action` (`user_id`,`op_type`,`act_user_id`,`repo_id`,`comment_id`,`is_deleted`,`ref_name`,`is_private`,`content`,`created_unix`) VALUES (?,?,?,?,?,?,?,?,?,?) [1 push_tag 1 9 0 false refs/tags/5.7.324.2 false {"Commits":null,"HeadCommit":{"Sha1":"65e3722a1995fbbdb266d19e717d65749c9444e5","Message":"Version 5.7.324.2 (cherry-pick)\n\nMerged aa8a208a473af43e7aa97626d8d2a4a81667850c\n\nRevert of [TypeFeedbackVector] Root literal arrays in function literals slots (patchset #11 id:370001 of https://codereview.chromium.org/2504153002/ )\n\nTBR=jgruber@chromium.org\n\nReview-Url: https://codereview.chromium.org/2592393002 .\nCr-Commit-Position: refs/heads/5.7.324@{#3}\nCr-Branched-From: 2041c504025d706041e50e52d9e8c7221667492d-refs/heads/master@{#41902}\n","AuthorEmail":"hablich@chromium.org","AuthorName":"Michael Hablich","CommitterEmail":"hablich@chromium.org","CommitterName":"Michael Hablich","Timestamp":"2016-12-22T11:31:14+01:00"},"CompareURL":"v8/v8/compare/0000000000000000000000000000000000000000...65e3722a1995fbbdb266d19e717d65749c9444e5","Len":0} 1743768928] - 26m22.019961149s

上述的输出非常的不合理，简单的 SQL 语句执行耗时高达 26分钟，这个结果是非常不合理的。SQLite 的性能不可能这么差劲。

导出数据库文件，通过 SQLiteStudio 执行相同的 SQL 语句，在 0.1 毫秒执行结束。

并且 Docker 多次重启之后，高概率发生文件损坏。另一个常见现象是处理器占用长时间处于高位，某几个核心长时间满负荷，但是 DUMP 堆栈调用又一切正常，看不到用户态的高占用函数。

这个原因是由于 Windows 和 Linux 的跨系统文件兼容性问题无法得到很好的解决，WSL 2 下访问 Windows 文件性能会非常差。

具体解释参考 [wsl2] filesystem performance is much slower than wsl1 in /mnt #4197 。

$ podman machine ls
NAME                     VM TYPE     CREATED         LAST UP            CPUS        MEMORY      DISK SIZE
podman-machine-default*  wsl         21 minutes ago  Currently running  12          50GiB       1.953TiB

$ podman machine ls

NAME VM TYPE CREATED LAST UP CPUS MEMORY DISK SIZE

podman-machine-default* wsl 21 minutes ago Currently running 12 50GiB 1.953TiB

解决这个问题的方法就是不要进行映射，直接在存储在虚拟机的磁盘里。

# 禁用 Hyper-V 功能 
$ DISM /Online /Disable-Feature /FeatureName:Microsoft-Hyper-V 

# 启用 VirtualMachinePlatform 功能 
$ DISM /Online /Enable-Feature /All /FeatureName:VirtualMachinePlatform

# 启用 Microsoft-Windows-Subsystem-Linux 功能 
$ DISM /Online /Enable-Feature /All /FeatureName:Microsoft-Windows-Subsystem-Linux 

# 删除之前创建的虚拟机
$ podman machine stop podman-machine-default

$ podman machine rm -f podman-machine-default

$ podman system connection rm podman-machine-default

$ podman system connection rm podman-machine-default-root

$ wsl --uninstall podman-machine-default

$ wsl --update

# 使用 WSL 2.0 或者 Hyper-V 版本，但是不要通过 -v 参数进行目录映射。目录映射使用9P协议，该协议性能低下，造成严重性能问题，并且高负载，高并发下文件系统不稳定。 
# 但是 WSL 1.0 文件权限不正确，默认创建的文件权限都是 777，导致权限问题。 
# 建议优先使用 WSL 2.0。 
# Windows 11 默认就是 WSL 2.0 但是 Windows 10 默认是 WSL 1.0 需要手工设置成 WSL 2.0。
$ wsl --set-default-version 2

$ wsl --install --no-distribution

# 指定给出 12个CPU核心 内存 50GB，磁盘2TB 此处如果不指定，默认是核心数/内存的一半，磁盘默认100GB
# 不要通过 -v 参数进行 Windows 目录映射，两者文件系统格式不同，需要通过9p协议转换，性能损失巨大，不如直接给出足够大的磁盘空间，文件直接存储在虚拟机内部
$ podman machine init --cpus 12 -m 51200 --disk-size 2000

$ podman machine start

# 禁用 Hyper-V 功能

$ DISM /Online /Disable-Feature /FeatureName:Microsoft-Hyper-V

# 启用 VirtualMachinePlatform 功能

$ DISM /Online /Enable-Feature /All /FeatureName:VirtualMachinePlatform

# 启用 Microsoft-Windows-Subsystem-Linux 功能

$ DISM /Online /Enable-Feature /All /FeatureName:Microsoft-Windows-Subsystem-Linux

# 删除之前创建的虚拟机

$ podman machine stop podman-machine-default

$ podman machine rm -f podman-machine-default

$ podman system connection rm podman-machine-default

$ podman system connection rm podman-machine-default-root

$ wsl --uninstall podman-machine-default

$ wsl --update

# 但是 WSL 1.0 文件权限不正确，默认创建的文件权限都是 777，导致权限问题。

# 建议优先使用 WSL 2.0。

# Windows 11 默认就是 WSL 2.0 但是 Windows 10 默认是 WSL 1.0 需要手工设置成 WSL 2.0。

$ wsl --set-default-version 2

$ wsl --install --no-distribution

# 指定给出 12个CPU核心内存 50GB，磁盘2TB 此处如果不指定，默认是核心数/内存的一半，磁盘默认100GB

$ podman machine init --cpus 12 -m 51200 --disk-size 2000

$ podman machine start

同时，建议内存不低于 32GB ，大型项目，如果内存不足的话，也可能诱发此类问题。

参考链接

GitLab的替代者-轻量级Gitea安装与配置-ubuntu 24.04.2

前置条件

ubuntu 24.04.2 LTS

Gitea 1.23.6

动手实践

# 安装 podman
$ sudo apt install podman
 
# 创建一个低权限用户，尽量不要使用root用户，身份操作podman,降低安全风险
$ sudo adduser podman
 
# 允许用户下的容器在系统启动的时候启动服务
$ sudo loginctl enable-linger podman

# 退出当前用户，切换到刚刚创建的低权限用户, 注意，不要使用 su - user 的方式切换，后续会执行各种报错
# 如果使用 su user 切换会导致环境变量被带到新用户，导致执行报错
# ERRO[0000] XDG_RUNTIME_DIR directory "/run/user/1000" is not owned by the current user 
# Error running systemd as user - Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined
# 或者在使用 systemctl --user daemon-reload 之类的命令报错
# Systemd User Services: Failed to connect to bus
 
$ exit
 
# 通过 ssh 登录用户名 podman 密码是创建用户的时候设置的密码，解决报错问题
$ ssh xxx.xxx.xxx.xxx -l podman
 
# 准备本地目录映射
$ mkdir ~/.dockers
 
$ mkdir ~/.dockers/gitea

$ podman pull docker.gitea.com/gitea:latest

# 此处我们 默认不导出 ssh 访问，只允许 http 访问
$ podman run -d --cpus=2 --name gitea -p 10890:3000 -v /home/podman/.dockers/gitea:/data gitea

# 每次都启动新容器方式创建servcie //--new参数，每次启动都删除旧容器，启动一个新容器 
$ podman generate systemd --restart-policy=always -n --new -f gitea

# 保存到 ~/.config/systemd/user/
$ mkdir .config

$ mkdir .config/systemd

$ mkdir .config/systemd/user

$ mv container-gitea.service ~/.config/systemd/user/

# 刷新配置文件，让其生效
$ systemctl --user daemon-reload

# 上述命令如果报错 Failed to connect to bus 
# 一般是通过 su - 切换账号导致的，需要退出当前的SSH登录
# 重新通过 ssh 登录，用户名 podman 密码是创建用户的时候设置的密码

# 设置容器开机自启，并且现在启动
$ systemctl --user enable --now ~/.config/systemd/user/container-gitea.service

# 如果需要进入容器查看执行情况，参考如下命令
# podman exec -it container-gitea bash

# 查看日志
# podman logs -f -t gitea

# 测试，重启系统，观察是否能开机自动启动
$ sudo reboot

# 启动或重启服务 
# systemctl --user start container-gitea.service 
# systemctl --user restart container-gitea.service

# 如果启动失败，观察服务日志
# journalctl --user -xeu container-gitea.service
# 或者
# sudo journalctl -f

# 安装 podman

$ sudo apt install podman

# 创建一个低权限用户，尽量不要使用root用户，身份操作podman,降低安全风险

$ sudo adduser podman

# 允许用户下的容器在系统启动的时候启动服务

$ sudo loginctl enable-linger podman

# 退出当前用户，切换到刚刚创建的低权限用户, 注意，不要使用 su - user 的方式切换，后续会执行各种报错

# 如果使用 su user 切换会导致环境变量被带到新用户，导致执行报错

# ERRO[0000] XDG_RUNTIME_DIR directory "/run/user/1000" is not owned by the current user

# Error running systemd as user - Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined

# 或者在使用 systemctl --user daemon-reload 之类的命令报错

# Systemd User Services: Failed to connect to bus

$ exit

# 通过 ssh 登录用户名 podman 密码是创建用户的时候设置的密码，解决报错问题

$ ssh xxx.xxx.xxx.xxx -l podman

# 准备本地目录映射

$ mkdir ~/.dockers

$ mkdir ~/.dockers/gitea

$ podman pull docker.gitea.com/gitea:latest

# 此处我们默认不导出 ssh 访问，只允许 http 访问

$ podman run -d --cpus=2 --name gitea -p 10890:3000 -v /home/podman/.dockers/gitea:/data gitea

# 每次都启动新容器方式创建servcie //--new参数，每次启动都删除旧容器，启动一个新容器

$ podman generate systemd --restart-policy=always -n --new -f gitea

# 保存到 ~/.config/systemd/user/

$ mkdir .config

$ mkdir .config/systemd

$ mkdir .config/systemd/user

$ mv container-gitea.service ~/.config/systemd/user/

# 刷新配置文件，让其生效

$ systemctl --user daemon-reload

# 上述命令如果报错 Failed to connect to bus

# 一般是通过 su - 切换账号导致的，需要退出当前的SSH登录

# 重新通过 ssh 登录，用户名 podman 密码是创建用户的时候设置的密码

# 设置容器开机自启，并且现在启动

$ systemctl --user enable --now ~/.config/systemd/user/container-gitea.service

# 如果需要进入容器查看执行情况，参考如下命令

# podman exec -it container-gitea bash

# 查看日志

# podman logs -f -t gitea

# 测试，重启系统，观察是否能开机自动启动

$ sudo reboot

# 启动或重启服务

# systemctl --user start container-gitea.service

# systemctl --user restart container-gitea.service

# 如果启动失败，观察服务日志

# journalctl --user -xeu container-gitea.service

# 或者

# sudo journalctl -f

访问配置，在地址栏输入 http://xxx.xxx.xxx.xxx:10890 进入配置页面，如下图：

后续如果需要修改配置，可以通过调整修改 /home/podman/.dockers/gitea/gitea/conf/app.ini 解决。

APP_NAME = Gitea: Git with a cup of tea
RUN_MODE = prod
RUN_USER = git
WORK_PATH = /data/gitea

[repository]
;; 禁用点赞功能。
DISABLE_STARS = true

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 = www.mobibrw.com
SSH_DOMAIN = www.mobibrw.com
HTTP_PORT = 3000
ROOT_URL = http://www.mobibrw.com:10890/
DISABLE_SSH = true
SSH_PORT = 22
SSH_LISTEN_PORT = 22
LFS_START_SERVER = true
LFS_JWT_SECRET = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OFFLINE_MODE = true

;; 设置登录后跳转到项目浏览而不是默认返回首页，默认返回首页可能导致循环跳转 
LANDING_PAGE = explore

;; http返回启用gzip压缩，设置为true
ENABLE_GZIP = true

[database]
PATH = /data/gitea/gitea.db
DB_TYPE = sqlite3
HOST = localhost:3306
NAME = gitea
USER = root
PASSWD =
LOG_SQL = false
SCHEMA =
SSL_MODE = disable

;; 启用 WAL 增强 SQlite 的并发写入性能
;; 更改 SQlite3 的日志模式。可以用于在高负载导致写入拥塞时启用 WAL 模式。有关可能的值，请参阅 SQlite3 文档。默认为数据库文件的默认值，通常为 DELETE。
;; _cache_size 为 SQlite 的缓存大小，内存充足的情况下，增大缓存，提升性能，默认值是 2000
SQLITE_JOURNAL_MODE = WAL&_cache_size=200000

[indexer]
ISSUE_INDEXER_PATH = /data/gitea/indexers/issues.bleve

[session]
PROVIDER_CONFIG = /data/gitea/sessions
PROVIDER = file

[picture]
;; 禁用头像联盟，已知头像联盟会导致运行缓慢
DISABLE_GRAVATAR = true
ENABLE_FEDERATED_AVATAR = false

AVATAR_UPLOAD_PATH = /data/gitea/avatars
REPOSITORY_AVATAR_UPLOAD_PATH = /data/gitea/repo-avatars

[attachment]
PATH = /data/gitea/attachments

[log]
MODE = console
LEVEL = info
ROOT_PATH = /data/gitea/log

[security]
;; 控制是否能够访问安装向导页面，设置为 true 则禁止访问安装向导页面。
INSTALL_LOCK = true
SECRET_KEY =
REVERSE_PROXY_LIMIT = 1
REVERSE_PROXY_TRUSTED_PROXIES = *
INTERNAL_TOKEN = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PASSWORD_HASH_ALGO = pbkdf2

[service]
DISABLE_REGISTRATION = true
REQUIRE_SIGNIN_VIEW = false
REGISTER_EMAIL_CONFIRM = false
ENABLE_NOTIFY_MAIL = false
ALLOW_ONLY_EXTERNAL_REGISTRATION = false

;; 启用此项以对注册使用验证码验证
ENABLE_CAPTCHA = true

;; 启用此项以要求登录使用验证码验证。您还必须启用ENABLE_CAPTCHA。
REQUIRE_CAPTCHA_FOR_LOGIN = true

DEFAULT_KEEP_EMAIL_PRIVATE = false
DEFAULT_ALLOW_CREATE_ORGANIZATION = false
DEFAULT_ENABLE_TIMETRACKING = true
NO_REPLY_ADDRESS = noreply.localhost

;; 启用此项以在用户个人资料上显示热图。此功能开销太大，关闭
ENABLE_USER_HEATMAP = false

;; 启用时间跟踪功能。此功能开销太大，关闭
ENABLE_TIMETRACKING = true

[lfs]
PATH = /data/git/lfs

[mailer]
ENABLED = false

[openid]
ENABLE_OPENID_SIGNIN = false
ENABLE_OPENID_SIGNUP = false

[cron.update_checker]
ENABLED = false

[repository.pull-request]
DEFAULT_MERGE_STYLE = merge

[repository.signing]
DEFAULT_TRUST_MODEL = committer

[oauth2]
;; 启用OAuth2提供者，不使用此功能则关闭
ENABLED = false

JWT_SECRET = xxxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

APP_NAME = Gitea: Git with a cup of tea

RUN_MODE = prod

RUN_USER = git

WORK_PATH = /data/gitea

[repository]

;; 禁用点赞功能。

DISABLE_STARS = true

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 = www.mobibrw.com

SSH_DOMAIN = www.mobibrw.com

HTTP_PORT = 3000

ROOT_URL = http://www.mobibrw.com:10890/

DISABLE_SSH = true

SSH_PORT = 22

SSH_LISTEN_PORT = 22

LFS_START_SERVER = true

LFS_JWT_SECRET = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

OFFLINE_MODE = true

;; 设置登录后跳转到项目浏览而不是默认返回首页，默认返回首页可能导致循环跳转

LANDING_PAGE = explore

;; http返回启用gzip压缩，设置为true

ENABLE_GZIP = true

[database]

PATH = /data/gitea/gitea.db

DB_TYPE = sqlite3

HOST = localhost:3306

NAME = gitea

USER = root

PASSWD =

LOG_SQL = false

SCHEMA =

SSL_MODE = disable

;; 启用 WAL 增强 SQlite 的并发写入性能

;; 更改 SQlite3 的日志模式。可以用于在高负载导致写入拥塞时启用 WAL 模式。有关可能的值，请参阅 SQlite3 文档。默认为数据库文件的默认值，通常为 DELETE。

;; _cache_size 为 SQlite 的缓存大小，内存充足的情况下，增大缓存，提升性能，默认值是 2000

SQLITE_JOURNAL_MODE = WAL&_cache_size=200000

[indexer]

ISSUE_INDEXER_PATH = /data/gitea/indexers/issues.bleve

[session]

PROVIDER_CONFIG = /data/gitea/sessions

PROVIDER = file

[picture]

;; 禁用头像联盟，已知头像联盟会导致运行缓慢

DISABLE_GRAVATAR = true

ENABLE_FEDERATED_AVATAR = false

AVATAR_UPLOAD_PATH = /data/gitea/avatars

REPOSITORY_AVATAR_UPLOAD_PATH = /data/gitea/repo-avatars

[attachment]

PATH = /data/gitea/attachments

[log]

MODE = console

LEVEL = info

ROOT_PATH = /data/gitea/log

[security]

;; 控制是否能够访问安装向导页面，设置为 true 则禁止访问安装向导页面。

INSTALL_LOCK = true

SECRET_KEY =

REVERSE_PROXY_LIMIT = 1

REVERSE_PROXY_TRUSTED_PROXIES = *

INTERNAL_TOKEN = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

PASSWORD_HASH_ALGO = pbkdf2

[service]

DISABLE_REGISTRATION = true

REQUIRE_SIGNIN_VIEW = false

REGISTER_EMAIL_CONFIRM = false

ENABLE_NOTIFY_MAIL = false

ALLOW_ONLY_EXTERNAL_REGISTRATION = false

;; 启用此项以对注册使用验证码验证

ENABLE_CAPTCHA = true

;; 启用此项以要求登录使用验证码验证。您还必须启用ENABLE_CAPTCHA。

REQUIRE_CAPTCHA_FOR_LOGIN = true

DEFAULT_KEEP_EMAIL_PRIVATE = false

DEFAULT_ALLOW_CREATE_ORGANIZATION = false

DEFAULT_ENABLE_TIMETRACKING = true

NO_REPLY_ADDRESS = noreply.localhost

;; 启用此项以在用户个人资料上显示热图。此功能开销太大，关闭

ENABLE_USER_HEATMAP = false

;; 启用时间跟踪功能。此功能开销太大，关闭

ENABLE_TIMETRACKING = true

[lfs]

PATH = /data/git/lfs

[mailer]

ENABLED = false

[openid]

ENABLE_OPENID_SIGNIN = false

ENABLE_OPENID_SIGNUP = false

[cron.update_checker]

ENABLED = false

[repository.pull-request]

DEFAULT_MERGE_STYLE = merge

[repository.signing]

DEFAULT_TRUST_MODEL = committer

[oauth2]

;; 启用OAuth2提供者，不使用此功能则关闭

ENABLED = false

JWT_SECRET = xxxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx

注意：如果对大型项目进行镜像部署，比如 chromium 。登录之前可以正常使用，登录特别慢，那么可能是内存不足导致的，大型项目建议内存不低于 32GB，否则会出现各种问题。

参考链接

GitLab的替代者-轻量级Gogs安装与配置

更建议参考使用 GitLab的替代者-轻量级Gitea安装与配置，功能更完善，尤其是作为大规模项目的镜像的情况。

Gogs项目开发进展比较缓慢，功能缺陷较多，Gitea 项目继承自 Gogs 项目。

前置条件

ubuntu 24.04.2 LTS

动手实践

# 安装 podman
$ sudo apt install podman
 
# 创建一个低权限用户，尽量不要使用root用户，身份操作podman,降低安全风险
$ sudo adduser podman
 
# 允许用户下的容器在系统启动的时候启动服务
$ sudo loginctl enable-linger podman

# 退出当前用户，切换到刚刚创建的低权限用户, 注意，不要使用 su - user 的方式切换，后续会执行各种报错
# 如果使用 su user 切换会导致环境变量被带到新用户，导致执行报错
# ERRO[0000] XDG_RUNTIME_DIR directory "/run/user/1000" is not owned by the current user 
# Error running systemd as user - Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined
# 或者在使用 systemctl --user daemon-reload 之类的命令报错
# Systemd User Services: Failed to connect to bus
 
$ exit
 
# 通过 ssh 登录用户名 podman 密码是创建用户的时候设置的密码，解决报错问题
$ ssh xxx.xxx.xxx.xxx -l podman
 
# 准备本地目录映射
$ mkdir ~/.dockers
 
$ mkdir ~/.dockers/gogs

$ podman pull ghcr.io/gogs/gogs:latest

# 此处我们 默认不导出 ssh 访问，只允许 http 访问
$ podman run -d --cpus=2 --name gogs -p 10880:3000 -v /home/podman/.dockers/gogs:/data gogs/gogs

# 每次都启动新容器方式创建servcie //--new参数，每次启动都删除旧容器，启动一个新容器 
$ podman generate systemd --restart-policy=always -n --new -f gogs

# 保存到 ~/.config/systemd/user/
$ mkdir .config

$ mkdir .config/systemd

$ mkdir .config/systemd/user

$ mv container-gogs.service ~/.config/systemd/user/

# 刷新配置文件，让其生效
$ systemctl --user daemon-reload

# 上述命令如果报错 Failed to connect to bus 
# 一般是通过 su - 切换账号导致的，需要退出当前的SSH登录
# 重新通过 ssh 登录，用户名 podman 密码是创建用户的时候设置的密码

# 设置容器开机自启，并且现在启动
$ systemctl --user enable --now ~/.config/systemd/user/container-gogs.service

# 如果需要进入容器查看执行情况，参考如下命令
# podman exec -it container-gogs bash

# 查看日志
# podman logs -f -t gogs

# 测试，重启系统，观察是否能开机自动启动
$ sudo reboot

# 启动或重启服务 
# systemctl --user start container-gogs.service 
# systemctl --user restart container-gogs.service

# 如果启动失败，观察服务日志
# journalctl --user -xeu container-gogs.service
# 或者
# sudo journalctl -f

# 安装 podman

$ sudo apt install podman

# 创建一个低权限用户，尽量不要使用root用户，身份操作podman,降低安全风险

$ sudo adduser podman

# 允许用户下的容器在系统启动的时候启动服务

$ sudo loginctl enable-linger podman

# 退出当前用户，切换到刚刚创建的低权限用户, 注意，不要使用 su - user 的方式切换，后续会执行各种报错

# 如果使用 su user 切换会导致环境变量被带到新用户，导致执行报错

# ERRO[0000] XDG_RUNTIME_DIR directory "/run/user/1000" is not owned by the current user

# Error running systemd as user - Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined

# 或者在使用 systemctl --user daemon-reload 之类的命令报错

# Systemd User Services: Failed to connect to bus

$ exit

# 通过 ssh 登录用户名 podman 密码是创建用户的时候设置的密码，解决报错问题

$ ssh xxx.xxx.xxx.xxx -l podman

# 准备本地目录映射

$ mkdir ~/.dockers

$ mkdir ~/.dockers/gogs

$ podman pull ghcr.io/gogs/gogs:latest

# 此处我们默认不导出 ssh 访问，只允许 http 访问

$ podman run -d --cpus=2 --name gogs -p 10880:3000 -v /home/podman/.dockers/gogs:/data gogs/gogs

# 每次都启动新容器方式创建servcie //--new参数，每次启动都删除旧容器，启动一个新容器

$ podman generate systemd --restart-policy=always -n --new -f gogs

# 保存到 ~/.config/systemd/user/

$ mkdir .config

$ mkdir .config/systemd

$ mkdir .config/systemd/user

$ mv container-gogs.service ~/.config/systemd/user/

# 刷新配置文件，让其生效

$ systemctl --user daemon-reload

# 上述命令如果报错 Failed to connect to bus

# 一般是通过 su - 切换账号导致的，需要退出当前的SSH登录

# 重新通过 ssh 登录，用户名 podman 密码是创建用户的时候设置的密码

# 设置容器开机自启，并且现在启动

$ systemctl --user enable --now ~/.config/systemd/user/container-gogs.service

# 如果需要进入容器查看执行情况，参考如下命令

# podman exec -it container-gogs bash

# 查看日志

# podman logs -f -t gogs

# 测试，重启系统，观察是否能开机自动启动

$ sudo reboot

# 启动或重启服务

# systemctl --user start container-gogs.service

# systemctl --user restart container-gogs.service

# 如果启动失败，观察服务日志

# journalctl --user -xeu container-gogs.service

# 或者

# sudo journalctl -f

访问配置，在地址栏输入 http://xxx.xxx.xxx.xxx:10880 进入配置页面，如下图：

后续如果需要修改配置，可以通过调整修改 /home/podman/.dockers/gogs/gogs/conf/app.ini 解决。

; The brand name of the application, can be your company or team name.
BRAND_NAME = Gogs

; The system user who should be running the applications. It has no effect on Windows,
; otherwise, it should match the value of $USER environment variable.
RUN_USER   = git

; The running mode of the application, can be either "dev", "prod" or "test".
RUN_MODE   = prod

[database]
; The database backend, either "postgres", "mysql" "sqlite3" or "mssql".
; You can connect to TiDB with MySQL protocol.
TYPE     = sqlite3

HOST     = 127.0.0.1:5432
NAME     = gogs

; For "postgres" only
SCHEMA   = public

USER     = gogs
PASSWORD = 

; For "postgres" only, either "disable", "require" or "verify-full".
SSL_MODE = disable

; For "sqlite3" only, make sure to use absolute path.
PATH     = data/gogs.db

[repository]
; The root path for storing managed repositories, default is "~/gogs-repositories"
ROOT           = /data/git/gogs-repositories

; Default branch name when creating new repositories.
DEFAULT_BRANCH = master

[server]
; The public-facing domain name for the application.
DOMAIN           = www.mobibrw.com

; The port number to be listened by the application.
HTTP_PORT        = 3000

; The public-facing URL for the application.
EXTERNAL_URL     = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/gogs-git-mirror

; Local (DMZ) URL for workers (e.g. SSH update) accessing web service.
; In most cases you do not need to change the default value.
; Alter it only if your SSH server node is not the same as HTTP node.
LOCAL_ROOT_URL   = %(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/gogs-git-mirror

; Whether to enable application level GZIP compression.
ENABLE_GZIP = true

; Whether to disable SSH access to the application entirely.
DISABLE_SSH      = true

; The port number to be exposed in SSH clone URL.
SSH_PORT         = 

; Whether to start a builtin SSH server.
START_SSH_SERVER = false

; Whether to disable using CDN for static files regardless.
OFFLINE_MODE     = true

[email]
; Whether to enable the email service.
ENABLED = false

[auth]
REQUIRE_EMAIL_CONFIRMATION  = false
DISABLE_REGISTRATION        = true
ENABLE_REGISTRATION_CAPTCHA = false
REQUIRE_SIGNIN_VIEW         = false

[user]
ENABLE_EMAIL_NOTIFICATION = false

[picture]
DISABLE_GRAVATAR        = true
ENABLE_FEDERATED_AVATAR = false

[session]
PROVIDER = file

[log]
MODE      = file
LEVEL     = Info
ROOT_PATH = /app/gogs/log

[security]
INSTALL_LOCK = true
SECRET_KEY   = xxxxxx

[i18n]
LANGS = zh-CN,en-US
NAMES = 简体中文,English

; Used for jQuery DateTimePicker,
; list of supported languages in https://xdsoft.net/jqplugins/datetimepicker/#lang
[i18n.datelang]
zh-CN = zh
en-US = en

100

101

102

103

104

105

; The brand name of the application, can be your company or team name.

BRAND_NAME = Gogs

; The system user who should be running the applications. It has no effect on Windows,

; otherwise, it should match the value of $USER environment variable.

RUN_USER = git

; The running mode of the application, can be either "dev", "prod" or "test".

RUN_MODE = prod

[database]

; The database backend, either "postgres", "mysql" "sqlite3" or "mssql".

; You can connect to TiDB with MySQL protocol.

TYPE = sqlite3

HOST = 127.0.0.1:5432

NAME = gogs

; For "postgres" only

SCHEMA = public

USER = gogs

PASSWORD =

; For "postgres" only, either "disable", "require" or "verify-full".

SSL_MODE = disable

; For "sqlite3" only, make sure to use absolute path.

PATH = data/gogs.db

[repository]

; The root path for storing managed repositories, default is "~/gogs-repositories"

ROOT = /data/git/gogs-repositories

; Default branch name when creating new repositories.

DEFAULT_BRANCH = master

[server]

; The public-facing domain name for the application.

DOMAIN = www.mobibrw.com

; The port number to be listened by the application.

HTTP_PORT = 3000

; The public-facing URL for the application.

EXTERNAL_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/gogs-git-mirror

; Local (DMZ) URL for workers (e.g. SSH update) accessing web service.

; In most cases you do not need to change the default value.

; Alter it only if your SSH server node is not the same as HTTP node.

LOCAL_ROOT_URL = %(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/gogs-git-mirror

; Whether to enable application level GZIP compression.

ENABLE_GZIP = true

; Whether to disable SSH access to the application entirely.

DISABLE_SSH = true

; The port number to be exposed in SSH clone URL.

SSH_PORT =

; Whether to start a builtin SSH server.

START_SSH_SERVER = false

; Whether to disable using CDN for static files regardless.

OFFLINE_MODE = true

[email]

; Whether to enable the email service.

ENABLED = false

[auth]

REQUIRE_EMAIL_CONFIRMATION = false

DISABLE_REGISTRATION = true

ENABLE_REGISTRATION_CAPTCHA = false

REQUIRE_SIGNIN_VIEW = false

[user]

ENABLE_EMAIL_NOTIFICATION = false

[picture]

DISABLE_GRAVATAR = true

ENABLE_FEDERATED_AVATAR = false

[session]

PROVIDER = file

[log]

MODE = file

LEVEL = Info

ROOT_PATH = /app/gogs/log

[security]

INSTALL_LOCK = true

SECRET_KEY = xxxxxx

[i18n]

LANGS = zh-CN,en-US

NAMES = 简体中文,English

; Used for jQuery DateTimePicker,

; list of supported languages in https://xdsoft.net/jqplugins/datetimepicker/#lang

[i18n.datelang]

zh-CN = zh

en-US = en

参考链接

解决 fetch-pack: unexpected disconnect while reading sideband packet fatal: early EOF fatal: fetch-pack

在克隆仓库或者拉取代码的时候出现类似如下错误:

$ git clone https://github.com/WebPlatformForEmbedded/WPEWebKit.git
Cloning into 'WPEWebKit'…
remote: Enumerating objects: 5893112, done.
remote: Counting objects: 100% (2540/2540), done.
remote: Compressing objects: 100% (1256/1256), done.
client_loop: send disconnect: Broken pipeB | 770.00 KiB/s
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: fetch-pack: invalid index-pack output

$ git clone https://github.com/WebPlatformForEmbedded/WPEWebKit.git

Cloning into 'WPEWebKit'…

remote: Enumerating objects: 5893112, done.

remote: Counting objects: 100% (2540/2540), done.

remote: Compressing objects: 100% (1256/1256), done.

client_loop: send disconnect: Broken pipeB | 770.00 KiB/s

fetch-pack: unexpected disconnect while reading sideband packet

fatal: early EOF

fatal: fetch-pack: invalid index-pack output

$ git clone https://github.com/WebPlatformForEmbedded/WPEWebKit.git
正克隆到 'WPEWebKit'...
remote: Enumerating objects: 5893112, done.
remote: Counting objects: 100% (2540/2540), done.
remote: Compressing objects: 100% (1256/1256), done.
错误：RPC 失败。curl 56 Recv failure: Operation timed out  
错误：预期仍然需要 1329 个字节的正文
fetch-pack: unexpected disconnect while reading sideband packet
致命错误：过早的文件结束符（EOF）
致命错误：fetch-pack：无效的 index-pack 输出

$ git clone https://github.com/WebPlatformForEmbedded/WPEWebKit.git

正克隆到 'WPEWebKit'...

remote: Enumerating objects: 5893112, done.

remote: Counting objects: 100% (2540/2540), done.

remote: Compressing objects: 100% (1256/1256), done.

错误：RPC 失败。curl 56 Recv failure: Operation timed out

错误：预期仍然需要 1329 个字节的正文

fetch-pack: unexpected disconnect while reading sideband packet

致命错误：过早的文件结束符（EOF）

致命错误：fetch-pack：无效的 index-pack 输出

解决方法：

主要是由于仓库内容比较大，或者仓库中有比较大的文件，由于 http 协议 或者传输数据大小限制导致的，可以通过设置如下参数解决：

$ git config --global http.postBuffer 524288000

$ git config --global http.version HTTP/1.1

# 如果网络环境不太好，可以通过增加下面的参数，降低失败率

$ git config --global http.lowSpeedLimit 0 

$ git config --global http.lowSpeedTime 999999

$ git config --global http.postBuffer 524288000

$ git config --global http.version HTTP/1.1

# 如果网络环境不太好，可以通过增加下面的参数，降低失败率

$ git config --global http.lowSpeedLimit 0

$ git config --global http.lowSpeedTime 999999

参考链接

解决fetch-pack: unexpected disconnect while reading sideband packet fatal: early EOF fatal: fetch-pack

Centos 7/RedFlag 7/Asianux 7安装|更新Git

背景描述

Centos 7/RedFlag 7/Asianux 7 上的 Git 版本太陈旧，在使用过程中会遇到问题，比如不支持目录分支（release/v01 这种格式会在检出的时候报错)，因此需要升级 Git 版本。

$ git --version
git version 1.8.3.1

# 系统版本：（CentOS 7.6）
$ cat /etc/redhat-release 
CentOS Linux release 7.6.1810 (Core)

$ git --version

git version 1.8.3.1

# 系统版本：（CentOS 7.6）

$ cat /etc/redhat-release

CentOS Linux release 7.6.1810 (Core)

安装依赖包

源代码安装和编译git，需安装一些依赖。

$ yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel asciidoc -y

$ yum install  gcc perl-ExtUtils-MakeMaker -y

$ yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel asciidoc -y

$ yum install gcc perl-ExtUtils-MakeMaker -y

卸载旧版本

$ yum remove git

1	$ yum remove git

安装步骤

$ cd /usr/local/src/

$ wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.38.1.tar.gz

# 或者 wget https://www.mobibrw.com/wp-content/uploads/2023/09/git-2.38.1.tar.gz

$ tar -xvf git-2.38.1.tar.gz

$ cd git-2.38.1/

$ ./configure --prefix=/usr/local/git all

$ make -j && make install
 
# 链接到系统默认搜索路径 
$ ln -s /usr/local/git/bin/git /usr/bin/git

$ cd /usr/local/src/

$ wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.38.1.tar.gz

# 或者 wget https://www.mobibrw.com/wp-content/uploads/2023/09/git-2.38.1.tar.gz

$ tar -xvf git-2.38.1.tar.gz

$ cd git-2.38.1/

$ ./configure --prefix=/usr/local/git all

$ make -j && make install

# 链接到系统默认搜索路径

$ ln -s /usr/local/git/bin/git /usr/bin/git

验证版本

[root@localhost ~]# git --version
git version 2.38.1

1 2	[root@localhost ~]# git --version git version 2.38.1

参考链接

Gitlab Flow实践

当前git是大部分开发团队的首选版本管理工具，一个好的流程规范可以让大家有效地合作，像流水线一样有条不紊地进行团队协作。

业界包含三种flow：

Git flow
Github flow
Gitlab flow

继续阅读Gitlab Flow实践

Git Flow详细介绍和使用

git-flow 的工作流程

当在团队开发中使用版本控制系统时，商定一个统一的工作流程是至关重要的。Git 的确可以在各个方面做很多事情，然而，如果在你的团队中还没有能形成一个特定有效的工作流程，那么混乱就将是不可避免的。

基本上你可以定义一个完全适合你自己项目的工作流程，或者使用一个别人定义好的。

在这章节中我们将一起学习一个当前非常流行的工作流程 git-flow。

什么是 git-flow？

一旦安装安装 git-flow，你将会拥有一些扩展命令。这些命令会在一个预定义的顺序下自动执行多个操作。是的，这就是我们的工作流程！

git-flow 并不是要替代 Git，它仅仅是非常聪明有效地把标准的 Git 命令用脚本组合了起来。

严格来讲，你并不需要安装什么特别的东西就可以使用 git-flow 工作流程。你只需要了解，哪些工作流程是由哪些单独的任务所组成的，并且附带上正确的参数，以及在一个正确的顺序下简单执行那些对应的 Git 命令就可以了。当然，如果你使用 git-flow 脚本就会更加方便了，你就不需要把这些命令和顺序都记在脑子里。

安装 git-flow

最新的git bash已经支持，不用安装，或者使用 Sourcetree。

要了解安装 git-flow 细节，请阅读下面这个文档 official documentation。

在项目中设置 git-flow

当你想把你的项目 “切换” 到 git-flow 上后，Git 还是可以像往常一样工作的。这完全是取决于你在仓库上使用特殊的 git-flow 命令或是普通的 Git 命令。换句话说，git-flow 它不会以任何一种戏剧性的方式来改变你的仓库。

话虽如此，git-flow 却存在一些限制。让我们开始在一个新的项目上初始化它吧，之后我们就会有所发现：

$ git flow init
Initialized empty Git repository in /Users/tobi/acme-website/.git/
Branch name for production releases: [master] 
Branch name for "next release" development: [develop] 

How to name your supporting branch prefixes?
Feature branches? [feature/] 
Release branches? [release/] 
Hotfix branches? [hotfix/]

$ git flow init

Initialized empty Git repository in /Users/tobi/acme-website/.git/

Branch name for production releases: [master]

Branch name for "next release" development: [develop]

How to name your supporting branch prefixes?

Feature branches? [feature/]

Release branches? [release/]

Hotfix branches? [hotfix/]

当在项目的根目录执行 “git flow init” 命令时（它是否已经包括了一个 Git 仓库并不重要），一个交互式安装助手将引导您完成这个初始化操作。听起来是不是有点炫，但实际上它只是在你的分支上配置了一些命名规则。
尽管如此，这个安装助手还是允许你使用自己喜欢的名字。我强烈建议你使用默认的命名机制，并且一步一步地确定下去。

分支的模式

git-flow 模式会预设两个主分支在仓库中：

master 只能用来包括产品代码。你不能直接工作在这个 master 分支上，而是在其他指定的，独立的特性分支中（这方面我们会马上谈到）。不直接提交改动到 master 分支上也是很多工作流程的一个共同的规则。
develop 是你进行任何新的开发的基础分支。当你开始一个新的功能分支时，它将是_开发_的基础。另外，该分支也汇集所有已经完成的功能，并等待被整合到 master 分支中。

这两个分支被称作为长期分支。它们会存活在项目的整个生命周期中。而其他的分支，例如针对功能的分支，针对发行的分支，仅仅只是临时存在的。它们是根据需要来创建的，当它们完成了自己的任务之后就会被删除掉。

让我们开始探索一些在现实应用中可能遇到的案例吧！

功能开发

对于一个开发人员来说，最平常的工作可能就是功能的开发。这就是为什么 git-flow 定义了很多对于功能开发的工作流程，从而来帮助你有组织地完成它。

开始新功能

让我们开始开发一个新功能 “rss-feed”：

$ git flow feature start rss-feed
Switched to a new branch 'feature/rss-feed'

Summary of actions:
- A new branch 'feature/rss-feed' was created, based on 'develop'
- You are now on branch 'feature/rss-feed'

$ git flow feature start rss-feed

Switched to a new branch 'feature/rss-feed'

Summary of actions:

- A new branch 'feature/rss-feed' was created, based on 'develop'

- You are now on branch 'feature/rss-feed'

概念

在这些命令的输出文本中，git-flow 会对刚刚完成的操作打印出一个很有帮助的概述
当你需要帮助的时候，你可以随时请求帮助。例如：

$ git flow feature help

1

$ git flow feature help

正如上面这个新功能一样，git-flow 会创建一个名为 “feature/rss-feed” 的分支（这个 “feature/” 前缀是一个可配置的选项设置）。你已经知道了，在你做新功能开发时使用一个独立的分支是版本控制中最重要的规则之一。
git-flow 也会直接签出这个新的分支，这样你就可以直接进行工作了。

完成一个功能

经过一段时间艰苦地工作和一系列的聪明提交，我们的新功能终于完成了：

$ git flow feature finish rss-feed
Switched to branch 'develop'
Updating 6bcf266..41748ad
Fast-forward
    feed.xml | 0
    1 file changed, 0 insertions(+), 0 deletions(-)
    create mode 100644 feed.xml
Deleted branch feature/rss-feed (was 41748ad).

$ git flow feature finish rss-feed

Switched to branch 'develop'

Updating 6bcf266..41748ad

Fast-forward

feed.xml | 0

1 file changed, 0 insertions(+), 0 deletions(-)

create mode 100644 feed.xml

Deleted branch feature/rss-feed (was 41748ad).

最重要的是，这个 “feature finish” 命令会把我们的工作整合到主 “develop” 分支中去。在这里它需要等待：

一个在更广泛的 “开发” 背景下的全面测试。
稍后和所有积攒在 “develop” 分支中的其它功能一起进行发布。

之后，git-flow 也会进行清理操作。它会删除这个当下已经完成的功能分支，并且换到 “develop” 分支。

管理 releases

Release 管理是版本控制处理中的另外一个非常重要的话题。让我们来看看如何利用 git-flow 创建和发布 release。

创建 release

当你认为现在在 “develop” 分支的代码已经是一个成熟的 release 版本时，这意味着：第一，它包括所有新的功能和必要的修复；第二，它已经被彻底的测试过了。如果上述两点都满足，那就是时候开始生成一个新的 release 了：

$ git flow release start 1.1.5
Switched to a new branch 'release/1.1.5'

1 2	$ git flow release start 1.1.5 Switched to a new branch 'release/1.1.5'

请注意，release 分支是使用版本号命名的。这是一个明智的选择，这个命名方案还有一个很好的附带功能，那就是当我们完成了release 后，git-flow 会适当地自动去标记那些 release 提交。

有了一个 release 分支，再完成针对 release 版本号的最后准备工作（如果项目里的某些文件需要记录版本号），并且进行最后的编辑。

完成 release

现在是时候按下那个危险的红色按钮来完成我们的release了：

git flow release finish 1.1.5

1	git flow release finish 1.1.5

这个命令会完成如下一系列的操作：

首先，git-flow 会拉取远程仓库，以确保目前是最新的版本。
然后，release 的内容会被合并到 “master” 和 “develop” 两个分支中去，这样不仅产品代码为最新的版本，而且新的功能分支也将基于最新代码。
为便于识别和做历史参考，release 提交会被标记上这个 release 的名字（在我们的例子里是 “1.1.5”）。
清理操作，版本分支会被删除，并且回到 “develop”。

从 Git 的角度来看，release 版本现在已经完成。依据你的设置，对 “master” 的提交可能已经触发了你所定义的部署流程，或者你可以通过手动部署，来让你的软件产品进入你的用户手中。

hotfix

很多时候，仅仅在几个小时或几天之后，当对 release 版本作做全面测试时，可能就会发现一些小错误。
在这种情况下，git-flow 提供一个特定的 “hotfix” 工作流程（因为在这里不管使用 “功能” 分支流程，还是 “release” 分支流程都是不恰当的）。

创建 Hotfixes

$ git flow hotfix start missing-link

1	$ git flow hotfix start missing-link

这个命令会创建一个名为 “hotfix/missing-link” 的分支。因为这是对产品代码进行修复，所以这个 hotfix 分支是基于 “master” 分支。
这也是和 release 分支最明显的区别，release 分支都是基于 “develop” 分支的。因为你不应该在一个还不完全稳定的开发分支上对产品代码进行地修复。

就像 release 一样，修复这个错误当然也会直接影响到项目的版本号！

完成 Hotfixes

在把我们的修复提交到 hotfix 分支之后，就该去完成它了：

$ git flow hotfix finish missing-link

1	$ git flow hotfix finish missing-link

这个过程非常类似于发布一个 release 版本：

完成的改动会被合并到 “master” 中，同样也会合并到 “develop” 分支中，这样就可以确保这个错误不会再次出现在下一个 release 中。
这个 hotfix 程序将被标记起来以便于参考。
这个 hotfix 分支将被删除，然后切换到 “develop” 分支上去。

还是和产生 release 的流程一样，现在需要编译和部署你的产品（如果这些操作不是自动被触发的话）。

回顾一下

最后，在结束这个章节之前，我要再次强调几个重点。

首先，git-flow 并不会为 Git 扩展任何新的功能，它仅仅使用了脚本来捆绑了一系列 Git 命令来完成一些特定的工作流程。

其次，定义一个固定的工作流程会使得团队协作更加简单容易。无论是一个 “版本控制的新手” 还是 “Git 专家”，每一个人都知道如何来正确地完成某个任务。

记住，使用 git-flow 并不是必须的。当积攒了一定的使用经验后，很多团队会不再需要它了。当你能正确地理解工作流程的基本组成部分和目标的之后，你完全可以定义一个属于你自己的工作流程。

上面的工作流程不涉及到代码评审过程，开发人员开发完就可以合并分支。但是如果合并分支之前需要进行代码评审，那么整个流程就变复杂，我们下面分析增加了代码评审情况下的工作流。

代码评审下的 git-flow 的工作流程

我们使用 Git Flow 来进行版本管理控制，它相对于 GitHub Flow 更适合在产品开发中快速迭代，这种代码管理模式应该已经广泛使用了。

另外，我们鼓励使用 Git 客户端 SourceTree，它集成了 Git Flow 的一些基本操作。如果严格遵循 Git Flow 的流程进行版本管理控制，那么我们只用管开始和结束一个 Feature/Release/Hotfix，基本上是不用手动 merge 分支的。

新功能开发流程

从 develop 分支创建 feature 分支；
开发调试完将 feature 分支提交到远程版本库；
提交 pull request 请求合并到 develop 分支；
相关负责人 code review 后如果同意合并后，删除远程 feature 分支，如果不同意，重新修改后再上传 feature 分支请求 pull request。

Pull Request

Pull Request是当功能开发者完成一个新功能后向项目维护者发送合并请求通知的机制。它的使用过程如下：

功能开发者可以通过Gitlab页面发送pull request
开发管理员自己或组织其他的团队成员审查、讨论和修改代码
开发管理员合并新增功能分支到develop分支，然后关闭pull request，并且可以选择删除新增分支

工作流程

1. 由开发管理员负责在Gitlab上创建空白的仓库，并clone到本地，在sourcetree的git flow菜单中选择初始化仓库，并push到远端。

2. 在Gitlab上设置保护分支，把master、develop分支保护起来，只有指定人可push。

3. 功能开发者clone代码到本地，先在sourcetree的git flow菜单中选择初始化仓库。

4. 然后再开始新建功能分支，进行开发工作。

5. 新功能开发全部完成或部分完成后，功能开发者把最新代码push到远端同样的新功能分支里，并在Gitflow发起pull request给开发管理员

6. 开发管理员review代码，选择合并代码到develop，并可选择删除已经合并的新功能分支

7. 当开发管理员处理完合并请求后，开发者,切换到develop分支，直接删除自己的本地分支及远程分支，不要点击完成(Finish Feature)，此时开发者pull远端develop分支最新代码即可，可忽视本地的push提醒。

8. release、hotfix分支和feature分支操作类似。

9. 不可点击完成新功能、完成发布版本、完成修复补丁，因为这样会导致自动合并代码到master或develop分支

Git Flow Release

到此为止，我们发现整个的工作流还算可以接受，但是执行 git flow release 的时候，会发现由于 Git Flow 总是假定我们合并的分支可以立即部署到生产环境，所以如果我们的工作流程符合这个过程，是很简单的。

但是更多的时候，我们会遇到同时开发可功能模块A、B、C，最终上线只上线A、C的情况，这种情况下，会涉及到版本会退的问题，这个时候 git flow 反倒是不方便使用了。

这种情况下，GitLab Flow 流程可能更适合我们的工作流程。

参考链接

.gitignore文件无法提交

问题

创建的 .gitignore 文件无法提交到 git 上

场景

在log路径下创建了.gitignore文件, 文件内容:

*

想着忽略当前文件夹的所有内容. 此时想将 .gitignore文件提交上去, 运行git status 发现没有.gitignore文件的变动.

于是想着可能没反应过来, 就直接提交吧, 运行命令: git add .gitignore, 提示信息如下:

下列路径根据您的一个 .gitignore 文件而被忽略：
php/config/redis/log/.gitignore
提示：如果您确实要添加它们，使用 -f 参数。
提示：运行下面的命令来关闭本消息
提示："git config advice.addIgnoredFile false"

下列路径根据您的一个 .gitignore 文件而被忽略：

php/config/redis/log/.gitignore

提示：如果您确实要添加它们，使用 -f 参数。

提示：运行下面的命令来关闭本消息

提示："git config advice.addIgnoredFile false"

解决

如此看来, 是我将这个文件忽略了, 运行命令检查是那里将其忽略了git check-ignore -v .gitignore. 输出结果:

php/config/redis/log/.gitignore:1:* .gitignore

1	php/config/redis/log/.gitignore:1:* .gitignore

表明, 是在.gitignore文件的第一行, 规则* 忽略了此文件.

吆西, 明白了, 解决方法也简单, 修改.gitignore文件内容, 将此文件排除即可, 修改后的内容:

* 
!.gitignore

1 2	* !.gitignore

此时就可以正常提交。

参考链接

.gitignore 文件无法提交

Windows git ssh报错“no matching host key type found. Their offer: ssh-rsa,ssh-dss”

Windows 下检出代码的时候报错：

$ git clone root@10.10.10.10:/nfs/MyCloud/.Git/xxxx
Cloning into 'xxxx'...
Unable to negotiate with 10.10.10.10 port 22: no matching host key type found. Their offer: ssh-rsa,ssh-dss
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

$ git clone root@10.10.10.10:/nfs/MyCloud/.Git/xxxx

Cloning into 'xxxx'...

Unable to negotiate with 10.10.10.10 port 22: no matching host key type found. Their offer: ssh-rsa,ssh-dss

fatal: Could not read from remote repository.

Please make sure you have the correct access rights

and the repository exists.

解决：

前提：在排除没有配置公钥的情况下。

在Git的安装目录下 Git > etc > ssh 文件夹下找到 ssh_config 文件
在文件末尾添加一下代码（注意，这里的 xxx.com 就是远程仓库地址或者ip，格式如：baidu.com）

Host xxx.com
    HostkeyAlgorithms +ssh-rsa
    PubkeyAcceptedAlgorithms +ssh-rsa

Host xxx.com

HostkeyAlgorithms +ssh-rsa

PubkeyAcceptedAlgorithms +ssh-rsa

参考链接

windows git ssh 方式提示 no matching host key type found. Their offer: ssh-rsa,ssh-dss

聊聊如何从SVN迁移源码到Git仓库

背景介绍

这里就不再赘述关于SVN与Git的区别以及为什么要迁移源码到Git了，毕竟Git是当前的主流DVCS了，而且已经公认地非常好用，如果你还在使用SVN的话该考虑换了，是时候迁移那些遗留代码了，有兴趣可以参阅 Why Git 和 Perforce to Git 了解更多。

通常来说，在项目开发过程中，难免会遇到一些老项目代码正被SVN管理着，但基于当下诸多原因，或是扩展开发，或是战略转移，或是为了更好地开发体验，需要将这些在维护的遗留项目源码迁移为Git管理。

那如何有效地迁移源码？并且如何保留提交记录、分支记录以及开发成员等信息呢？笔者前一段时间就经历了这样的迁移工作，还是有必要分享一下，也算是一种总结了。

继续阅读聊聊如何从SVN迁移源码到Git仓库

2025 年 4 月
一	二	三	四	五	六	日
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30