搭建git私服并汉化过程是怎样的

# 搭建Git私服并汉化过程是怎样的

## 前言

在企业开发或团队协作中，搭建私有Git服务器（Git私服）能有效保护代码安全、提升协作效率。本文将详细介绍基于Linux系统搭建Git私服（以Gitea为例）并实现界面汉化的完整流程。

---

## 一、环境准备

### 1.1 基础要求
- **操作系统**：Ubuntu 20.04/CentOS 7+（本文以Ubuntu为例）
- **硬件配置**：1核CPU/1GB内存/20GB存储（小型团队够用）
- **依赖软件**：
  ```bash
  sudo apt update
  sudo apt install -y git mysql-server nginx

1.2 创建专用用户

sudo adduser --system --group --disabled-password --shell /bin/bash git

---

二、安装Gitea

2.1 下载二进制包

wget -O /tmp/gitea https://dl.gitea.io/gitea/1.18.0/gitea-1.18.0-linux-amd64
sudo mv /tmp/gitea /usr/local/bin/
sudo chmod +x /usr/local/bin/gitea

2.2 初始化目录

sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R git:git /var/lib/gitea

2.3 配置服务

创建systemd服务文件/etc/systemd/system/gitea.service：

[Unit]
Description=Gitea

[Service]
User=git
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always

[Install]
WantedBy=multi-user.target

---

三、数据库配置

3.1 初始化MySQL

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

3.2 修改Gitea配置

编辑/etc/gitea/app.ini：

[database]
DB_TYPE  = mysql
HOST     = 127.0.0.1:3306
NAME     = giteadb
USER     = gitea
PASSWD   = YourPassword123

---

四、Nginx反向代理

4.1 配置站点

创建/etc/nginx/sites-available/git.yourdomain.com：

server {
    listen 80;
    server_name git.yourdomain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
    }
}

4.2 启用配置

sudo ln -s /etc/nginx/sites-available/git.yourdomain.com /etc/nginx/sites-enabled/
sudo systemctl restart nginx

---

五、首次访问配置

1. 访问 http://git.yourdomain.com/install
2. 按向导完成：
   • 选择MySQL数据库
   • 设置管理员账号
   • 修改站点URL为实际域名

---

六、汉化Gitea界面

6.1 下载中文语言包

wget https://gitea.com/xiao/language-zh-CN/raw/branch/master/zh_CN.ini
sudo cp zh_CN.ini /var/lib/gitea/custom/options/locale/

6.2 修改配置文件

在app.ini中添加：

[i18n]
LANGS = en-US,zh-CN
NAMES = English,简体中文
DEFAULT_LANG = zh-CN

6.3 重启服务

sudo systemctl restart gitea

---

七、验证汉化效果

1. 重新登录后进入「用户设置」→「界面设置」
2. 选择「简体中文」并保存
3. 刷新页面后所有菜单、按钮将显示为中文

---

常见问题解决

1. 502 Bad Gateway

   • 检查Nginx与Gitea服务是否正常运行
   • 确认防火墙开放3000端口

2. 中文显示乱码

   • 确保MySQL数据库使用utf8mb4编码
   • 检查语言文件是否为UTF-8编码

3. 邮件服务配置 在app.ini的[mailer]部分配置SMTP信息

---

结语

通过以上步骤，我们完成了从零搭建Git私服到实现中文界面的全过程。Gitea作为轻量级方案，适合中小团队使用。如需更复杂功能，可考虑GitLab或Gogs等替代方案。

注：本文档更新于2023年8月，不同版本配置可能存在差异，请以官方文档为准。 “`

（全文约900字，实际可根据需要调整细节描述长度）