code.gitea.io/gitea@v1.22.3/docs/content/installation/from-binary.zh-cn.md (about)

     1  ---
     2  date: "2016-12-01T16:00:00+02:00"
     3  title: "使用二进制文件安装"
     4  slug: "install-from-binary"
     5  sidebar_position: 15
     6  toc: false
     7  draft: false
     8  aliases:
     9    - /zh-cn/install-from-binary
    10  menu:
    11    sidebar:
    12      parent: "installation"
    13      name: "使用二进制文件安装"
    14      sidebar_position: 15
    15      identifier: "install-from-binary"
    16  ---
    17  
    18  # 使用二进制文件安装
    19  
    20  所有打包的二进制程序均包含 SQLite，MySQL 和 PostgreSQL 的数据库连接支持，同时网站的静态资源均已嵌入到可执行程序中，这一点和曾经的 Gogs 有所不同。
    21  
    22  ## 下载
    23  
    24  你可以从 [下载页面](https://dl.gitea.com/gitea/) 选择对应平台的二进制文件。
    25  
    26  ### 选择架构
    27  
    28  - **对于 Linux**，`linux-amd64` 适用于 64-bit 的 Intel/AMD 平台。更多架构包含 `arm64` (Raspberry PI 4)，`386` (32-bit)，`arm-5` 以及 `arm-6`。
    29  
    30  - **对于 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)）
    31  
    32  - **对于 macOS**，`darwin-arm64` 适用于 Apple Silicon 架构，`darwin-amd64` 适用于 Intel 架构.
    33  
    34  - **对于 FreeBSD**，`freebsd12-amd64` 适用于 64-bit 的 Intel/AMD 平台。
    35  
    36  ### 使用 wget 下载
    37  
    38  使用以下命令下载适用于 64-bit Linux 平台的二进制文件。
    39  
    40  ```sh
    41  wget -O gitea https://dl.gitea.com/gitea/@version@/gitea-@version@-linux-amd64
    42  chmod +x gitea
    43  ```
    44  
    45  ## 验证 GPG 签名
    46  
    47  Gitea 对打包的二进制文件使用 [GPG密钥](https://keys.openpgp.org/search?q=teabot%40gitea.io) 签名以防止篡改。
    48  请根据对应文件名 `.asc` 中包含的校验码检验文件的一致性。
    49  
    50  ```sh
    51  gpg --keyserver keys.openpgp.org --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
    52  gpg --verify gitea-@version@-linux-amd64.asc gitea-@version@-linux-amd64
    53  ```
    54  
    55  校验正确时的信息为 `Good signature from "Teabot <teabot@gitea.io>"`。
    56  校验错误时的信息为 `This key is not certified with a trusted signature!`。
    57  
    58  ## 服务器设置
    59  
    60  **提示：** `GITEA_WORK_DIR` 表示 Gitea 工作的路径。以下路径可以通过 [环境变量](administration/environment-variables.md) 初始化。
    61  
    62  ### 准备环境
    63  
    64  检查是否安装 Git。要求 Git 版本 >= 2.0。
    65  
    66  ```sh
    67  git --version
    68  ```
    69  
    70  创建用户（推荐使用名称 `git`）
    71  
    72  ```sh
    73  # On Ubuntu/Debian:
    74  adduser \
    75     --system \
    76     --shell /bin/bash \
    77     --gecos 'Git Version Control' \
    78     --group \
    79     --disabled-password \
    80     --home /home/git \
    81     git
    82  
    83  # On Fedora/RHEL/CentOS:
    84  groupadd --system git
    85  adduser \
    86     --system \
    87     --shell /bin/bash \
    88     --comment 'Git Version Control' \
    89     --gid git \
    90     --home-dir /home/git \
    91     --create-home \
    92     git
    93  ```
    94  
    95  ### 创建工作路径
    96  
    97  ```sh
    98  mkdir -p /var/lib/gitea/{custom,data,log}
    99  chown -R git:git /var/lib/gitea/
   100  chmod -R 750 /var/lib/gitea/
   101  mkdir /etc/gitea
   102  chown root:git /etc/gitea
   103  chmod 770 /etc/gitea
   104  ```
   105  
   106  > **注意：** 为了让 Web 安装程序可以写入配置文件，我们临时为 `/etc/gitea` 路径授予了组外用户 `git` 写入权限。建议在安装结束后将配置文件的权限设置为只读。
   107  >
   108  > ```sh
   109  > chmod 750 /etc/gitea
   110  > chmod 640 /etc/gitea/app.ini
   111  > ```
   112  
   113  如果您不希望通过 Web 安装程序创建配置文件，可以将配置文件设置为仅供 Gitea 用户只读（owner/group `root:git`, mode `0640`）并手工创建配置文件：
   114  
   115  - 设置 `INSTALL_LOCK=true` 关闭安装界面
   116  - 手动配置数据库连接参数
   117  - 使用 `gitea generate secret` 创建 `SECRET_KEY` 和 `INTERNAL_TOKEN`
   118  - 提供所有必要的密钥
   119  
   120  详情参考 [命令行文档](administration/command-line.md) 中有关 `gitea generate secret` 的内容。
   121  
   122  ### 配置 Gitea 工作路径
   123  
   124  **提示：** 如果使用 Systemd 管理 Gitea 的 Linux 服务，你可以采用 `WorkingDirectory` 参数来配置工作路径。 否则，使用环境变量 `GITEA_WORK_DIR` 来明确指出程序工作和数据存放路径。
   125  
   126  ```sh
   127  export GITEA_WORK_DIR=/var/lib/gitea/
   128  ```
   129  
   130  ### 复制二进制文件到全局位置
   131  
   132  ```sh
   133  cp gitea /usr/local/bin/gitea
   134  ```
   135  
   136  ### 添加 bash/zsh 自动补全（从 1.19 版本开始）
   137  
   138  可以在 [`contrib/autocompletion/bash_autocomplete`](https://raw.githubusercontent.com/go-gitea/gitea/main/contrib/autocompletion/bash_autocomplete) 找到启用 bash 自动补全的脚本。可以将其复制到 `/usr/share/bash-completion/completions/gitea`，或在 `.bashrc` 中引用。
   139  
   140  同样地，zsh 自动补全的脚本可以在 [`contrib/autocompletion/zsh_autocomplete`](https://raw.githubusercontent.com/go-gitea/gitea/main/contrib/autocompletion/zsh_autocomplete) 找到。您可以将其复制到 `/usr/share/zsh/_gitea`，或在您的 `.zshrc` 中引用。
   141  
   142  具体情况可能会有所不同，这些脚本可能需要进一步的改进。
   143  
   144  ## 运行 Gitea
   145  
   146  完成以上步骤后，可以通过两种方式运行 Gitea：
   147  
   148  ### 1. 创建服务自动启动 Gitea（推荐）
   149  
   150  学习创建 [Linux 服务](installation/run-as-service-in-ubuntu.md)
   151  
   152  ### 2. 通过命令行终端运行
   153  
   154  ```sh
   155  GITEA_WORK_DIR=/var/lib/gitea/ /usr/local/bin/gitea web -c /etc/gitea/app.ini
   156  ```
   157  
   158  ## 升级到最新版本
   159  
   160  您可以通过停止程序，替换 `/usr/local/bin/gitea` 并重启来更新到新版本。直接替换可执行程序时不要更改或使用新的文件名称，以避免数据出错。
   161  
   162  建议您在更新之前进行[备份](administration/backup-and-restore.md)。
   163  
   164  如果您按照上述描述执行了安装步骤，二进制文件的通用名称应为 gitea。请勿更改此名称，即不要包含版本号。
   165  
   166  ### 1. 使用 systemd 重新启动 Gitea（推荐）
   167  
   168  我们建议使用 systemd 作为服务管理器，使用 `systemctl restart gitea` 安全地重启程序。
   169  
   170  ### 2. 非 systemd 重启方法
   171  
   172  使用 SIGHUP 信号关闭程序：查询到 Gitea 程序的 PID，使用 `kill -1 $GITEA_PID`，或者 `killall -1 gitea`。
   173  
   174  更优雅的停止指令可能包括 `kill $GITEA_PID` 或者 `killall gitea`。
   175  
   176  **提示：** 我们不建议使用 SIGKILL 信号（`-9`），这会强制停止 Gitea 程序，但不会正确关闭队列、索引器等任务。
   177  
   178  请参阅下面的疑难解答说明，以在Gitea版本更新后修复损坏的仓库。
   179  
   180  ## 排查故障
   181  
   182  ### 旧版 glibc
   183  
   184  旧版 Linux 发行版（例如 Debian 7 和 CentOS 6）可能无法加载 Gitea 二进制文件，通常会产生类似于 `./gitea: /lib/x86_64-linux-gnu/libc.so.6:
   185  version 'GLIBC\_2.14' not found (required by ./gitea)` 的错误。这是由于 dl.gitea.com 提供的二进制文件中集成了 SQLite 支持。在这种情况下，通常可以选择[从源代码安装](installation/from-source.md)，而不包括 SQLite 支持。
   186  
   187  ### 在另一个端口上运行 Gitea
   188  
   189  对于出现类似于 `702 runWeb()] [E] Failed to start server: listen tcp 0.0.0.0:3000:
   190  bind: address already in use` 的错误，需要将 Gitea 启动在另一个空闲端口上。您可以使用 `./gitea web -p $PORT` 来实现。可能已经有另一个 Gitea 实例在运行。
   191  
   192  ### 在 Raspbian 上运行 Gitea
   193  
   194  从 v1.8 版本开始，arm7 版本的 Gitea 存在问题，无法在树莓派和类似设备上运行。
   195  
   196  建议切换到 arm6 版本，该版本经过测试并已被证明可以在树莓派和类似设备上运行。
   197  
   198  ### 更新到新版本的 Gitea 后出现的 Git 错误
   199  
   200  如果在更新过程中，二进制文件的名称已更改为新版本的 Gitea，则现有仓库中的 Git 钩子将不再起作用。在这种情况下，当推送到仓库时，会显示 Git 错误。
   201  
   202  ```
   203  remote: ./hooks/pre-receive.d/gitea: line 2: [...]: No such file or directory
   204  ```
   205  
   206  错误信息中的 `[...]` 部分将包含您先前 Gitea 二进制文件的路径。
   207  
   208  要解决此问题，请转到管理选项，并运行任务 `Resynchronize pre-receive, update and post-receive hooks of all repositories`，以将所有钩子更新为包含新的二进制文件路径。请注意，这将覆盖所有 Git 钩子，包括自定义的钩子。
   209  
   210  如果您没有使用 Gitea 内置的 SSH 服务器，您还需要通过在管理选项中运行任务 `Update the '.ssh/authorized_keys' file with Gitea SSH keys.` 来重新编写授权密钥文件。
   211  
   212  > 更多经验总结，请参考英文版 [Troubleshooting](https://docs.gitea.com/installation/install-from-binary#troubleshooting)
   213  
   214  如果从本页中没有找到你需要的内容，请访问 [帮助页面](help/support.md)