macOS 搭建 Gitea 私有 Git 服务器教程
macOS 搭建 Gitea 私有 Git 服务器教程
本文详细介绍如何在 macOS 系统上快速搭建 Gitea 私有 Git 服务器，适合个人开发者和小团队使用。
📝 前言
在日常开发中，我们经常需要一个私有的 Git 服务器来管理代码。相比于 GitLab 的复杂配置，Gitea 是一个轻量级的 Git 服务解决方案，特别适合在 macOS 上搭建本地或局域网的 Git 服务。
为什么选择 Gitea？
- 🚀 轻量级：资源占用少，启动速度快
- 🔧 易安装：一个二进制文件即可运行
- 🌐 功能完整：支持 Issues、Pull Requests、Wiki 等
- 💾 多数据库支持：SQLite、MySQL、PostgreSQL
- 🔒 安全可控：私有部署，数据完全掌控
为什么选择 Mac 作为 Gitea 服务器？
相比于 Linux 服务器或 Windows，使用 Mac 搭建 Gitea 服务器有以下独特优势：
🖥️ 硬件优势
- Apple Silicon 性能：M1/M2/M3 芯片提供卓越的性能功耗比
- 静音运行：Mac 设备运行安静，适合家庭或办公室环境
- 稳定可靠：macOS 系统稳定性高，长时间运行无故障
- 低功耗：相比传统服务器，Mac 设备功耗更低，节能环保
💻 开发友好
- 开发环境一体化：开发和服务器在同一台设备，调试更方便
- 原生 Unix 环境：完美支持 Git 和各种开发工具
- Homebrew 生态：丰富的包管理工具，安装软件更简单
- 完美支持容器：Docker Desktop 在 Mac 上运行流畅
🛠️ 环境准备
系统要求
- macOS 10.15 及以上版本
- 至少 4GB 内存（推荐 8GB）
- 10GB 以上可用磁盘空间
检查系统环境
# 查看 macOS 版本
sw_vers
# 查看 CPU 架构（重要：影响下载的安装包）
uname -m
# arm64 = Apple Silicon (M1/M2/M3)
# x86_64 = Intel 芯片
# 检查是否安装了 Xcode 命令行工具
xcode-select -p
# 如果没有安装，运行：xcode-select --install
# 检查端口 3000 是否可用
lsof -i :3000 || echo "端口 3000 可用"
📦 方法一：Homebrew 安装（推荐）
1. 安装 Homebrew
# 如果还没安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装 Gitea
# 更新 Homebrew
brew update
# 安装 Gitea
brew install gitea
# 验证安装
gitea --version
3. 创建目录结构
# 在用户目录下创建 Gitea 工作目录
mkdir -p ~/Development/gitea/{custom/conf,data,log}
# 查看创建的目录结构
ls -la ~/Development/gitea/
4. 启动 Gitea 服务
# 进入工作目录
cd ~/Development/gitea
# 启动 Gitea
gitea web
成功启动后，你会看到类似这样的输出：
2024/08/11 15:30:00 ...eb/routing/logger.go:102:func1() [I] Started GET / for 127.0.0.1:52000
2024/08/11 15:30:00 ...s/context/context.go:227:Render() [I] Completed GET / 200 OK in 2.3ms
🌐 Web 界面配置
1. 访问安装页面
打开浏览器，访问：http://localhost:3000
2. 数据库配置
推荐使用 SQLite（适合个人和小团队）：
- 数据库类型：选择
SQLite3 - 数据库文件路径：
data/gitea.db
💡 小贴士：SQLite 无需额外配置，数据存储在一个文件中，备份和迁移都很方便。
3. 基本设置
- 站点名称：输入你想要的名称，如 “我的代码仓库”
- 仓库根目录：
data/repositories - Git LFS 根目录：
data/lfs - 以此用户运行：你的 macOS 用户名
- 服务器域名：
localhost - SSH 服务端口：
22 - HTTP 端口：
3000 - 应用程序 URL：
http://localhost:3000/ - 日志路径：
log
4. 管理员账户设置
- 管理员用户名：
admin - 密码：设置一个强密码
- 邮箱地址：
admin@localhost
5. 完成安装
点击 “立即安装” 按钮，等待安装完成。
🔧 方法二：直接下载二进制文件
如果你不想使用 Homebrew，可以直接下载 Gitea 的二进制文件。
1. 下载对应版本
# Intel 芯片 Mac
curl -L https://dl.gitea.io/gitea/1.21.11/gitea-1.21.11-darwin-10.12-amd64 -o gitea
# Apple Silicon (M1/M2/M3) Mac
curl -L https://dl.gitea.io/gitea/1.21.11/gitea-1.21.11-darwin-10.12-arm64 -o gitea
# 给文件执行权限
chmod +x gitea
# 移动到系统路径
sudo mv gitea /usr/local/bin/gitea
2. 创建配置文件
# 创建工作目录
mkdir -p ~/gitea-server/{custom/conf,data,log}
cd ~/gitea-server
# 创建基本配置文件
cat > custom/conf/app.ini << 'EOF'
[database]
DB_TYPE = sqlite3
PATH = data/gitea.db
[repository]
ROOT = data/repositories
[server]
HTTP_PORT = 3000
DOMAIN = localhost
ROOT_URL = http://localhost:3000/
[log]
MODE = file
LEVEL = Info
ROOT_PATH = log
EOF
3. 启动服务
# 启动 Gitea
gitea web
💾 使用外置硬盘存储（可选）
如果你有外置硬盘，可以将 Gitea 数据存储在外置硬盘上：
1. 查看挂载的外置硬盘
# 查看已挂载的外置硬盘
ls -la /Volumes/
2. 创建目录结构
# 假设你的外置硬盘名为 "Project"
mkdir -p /Volumes/Project/gitea/{repositories,lfs,logs,database}
3. 在 Web 配置中使用外置硬盘路径
- 仓库根目录：
/Volumes/Project/gitea/repositories - Git LFS 根目录：
/Volumes/Project/gitea/lfs - 数据库文件路径：
/Volumes/Project/gitea/database/gitea.db - 日志路径：
/Volumes/Project/gitea/logs
🚀 设置开机自启动
创建启动服务
# 创建 Launch Agent 文件
cat > ~/Library/LaunchAgents/com.gitea.server.plist << EOF
Label
com.gitea.server
ProgramArguments
/usr/local/bin/gitea
web
WorkingDirectory
$HOME/Development/gitea
RunAtLoad
KeepAlive
EOF
# 加载服务
launchctl load ~/Library/LaunchAgents/com.gitea.server.plist
🌐 局域网访问配置
如果你想让局域网内的其他设备访问你的 Git 服务器：
1. 查找 Mac 的 IP 地址
# 查看本机 IP 地址
ifconfig | grep "inet " | grep -v 127.0.0.1
2. 修改配置
编辑 ~/Development/gitea/custom/conf/app.ini 文件：
[server]
DOMAIN = 192.168.1.100 # 替换为你的实际 IP
ROOT_URL = http://192.168.1.100:3000/
3. 重启 Gitea 服务
# 停止服务
launchctl unload ~/Library/LaunchAgents/com.gitea.server.plist
# 重新启动
launchctl load ~/Library/LaunchAgents/com.gitea.server.plist
现在局域网内的设备可以通过 http://你的IP:3000 访问 Git 服务器了。
📱 基本使用
1. 登录和创建仓库
- 打开浏览器访问
http://localhost:3000 - 使用管理员账户登录
- 点击右上角的 “+” 号创建新仓库
2. 克隆仓库
# 克隆仓库到本地
git clone http://localhost:3000/用户名/仓库名.git
# 或者使用 IP 地址（局域网访问）
git clone http://192.168.1.100:3000/用户名/仓库名.git
3. 基本操作
# 进入仓库目录
cd 仓库名
# 添加文件
echo "# 我的项目" > README.md
git add .
git commit -m "初始提交"
# 推送到服务器
git push origin main
🛠️ 常用管理命令
# 手动启动 Gitea
cd ~/Development/gitea && gitea web
# 停止 Gitea 服务
launchctl unload ~/Library/LaunchAgents/com.gitea.server.plist
# 查看 Gitea 日志
tail -f ~/Development/gitea/log/gitea.log
# 检查 Gitea 是否运行
curl http://localhost:3000
# 创建管理员用户（命令行方式）
gitea admin user create --admin --username admin --password AdminPass123 --email admin@localhost
❓ 常见问题解决
端口 3000 被占用
# 查看占用端口的进程
lsof -i :3000
# 使用其他端口启动
gitea web --port 3001
权限问题
# 修复目录权限
sudo chown -R $(whoami) ~/Development/gitea
macOS 安全限制
如果 macOS 阻止运行 Gitea：
# 移除隔离属性
sudo xattr -r -d com.apple.quarantine /usr/local/bin/gitea
或者在 “系统偏好设置 → 安全性与隐私” 中点击 “仍要打开”。
数据库锁定
# 停止所有 Gitea 进程
pkill gitea
# 然后重新启动
📊 性能优化建议
1. 硬件建议
- 内存：8GB 以上（支持更多并发用户）
- 存储：使用 SSD 硬盘提高性能
- 网络：千兆网络（局域网访问）
2. 配置优化
# 在 app.ini 中添加性能优化配置
[server]
LFS_START_SERVER = true
OFFLINE_MODE = true
[database]
MAX_IDLE_CONNS = 30
MAX_OPEN_CONNS = 300
[indexer]
ISSUE_INDEXER_TYPE = bleve
REPO_INDEXER_ENABLED = true
🔐 安全建议
- 定期备份：定期备份
data目录 - 强密码：使用复杂的管理员密码
- 网络安全：如果对外开放，配置防火墙规则
- 更新及时：定期更新 Gitea 到最新版本
📝 总结
通过本教程，你已经学会了：
- ✅ 在 macOS 上安装和配置 Gitea
- ✅ 设置数据库和基本配置
- ✅ 配置局域网访问
- ✅ 设置开机自启动
- ✅ 解决常见问题
Gitea 是一个优秀的轻量级 Git 服务解决方案，特别适合个人开发者和小团队使用。相比于复杂的 GitLab，Gitea 的配置更加简单，资源占用更少，是搭建私有 Git 服务器的理想选择。
现在你可以开始使用自己的私有 Git 服务器了！如果遇到问题，可以查看 Gitea 官方文档 获取更多帮助。
