Skip to content

Commit b6d7722

Browse files
Xinyu Zhoulunny
Xinyu Zhou
andauthored
docs: Update translation from-binary.zh-cn.md (#22820)
Signed-off-by: Xinyu Zhou <[email protected]> Co-authored-by: Lunny Xiao <[email protected]>
1 parent f2772b5 commit b6d7722

File tree

2 files changed

+142
-11
lines changed

2 files changed

+142
-11
lines changed

docs/content/doc/installation/from-binary.en-us.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,15 +16,15 @@ menu:
1616
# Installation from binary
1717

1818
All downloads come with SQLite, MySQL and PostgreSQL support, and are built with
19-
embedded assets. This can be different for older releases.
19+
embedded assets. This can be different from Gogs.
2020

2121
**Table of Contents**
2222

2323
{{< toc >}}
2424

2525
## Download
2626

27-
You can find the file matching your platform from the [downloads page](https://dl.gitea.io/gitea/) after navigating to the version you want to download.
27+
You can find the file matching your platform from the [downloads page](https://dl.gitea.com/gitea/) after navigating to the version you want to download.
2828

2929
### Choosing the right file
3030

@@ -36,12 +36,14 @@ You can find the file matching your platform from the [downloads page](https://d
3636

3737
**For macOS**, you should choose `darwin-arm64` if your hardware uses Apple Silicon, or `darwin-amd64` for Intel.
3838

39+
**For FreeBSD**, you should choose `freebsd12-amd64` for 64-bit Intel/AMD platforms.
40+
3941
### Downloading with wget
4042

4143
Copy the commands below and replace the URL within the one you wish to download.
4244

4345
```sh
44-
wget -O gitea https://dl.gitea.io/gitea/{{< version >}}/gitea-{{< version >}}-linux-amd64
46+
wget -O gitea https://dl.gitea.com/gitea/{{< version >}}/gitea-{{< version >}}-linux-amd64
4547
chmod +x gitea
4648
```
4749

@@ -173,7 +175,7 @@ an update of your Gitea version.
173175
Older Linux distributions (such as Debian 7 and CentOS 6) may not be able to load the
174176
Gitea binary, usually producing an error such as `./gitea: /lib/x86_64-linux-gnu/libc.so.6:
175177
version 'GLIBC\_2.14' not found (required by ./gitea)`. This is due to the integrated
176-
SQLite support in the binaries provided by dl.gitea.io. In this situation, it is usually
178+
SQLite support in the binaries provided by dl.gitea.com. In this situation, it is usually
177179
possible to [install from source]({{< relref "from-source.en-us.md" >}}), without including
178180
SQLite support.
179181

docs/content/doc/installation/from-binary.zh-cn.md

Lines changed: 136 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,21 +15,150 @@ menu:
1515

1616
# 从二进制安装
1717

18-
所有下载均包括 SQLite, MySQL 和 PostgreSQL 的支持,同时所有资源均已嵌入到可执行程序中,这一点和老版本有所不同。 基于二进制的安装非常简单,只要从 [下载页面](https://dl.gitea.io/gitea) 选择对应平台,拷贝下载URL,执行以下命令即可(以Linux为例):
18+
所有打包的二进制程序均包含 SQLiteMySQL 和 PostgreSQL 的数据库连接支持,同时网站的静态资源均已嵌入到可执行程序中,这一点和曾经的 Gogs 有所不同。
1919

20-
```
21-
wget -O gitea https://dl.gitea.io/gitea/{{< version >}}/gitea-{{< version >}}-linux-amd64
20+
**目录**
21+
22+
{{< toc >}}
23+
24+
## 下载
25+
26+
你可以从 [下载页面](https://dl.gitea.com/gitea/) 选择对应平台的二进制文件。
27+
28+
### 选择架构
29+
30+
- **对于 Linux**`linux-amd64` 适用于 64-bit 的 Intel/AMD 平台。更多架构包含 `arm64` (Raspberry PI 4),`386` (32-bit),`arm-5` 以及 `arm-6`
31+
32+
- **对于 Windows**`windows-4.0-amd64` 适用于 64-bit 的 Intel/AMD 平台,`386` 适用于 32-bit 的 Intel/AMD 平台。(提示:`gogit-windows` 版本内建了 gogit 可能缓解在旧的 Windows 平台上 Go 程序调用 git 子程序时面临的 [性能问题](https://github.com/go-gitea/gitea/pull/15482)
33+
34+
- **对于 macOS**`darwin-arm64` 适用于 Apple Silicon 架构,`darwin-amd64` 适用于 Intel 架构.
35+
36+
- **对于 FreeBSD**`freebsd12-amd64` 适用于 64-bit 的 Intel/AMD 平台。
37+
38+
### 使用 wget 下载
39+
40+
使用以下命令下载适用于 64-bit Linux 平台的二进制文件。
41+
42+
```sh
43+
wget -O gitea https://dl.gitea.com/gitea/{{< version >}}/gitea-{{< version >}}-linux-amd64
2244
chmod +x gitea
2345
```
2446

25-
## 测试
47+
## 验证 GPG 签名
2648

27-
在执行了以上步骤之后,你将会获得 `gitea` 的二进制文件,在你复制到部署的机器之前可以先测试一下。在命令行执行完后,你可以 `Ctrl + C` 关掉程序。
49+
Gitea 对打包的二进制文件使用 [GPG密钥](https://keys.openpgp.org/search?q=teabot%40gitea.io) 签名以防止篡改。
50+
请根据对应文件名 `.asc` 中包含的校验码检验文件的一致性。
2851

52+
```sh
53+
gpg --keyserver keys.openpgp.org --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
54+
gpg --verify gitea-{{< version >}}-linux-amd64.asc gitea-{{< version >}}-linux-amd64
2955
```
30-
./gitea web
56+
57+
校验正确时的信息为 `Good signature from "Teabot <[email protected]>"`
58+
校验错误时的信息为 `This key is not certified with a trusted signature!`
59+
60+
## 服务器设置
61+
62+
**提示:** `GITEA_WORK_DIR` 表示 Gitea 工作的路径。以下路径可以通过 [环境变量]({{< relref "doc/advanced/environment-variables.zh-cn.md" >}}) 初始化。
63+
64+
### 准备环境
65+
66+
检查是否安装 Git。要求 Git 版本 >= 2.0。
67+
68+
```sh
69+
git --version
70+
```
71+
72+
创建用户(推荐使用名称 `git`
73+
74+
```sh
75+
adduser \
76+
--system \
77+
--shell /bin/bash \
78+
--gecos 'Git Version Control' \
79+
--group \
80+
--disabled-password \
81+
--home /home/git \
82+
git
3183
```
3284

33-
## 需要帮助?
85+
### 创建工作路径
86+
87+
```sh
88+
mkdir -p /var/lib/gitea/{custom,data,log}
89+
chown -R git:git /var/lib/gitea/
90+
chmod -R 750 /var/lib/gitea/
91+
mkdir /etc/gitea
92+
chown root:git /etc/gitea
93+
chmod 770 /etc/gitea
94+
```
95+
96+
> **注意:** 为了让 Web 安装程序可以写入配置文件,我们临时为 `/etc/gitea` 路径授予了组外用户 `git` 写入权限。建议在安装结束后将配置文件的权限设置为只读。
97+
>
98+
> ```sh
99+
> chmod 750 /etc/gitea
100+
> chmod 640 /etc/gitea/app.ini
101+
> ```
102+
103+
如果您不希望通过 Web 安装程序创建配置文件,可以将配置文件设置为仅供 Gitea 用户只读(owner/group `root:git`, mode `0640`)并手工创建配置文件:
104+
105+
- 设置 `INSTALL_LOCK=true` 关闭安装界面
106+
- 手动配置数据库连接参数
107+
- 使用 `gitea generate secret` 创建 `SECRET_KEY``INTERNAL_TOKEN`
108+
- 提供所有必要的密钥
109+
110+
详情参考 [命令行文档](/zh-cn/command-line/) 中有关 `gitea generate secret` 的内容。
111+
112+
### 配置 Gitea 工作路径
113+
114+
**提示:** 如果使用 Systemd 管理 Gitea 的 Linux 服务,你可以采用 `WorkingDirectory` 参数来配置工作路径。 否则,使用环境变量 `GITEA_WORK_DIR` 来明确指出程序工作和数据存放路径。
115+
116+
```sh
117+
export GITEA_WORK_DIR=/var/lib/gitea/
118+
```
119+
120+
### 复制二进制文件到全局位置
121+
122+
```sh
123+
cp gitea /usr/local/bin/gitea
124+
```
125+
126+
## 运行 Gitea
127+
128+
完成以上步骤后,可以通过两种方式运行 Gitea:
129+
130+
### 1. 创建服务自动启动 Gitea(推荐)
131+
132+
学习创建 [Linux 服务]({{< relref "run-as-service-in-ubuntu.zh-cn.md" >}})
133+
134+
### 2. 通过命令行终端运行
135+
136+
```sh
137+
GITEA_WORK_DIR=/var/lib/gitea/ /usr/local/bin/gitea web -c /etc/gitea/app.ini
138+
```
139+
140+
## 升级到最新版本
141+
142+
您可以通过停止程序,替换 `/usr/local/bin/gitea` 并重启来更新到新版本。直接替换可执行程序时不要更改或使用新的文件名称,以避免数据出错。
143+
144+
建议您在更新之前进行[备份]({{< relref "doc/usage/backup-and-restore.zh-cn.md" >}})。
145+
146+
### 1. 使用 systemd 重新启动 Gitea(推荐)
147+
148+
我们建议使用 systemd 作为服务管理器,使用 `systemctl restart gitea` 安全地重启程序。
149+
150+
### 2. 非 systemd 重启方法
151+
152+
使用 SIGHUP 信号关闭程序:查询到 Gitea 程序的 PID,使用 `kill -1 $GITEA_PID`,或者 `killall -1 gitea`
153+
154+
更优雅的停止指令可能包括 `kill $GITEA_PID` 或者 `killall gitea`
155+
156+
**提示:** 我们不建议使用 SIGKILL 信号(`-9`),这会强制停止 Gitea 程序,但不会正确关闭队列、索引器等任务。
157+
158+
请参阅下面的疑难解答说明,以在Gitea版本更新后修复损坏的仓库。
159+
160+
## 排查故障
161+
162+
> 更多经验总结,请参考英文版 [Troubleshooting](/en-us/install-from-binary/#troubleshooting)
34163
35164
如果从本页中没有找到你需要的内容,请访问 [帮助页面]({{< relref "seek-help.zh-cn.md" >}})

0 commit comments

Comments
 (0)