187 lines
5.9 KiB
Markdown
187 lines
5.9 KiB
Markdown
# 服务器部署Gitea
|
||
|
||
> 环境：Debian 12.0， 服务器：腾讯云
|
||
|
||
## 1. 安装基础依赖并创建专用 git 用户
|
||
|
||
```bash
|
||
apt update && apt install -y git curl wget
|
||
id git &>/dev/null || useradd -r -m -d /home/git -s /bin/bash git
|
||
```
|
||
|
||
`useradd -r` 创建一个系统用户，确保它的操作权限限制在专属目录中，既无法改动系统核心配置，也碰不到服务器上其他服务的数据。
|
||
|
||
## 2. 安装Gitea 文件
|
||
|
||
> [Gitea 文件下载](https://dl.gitea.com/gitea/) 查找最新稳定版；
|
||
|
||
```bash
|
||
uname -r
|
||
```
|
||
|
||
查看框架之后，`x86_64` 选择 gitea-版本号-linux-amd64；`aarch64`选择 gitea-版本号-linux-arm64
|
||
|
||
下载之后，拖拽到`/usr/local/bin` 文件夹下，并重命名为 `gitea`
|
||
|
||
```bash
|
||
chmod +x /usr/local/bin/gitea
|
||
/usr/local/bin/gitea --version
|
||
```
|
||
|
||
## 3. 创建工作目录并分配权限
|
||
|
||
```bash
|
||
mkdir -p /var/lib/gitea/{custom,data,log}
|
||
chown -R git:git /var/lib/gitea/
|
||
chmod -R 750 /var/lib/gitea/
|
||
|
||
mkdir -p /etc/gitea
|
||
chown root:git /etc/gitea
|
||
chmod 770 /etc/gitea
|
||
```
|
||
|
||
| **目录 / 命令** | **类别** | **属主与权限** | **具体用途与作用说明** |
|
||
|:-----------------------------------------------------:|:--------:|:--------------------------:|:-----------------------------------------------------------------------------------------:|
|
||
| **`/var/lib/gitea/data`** | 核心业务数据目录 | `git:git` (`750`) | 存放所有 Git 代码仓库、SQLite3 数据库（`gitea.db`）、用户头像及附件（**备份优先级最高**，迁移服务器时必须完整保留）。 |
|
||
| **`/var/lib/gitea/custom`** | 个性化定制目录 | `git:git` (`750`) | 存放自定义网页主题、Logo 图标、自定义 HTML 模板等覆盖文件（默认安装初期为空）。 |
|
||
| **`/var/lib/gitea/log`** | 运行日志目录 | `git:git` (`750`) | 存放 Gitea 服务启动日志、HTTP 访问记录与报错信息，用于日常故障排查（可定期清理）。 |
|
||
| **`/etc/gitea`** | 系统配置目录 | `root:git` (`770` → `750`) | 存放主配置文件 `app.ini`（记录端口、公网 IP/域名、数据库及密钥设置）。 |
|
||
| **`chown -R git:git` & `chmod -R 750`** | 数据目录赋权命令 | 针对 `/var/lib/gitea/` | 将数据目录完全交给 `git` 系统账号管理（读写执行 `7`），同组用户只读（`5`），其他无关用户禁止访问（`0`），防止代码泄露。 |
|
||
| **`chown root:git` & `chmod 770`** | 配置目录赋权命令 | 针对 `/etc/gitea` | 属主设为 `root`、所属组设为 `git` 并临时赋予组写入权限（`770`），确保网页初始化点击“立即安装”时能自动写入 `app.ini`（安装后需收紧为 `750`）。 |
|
||
|
||
## 4. 配置systemd系统服务实现后台常驻
|
||
|
||
### 4.1 写入配置文件
|
||
|
||
```bash
|
||
vim /etc/systemd/system/gitea.service
|
||
```
|
||
|
||
```bash
|
||
[Unit]
|
||
Description=Gitea (Git with a cup of tea)
|
||
After=syslog.target network.target
|
||
|
||
[Service]
|
||
RestartSec=2s
|
||
Type=simple
|
||
User=git
|
||
Group=git
|
||
WorkingDirectory=/var/lib/gitea/
|
||
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
|
||
Restart=always
|
||
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
```
|
||
|
||
### 4.2 重新加载服务配置并设置开机自启
|
||
|
||
```bash
|
||
systemctl daemon-reload
|
||
systemctl enable --now gitea
|
||
```
|
||
|
||
### 4.3 确认 Gitea 已正常运行
|
||
|
||
```bash
|
||
systemctl status gitea
|
||
```
|
||
|
||
## 5. 开启公网访问
|
||
|
||
开启3000端口防火墙之后，然后访问 `http:公网IP:3000`进行配置
|
||
|
||
<img title="" src="file:///C:/Users/lbybr/Pictures/Typedown/2ec1e0d1-dd64-403e-a1f2-1e8833afe97c.png" alt="2ec1e0d1-dd64-403e-a1f2-1e8833afe97c" style="zoom:50%;" data-align="inline">
|
||
|
||
## 6. 收紧配置文件权限
|
||
|
||
```bash
|
||
chmod 750 /etc/gitea
|
||
chmod 640 /etc/gitea/app.ini
|
||
```
|
||
|
||
这种情况下只能登录到服务器，使用root权限修改，并`systemctl restart gitea`重新启动
|
||
|
||
## 7. 配置域名
|
||
|
||
### 7.1 域名解析
|
||
|
||
将域名解析到服务器的公网IP
|
||
|
||
### 7.2 放行 80/443 端口并安装Nginx与Certbot
|
||
|
||
```bash
|
||
apt update && apt install -y nginx certbot python3-certbot-nginx
|
||
```
|
||
|
||
### 7.3 配置反向代理
|
||
|
||
```bash
|
||
vim /etc/nginx/sites-available/gitea
|
||
```
|
||
|
||
```bash
|
||
server {
|
||
listen 80;
|
||
server_name git.你的域名.com;
|
||
|
||
# 调大请求体上限，防止推送较大提交时出现 413 报错
|
||
client_max_body_size 512M;
|
||
|
||
location / {
|
||
proxy_pass http://127.0.0.1:3000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
}
|
||
```
|
||
|
||
创建快捷方式，并激活反向代理
|
||
|
||
```bash
|
||
ln -sf /etc/nginx/sites-available/gitea /etc/nginx/sites-enabled/gitea
|
||
nginx -t && systemctl reload nginx
|
||
```
|
||
|
||
出现以下提示信息时，表示配置成功！
|
||
|
||
```bash
|
||
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
|
||
nginx: configuration file /etc/nginx/nginx.conf test is successful
|
||
```
|
||
|
||
### 7.4 申请免费 SSL 证书开启 HTTPS
|
||
|
||
```bash
|
||
certbot --nginx -d git.你的域名.com
|
||
```
|
||
|
||
出现`Congratulations! You have successfully enabled HTTPS on https://git.你的域名.com`表示配置成功
|
||
|
||
### 7.5 修改Gitea配置文件并重启
|
||
|
||
```bash
|
||
vim /etc/gitea/app.ini
|
||
```
|
||
|
||
修改`server`段落
|
||
|
||
```toml
|
||
[server]
|
||
DOMAIN = git.你的域名.com
|
||
ROOT_URL = https://git.你的域名.com/
|
||
HTTP_ADDR = 127.0.0.1
|
||
```
|
||
|
||
重启生效
|
||
|
||
```bash
|
||
systemctl restart gitea
|
||
```
|
||
|
||
> ! 至此，配置完成
|