code.gitea.io/gitea@v1.22.3/docs/content/usage/packages/go.zh-cn.md (about)

     1  ---
     2  date: "2023-05-10T00:00:00+00:00"
     3  title: "Go 软件包注册表"
     4  slug: "go"
     5  sidebar_position: 45
     6  draft: false
     7  toc: false
     8  menu:
     9    sidebar:
    10      parent: "packages"
    11      name: "Go"
    12      sidebar_position: 45
    13      identifier: "go"
    14  ---
    15  
    16  # Go 软件包注册表
    17  
    18  为您的用户或组织发布 Go 软件包。
    19  
    20  ## 发布软件包
    21  
    22  要发布 Go 软件包，请执行 HTTP `PUT` 操作，并将软件包内容放入请求主体中。
    23  如果已经存在相同名称和版本的软件包，您无法发布软件包。您必须首先删除现有的软件包。
    24  该软件包必须遵循[文档中的结构](https://go.dev/ref/mod#zip-files)。
    25  
    26  ```
    27  PUT https://gitea.example.com/api/packages/{owner}/go/upload
    28  ```
    29  
    30  | 参数    | 描述           |
    31  | ------- | -------------- |
    32  | `owner` | 软件包的所有者 |
    33  
    34  要身份验证到软件包注册表，您需要提供[自定义 HTTP 头或使用 HTTP 基本身份验证](development/api-usage.md#通过-api-认证)：
    35  
    36  ```shell
    37  curl --user your_username:your_password_or_token \
    38       --upload-file path/to/file.zip \
    39       https://gitea.example.com/api/packages/testuser/go/upload
    40  ```
    41  
    42  如果您使用的是 2FA 或 OAuth，请使用[个人访问令牌](development/api-usage.md#通过-api-认证)替代密码进行身份验证。
    43  
    44  服务器将使用以下 HTTP 状态代码进行响应。
    45  
    46  | HTTP 状态码       | 含义                       |
    47  | ----------------- | -------------------------- |
    48  | `201 Created`     | 软件包已发布               |
    49  | `400 Bad Request` | 软件包无效                 |
    50  | `409 Conflict`    | 具有相同名称的软件包已存在 |
    51  
    52  ## 安装软件包
    53  
    54  要安装Go软件包，请指示Go使用软件包注册表作为代理：
    55  
    56  ```shell
    57  # 使用最新版本
    58  GOPROXY=https://gitea.example.com/api/packages/{owner}/go go install {package_name}
    59  # 或者
    60  GOPROXY=https://gitea.example.com/api/packages/{owner}/go go install {package_name}@latest
    61  # 使用特定版本
    62  GOPROXY=https://gitea.example.com/api/packages/{owner}/go go install {package_name}@{package_version}
    63  ```
    64  
    65  | 参数              | 描述           |
    66  | ----------------- | -------------- |
    67  | `owner`           | 软件包的所有者 |
    68  | `package_name`    | 软件包名称     |
    69  | `package_version` | 软件包版本     |
    70  
    71  如果软件包的所有者是私有的，则需要[提供凭据](https://go.dev/ref/mod#private-module-proxy-auth)。
    72  
    73  有关 `GOPROXY` 环境变量的更多信息以及如何防止数据泄漏的信息，请[参阅文档](https://go.dev/ref/mod#private-modules)。