gitea 本地源码库搭建

==============================
文档名称:Gitea在线搭建 + 离线完整迁移操作手册
适用:Docker Compose MySQL8.0+Gitea
全部命令可直接复制运行
==============================

==============================
第一部分:有外网服务器 全新在线搭建Gitea
==============================
## 1、一键安装Docker与Compose插件
curl -fsSL https://get.docker.com | sudo bash
sudo systemctl start docker
sudo systemctl enable docker
sudo apt install -y docker-compose-plugin
# 验证版本
sudo docker --version
sudo docker compose version

## 2、配置阿里云镜像源加速拉取镜像
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json << EOF
{
  "registry-mirrors": ["https://docker.aliyuncs.com","https://hub-mirror.c.163.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
# 查看镜像源是否生效
sudo docker info | grep Registry Mirrors

## 3、创建部署目录,编写docker-compose.yml
sudo mkdir -p /opt/gitea
cd /opt/gitea
sudo vim docker-compose.yml
# 复制下方配置粘贴到文件内
version: '3'
services:
  mysql:
    image: mysql:8.0
    container_name: gitea-mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: Gitea@123
      MYSQL_DATABASE: gitea
    volumes:
      - ./mysql-data:/var/lib/mysql
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - ./gitea-data:/data
    depends_on:
      - mysql

## 4、后台启动容器
sudo docker compose up -d
# 查看运行状态
sudo docker compose ps

## 5、浏览器初始化配置
访问地址:http://服务器公网IP:3000
数据库配置:
数据库主机:mysql:3306
数据库名称:gitea
数据库用户:root
数据库密码:Gitea@123
站点ROOT_URL填写:http://服务器IP:3000/
设置管理员账号密码,点击安装完成

## 6、更换IP/域名修改访问地址命令
# 停止gitea容器
sudo docker compose stop gitea
# 修改配置文件
sudo vim ./gitea-data/gitea/conf/app.ini
# 修改[server]区块内容
[server]
ROOT_URL = http://新服务器IP:3000/
SSH_DOMAIN = 新服务器IP
# 重启生效
sudo docker compose up -d gitea

==============================
第二部分:离线迁移流程(源云服务器打包→本地无外网服务器导入)
==============================
===== 阶段A:源云服务器打包操作 =====
## 1、停止整套容器
cd /opt/gitea
sudo docker compose down

## 2、导出mysql、gitea离线镜像包
sudo docker save -o mysql-8.0.tar mysql:8.0
sudo docker save -o gitea-latest.tar gitea/gitea:latest
# 放开文件读取权限,方便拷贝传输
sudo chmod 777 mysql-8.0.tar gitea-latest.tar

## 3、打包数据库、gitea数据与配置文件
sudo tar -zcvf gitea-full-data.tar.gz mysql-data gitea-data docker-compose.yml
# 需要拷贝到本地服务器的文件:
# mysql-8.0.tar、gitea-latest.tar、gitea-full-data.tar.gz

===== 阶段B:目标本地无外网服务器部署迁移 =====
## 1、创建部署目录,上传3个压缩包到此目录
sudo mkdir -p /opt/gitea
cd /opt/gitea

## 2、导入离线docker镜像
sudo docker load -i mysql-8.0.tar
sudo docker load -i gitea-latest.tar
# 校验镜像是否导入成功
sudo docker images | grep -E "mysql|gitea"

## 3、解压全部业务数据
sudo tar -zxvf gitea-full-data.tar.gz -C /opt/gitea
# 修复目录读写权限(容器必须)
sudo chmod -R 777 mysql-data gitea-data

## 4、修改站点访问IP(消除地址不匹配警告)
sudo docker compose stop gitea
sudo vim ./gitea-data/gitea/conf/app.ini
# 修改内容
[server]
ROOT_URL = http://本地服务器内网IP:3000/
SSH_DOMAIN = 本地服务器内网IP

## 5、启动整套服务
sudo docker compose up -d
# 查看容器运行状态
sudo docker compose ps

## 6、验证
浏览器访问 http://本地服务器IP:3000,原有账号、仓库、数据全部保留

==============================
第三部分:日常维护通用命令
==============================
# 实时查看gitea运行日志
sudo docker compose logs -f gitea

# 重启全部服务
sudo docker compose restart

# 仅重启gitea服务
sudo docker compose restart gitea

# 停止容器,保留本地数据文件夹
sudo docker compose down

# 彻底重装(清空所有数据、镜像)
sudo docker compose down
sudo rm -rf mysql-data gitea-data *.tar *.tar.gz
sudo docker rmi mysql:8.0 gitea/gitea:latest
posted @ 2026-03-20 13:37  JackDDD  阅读(46)  评论(0)    收藏  举报