前言
好吧,我承认我这篇文档是把简单问题复杂化,其实一行 Docker 运行命令就能解决问题
不过,为了学习,尽量详尽的分解步骤,搞清楚每一个步骤,是很重要的
本文设计了多个知识点
更新 官方源 没有的 软件
创建 用户
为文件目录及子目录 赋予权限
查看 软件 运行日志
为 软件 创建 系统服务文件
Docker Compose 脚本编写
配置文件编写
前期准备
# 官方网站
https://about.gitea.cn/
# 官方网站 帮助文档
https://docs.gitea.cn/installation/install-from-binary
# 官方网址 Gitea 下载页面
https://dl.gitea.com/gitea/
# 下载 新版 Gitea
https://dl.gitea.com/gitea/1.21/gitea-1.21-linux-amd64
环境准备
安装Wget
# 如使用 Shell 环境直接下载 Gitea 二进制文件则需要安装 Wget,如用其他方法下载则不需要
# 安装 Wget
sudo yum install -y wget
安装新版 Git
# 之前版本的 Gitea 需要2.0以上版本的Git才能正常运行,因此在CentOS7.9.2207环境下, 需要安装更新版本的Git
# 该问题在最新版貌似改过来了,不过升级总没有坏处,所以先升级了
# 配置 IUS 源
# 此处,可以将 IUS 源换成清华大学的镜像源
sudo yum install -y https://mirrors.tuna.tsinghua.edu.cn/ius/ius-release-el7.rpm
or
sudo yum install -y https://repo.ius.io/ius-release-el7.rpm
# 查看 IUS 源 中的 Git版本
sudo yum search git|grep -E "^git2"
# 如果反应太慢也可以直接登录网站查看
https://mirrors.tuna.tsinghua.edu.cn/ius/7/x86_64/packages/g/
or
https://repo.ius.io/7/x86_64/packages/g/
# 安装 Git 2.36 版
sudo yum install -y git236
# 查询 当前 git 版本
git version
# 此处,Git 进作为服务器的一个功能使用,所以不需要做初始化设置
创建 gitea 用户
# 目前版本的 Gitea 不允许在 root 用户下运行,因此需要单独创建一个 gitea 可以运行的用户账户
# 创建一个名为 gitea 的系统用户、并为其创建家目录、指定Shell、并添加用户备注
sudo useradd \
-r \
-m \
-s /bin/bash \
-c 'Gitea User' \
gitea
创建 Gitea 运行及数据 目录
# 创建 Gitea 运行及数据 目录
mkdir -p /data/gitea/data
# 进入 Gitea 运行及数据 目录
cd /data/gitea
# 赋予 /data/gitea/ 及其子目录 读写进入权限
sudo chmod -R ugo+rwx /data/gitea
基本安装
使用二进制包部署
下载 Gitea 二进制安装包
# 下载 最新版本 Gitea 二进制安装包,并改名为gitea
wget -O gitea https://dl.gitea.com/gitea/1.21/gitea-1.21-linux-amd64
# 赋予 gitea 二进制文件 运行权限
sudo chmod +x gitea
# 运行 gitea (一定会报错)
./gitea web
# 验证 Gitea 运行 (查看运行日志)
nohup ./gitea web > gitea.log 2>&1 &
创建 Gitea 系统服务运行文件
# 使用命令 直接创建 Gitea 系统服务运行文件
sudo cat <<EOF > /etc/systemd/system/gitea.service
#!/bin/bash
[Unit]
Description=gitea
[Service]
User=gitea
ExecStart=/data/gitea/gitea web
Restart=on-abort
[Install]
WantedBy=multi-user.target
EOF
# 重新加载服务配置文件
sudo systemctl daemon-reload
# 启动 Gitea 服务
sudo systemctl start gitea.service
# 设置 Gitea 服务 为开机自启动
sudo systemctl enable gitea.service
# 检查 Gitea 服务 运行状态
sudo systemctl status gitea.service
# 查看Gitea 服务 进程运行信息
ps -ef | grep gitea
防火墙放行 Gitea 服务
# 防火墙放行 Gitea 网页 服务
sudo firewall-cmd --permanent --zone=public --add-port=3000/tcp
# 防火墙放行 Gitea SSH 服务
sudo firewall-cmd --permanent --zone=public --add-port=22/tcp
# 生效 防火墙策略
firewall-cmd --reload
使用 Docker Compose 方式部署 (SQLite版)
# 使用命令 直接创建 Gitea Docker Compose 脚本文件
sudo cat <<EOF > docker-compose.yml
version: "3"
networks:
gitea:
external: false
services:
server:
image: gitea/gitea:1.21
container_name: gitea
environment:
- USER_UID=1000
- USER_GID=1000
restart: always
networks:
- gitea
volumes:
- /data/gitea:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "2201:22"
EOF
# 运行 Docker Compose 脚本
sudo docker compose up -d
sudo docker-compose up -d
# 查看 容器 运行情况
sudo docker compose logs
sudo docker-compose logs
# 终止 当前 容器
sudo docker compose down
sudo docker-compose down
使用 Docker Compose 方式部署 (MySQL版)
# 创建 MySQL 运行及数据 目录
mkdir -p /data/mysql
# 使用命令 直接创建 Gitea Docker Compose 脚本文件
sudo cat <<EOF > docker-compose.yml
version: "3"
networks:
gitea:
external: false
services:
server:
image: gitea/gitea:1.21
container_name: gitea
environment:
- USER_UID=1000
- USER_GID=1000
+ - GITEA__database__DB_TYPE=mysql
+ - GITEA__database__HOST=db:3306
+ - GITEA__database__NAME=gitea
+ - GITEA__database__USER=gitea
+ - GITEA__database__PASSWD=gitea
restart: always
networks:
- gitea
volumes:
- /data/gitea:/data/
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "2201:22"
depends_on:
- db
db:
image: mysql:8
restart: always
environment:
- MYSQL_ROOT_PASSWORD=gitea
- MYSQL_USER=gitea
- MYSQL_PASSWORD=gitea
- MYSQL_DATABASE=gitea
networks:
- gitea
volumes:
- /data/mysql:/var/lib/mysql
EOF
# 运行 Docker Compose 脚本
sudo docker compose up -d
sudo docker-compose up -d
# 查看 容器 运行情况
sudo docker compose logs
sudo docker-compose logs
# 终止 当前 容器
sudo docker compose down
sudo docker-compose down
Gitea 初始化设置
网页初始化
# 数据库类型:SQLite3
# 数据库文件路径:{默认}
# 站点名称:{根据需求修改}
# 仓库根目录:{默认}
# LFS根目录:{默认}
# 以用户名运行:{默认}
# 服务器域名:{根据需求修改}
# SSH服务端口:{默认} (就算用Docker 改为别的端口,内部也是默认的22)
# HTTP 服务端口:{默认} (可以修改,如使用Docker 改为别的端口,则需要修改Dokcer 脚本,并重新运行 Docker)
# 基础 URL: {默认}
# 日志路径:{默认}
初次登录 Gitea 站点
# Gitea 站点 URL
http://Server_IP3000
创建首个账号
# 由于初始化配置时没有配置管理员,因此第一个用户会自动变成管理员
用户登录 Gitea
修改 配置文件
# Gitea 配置文件路径
/data/gitea/custom/conf/app.ini
# Gitea 配置文件 官方教程
https://docs.gitea.cn/administration/config-cheat-sheet
# 修改完 配置文件后,需要重启 Gitea
# 重新启动 Gitea 服务
sudo systemctl restart gitea.service
Gitea 完整 配置文件内容
; Gitea 站点名称
APP_NAME = FourLeaf Git Server
; Gitea 运行用户
RUN_USER = gitea
; Gitea 运行目录
WORK_PATH = /data/gitea
RUN_MODE = prod
[database]
DB_TYPE = sqlite3
HOST = 127.0.0.1:3306
NAME = gitea
USER = gitea
PASSWD =
SCHEMA =
SSL_MODE = disable
PATH = /data/gitea/data/gitea.db
LOG_SQL = false
[repository]
ROOT = /data/gitea/data/gitea-repositories
[server]
SSH_DOMAIN = 172.16.28.125
DOMAIN = 172.16.28.125
HTTP_PORT = 3000
ROOT_URL = http://172.16.28.125:3000/
APP_DATA_PATH = /data/gitea/data
DISABLE_SSH = false
SSH_PORT = 22
; 启用 git-lfs 支持。true 或 false,默认为 false
LFS_START_SERVER = true
LFS_JWT_SECRET = zBwh1huixV55w0FpHA7oLMlpd_Y9B-r2aaMfPkGeFrk
OFFLINE_MODE = false
[lfs]
; 存放 LFS 文件的路径,默认为 data/lfs
PATH = /data/gitea/data/lfs
[mailer]
; Gitea 使用 sendmail 作为邮件传输代理
; 开启或关闭 邮件功能 true / false
ENABLED = false
; FROM = {电子邮件地址}
; MAILER_TYPE = sendmail
; SENDMAIL_PATH = /usr/sbin/sendmail
; 大多数 "sendmail" 程序都接受选项,使用 "--" 将防止电子邮件地址被解释为选项
; SENDMAIL_ARGS = "--"
[service]
REGISTER_EMAIL_CONFIRM = false
ENABLE_NOTIFY_MAIL = false
DISABLE_REGISTRATION = false
ALLOW_ONLY_EXTERNAL_REGISTRATION = false
ENABLE_CAPTCHA = false
REQUIRE_SIGNIN_VIEW = false
DEFAULT_KEEP_EMAIL_PRIVATE = false
DEFAULT_ALLOW_CREATE_ORGANIZATION = true
DEFAULT_ENABLE_TIMETRACKING = true
NO_REPLY_ADDRESS = noreply.localhost
[openid]
ENABLE_OPENID_SIGNIN = true
ENABLE_OPENID_SIGNUP = true
[cron.update_checker]
ENABLED = false
[session]
PROVIDER = file
[log]
MODE = console
LEVEL = info
ROOT_PATH = /data/gitea/log
[repository.pull-request]
DEFAULT_MERGE_STYLE = merge
[repository.signing]
DEFAULT_TRUST_MODEL = committer
[security]
INSTALL_LOCK = true
INTERNAL_TOKEN = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYmYiOjE3MDA2MTg5NjB9.YKxX1kUW5N_yjFOspKuNe-qWbH1x4zdAyJo2M4vc1oM
PASSWORD_HASH_ALGO = pbkdf2
[oauth2]
JWT_SECRET = VeHg4gCAvWYE7Fz7f2vWsVzwtYlC12omCWZQxBxqdig
允许上传文件限制 设置
[attachment]
; 是否允许用户上传附件
ENABLED = true
; 允许上传所有文件类型
ALLOWED_TYPES = */*
; 附件的最大限制(MB)
MAX_SIZE = 10240
; 一次最多上传的附件数量
MAX_FILES = 5
; 可选配置
; 附件存储类型,local 将存储到本地文件夹, minio 将存储到 s3 兼容的对象存储服务中
STORAGE_TYPE = local
; 附件存储路径,仅当 STORAGE_TYPE 为 local 时有效
PATH = data/attachments
; Minio URL,仅当 STORAGE_TYPE 是 minio 时有效。
MINIO_ENDPOINT = localhost:9000:
; Minio accessKeyID,仅当 STORAGE_TYPE 是 minio 时有效
MINIO_ACCESS_KEY_ID = {Minio accessKeyID}
; Minio secretAccessKey,仅当 STORAGE_TYPE 是 minio 时有效
MINIO_SECRET_ACCESS_KEY = {Minio secretAccessKey}
; Minio bucket to store the attachments,仅当 STORAGE_TYPE 是 minio 时有效
MINIO_BUCKET = gitea
; Minio location to create bucket,仅当 STORAGE_TYPE 是 minio 时有效
MINIO_LOCATION = us-east-1:
; Minio base path on the bucket,仅当 STORAGE_TYPE 是 minio 时有效
MINIO_BASE_PATH = attachments/
; Minio enabled ssl,仅当 STORAGE_TYPE 是 minio 时有效
MINIO_USE_SSL = false
# 允许类型列表
ALLOWED_TYPES = .csv,.docx,.fodg,.fodp,.fods,.fodt,.gif,.gz,.jpeg,.jpg,.log,.md,.mov,.mp4,.odf,.odg,.odp,.ods,.odt,.patch,.pdf,.png,.pptx,.svg,.tgz,.txt,.webm,.xls,.xlsx,.zip: 允许的文件扩展名(.zip)、mime 类型(text/plain)或通配符类型(image/*、audio/*、video/*)的逗号分隔列表。空值或 */* 允许所有类型
电子邮件 设置
[mailer]
ENABLED = true
FROM = {电子邮件地址}
MAILER_TYPE = smtp
SMTP_ADDR = {SMTP服务器地址}
SMTP_PORT = 587
IS_TLS_ENABLED = true
USER = {电子邮件用户名}
PASSWD = `{电子邮件密码}`
LFS 大文件存储 设置
# LFS 功能 需要 Git 版本大于 2.1.2
[server]
; 启用 git-lfs 支持。true 或 false,默认为 false。
LFS_START_SERVER = true
[lfs]
; 存放 LFS 文件的路径,默认为 data/lfs。
PATH = /home/gitea/data/lfs
HTTPS 设置
[server]
PROTOCOL = https
ROOT_URL = https://{GiteaURL}:3000/
HTTP_PORT = 3000
CERT_FILE = cert.pem
KEY_FILE = key.pem
仓库索引器 设置
[indexer]
; ...
; 将排除供应商文件不包含在索引中
REPO_INDEXER_ENABLED = true
REPO_INDEXER_PATH = indexers/repos.bleve
; 选项将使索引器跳过所有大于指定值的文件
MAX_FILE_SIZE = 1048576
; 以逗号分隔的列表,用来表示需要索引的文件,为空表示所有文件
REPO_INDEXER_INCLUDE =
; 以逗号分隔的列表,用来表示需要排除的文件,优先级高于“REPO_INDEXER_INCLUDE”
REPO_INDEXER_EXCLUDE = resources/bin/**