forgejo/docs/content/doc/installation/from-binary.zh-cn.md
Lunny Xiao e8433b7fe6
Restructure documentation. Now the documentation has installation, administration, usage, development, contributing the 5 main parts (#23629)
- **Installation**: includes how to install Gitea and related other
tools, also includes upgrade Gitea
- **Administration**: includes how to configure Gitea, customize Gitea
and manage Gitea instance out of Gitea admin UI
- **Usage**: includes how to use Gitea's functionalities. A sub
documentation is about packages, in future we could also include CI/CD
and others.
- **Development**: includes how to integrate with Gitea's API, how to
develop new features within Gitea
- **Contributing**: includes how to contribute code to Gitea
repositories.

After this is merged, I think we can have a sub-documentation of `Usage`
part named `Actions` to describe how to use Gitea actions

---------

Co-authored-by: John Olheiser <john.olheiser@gmail.com>
2023-03-23 23:18:24 +08:00

5.4 KiB
Raw Blame History

date title slug weight toc draft menu
2016-12-01T16:00:00+02:00 从二进制安装 install-from-binary 10 false false
sidebar
parent name weight identifier
installation 从二进制安装 20 install-from-binary

从二进制安装

所有打包的二进制程序均包含 SQLiteMySQL 和 PostgreSQL 的数据库连接支持,同时网站的静态资源均已嵌入到可执行程序中,这一点和曾经的 Gogs 有所不同。

目录

{{< toc >}}

下载

你可以从 下载页面 选择对应平台的二进制文件。

选择架构

  • 对于 Linuxlinux-amd64 适用于 64-bit 的 Intel/AMD 平台。更多架构包含 arm64 (Raspberry PI 4)386 (32-bit)arm-5 以及 arm-6

  • 对于 Windowswindows-4.0-amd64 适用于 64-bit 的 Intel/AMD 平台,386 适用于 32-bit 的 Intel/AMD 平台。(提示:gogit-windows 版本内建了 gogit 可能缓解在旧的 Windows 平台上 Go 程序调用 git 子程序时面临的 性能问题

  • 对于 macOSdarwin-arm64 适用于 Apple Silicon 架构,darwin-amd64 适用于 Intel 架构.

  • 对于 FreeBSDfreebsd12-amd64 适用于 64-bit 的 Intel/AMD 平台。

使用 wget 下载

使用以下命令下载适用于 64-bit Linux 平台的二进制文件。

wget -O gitea https://dl.gitea.com/gitea/{{< version >}}/gitea-{{< version >}}-linux-amd64
chmod +x gitea

验证 GPG 签名

Gitea 对打包的二进制文件使用 GPG密钥 签名以防止篡改。 请根据对应文件名 .asc 中包含的校验码检验文件的一致性。

gpg --keyserver keys.openpgp.org --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-{{< version >}}-linux-amd64.asc gitea-{{< version >}}-linux-amd64

校验正确时的信息为 Good signature from "Teabot <teabot@gitea.io>"。 校验错误时的信息为 This key is not certified with a trusted signature!

服务器设置

提示: GITEA_WORK_DIR 表示 Gitea 工作的路径。以下路径可以通过 [环境变量]({{< relref "doc/administration/environment-variables.zh-cn.md" >}}) 初始化。

准备环境

检查是否安装 Git。要求 Git 版本 >= 2.0。

git --version

创建用户(推荐使用名称 git

adduser \
   --system \
   --shell /bin/bash \
   --gecos 'Git Version Control' \
   --group \
   --disabled-password \
   --home /home/git \
   git

创建工作路径

mkdir -p /var/lib/gitea/{custom,data,log}
chown -R git:git /var/lib/gitea/
chmod -R 750 /var/lib/gitea/
mkdir /etc/gitea
chown root:git /etc/gitea
chmod 770 /etc/gitea

注意: 为了让 Web 安装程序可以写入配置文件,我们临时为 /etc/gitea 路径授予了组外用户 git 写入权限。建议在安装结束后将配置文件的权限设置为只读。

chmod 750 /etc/gitea
chmod 640 /etc/gitea/app.ini

如果您不希望通过 Web 安装程序创建配置文件,可以将配置文件设置为仅供 Gitea 用户只读owner/group root:git, mode 0640)并手工创建配置文件:

  • 设置 INSTALL_LOCK=true 关闭安装界面
  • 手动配置数据库连接参数
  • 使用 gitea generate secret 创建 SECRET_KEYINTERNAL_TOKEN
  • 提供所有必要的密钥

详情参考 命令行文档 中有关 gitea generate secret 的内容。

配置 Gitea 工作路径

提示: 如果使用 Systemd 管理 Gitea 的 Linux 服务,你可以采用 WorkingDirectory 参数来配置工作路径。 否则,使用环境变量 GITEA_WORK_DIR 来明确指出程序工作和数据存放路径。

export GITEA_WORK_DIR=/var/lib/gitea/

复制二进制文件到全局位置

cp gitea /usr/local/bin/gitea

运行 Gitea

完成以上步骤后,可以通过两种方式运行 Gitea

1. 创建服务自动启动 Gitea推荐

学习创建 [Linux 服务]({{< relref "run-as-service-in-ubuntu.zh-cn.md" >}})

2. 通过命令行终端运行

GITEA_WORK_DIR=/var/lib/gitea/ /usr/local/bin/gitea web -c /etc/gitea/app.ini

升级到最新版本

您可以通过停止程序,替换 /usr/local/bin/gitea 并重启来更新到新版本。直接替换可执行程序时不要更改或使用新的文件名称,以避免数据出错。

建议您在更新之前进行[备份]({{< relref "doc/administration/backup-and-restore.zh-cn.md" >}})。

1. 使用 systemd 重新启动 Gitea推荐

我们建议使用 systemd 作为服务管理器,使用 systemctl restart gitea 安全地重启程序。

2. 非 systemd 重启方法

使用 SIGHUP 信号关闭程序:查询到 Gitea 程序的 PID使用 kill -1 $GITEA_PID,或者 killall -1 gitea

更优雅的停止指令可能包括 kill $GITEA_PID 或者 killall gitea

提示: 我们不建议使用 SIGKILL 信号(-9),这会强制停止 Gitea 程序,但不会正确关闭队列、索引器等任务。

请参阅下面的疑难解答说明以在Gitea版本更新后修复损坏的仓库。

排查故障

更多经验总结,请参考英文版 Troubleshooting

如果从本页中没有找到你需要的内容,请访问 [帮助页面]({{< relref "seek-help.zh-cn.md" >}})