Gitea 安装和配置
Gitea 安装和配置: http://coffeelatte.cpolar.cn/post/software/applications/gitea/gitea_安装和配置/1. 简介
Gitea 是一个雷同于 GitHub 的功能强大的代码托管平台，利用 Go 语言开发，只需要一个可执行程序文件即可部署，非常简朴易用，且功能丰富。具有版本管理、组织管理、Issues讨论、版本发布等功能。内置维基百科和 SSH 子系统。
2. Gitea 安装
下载 Gitea 后直接运行，浏览器输入127.0.0.1:3000 来举行初始配置（需要先安装好数据库软件）。
3. 配置文件
Gitea 的配置文件为 <Gitea可执行程序路径>/custom/conf 目录下的 app.ini 文件。全部配置均可通过修改该文件来实现。修改完配置后，需要重启 Gitea 服务才能生效。
3.1. 发送测试邮件
以管理员账户登录 Gitea，点击右上角菜单进入“管理后台->应用配置”，下拉到“Mailer 配置->发送测试邮件”，输入吸收邮箱地址后点击“发送”按钮即可发送测试邮件。
4. 创建/删除 Gitea 服务
4.1. Windows 服务
利用 SC 下令创建 Gitea 服务，并自动运行：
sc create Gitea start= auto binPath= ""<绝对路径>\gitea.exe" web --config "<绝对路径>\custom\conf\app.ini""
创建完服务后进入 Windows Services 找到 Gitea 而且点击运行。
如不再需要，同样利用 SC 下令删除服务，删除服务前需先停止该服务。
sc delete Gitea
4.2. Linux 服务
systemd 服务的开启过程如下，首先创建 gitea.service 文件：
sudo vim /etc/systemd/system/gitea.service
并参照以下模板添补该文件：
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target
#After=mysqld.service
#After=postgresql.service
#After=memcached.service
#After=redis.service
# Modify these two values and uncomment them if you have
# repos with lots of files and get an HTTP error 500 because
# of that
###
#LimitMEMLOCK=infinity
#LimitNOFILE=65535
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini
Restart=always
#Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
# If you want to bind Gitea to a port below 1024 uncomment
# the two values below
###
#CapabilityBoundingSet=CAP_NET_BIND_SERVICE
#AmbientCapabilities=CAP_NET_BIND_SERVICE
WantedBy=multi-user.target
利用如下下令使能并启动 gitea 服务：
sudo systemctl enable gitea
sudo systemctl start gitea
利用如下下令停止 gitea 服务：
sudo systemctl stop gitea
5. 利用 HTTPS 服务
可以利用 Gitea 内嵌的 HTTPS 服务。内嵌 HTTPS 服务利用自认证证书，生成 10 年期限自认证证书下令如下：
gitea cert --host <HOST0,HOST1,...> --ca --duration 87600h
参数说明：
ArgumentDescription–host <value>Comma seperated hostnames and ips which this certificate is valid for. Wildcards are supported. Required.–duration <value>Duration which the certificate is valid for. Optional. (default: 8760h0m0s)–caIf provided, this cert generates it’s own certificate authority. Optional. 编辑 app.ini 文件如下：
PROTOCOL=https
ROOT_URL = https://git.example.com:3000/
HTTP_PORT = 3000
CERT_FILE = <绝对路径>/custom/https/cert.pem
KEY_FILE = <绝对路径>/custom/https/key.pem
注意，上面 CERT_FILE 和 KEY_FILE 必须利用绝对路径，否则无法正常启动 Gitea 服务。之后重启 Gitea 服务。通过浏览器访问 HTTPS 版本的 Gitea 服务，需要添加浏览器例外才能正常访问。另外客户端利用 git clone 需要关闭 git 的 ssl 认证功能。下令如下：
git config --global http.sslVerify false
另外 Gitea 还可以利用 Let’s Encrypt 提供的证书，这是 CA 认证证书，有用期为 90 天。Let’s Encrypt 的利用方法见官方手册。
6. 利用内置 SSH
Gitea 有内置 SSH 服务，支持 SSH 格式的 git clone，使能方式为修改 app.ini 文件中的下列内容：
SSH_DOMAIN = 127.0.0.1
DISABLE_SSH = false
START_SSH_SERVER = true
SSH_PORT = 3022
SSH_LISTEN_PORT= 3022
7. 邮箱配置
Gitea 可以通过预先配置好的电子邮件发送服务器发送服务邮件如：通知、消息、注册确认等信息。邮件发送服务器为 smtp 服务器，需要同时提供服务器端口，用户名和密码。
; Mail server
; Gmail: smtp.gmail.com:587
; QQ: smtp.qq.com:465
; 163: smtp.163.com:465
; Note, if the port ends with "465", SMTPS will be used. Using STARTTLS on port 587 is recommended per RFC 6409. If the server supports STARTTLS it will always be used.
ENABLED = true
; PROTOCOL: empty: One of "smtp", "smtps", "smtp+starttls", "smtp+unix", "sendmail", "dummy".
PROTOCOL = smtp
SMTP_ADDR = smtp.sina.com
; SMTP_PORT: empty: Mail server port. If no protocol is specified, it will be inferred by this setting. Common ports are
; * 25: insecure SMTP
; * 465: SMTP Secure
; * 587: StartTLS
; Mail from address, RFC 5322. This can be just an email address, or the `"Name" <email@example.com>` format
FROM = user_name@sina.com
; Mailer user name and password
USER = user_name@sina.com
; Use PASSWD = `your password` for quoting if you use special characters in the password. 该字段也可用于指定“设备授权码”
PASSWD= user_password
启用邮件系统后，可以开启邮件通知功能。该功能在有提示需要发送时，Gitea 会通过以上配置的邮件系统向用户发送邮件通知，如有 Issue 分派给了某个用户，则该用户会收到邮件提示。
; Mail notification
ENABLE_NOTIFY_MAIL = true
8. 答应通过邮箱举行外部注册
开启邮件系统后，可以开启邮件注册功能。用户可以本身注册账号，并收到注册确认邮件。通过点击注册确认邮件中的毗连，激活新账号。
; Whether a new user needs to confirm their email when registering.
REGISTER_EMAIL_CONFIRM = true
; Disallow registration, only allow admins to create accounts.
DISABLE_REGISTRATION = false
; Allow registration only using third part services, it works only when DISABLE_REGISTRATION is false
ALLOW_ONLY_EXTERNAL_REGISTRATION= false
; Enable captcha validation for registration
ENABLE_CAPTCHA = true
此中，校验码为可选功能，建议开启。
9. 配置文件示例
APP_NAME = Gitea: Git with a cup of tea
RUN_USER = Administrator
RUN_MODE = prod
INTERNAL_TOKEN = <TOKEN>
INSTALL_LOCK = true
SECRET_KEY = <KEY>
DB_TYPE= sqlite3
HOST = 127.0.0.1:3306
NAME = gitea
USER = gitea
PASSWD =
SSL_MODE = disable
PATH = <绝对路径>/data/gitea.db
ROOT = <绝对路径>/gitea-repositories
DISABLE_HTTP_GIT = true
ENABLED = true
FILE_MAX_SIZE = 1024
MAX_FILES = 1000
PROTOCOL = https
SSH_DOMAIN = 127.0.0.1
DOMAIN = 127.0.0.1
HTTP_PORT = 3000
ROOT_URL = %(PROTOCOL)s://127.0.0.1:3000/
CERT_FILE = <绝对路径>/Path/cert.pem
KEY_FILE = <绝对路径>/Path/key.pem
DISABLE_SSH = false
START_SSH_SERVER = true
SSH_PORT = 3022
SSH_LISTEN_PORT= 3022
LFS_START_SERVER = true
LFS_CONTENT_PATH = <绝对路径>/Path/data/lfs
LFS_JWT_SECRET = <SECRET>
OFFLINE_MODE = false
ENABLED = true
HOST = smtp.sina.com:465
FROM = user_name@sina.com
USER = user_name@sina.com
PASSWD= user_password
REGISTER_EMAIL_CONFIRM = true
ENABLE_NOTIFY_MAIL = true
DISABLE_REGISTRATION = false
ALLOW_ONLY_EXTERNAL_REGISTRATION= false
ENABLE_CAPTCHA = true
REQUIRE_SIGNIN_VIEW = true
DEFAULT_KEEP_EMAIL_PRIVATE = false
DEFAULT_ALLOW_CREATE_ORGANIZATION = false
DEFAULT_ENABLE_TIMETRACKING = true
NO_REPLY_ADDRESS = noreply.example.org
DISABLE_GRAVATAR = true
ENABLE_FEDERATED_AVATAR = false
ENABLE_OPENID_SIGNIN = false
ENABLE_OPENID_SIGNUP = false
PROVIDER = file
ENABLED = true
PATH = <绝对路径>/Path/data/attachments
ALLOWED_TYPES = image/jpeg|image/png|application/zip|application/gzip
MAX_SIZE = 4
MAX_FILES = 5
MODE = file
LEVEL = Info
ROOT_PATH = <绝对路径>/Path/log
SHOW_FOOTER_TEMPLATE_LOAD_TIME = false
10. 主题配置
主题文件主要是 CSS 文件，需要添加到：
${CUSTOM_PATH}/public/assets
/css/
以 theme-<theme-name>.css 格式定名。一样平常主题堆栈下的 CSS 文件已经按指定格式定名好了，直接下载到 CSS 目录即可。
有的主题还附加了图片等文件，也都放置在：
${CUSTOM_PATH}/public/assets
${CUSTOM_PATH} 可通过 -w 或 -C 参数指定，也可在 app.ini 文件中指定：
WORK_PATH = /Path/to/Gitea/Work/Dir
之以是指定 ${WORK_PATH}，是因为默认情况下 ${CUSTOM_PATH} 等于 ${WORK_PATH}/custom。
添加好的主题可在个人 设置->表面 中举行选择。主题与 Gitea 版本密切相干，很多第三方主题由于没有及时更新，大概和最新版本之间存在兼容问题，导致显示异常。因此定制主题后需要举行充分验证。
如果添加的主题没有出现在 设置->表面 中，或主题显示异常，大概是 app.ini 配置异常。app.ini 中的相干配置在 UI (ui) 配置下，主要是 DEFAULT_THEME 和 THEMES：
[*]DEFAULT_THEME：gitea-auto: Set the default theme for the Gitea installation, custom themes could be provided by ${CustomPath}/public/assets/css/theme-<theme-name>.css.
[*]THEMES：empty: All available themes by ${CustomPath}/public/assets/css/theme-<theme-name>.css. Allow users select personalized themes.
11. Linux 下利用代理实现堆栈迁徙和镜像
经常利用 Gitea 来迁徙或备份 Github 上的堆栈，若不利用代理则经常迁徙失败。因此需要为堆栈迁徙功能配置代理，实际上就是为 Gitea 配置代理。
我们知道，Linux 下可以利用：
export https_proxy=127.0.0.1:7890 http_proxy=127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7891
来为下令行程序设置代理。
但是当 Gitea 作为 Systemd 服务启动时这个代剖析失效。办理办法是通过 Systemd 的 Environment 来配置。例如 Gitea 的服务文件为 gitea.service，修改 Environment 如下：
Description=Gitea (Git with a cup of tea)
ExecStart=/Path/to/gitea
Environment=https_proxy="127.0.0.1:7890" http_proxy="127.0.0.1:7890" all_proxy="socks5://127.0.0.1:7891"
然后执行下列下令使配置生效：
sudo systemctl daemon-reload
sudo systemctl restart gitea
12. 备份与恢复
12.1. 备份
Gitea 已经实现了 dump 下令可以用来备份全部需要的文件到一个zip压缩文件。该压缩文件可以被用来举行数据恢复。
先转到 git 用户的权限: su git. 再 Gitea 目录运行 ./gitea dump。一样平常会显示雷同如下的输出：
2016/12/27 22:32:09 Creating tmp work dir: /tmp/gitea-dump-417443001
2016/12/27 22:32:09 Dumping local repositories.../home/git/gitea-repositories
2016/12/27 22:32:22 Dumping database...
2016/12/27 22:32:22 Packing dump files...
2016/12/27 22:32:34 Removing tmp work dir: /tmp/gitea-dump-417443001
2016/12/27 22:32:34 Finish dumping in file gitea-dump-1482906742.zip
最后生成的 gitea-dump-1482906742.zip 文件将会包罗如下内容：
[*]custom - 全部生存在 custom/ 目录下的配置和自定义的文件。
[*]data - 数据目录下的全部内容不包罗利用文件session的文件。该目录包罗 attachments, avatars, lfs, indexers, 如果利用sqlite 还会包罗 sqlite 数据库文件。
[*]gitea-db.sql - 数据库dump出来的 SQL。
[*]gitea-repo.zip - Git堆栈压缩文件。
[*]log/ - Logs文件，如果用作迁徙不是必须的。
中央备份文件将会在临时目录举行创建，如果您要重新指定临时目录，可以用 --tempdir 参数，或者用 TMPDIR 环境变量。
12.2. 恢复
当前还没有恢复下令，恢复需要人工举行。主要是把文件和数据库举行恢复。
例如：
unzip gitea-dump-1610949662.zip
cd gitea-dump-1610949662
mv data/conf/app.ini /etc/gitea/conf/app.ini
mv data/* /var/lib/gitea/data/
mv log/* /var/lib/gitea/log/
mv repos/* /var/lib/gitea/repositories/
chown -R gitea:gitea /etc/gitea/conf/app.ini /var/lib/gitea
# mysql
mysql --default-character-set=utf8mb4 -u$USER -p$PASS $DATABASE <gitea-db.sql
# sqlite3
sqlite3 $DATABASE_PATH <gitea-db.sql
# postgres
psql -U $USER -d $DATABASE < gitea-db.sql
service gitea restart
13. 外部参考资料
[*]官方网站
[*]下载毗连
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]