360 lines
9.4 KiB
Markdown
360 lines
9.4 KiB
Markdown
# Gitea Docker 部署项目
|
||
|
||
本项目用于在已有DNMP环境中部署Gitea服务。
|
||
|
||
## 项目背景
|
||
|
||
- 服务器环境：Debian 12
|
||
- 已部署服务：DNMP (Docker + Nginx + MySQL + PHP)
|
||
- 目标：部署Gitea服务
|
||
- 域名：gitea.mzh.one (已完成DNS解析)
|
||
- 证书：使用已安装的certbot申请和自动更新SSL证书
|
||
|
||
## DNMP环境配置
|
||
|
||
- DNMP目录：/opt/dnmp
|
||
- DNMP的www目录：/opt/dnmp/www
|
||
- DNMP的Nginx配置目录：/opt/dnmp/services/nginx/conf.d
|
||
- SSL证书目录：/opt/dnmp/services/nginx/ssl/gitea.mzh.one
|
||
- Nginx配置文件名：gitea.mzh.one.conf
|
||
|
||
## 容器路径映射
|
||
|
||
本项目会自动检测DNMP环境中的容器路径映射，适应不同的DNMP配置：
|
||
|
||
- Nginx容器中的路径映射：
|
||
- 主机上的 `/opt/dnmp/www` 通常映射到容器内的 `/www`
|
||
- 主机上的 `/opt/dnmp/services/nginx/ssl` 通常映射到容器内的 `/ssl`
|
||
- 主机上的 `/opt/dnmp/services/nginx/conf.d` 通常映射到容器内的 `/etc/nginx/conf.d`
|
||
|
||
安装脚本会自动检测这些映射，并相应地调整配置文件。
|
||
|
||
## 容器自动检测
|
||
|
||
本项目的脚本会自动检测环境中的容器：
|
||
|
||
- 自动检测MySQL容器：脚本会自动查找运行中的MySQL或MariaDB容器
|
||
- 自动检测Nginx容器：脚本会自动查找运行中的Nginx容器
|
||
- 自动检测Docker网络：如果没有找到dnmp_default网络，会使用默认的bridge网络
|
||
|
||
这使得本项目可以适应不同的Docker环境配置，无需手动修改脚本中的容器名称。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
.
|
||
├── README.md # 项目说明文档
|
||
├── docker-compose.yml # Docker Compose配置文件
|
||
├── deploy.sh # 部署脚本
|
||
├── install.sh # 一键安装脚本
|
||
├── uninstall.sh # 卸载脚本
|
||
├── backup.sh # 备份脚本
|
||
├── conf # 配置文件目录
|
||
│ ├── nginx # Nginx配置文件目录
|
||
│ │ └── conf.d # Nginx站点配置目录
|
||
│ │ └── gitea.mzh.one.conf # Gitea站点配置
|
||
│ └── gitea # Gitea配置文件目录
|
||
│ └── app.ini # Gitea主配置文件
|
||
└── data # 数据存储目录
|
||
├── gitea # Gitea数据目录
|
||
└── mysql # MySQL数据目录(如需单独使用)
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 一键安装
|
||
|
||
使用一键安装脚本可以快速部署Gitea：
|
||
|
||
```bash
|
||
# 下载安装脚本
|
||
wget https://raw.githubusercontent.com/yourusername/gitea-docker/main/install.sh
|
||
# 添加执行权限
|
||
chmod +x install.sh
|
||
# 执行安装脚本
|
||
sudo ./install.sh
|
||
```
|
||
|
||
安装脚本会自动完成以下操作：
|
||
1. 检查必要的依赖
|
||
2. 自动检测MySQL和Nginx容器
|
||
3. 自动检测容器的路径映射
|
||
4. 创建项目目录结构
|
||
5. 创建MySQL数据库和用户
|
||
6. 申请SSL证书
|
||
7. 配置Nginx反向代理
|
||
8. 启动Gitea服务
|
||
|
||
### 一键卸载
|
||
|
||
如需卸载Gitea，可以使用卸载脚本：
|
||
|
||
```bash
|
||
# 下载卸载脚本
|
||
wget https://raw.githubusercontent.com/yourusername/gitea-docker/main/uninstall.sh
|
||
# 添加执行权限
|
||
chmod +x uninstall.sh
|
||
# 执行卸载脚本
|
||
sudo ./uninstall.sh
|
||
```
|
||
|
||
卸载脚本会执行以下操作：
|
||
1. 停止并删除Gitea容器
|
||
2. 删除Nginx配置
|
||
3. 可选：删除Gitea数据库
|
||
4. 可选：删除SSL证书
|
||
5. 可选：删除安装目录
|
||
|
||
### 自动备份
|
||
|
||
使用备份脚本可以定期备份Gitea数据：
|
||
|
||
```bash
|
||
# 下载备份脚本
|
||
wget https://raw.githubusercontent.com/yourusername/gitea-docker/main/backup.sh
|
||
# 添加执行权限
|
||
chmod +x backup.sh
|
||
# 执行备份脚本
|
||
sudo ./backup.sh
|
||
```
|
||
|
||
备份脚本支持以下选项：
|
||
- `-d <目录>`: 指定备份目录（默认：/opt/gitea-backups）
|
||
- `-g <目录>`: 指定Gitea安装目录（默认：/opt/gitea）
|
||
- `-m <容器名>`: 指定MySQL容器名（默认：自动检测）
|
||
- `-u <用户名>`: 指定MySQL用户名（默认：gitea）
|
||
- `-p <密码>`: 指定MySQL密码（默认：gitea_password）
|
||
- `-k <天数>`: 指定保留备份的天数（默认：7）
|
||
|
||
设置定时备份：
|
||
```bash
|
||
# 编辑crontab
|
||
sudo crontab -e
|
||
|
||
# 添加以下行，每天凌晨2点执行备份
|
||
0 2 * * * /opt/gitea/backup.sh > /var/log/gitea-backup.log 2>&1
|
||
```
|
||
|
||
## 详细部署步骤
|
||
|
||
### 1. 准备工作
|
||
|
||
1. 确保服务器上已安装Docker和Docker Compose
|
||
2. 确保MySQL和Nginx容器已正常运行
|
||
3. 确保域名gitea.mzh.one已正确解析到服务器IP
|
||
4. 确保服务器上已安装certbot
|
||
|
||
### 2. 克隆项目
|
||
|
||
```bash
|
||
git clone https://github.com/yourusername/gitea-docker.git
|
||
cd gitea-docker
|
||
```
|
||
|
||
或者手动创建项目结构和文件。
|
||
|
||
### 3. 准备MySQL数据库
|
||
|
||
创建Gitea所需的数据库和用户：
|
||
|
||
```bash
|
||
# 创建SQL脚本
|
||
cat <<EOF > create_db.sql
|
||
CREATE DATABASE IF NOT EXISTS gitea CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||
CREATE USER IF NOT EXISTS 'gitea'@'%' IDENTIFIED BY 'gitea_password';
|
||
GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'%';
|
||
FLUSH PRIVILEGES;
|
||
EOF
|
||
|
||
# 执行SQL脚本（脚本会自动检测MySQL容器）
|
||
docker exec -i $(docker ps | grep -E 'mysql|mariadb' | head -1 | awk '{print $1}') mysql -uroot -p < create_db.sql
|
||
```
|
||
|
||
### 4. 申请SSL证书
|
||
|
||
使用certbot申请SSL证书：
|
||
|
||
```bash
|
||
# 确保DNMP的www目录存在
|
||
sudo mkdir -p /opt/dnmp/www/.well-known/acme-challenge
|
||
|
||
# 申请证书
|
||
sudo certbot certonly --webroot -w /opt/dnmp/www -d gitea.mzh.one
|
||
|
||
# 创建SSL证书目录
|
||
sudo mkdir -p /opt/dnmp/services/nginx/ssl/gitea.mzh.one
|
||
|
||
# 复制证书到DNMP的SSL目录
|
||
sudo cp /etc/letsencrypt/live/gitea.mzh.one/fullchain.pem /opt/dnmp/services/nginx/ssl/gitea.mzh.one/gitea.mzh.one.pem
|
||
sudo cp /etc/letsencrypt/live/gitea.mzh.one/privkey.pem /opt/dnmp/services/nginx/ssl/gitea.mzh.one/gitea.mzh.one.key
|
||
```
|
||
|
||
### 5. 配置Nginx
|
||
|
||
将项目中的Nginx配置文件复制到DNMP的Nginx配置目录：
|
||
|
||
```bash
|
||
# 复制Nginx配置文件
|
||
sudo cp conf/nginx/conf.d/gitea.mzh.one.conf /opt/dnmp/services/nginx/conf.d/
|
||
|
||
# 重新加载Nginx配置（脚本会自动检测Nginx容器）
|
||
docker exec -it $(docker ps | grep nginx | head -1 | awk '{print $1}') nginx -s reload
|
||
```
|
||
|
||
### 6. 启动Gitea服务
|
||
|
||
```bash
|
||
# 启动服务
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 7. 完成初始化设置
|
||
|
||
访问 https://gitea.mzh.one 完成Gitea的初始化设置。
|
||
|
||
初始化时，请使用以下数据库设置：
|
||
- 数据库类型：MySQL
|
||
- 主机：[MySQL容器名]:3306（脚本会自动检测并显示）
|
||
- 用户名：gitea
|
||
- 密码：gitea_password
|
||
- 数据库名：gitea
|
||
|
||
## 使用方法
|
||
|
||
### 1. 启动服务
|
||
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 2. 停止服务
|
||
|
||
```bash
|
||
docker-compose down
|
||
```
|
||
|
||
### 3. 查看日志
|
||
|
||
```bash
|
||
docker-compose logs -f gitea
|
||
```
|
||
|
||
### 4. 备份数据
|
||
|
||
备份Gitea数据有两种方式：
|
||
|
||
#### 手动备份
|
||
|
||
```bash
|
||
# 备份数据目录
|
||
tar -czvf gitea-data-backup.tar.gz data/gitea
|
||
|
||
# 备份MySQL数据库（脚本会自动检测MySQL容器）
|
||
MYSQL_CONTAINER=$(docker ps | grep -E 'mysql|mariadb' | head -1 | awk '{print $NF}')
|
||
docker exec $MYSQL_CONTAINER mysqldump -u gitea -pgitea_password gitea > gitea-db-backup.sql
|
||
```
|
||
|
||
#### 自动备份
|
||
|
||
使用提供的备份脚本：
|
||
|
||
```bash
|
||
# 执行备份
|
||
./backup.sh
|
||
|
||
# 查看备份帮助
|
||
./backup.sh -h
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- 确保MySQL服务已正常运行
|
||
- 确保80和443端口未被占用
|
||
- 确保域名已正确解析到服务器IP
|
||
- 修改app.ini中的密钥和令牌（SECRET_KEY, INTERNAL_TOKEN, LFS_JWT_SECRET）
|
||
- 默认SSH端口为222，如需修改，请同时更新docker-compose.yml和app.ini
|
||
- 默认数据库密码为gitea_password，建议在生产环境中修改为更强的密码
|
||
- 确保没有其他配置文件使用相同的域名，以避免Nginx配置冲突
|
||
|
||
## 故障排除
|
||
|
||
- 如果无法访问Gitea，请检查Nginx配置和容器运行状态
|
||
```bash
|
||
docker ps | grep gitea
|
||
docker logs gitea
|
||
```
|
||
|
||
- 如果数据库连接失败，请检查MySQL服务状态和连接配置
|
||
```bash
|
||
# 自动检测MySQL容器并查询
|
||
MYSQL_CONTAINER=$(docker ps | grep -E 'mysql|mariadb' | head -1 | awk '{print $NF}')
|
||
docker exec -it $MYSQL_CONTAINER mysql -u gitea -pgitea_password -e "SHOW DATABASES;"
|
||
```
|
||
|
||
- 如果SSL证书问题，请检查证书路径和权限
|
||
```bash
|
||
ls -la /opt/dnmp/services/nginx/ssl/gitea.mzh.one/
|
||
```
|
||
|
||
- 如果Nginx配置冲突，请检查是否有多个配置文件使用相同的域名
|
||
```bash
|
||
grep -r "server_name gitea.mzh.one" /opt/dnmp/services/nginx/conf.d/
|
||
```
|
||
|
||
## 安全建议
|
||
|
||
1. 修改默认的数据库密码
|
||
2. 启用Gitea的二次验证功能
|
||
3. 定期备份数据
|
||
4. 定期更新Gitea版本
|
||
5. 限制SSH访问权限
|
||
|
||
## 维护指南
|
||
|
||
### 更新Gitea
|
||
|
||
更新Gitea到最新版本：
|
||
|
||
```bash
|
||
# 拉取最新镜像
|
||
docker pull gitea/gitea:latest
|
||
|
||
# 重启服务
|
||
docker-compose down
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 数据迁移
|
||
|
||
如需迁移Gitea到新服务器：
|
||
|
||
1. 在旧服务器上执行备份
|
||
```bash
|
||
./backup.sh
|
||
```
|
||
|
||
2. 将备份文件复制到新服务器
|
||
```bash
|
||
scp -r /opt/gitea-backups user@new-server:/tmp/
|
||
```
|
||
|
||
3. 在新服务器上安装Gitea
|
||
```bash
|
||
./install.sh
|
||
```
|
||
|
||
4. 恢复备份
|
||
```bash
|
||
# 停止Gitea服务
|
||
docker-compose down
|
||
|
||
# 恢复数据
|
||
tar -xzf /tmp/gitea-data-*.tar.gz -C /opt/gitea/
|
||
|
||
# 自动检测MySQL容器并恢复数据库
|
||
MYSQL_CONTAINER=$(docker ps | grep -E 'mysql|mariadb' | head -1 | awk '{print $NF}')
|
||
gunzip -c /tmp/gitea-db-*.sql.gz | docker exec -i $MYSQL_CONTAINER mysql -u gitea -pgitea_password gitea
|
||
|
||
# 启动服务
|
||
docker-compose up -d
|
||
``` |