# self-service-download-guide

**Repository Path**: premium/self-service-download-guide

## Basic Information

- **Project Name**: self-service-download-guide
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-18
- **Last Updated**: 2025-11-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 环境需求

## 硬件需求

### 推荐配置
#### 默认推荐配置为：
  CPU：8 C
  内存：16 GB
  存储：500G独立文件系统
  
#### CPU：
  Gitee premium自助下载版本目前只支持AMD64 或 X86-64 架构芯片。
  8C为默认推荐配置，具体情况需参考实际环境负载及用户数，如无法满足使用需求，未来可根据实际需求垂直扩容。

#### 内存：
  16G为默认推荐配置，具体需求取决于环境实际负载及用户数，未来可根据需求垂直扩容。

#### 存储：
  500G为默认推荐大小，用于存储gitee premium产生及存储的数据信息，具体容量可根据实际仓库文件大小及使用需求进行调整。需要注意的是，此处并非指系统总存储空间大小，出于数据安全及环境稳定性考虑，数据存储建议创建独立文件系统，并挂载至/data（gitee premium默认存储数据文件路径为/data，如有特殊环境需求可根据后续文档的配置信息介绍，修改数据文件路径），独立文件系统可有效防止共用文件系统导致根分区写满后，root相关进程无法正常运行，进而导致系统宕机并丢失数据。

  考虑到未来可能的数据增长，数据文件系统建议使用lvm进行管理，方便文件系统扩容。

## 环境需求及软件介绍
### 环境需求
  Gitee premium自助下载版本默认通过docker-compose方式部署安装，部署前置条件需要安装docker及docker-compose，如对docker版本无特殊要求，可根据下一节的部署文档中的命令直接安装，如有版本，配置等其它方面特殊需求，也可以自行准备安装，docker安装相关内容可参考官网https://docs.docker.com/get-docker。

### 软件介绍
Gitee premium自助下载版本共有7个容器，分别为：

frontend：前端容器

gitee：后端容器

mysql：数据库容器

redis：缓存及队列数据存储

http-pilot: http协议git推拉分发

ssh-pilot: ssh协议git推拉分发

git-service：仓库数据存储

环境需要预留的网络端口为：80，2222，443（需要https访问时使用，非必要）

# 不同系统类型下安装方式
CENTOS 7.6 ~ 7.8 & RHEL  &  Oracle  & Scientific

## 环境安装
### 在线安装
  如您的服务器环境可以直接访问互联网，可以选择在线安装，根据文档操作，执行命令即可

#### 1：安装docker & docker-compose （如已安装，跳过此步骤）

命令行运行：
```
export docker_pack_url=https://download.gitee.cn/api/public/dl/W4LL75EG; 
curl https://download.gitee.cn/api/public/dl/oRJub2BJ | sudo bash
```

#### 2：安装gitee premium
##### 快捷安装
命令行运行：
```
# 根据环境的实际IP或URL，替换下方gitee_url.com,该地址为浏览器访问的入口地址，在使用了地址转发的情况下并非服务器本身的IP地址
export GITEE_URL=http://gitee_url.com 
export gitee_pack_url=https://download.gitee.cn/api/public/dl/iVOw7wDt;  
curl https://download.gitee.cn/api/public/dl/pkpig9Pg  | sudo bash
```

### 自定义安装

### 离线安装
  服务环境不能直接访问互联网，可预先下载离线安装包，导入服务器后进行安装
  离线安装包下载地址
```  
docker & docker-compose 安装包下载地址（如有版本及其它特殊需求，可自行下载官方版本安装）
（地址）
gitee 安装包下载地址
（地址）
```


## 环境激活

  环境完成安装后，通过浏览器访问之前配置的gitee web地址，进入激活页面（服务首次启动可能需等待几分钟完成初始化，期间浏览器访问会显示502）。
![初始化环境](./public/static/images/initialize_license.png)
  把 license 文件（.json）文件拖动到方框中，点击提交进行验证。通过后进入企业设置和管理员设置页面。

##  配置项介绍

  gitee参数配置文件为解压目录下的gitee.toml
```
[main]
giteeVolumeDir= "/data/gitee"     #gitee数据持久化目录，无特殊需求无需修改
giteeLogDir= "/data/gitee_log"    #gitee日志持久化目录，无特殊需求无需修改
httpBind = "0.0.0.0:80"           #nginx 映射端口，一般为 80，和部署服务 http 访问端口一致，无特殊需求无需修改
httpsBind = "0.0.0.0:443"         #nginx 映射端口，一般为 443，和部署服务 https 访问端口一致，无特殊需求无需修改
sshBind = "0.0.0.0:2222"          #nginx 映射端口，一般为 443，ssh 代码推拉端口，一般为 2222，无特殊需求无需修改

[smtp]
method = "sendmail"               # 开启为 smtp, 不开启为 sendmail
server = "smtp.gitee.cc"          # smtp邮件服务器的服务域名
port = 25                         # 服务端口
username = "mail@gitee.cc"        # 用来发送邮件的邮箱账号
password = "MailPassword"         # 用来发送邮件的邮箱密码
from = "mail@gitee.cc"            # 和 username 一致即可
authentication = "plain"          # 邮箱服务验证方式，可选：login/plain/crammd5，账号登录为 login
starttls = "true"                 # 是否启用了 starttls，非 ssl 状态，一般 ssl 配置开启就关闭该配置
opensslVerifyMode = "none"        # 使用 TLS 时，OpenSSL 检查证书的方式，一般为 none 
sslEnable = "false"               # 是否启用 ssl，看邮箱服务端口配置的是否有 ssl 协议一般 465 需要开启
domain = "gitee.cc"               # 邮箱服务的域名，比如：163.com

[gitee]
host = "gitee.cc"                 # gitee服务访问的域名
port = 80                         # gitee服务访问端口，一般与上述 nginx 端口 httpBind 配置对应，无特殊需求无需修改
url = "http://gitee.cc"           # gitee服务访问的 URL
sshPort = 2222                    # ssh 代码服务推拉端口，一般与上述 nginx 端口 sshBind 配置对应，无特殊需求无需修改
httpMaxBodySize = "400M"          # nginx http协议传送文件包的最大包大小，无特殊需求无需修改

[db]
rootPassword = "RootPassword"     # 内置数据库的初始 root 密码，仅对内置数据库有效，无特殊需求无需修改
password = "GiteePremium"         # 数据库gitee用户密码，，无特殊需求无需修改

[ssl]
enable = false                    # https 协议开关，默认不开启为http访问
sslCertificate = "/home/xxx/ssl/server.crt"              # ssl密钥对crt文件路径
sslCertificateKey = "/home/xxx/ssl/test_unsecure.key"    # ssl密钥对key文件路径

[redis]
password = "RedisPassword"        # 内置redis服务密码
```