summaryrefslogtreecommitdiffstats
path: root/docs/content/doc/advanced/specific-variables.zh-cn.md
blob: 042e818964d7f0ffc61b371265e7745998acd70e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
---
date: "2017-04-08T11:34:00+02:00"
title: "环境变量清单"
slug: "specific-variables"
weight: 20
toc: false
draft: false
menu:
  sidebar:
    parent: "advanced"
    name: "环境变量清单"
    weight: 20
    identifier: "specific-variables"
---

# 环境变量清单

这里是用来控制 Gitea 行为表现的的环境变量清单,您需要在执行如下 Gitea 启动命令前设置它们来确保配置生效:

```
GITEA_CUSTOM=/home/gitea/custom ./gitea web
```

## Go 的配置

因为 Gitea 使用 Go 语言编写,因此它使用了一些相关的 Go 的配置参数:

  * `GOOS`
  * `GOARCH`
  * [`GOPATH`](https://golang.org/cmd/go/#hdr-GOPATH_environment_variable)

您可以在[官方文档](https://golang.org/cmd/go/#hdr-Environment_variables)中查阅这些配置参数的详细信息。

## Gitea 的文件目录

  * `GITEA_WORK_DIR`:工作目录的绝对路径
  * `GITEA_CUSTOM`:默认情况下 Gitea 使用默认目录 `GITEA_WORK_DIR`/custom,您可以使用这个参数来配置 *custom* 目录
  * `GOGS_WORK_DIR`: 已废弃,请使用 `GITEA_WORK_DIR` 替代
  * `GOGS_CUSTOM`: 已废弃,请使用 `GITEA_CUSTOM` 替代

## 操作系统配置

  * `USER`:Gitea 运行时使用的系统用户,它将作为一些 repository 的访问地址的一部分
  * `USERNAME`: 如果没有配置 `USER`, Gitea 将使用 `USERNAME`
  * `HOME`: 用户的 home 目录,在 Windows 中会使用 `USERPROFILE` 环境变量

### 仅限于 Windows 的配置

  * `USERPROFILE`: 用户的主目录,如果未配置则会使用 `HOMEDRIVE` + `HOMEPATH`
  * `HOMEDRIVE`: 用于访问 home 目录的主驱动器路径(C盘)
  * `HOMEPATH`:在指定主驱动器下的 home 目录相对路径

## Macaron(Gitea 使用的 web 框架)

  * `HOST`:Macaron 监听的主机地址
  * `PORT`:Macaron 监听的端口地址
  * `MACARON_ENV`:为开发环境和生产环境提供特殊功能性配置的全局变量,当 MACARON_ENV 设置为 "" 或 "development"
  时,每次请求都会重编译页面模板。为了提高性能表现,可将它设置为 "production"。

## Miscellaneous

  * `SKIP_MINWINSVC`:如果设置为 1,在 Windows 上不会以 service 的形式运行。