搭建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字，實際可根據需要調整細節描述長度）