Linux香港VPS搭建Gitea：轻量Git服务部署指南

在开发协作中，代码托管是核心环节。Gitea作为轻量级Git服务工具，以低资源占用和高灵活性，成为个人开发者与小型团队的优选。借助Linux香港VPS的稳定网络与独立环境，能快速搭建专属代码托管平台。本文将从环境准备到最终配置，详细拆解搭建过程。

基础环境准备

搭建前需确认两项关键条件：首先是一台Linux系统的香港VPS，推荐选择Ubuntu 20.04及以上版本，其长期支持（LTS）特性可保障系统稳定性；其次需开放必要网络端口，包括HTTP（80）、HTTPS（443）用于网页访问，SSH（22）用于远程管理，部分情况下还需开放Gitea默认服务端口3000（若未通过反向代理映射至80/443）。

依赖软件安装

以Ubuntu系统为例，第一步更新软件包列表，确保后续安装为最新版本：

sudo apt update

Gitea运行需Git和数据库支持。Git用于版本控制操作，数据库存储仓库元数据（如用户、权限、提交记录）。此处选择MySQL作为数据库，执行安装命令：

sudo apt install git mysql-server

安装完成后启动MySQL服务并设置开机自启：

sudo systemctl start mysql
sudo systemctl enable mysql

接着创建Gitea专用数据库与用户。通过root账户登录MySQL：

sudo mysql -u root

依次执行以下命令（请将'your_password'替换为自定义密码）：

CREATE DATABASE gitea CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'gitea'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Gitea核心安装

下载Gitea二进制文件，根据VPS架构选择对应版本（以64位系统为例）：

wget -O gitea https://dl.gitea.io/gitea/1.16.8/gitea-1.16.8-linux-amd64

赋予执行权限并移动至系统路径：

chmod +x gitea
sudo mv gitea /usr/local/bin/gitea

创建专用用户与目录。Gitea建议以非root用户运行，避免权限风险：

sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git
sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R git:git /var/lib/gitea/
sudo chmod -R 750 /var/lib/gitea/
sudo mkdir /etc/gitea
sudo chown root:git /etc/gitea
sudo chmod 770 /etc/gitea

服务配置与启动

创建systemd服务文件管理Gitea进程：

sudo nano /etc/systemd/system/gitea.service

文件内填入以下内容（关键参数已标注说明）：

[Unit]
Description=Gitea (Git with a cup of tea)  # 服务描述
After=syslog.target network.target mysql.service  # 依赖服务启动顺序

[Service]
User=git  # 指定运行用户
Group=git
WorkingDirectory=/var/lib/gitea/  # 工作目录
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini  # 启动命令
Restart=always  # 自动重启策略
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target  # 开机启动级别

保存后重新加载systemd配置并启动服务：

sudo systemctl daemon-reload
sudo systemctl start gitea
sudo systemctl enable gitea

Web界面初始化

通过浏览器访问VPS公网IP或绑定的域名（默认端口3000，如http://your_vps_ip:3000），进入Gitea安装向导。需填写数据库信息（主机localhost、端口3306、用户gitea、密码为之前设置的'your_password'）、站点名称、管理员账户等参数，确认无误后点击安装，即可完成平台初始化。

至此，基于Linux香港VPS的Gitea代码托管平台搭建完成。这套方案既能满足小团队代码协作需求，又通过香港节点保障了亚太地区访问速度，是轻量开发场景的理想选择。