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

     1  ---
     2  date: "2016-12-01T16:00:00+02:00"
     3  title: "使用源代码安装"
     4  slug: "install-from-source"
     5  sidebar_position: 30
     6  toc: false
     7  draft: false
     8  aliases:
     9    - /zh-cn/install-from-source
    10  menu:
    11    sidebar:
    12      parent: "installation"
    13      name: "使用源代码安装"
    14      sidebar_position: 30
    15      identifier: "install-from-source"
    16  ---
    17  
    18  # 使用源代码安装
    19  
    20  你需要 [安装Go](https://golang.google.cn/doc/install) 并正确设置Go环境。特别的，建议设置`$GOPATH`环境变量，并将 Go 的二进制目录或目录`${GOPATH//://bin:}/bin`添加到`$PATH`中。请参阅 Go 百科上关于 [GOPATH](https://github.com/golang/go/wiki/GOPATH) 的词条。
    21  
    22  接下来，[安装 Node.js 和 npm](https://nodejs.org/zh-cn/download/)， 这是构建 JavaScript 和 CSS 文件所需的。最低支持的 Node.js 版本是 @minNodeVersion@，建议使用最新的 LTS 版本。
    23  
    24  **注意**：需要 Go 版本 @minGoVersion@ 或更高版本。不过，建议获取与我们的持续集成（continuous integration, CI）相同的版本，请参阅在 [Hacking on Gitea](development/hacking-on-gitea.md) 中给出的建议。
    25  
    26  ## 下载
    27  
    28  首先，我们需要获取源码。由于引入了 Go 模块，最简单的方法是直接使用 Git，因为我们不再需要在 GOPATH 内构建 Gitea。
    29  
    30  ```bash
    31  git clone https://github.com/go-gitea/gitea
    32  ```
    33  
    34  （之前的版本中建议使用 `go get`，但现在不再需要。）
    35  
    36  你可以选择编译和安装的版本，当前有多个选择。`main` 分支代表当前的开发版本。如果你想编译 `main` 版本，你可以直接跳到 [构建](#构建) 部分。
    37  
    38  如果你想编译带有标签的发行版本，可以使用以下命令签出：
    39  
    40  ```bash
    41  git branch -a
    42  git checkout v@version@
    43  ```
    44  
    45  要验证一个拉取请求（Pull Request, PR），要先启用新的分支（其中 `xyz` 是 PR 的 ID；例如，对于 [#2663](https://github.com/go-gitea/gitea/pull/2663)，ID是 `2663 `）：
    46  
    47  ```bash
    48  git fetch origin pull/xyz/head:pr-xyz
    49  ```
    50  
    51  要以指定发行版本（如 v@version@ ）的源代码来构建 Gitea，可执行以下命令列出可用的版本并选择某个版本签出。
    52  使用以下命令列出可用的版本：
    53  
    54  ```bash
    55  git tag -l
    56  git checkout v@version@  # or git checkout pr-xyz
    57  ```
    58  
    59  ## 构建
    60  
    61  要从源代码进行构建，系统必须预先安装以下程序：
    62  
    63  - `go` @minGoVersion@ 或更高版本，请参阅 [这里](https://go.dev/dl/)
    64  - `node` @minNodeVersion@ 或更高版本，并且安装 `npm`, 请参阅 [这里](https://nodejs.org/zh-cn/download/)
    65  - `make`, 请参阅 [这里](development/hacking-on-gitea.md)
    66  
    67  为了尽可能简化编译过程，提供了各种 [make任务](https://github.com/go-gitea/gitea/blob/main/Makefile)。
    68  
    69  根据你的构建需求，以下 tags 可以使用：
    70  
    71  - `bindata`: 构建一个单一的整体二进制文件，包含所有资源。适用于构建生产环境版本。
    72  - `sqlite sqlite_unlock_notify`: 启用对 [SQLite3](https://sqlite.org/) 数据库的支持。仅建议在少数人使用时使用这个模式。
    73  - `pam`: 启用对 PAM（ Linux 可插拔认证模块）的支持。可用于对本地用户进行身份验证或扩展身份验证到 PAM 可用的方法。
    74  - `gogit`：（实验性功能）使用 go-git 变体的 Git 命令。
    75  
    76  将所有资源（JS/CSS/模板等）打包到二进制文件中。在生产环境部署时，使用`bindata`构建标签是必需的。在开发/测试 Gitea 或能够明确分离资源时，可以不用`bindata`。
    77  
    78  要包含所有资源，请使用 `bindata` 标签：
    79  
    80  ```bash
    81  TAGS="bindata" make build
    82  ```
    83  
    84  在我们的持续集成系统的默认发行版中，构建标签为：`TAGS="bindata sqlite sqlite_unlock_notify"`。因此，从源码构建的最简单、推荐方式是：
    85  
    86  ```bash
    87  TAGS="bindata sqlite sqlite_unlock_notify" make build
    88  ```
    89  
    90  `build`目标分为两个子目标：
    91  
    92  - `make backend` 需要 [Go @minGoVersion@](https://golang.google.cn/doc/install) 或更高版本。
    93  - `make frontend` 需要 [Node.js @minNodeVersion@](https://nodejs.org/zh-cn/download/) 或更高版本。
    94  
    95  如果存在预构建的前端文件，可以仅构建后端：
    96  
    97  ```bash
    98  TAGS="bindata" make backend
    99  ```
   100  
   101  ## 测试
   102  
   103  按照上述步骤完成后，工作目录中将会有一个`gitea`二进制文件。可以从该目录进行测试，或将其移动到带有测试数据的目录中。当手动从命令行启动 Gitea 时，可以通过按下`Ctrl + C`来停止程序。
   104  
   105  ```bash
   106  ./gitea web
   107  ```
   108  
   109  ## 更改默认路径
   110  
   111  Gitea 将从`CustomPath`中查找许多信息。默认的，这会在运行 Gitea 时当前工作目录下的`custom/`目录中（译者案：即`$PATH_TO_YOUR_GITEA$/custom/`）。它还将在`$(CustomPath)/conf/app.ini`中查找其配置文件`CustomConf`，并将当前工作目录用作一些可配置值的相对基本路径`AppWorkPath`。最后，静态文件将从默认为 `AppWorkPath`的`StaticRootPath`提供。
   112  
   113  尽管在开发时这些值很有用，但可能与下游用户的偏好冲突。
   114  
   115  一种选择是使用脚本文件来隐藏`gitea`二进制文件，并在运行Gitea之前创建适当的环境。然而，在构建时，可以使用`make`的`LDFLAGS`环境变量来更改这些默认值。适当的设置如下：
   116  
   117  - 要设置`CustomPath`，请使用`LDFLAGS="-X \"code.gitea.io/gitea/modules/setting.CustomPath=custom-path\""`
   118  - 对于`CustomConf`，应该使用`-X \"code.gitea.io/gitea/modules/setting.CustomConf=conf.ini\"`
   119  - 对于`AppWorkPath`，应该使用`-X \"code.gitea.io/gitea/modules/setting.AppWorkPath=working-path\"`
   120  - 对于`StaticRootPath`，应该使用`-X \"code.gitea.io/gitea/modules/setting.StaticRootPath=static-root-path\"`
   121  - 要更改默认的 PID 文件位置，请使用`-X \"code.gitea.io/gitea/cmd.PIDFile=/run/gitea.pid\"`
   122  
   123  将这些字符串与其前导的`-X`添加到`LDFLAGS`变量中，并像上面那样使用适当的`TAGS`运行`make build`。
   124  
   125  运行`gitea help`将允许您查看配置的`gitea`设置。
   126  
   127  ## 交叉编译
   128  
   129  `go`编译器工具链支持将代码交叉编译到不同的目标架构上。请参考[`GOOS`和`GOARCH`环境变量](https://go.dev/doc/install/source#environment) 以获取支持的目标列表。如果您想为性能较弱的系统（如树莓派）构建 Gitea，交叉编译非常有用。
   130  
   131  要使用构建标签（`TAGS`）进行交叉编译Gitea，您还需要一个 C 交叉编译器，该编译器的目标架构与`GOOS`和`GOARCH`变量选择的架构相同。例如，要为 Linux ARM64（`GOOS=linux`和`GOARCH=arm64`）进行交叉编译，您需要`aarch64-unknown-linux-gnu-gcc`交叉编译器。这是因为 Gitea 构建标签使用了`cgo`的外部函数接口（FFI）。
   132  
   133  在没有任何标签的情况下，交叉编译的 Gitea 为 Linux ARM64 版本：
   134  
   135  ```
   136  GOOS=linux GOARCH=arm64 make build
   137  ```
   138  
   139  要交叉编译 Linux ARM64 下的Gitea，这是推荐的构建标签：
   140  
   141  ```
   142  CC=aarch64-unknown-linux-gnu-gcc GOOS=linux GOARCH=arm64 TAGS="bindata sqlite sqlite_unlock_notify" make build
   143  ```
   144  
   145  根据您的目标架构，适当替换`CC`、`GOOS`和`GOARCH`。
   146  
   147  有时您需要构建一个静态编译的镜像。为此，您需要添加以下内容：
   148  
   149  ```
   150  LDFLAGS="-linkmode external -extldflags '-static' $LDFLAGS" TAGS="netgo osusergo $TAGS" make build
   151  ```
   152  
   153  这可以与上述的`CC`、`GOOS`和`GOARCH`结合使用。
   154  
   155  ### 添加 bash/zsh 自动补全（从 1.19 版本起）
   156  
   157  在[`contrib/autocompletion/bash_autocomplete`](https://raw.githubusercontent.com/go-gitea/gitea/main/contrib/autocompletion/bash_autocomplete)中可以找到一个启用 bash 自动补全的脚本。您可以根据需要进行修改，并在您的 `.bashrc` 中使用 `source` 命令加载该脚本，或者将其复制到 `/usr/share/bash-completion/completions/gitea`。
   158  
   159  类似地，可以在[`contrib/autocompletion/zsh_autocomplete`](https://raw.githubusercontent.com/go-gitea/gitea/main/contrib/autocompletion/zsh_autocomplete)中找到一个用于 zsh 自动补全的脚本。您可以将其复制到 `/usr/share/zsh/_gitea`，或者在您的 `.zshrc` 中使用 `source` 命令加载该脚本。
   160  
   161  可能需要你根据具体情况进一步改进这些脚本。
   162  
   163  ## 在 Linux 上使用 Zig 进行编译或交叉编译
   164  
   165  请按照 [Zig 的入门指南](https://ziglang.org/learn/getting-started/#installing-zig) 安装 Zig。
   166  
   167  - 编译 (Linux ➝ Linux)
   168  
   169  ```sh
   170  CC="zig cc -target x86_64-linux-gnu" \
   171  CGO_ENABLED=1 \
   172  CGO_CFLAGS="-O2 -g -pthread" \
   173  CGO_LDFLAGS="-linkmode=external -v"
   174  GOOS=linux \
   175  GOARCH=amd64 \
   176  TAGS="bindata sqlite sqlite_unlock_notify" \
   177  make build
   178  ```
   179  
   180  - 交叉编译 (Linux ➝ Windows)
   181  
   182  ```sh
   183  CC="zig cc -target x86_64-windows-gnu" \
   184  CGO_ENABLED=1 \
   185  CGO_CFLAGS="-O2 -g -pthread" \
   186  GOOS=windows \
   187  GOARCH=amd64 \
   188  TAGS="bindata sqlite sqlite_unlock_notify" \
   189  make build
   190  ```
   191  
   192  ## 在 Windows 上使用 Zig 进行编译或交叉编译
   193  
   194  使用`GIT BASH`编译。
   195  
   196  - 编译 (Windows ➝ Windows)
   197  
   198  ```sh
   199  CC="zig cc -target x86_64-windows-gnu" \
   200  CGO_ENABLED=1 \
   201  CGO_CFLAGS="-O2 -g -pthread" \
   202  GOOS=windows \
   203  GOARCH=amd64 \
   204  TAGS="bindata sqlite sqlite_unlock_notify" \
   205  make build
   206  ```
   207  
   208  - 交叉编译 (Windows ➝ Linux)
   209  
   210  ```sh
   211  CC="zig cc -target x86_64-linux-gnu" \
   212  CGO_ENABLED=1 \
   213  CGO_CFLAGS="-O2 -g -pthread" \
   214  CGO_LDFLAGS="-linkmode=external -v"
   215  GOOS=linux \
   216  GOARCH=amd64 \
   217  TAGS="bindata sqlite sqlite_unlock_notify" \
   218  make build
   219  ```
   220  
   221  ## Source Map
   222  
   223  默认情况下，gitea 会为前端文件生成精简的 Source Map 以节省空间。 这可以通过“ENABLE_SOURCEMAP”环境变量进行控制：
   224  
   225  - `ENABLE_SOURCEMAP=true` 生成所有Source Map，这是开发版本的默认设置
   226  - `ENABLE_SOURCEMAP=reduced` 生成有限的Source Map，这是生产版本的默认设置
   227  - `ENABLE_SOURCEMAP=false` 不生成Source Map