devStandard/docs/learning/e-git/4-docker compose部署gitea.md
2025-03-29 14:35:49 +08:00

174 lines
4.1 KiB
Markdown
Executable File

# docker compose部署gitea
参考:
1. 官方: https://docs.gitea.io/en-us/install-with-docker/#sshing-shim-with-authorized_keys
注意事项:
1. linux上新建一个git用户
2. 生成ssh密钥时要选择 `ed25519` 算法
3. 编辑文件时注意权限, 特别是gitea数据和ssh文件的权限, 必须保证是 git 用户可读/写/执行的, 不要改成root/其他用户组的
环境:
默认linux环境, 已安装好docker和docker compose, 具备root权限, docker设置加速源
## 新建git用户
```sh
# 添加用户
sudo useradd -m git
# 设置密码
sudo passwd git
# 不设置密码/删除密码, 也可以禁止ssh登录
sudo passwd -d git
# 安全相关, 禁止ssh登录
# sudo usermod -L git # lock
# usermod -U git # unlock
```
## git用户添加到docker用户组
```sh
sudo usermod -aG docker git && newgrp docker
# 如果没有docker用户组
sudo groupadd docker
```
## gitea
```sh
cd 你的目录
mkdir data
# 获取git用户的uid和gid
id git
vim docker-compose.yml
# 把USER_UID, USER_GID改成实际获取的
# 127.0.0.1:2222:22 也是为了ssh直通
===
version: "3"
networks:
gitea:
external: false
services:
server:
image: gitea/gitea:latest
container_name: gitea
environment:
- USER_UID=1001 # git用户的uid, cat /etc/passwd 就能查看
- USER_GID=1001
restart: unless-stopped
networks:
- gitea
volumes:
- ./data:/data
- /home/git/.ssh/:/data/git/.ssh
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "127.0.0.1:2222:22"
===
docker compose up -d
```
初始化:
1. 数据库可以选 SQLite
2. 初始化后如果需要修改
```sh
# 注意文件权限, 数据都是git用户和git用户组的
sudo -u git vim ./data/gitea/conf/app.ini
# 然后重启容器
# 也可以通过环境变量的方法来写入ini
```
3. web端的端口是3000, 有需要设置nginx转发
4. 导入仓库, `app.ini`需要添加配置
```toml
[migrations]
ALLOW_LOCALNETWORKS = true
```
5. webhook需要添加配置
```toml
[webhook]
ALLOWED_HOST_LIST = *
```
### ssh直通下载
[sshing-shim-with-authorized_keys](https://docs.gitea.com/installation/install-with-docker#sshing-shim-with-authorized_keys)
1. 配置ssh文件
> 是为了ssh直通下载
> 因为一般22端口被服务器登录用了, 假设gitea容器使用了2222端口, 那么用户使用 ssh clone时没有指定端口, 需要把22端口转到容器的2222端口, 并且需要把参数也传进去
```sh
# openssh新版移除了rsa加密
sudo -u git ssh-keygen -t ed25519 -C "Gitea Host Key"
# 复制公钥信息, 是用来登录容器里的git用户的,后面会把整个.ssh映射到容器里
sudo -u git cat /home/git/.ssh/id_ed25519.pub | sudo -u git tee -a /home/git/.ssh/authorized_keys
chmod 600 /home/git/.ssh/authorized_keys
```
2. 在你的pc上, 生成公钥和私钥
```sh
ssh-keygen -t ed25519 -C 'test@gmail.com' -f ~/.ssh/gitea_ed25519
```
3. 登录 gitea, 打开设置界面, 添加SSH 密钥, 把pc上生成的公钥添加进去, 然后进行验证(==注意, 不是服务器上的公钥和私钥==)
4. 查看服务器上的`/home/git/.ssh/authorized_keys`, 它的结构类似这样
```sh
# SSH pubkey from git user
ssh-ed25519 xxxxxxxxxx Gitea Host Key
# gitea public key
command="/usr/local/bin/gitea --config=/data/gitea/conf/app.ini serv key-10",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty,no-user-rc,restrict ssh-ed25519 xxxxxxxxxx xxxxxxxxxx
```
5. 添加脚本
```sh
# 脚本的路径可能每个版本的gitea都不相同,最好看下官方的最新文档
# 对应上一步的command后面的路径
cat <<"EOF" | sudo tee /usr/local/bin/gitea
#!/bin/sh
ssh -p 2222 -o StrictHostKeyChecking=no git@127.0.0.1 "SSH_ORIGINAL_COMMAND=\"$SSH_ORIGINAL_COMMAND\" $0 $@"
EOF
sudo chmod +x /usr/local/bin/gitea
```
6. 个人pc上编辑config文件
```sh
vim ~/.ssh/config
===
# gitea
Host 你的gitea host
HostName 你的gitea hostname
User git
PreferredAuthentications publickey
IdentityFile ~/.ssh/gitea_ed25519
===
```
7. 测试 ssh
```sh
ssh -T git@你的gitea域名
```