Lazy loaded image
mac 安装 gitea 提供 git 服务
Words 383Read Time 1 min
2025-9-29
2025-11-10
date
related_level
slug
mac_gitea
type
Post
relate_date
summary
macOS 安装 Gitea:配置数据库、日志、SSH、禁用注册,并设置 fail2ban 与反代真实 IP
status
Published
tags
版本管理
mac
category
运维管理
last_updated
Nov 10, 2025 10:02 PM
是否已更新
orginal_page
是否推荐
  • 需要自行配置 postgresql 或者 mysql 作为后端数据库
安装 gitea 并启动服务
  • brew install gitea
  • brew services start gitea
  • 登录 http://localhost:3000 完成初始配置
查看日志
  • less /opt/homebrew/var/log/gitea.log
app.ini 配置文件
  • vim /opt/homebrew/var/gitea/custom/conf/app.ini
配置不同级别日志文件
vim /opt/homebrew/var/gitea/custom/conf/app.ini
  • 默认记录到 gitea.log,错误级别记录至 error.log
配置禁用外部注册
  • 只能通过管理员注册
vim /opt/homebrew/var/gitea/custom/conf/app.ini
配置启用内置 SSH 服务器
vim /opt/homebrew/var/gitea/custom/conf/app.ini
客户端添加对应连接信息到 ~/.ssh/config
  • 用户名为当前登录的用户名
  • 客户端测试连接
    • ssh -T gitea.example.com
添加 fail2ban 规则并反代显示真实 IP
添加 gitea fail2ban 过滤器及规则
  • mkdir -p /opt/homebrew/var/lib/fail2ban
vim /opt/homebrew/etc/fail2ban/filter.d/gitea.conf
vim /opt/homebrew/etc/fail2ban/jail.local
  • fail2ban-regex /opt/homebrew/var/log/gitea.log /opt/homebrew/etc/fail2ban/filter.d/gitea.conf
    • 测试规则
  • sudo fail2ban-client -d
    • 检查配置
  • sudo brew services restart fail2ban
  • fail2ban-client status
  • fail2ban-client status gitea
设置 app.ini 显示反代真实 IP
选项解释
  • REVERSE_PROXY_LIMIT
    • 解释 X-Forwarded-For 标头或 X-Real-IP 标头,并将其设置为请求的远程 IP
    • 可信代理计数
  • REVERSE_PROXY_TRUSTED_PROXIES
    • 可信代理地址
  • vim /opt/homebrew/var/gitea/custom/conf/app.ini
 
上一篇
自建 git server 同步配置文件
下一篇
TrueNAS SCALE 应用管理

Comments
Loading...