美国服务器上的Gitea如何配置访问权限与备份,降低代码仓库暴露风险?
现有美国服务器上的 Gitea 已经能够提供代码托管服务,现在的维护目标不是重新部署,而是收缩公开入口、限制仓库和管理功能的访问范围,并让数据库、仓库文件与关键配置具备可恢复的备份。服务器所在地区不会改变 Gitea 的权限模型,真正影响暴露风险的是监听端口、认证策略、仓库可见性、系统权限以及备份是否与线上环境隔离。
实际操作时,可以采用“公网只保留 HTTPS、Gitea 只监听本机、管理员 SSH 单独限制来源、普通成员按仓库和团队授权”的组合。再配合补丁更新、日志审计和定期恢复演练,即使某个账号、令牌或配置出现问题,也能缩小影响范围并恢复服务。
现状与条件:先确认已有服务暴露在哪里
不要直接修改防火墙或 app.ini。先确认 Gitea 的运行方式、配置文件位置、数据库类型和当前监听端口。不同安装方式的服务名和路径可能不同,先核对再执行后续命令。
确认 Gitea 是系统服务还是容器
系统服务安装通常可以这样查看:
sudo systemctl status gitea --no-pager
sudo systemctl cat gitea
ps -ef | grep -E '[g]itea'
重点关注以下信息:
- 服务实际使用的 Gitea 二进制路径;
--config指向的app.ini;- Gitea 运行账号,常见为
git; WorkingDirectory或数据目录;- 是否通过 Nginx、Apache 或其他反向代理对外提供访问。
如果是 Docker Compose 环境,应改为检查现有编排文件,不要同时套用 systemd 命令:
docker compose ps
docker compose config
docker compose logs --tail=100 gitea
容器环境还要确认数据库和 Gitea 数据卷是否分别持久化。只备份容器层并不能替代仓库、附件、LFS 对象和数据库备份。
核对配置、数据库和数据目录
读取配置时不要把完整文件直接粘贴到公共工单或聊天中,因为其中可能含有数据库密码、内部令牌和密钥。可以先查看非敏感字段:
sudo grep -E '^(APP_DATA_PATH|ROOT_PATH|DB_TYPE|HOST|NAME|USER|HTTP_ADDR|HTTP_PORT|ROOT_URL|DISABLE_SSH)' \
/etc/gitea/app.ini
如果配置文件不是 /etc/gitea/app.ini,使用 systemctl cat gitea 中的实际路径。还要确认仓库根目录是否被单独设置,例如:
sudo find /var/lib/gitea /srv -maxdepth 4 -type d \
\( -name 'gitea-repositories' -o -name 'lfs' -o -name 'attachments' \) \
-print 2>/dev/null
查看所有监听端口:
sudo ss -lntup
理想情况下,反向代理后的 Gitea Web 服务只监听 127.0.0.1:3000 或其他本机端口,公网只看到 80/tcp 和 443/tcp。如果 3000、数据库端口或管理端口监听在 0.0.0.0,就需要进一步收紧。
| 检查对象 | 期望状态 | 不符合时的处理 |
|---|---|---|
| Gitea HTTP 端口 | 仅监听 127.0.0.1 | 修改 HTTP_ADDR,并重启服务 |
| 80/tcp | 仅用于跳转 HTTPS | 检查 Nginx 重定向 |
| 443/tcp | 对外提供 Web 和 HTTPS Git | 保留并检查证书 |
| SSH 管理端口 | 仅允许固定管理来源 | 使用云防火墙和系统防火墙双重限制 |
| 数据库端口 | 不对公网开放 | 仅允许本机或应用网段 |
| Gitea SSH 克隆端口 | 按需启用 | 不使用 SSH 克隆时关闭 |
美国服务器通常同时存在云平台安全组和系统防火墙两层控制。两层规则都要核对,不能只修改 UFW 后忽略云防火墙。
日常操作一:把公网入口收缩到必要端口
让 Gitea 只在本机提供 HTTP
如果前面已有 Nginx,Gitea 不需要直接监听公网地址。配置文件中可以保留类似设置:
[server]
PROTOCOL = http
DOMAIN = git.example.com
ROOT_URL = https://git.example.com/
HTTP_ADDR = 127.0.0.1
HTTP_PORT = 3000
git.example.com 应替换为实际域名。使用反向代理时,ROOT_URL 必须带上外部访问协议和域名,否则仓库克隆地址、回调地址和邮件链接可能生成错误。
修改前先备份配置:
sudo cp -a /etc/gitea/app.ini \
"/etc/gitea/app.ini.bak.$(date +%Y%m%d-%H%M%S)"
sudo chmod 600 /etc/gitea/app.ini
修改后重启 Gitea。重启会造成短暂不可用,适合安排在维护窗口:
sudo systemctl restart gitea
sudo systemctl status gitea --no-pager
sudo ss -lntp | grep -E ':(3000|3001)\b'
如果服务启动失败,先恢复刚才的备份,再重启:
sudo cp -a /etc/gitea/app.ini.bak.YYYYMMDD-HHMMSS /etc/gitea/app.ini
sudo systemctl restart gitea
sudo journalctl -u gitea -n 100 --no-pager
不要随意重新生成 SECRET_KEY、INTERNAL_TOKEN 等已有密钥。更换这些值可能导致现有会话、内部调用或集成配置失效。
通过反向代理统一提供 HTTPS
已有 Nginx 时,可以将 Gitea 放在本机回环地址后面。下面是简化示例,证书路径和域名需要替换:
server {
listen 80;
listen [::]:80;
server_name git.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name git.example.com;
ssl_certificate /etc/letsencrypt/live/git.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/git.example.com/privkey.pem;
add_header Strict-Transport-Security "max-age=31536000" always;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto https;
}
}
只有在确认整个域名体系都能稳定使用 HTTPS 后,才考虑增加 includeSubDomains。否则某些仍提供 HTTP 的子域名可能因 HSTS 无法访问。
检查并加载配置:
sudo nginx -t
sudo systemctl reload nginx
curl -I http://git.example.com
curl -I https://git.example.com
预期结果是 HTTP 返回 301 或 308,HTTPS 返回登录页、重定向或其他正常应用响应。nginx -t 未通过时不要 reload,先修复语法错误。
配置系统防火墙时避免锁死 SSH
如果使用 UFW,先保存当前规则并确认当前 SSH 来源。下面的公网地址只是文档示例,不能直接当作实际管理地址使用:
sudo ufw status numbered
sudo ufw show raw
sudo cp -a /etc/ufw "/root/ufw-backup-$(date +%Y%m%d-%H%M%S)"
确认已经从固定管理地址建立备用连接后,再添加规则。规则顺序应先放行必要来源,再设置默认拒绝:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow from 198.51.100.24/32 to any port 22 proto tcp
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw enable
sudo ufw status verbose
198.51.100.24/32 是示例地址,应替换为企业出口或跳板机的固定地址。如果管理员使用 IPv6,还要为实际 IPv6 来源单独配置。执行默认拒绝前必须确认云控制台、远程终端或带外管理仍可用,否则可能失去服务器访问权限。
不使用 Gitea SSH 克隆时,建议关闭 Gitea SSH 服务,只通过 HTTPS 克隆:
[server]
DISABLE_SSH = true
如果确实需要 SSH 克隆,应将 Gitea SSH 与系统管理员 SSH 区分开,并明确 SSH_PORT、监听端口和防火墙规则。管理员端口只允许固定来源,Gitea SSH 端口是否开放给外部协作者则根据实际业务决定,不能因为修改了显示端口就误以为已经完成访问控制。
日常操作二:配置认证和最小权限
收紧注册、匿名访问和二次认证
在 Gitea 管理后台或对应版本的 app.ini 中,常见的加固项如下:
[service]
DISABLE_REGISTRATION = true
REQUIRE_SIGNIN_VIEW = true
REQUIRE_2FA = true
[security]
INSTALL_LOCK = true
COOKIE_SECURE = true
这些设置的影响需要提前确认:
DISABLE_REGISTRATION:关闭普通访客自行注册,账号由管理员或受控流程创建;REQUIRE_SIGNIN_VIEW:未登录用户无法浏览仓库和站点内容。如果有确实需要公开访问的开源仓库,不应盲目开启;REQUIRE_2FA:要求账号启用二次认证。启用前应确认管理员、机器人账号和外部集成均有适配方案;INSTALL_LOCK:防止安装向导被再次使用;COOKIE_SECURE:要求会话 Cookie 通过 HTTPS 传输,反向代理的X-Forwarded-Proto必须配置正确。
配置项会随 Gitea 版本变化。编辑前应在后台配置页面或当前版本配置参考中核对名称,不认识的配置项不要直接添加。修改 app.ini 后通常需要重启 Gitea,重启前保留可回滚副本。
按仓库、组织和团队分配权限
全局配置只能限制注册和匿名访问,真正的最小权限要在组织、团队和仓库层面完成。
建议按以下方式调整:
- 默认新建仓库设置为私有,公开仓库由管理员单独审核后开放。
- 普通开发成员只加入所需组织,不直接授予站点管理员权限。
- 团队权限按“只读、可推送、可管理”区分,避免所有成员都拥有仓库管理权限。
- CI、部署和自动化任务使用独立机器人账号,不使用个人账号令牌。
- 部署密钥优先设置为只读;确需写入时单独建立专用密钥并记录用途。
- 个人访问令牌设置较短有效期,只勾选实际需要的作用域,离职、转岗或任务结束后立即撤销。
- 定期检查组织成员、协作者、部署密钥、Webhook、OAuth 应用和机器人账号。
仓库权限调整前要确认已有构建任务和部署任务不会因权限降低而中断。对于生产部署,读取代码通常不需要仓库管理权限;对发布任务,也不应默认授予删除仓库、修改成员或管理组织的权限。
日常操作三:建立可恢复的备份
备份范围不能只包含 Git 仓库
一次完整的 Gitea 备份至少应包含:
- Gitea 数据库;
- Git 仓库裸仓库目录;
- LFS 对象;
- 附件、头像、发行版文件和包文件;
app.ini及自定义模板;- 外部对象存储中的 Gitea 数据;
- 反向代理配置、证书续期配置和服务单元文件。
app.ini 中包含敏感信息,备份文件必须限制权限,并存放到与线上服务器不同的存储位置。备份服务器不应使用与线上 Gitea 相同的登录凭据。
systemd 加 PostgreSQL 的示例
以下命令适用于“Gitea 由 systemd 管理、PostgreSQL 在本机、数据目录为 /var/lib/gitea”的示例环境。执行前必须根据实际配置替换服务名、路径和数据库名。
停止服务再复制文件,可以避免仓库文件、附件和数据库记录处于不一致状态。停止服务会造成维护窗口内不可访问:
#!/usr/bin/env bash
set -Eeuo pipefail
SERVICE="gitea"
APP_INI="/etc/gitea/app.ini"
GITEA_DATA="/var/lib/gitea"
DB_NAME="gitea"
BACKUP_ROOT="/srv/backup/gitea"
STAMP="$(date +%Y%m%d-%H%M%S)"
DEST="${BACKUP_ROOT}/${STAMP}"
install -d -m 700 "$DEST"
systemctl stop "$SERVICE"
trap 'systemctl start "$SERVICE"' EXIT
rsync -aH --numeric-ids \
"$GITEA_DATA/" "$DEST/gitea-data/"
install -m 600 "$APP_INI" "$DEST/app.ini"
runuser -u postgres -- pg_dump \
--format=custom \
--file="$DEST/${DB_NAME}.dump" \
"$DB_NAME"
systemctl start "$SERVICE"
trap - EXIT
sha256sum "$DEST/app.ini" \
"$DEST/${DB_NAME}.dump" \
> "$DEST/SHA256SUMS"
echo "Backup completed: $DEST"
如果仓库根目录、LFS 目录或附件目录不在 GITEA_DATA 下,要在脚本中追加对应的 rsync。如果数据库是 MySQL 或 MariaDB,应使用相应的逻辑备份工具;如果使用 SQLite,则必须停止 Gitea 后复制数据库文件,不能在服务持续写入时直接复制。
Gitea 自带的 dump 命令也可以用于小型环境,但不同版本和安装方式的二进制路径、参数位置可能不同。执行前先查看:
sudo -u git /usr/local/bin/gitea help dump
确认命令支持的配置文件参数、归档格式和输出位置后再使用。无论采用内置导出还是手工备份,都要确认数据库、仓库、LFS 和附件确实同时存在。
Gitea承载代码仓库、数据库与附件等数据,对服务器的存储和持续运行能力有一定要求。A5数据提供美国物理服务器,涵盖常规Xeon、AMD EPYC等配置,并有搭配大容量内存与NVMe存储的方案,可为面向美国用户的代码托管、数据库及相关服务提供硬件资源基础。不同地区的服务器也可用于布局跨地域业务,让代码服务与团队及业务系统的部署需求相衔接。
备份策略与恢复验证
备份文件不能只留在美国服务器本地。较常见的策略是:
- 服务器本地保留短期备份,便于快速恢复;
- 独立备份存储保留每日和每周版本;
- 关键备份加密后再传输;
- 备份存储使用独立账号,禁止线上 Gitea 账号删除历史备份;
- 对备份目录设置 700 权限,对配置和数据库文件设置 600 权限。
备份成功不等于可以恢复。至少检查文件清单、数据库归档和校验值:
sudo tar -tzf /srv/backup/gitea/example/gitea-dump.tar.gz | head
sudo -u postgres pg_restore --list \
/srv/backup/gitea/example/gitea.dump | head -n 30
sha256sum -c /srv/backup/gitea/example/SHA256SUMS
恢复测试应在隔离主机或临时环境进行,确认登录、私有仓库访问、历史提交、LFS 下载、附件下载和必要的 Webhook 均能工作。建议至少按季度进行一次完整恢复演练,而不是只观察备份任务是否显示成功。

补丁、日志和审计
更新前先备份,避免直接降级数据库
先记录 Gitea 和系统版本:
gitea --version
cat /etc/os-release
sudo systemctl status gitea --no-pager
更新前完成数据库和文件备份,再根据现有安装方式更新。不要把发行版包、手工二进制和容器镜像混用。Gitea 版本升级可能触发数据库迁移,升级后的数据库未必支持直接降级,因此“更换回旧二进制”不一定是安全回滚方式。
建议流程如下:
- 阅读目标版本的升级说明,确认数据库和操作系统支持范围。
- 做一份可验证的完整备份。
- 在维护窗口停止 Gitea,替换现有安装方式对应的版本。
- 启动服务并查看迁移日志。
- 检查登录、私有仓库、HTTPS 克隆和 LFS。
- 观察一段时间后再清理旧版本和旧备份。
检查启动日志:
sudo systemctl start gitea
sudo systemctl status gitea --no-pager
sudo journalctl -u gitea --since "15 minutes ago" --no-pager
如果升级失败,不要直接反复启动或强行降级。先保留当前数据库和日志,再根据备份恢复数据库与数据目录,或者在隔离环境中验证目标版本。
建立应用、系统和反向代理三类审计
日常审计至少覆盖以下事件:
- 管理员登录和管理员权限变化;
- 组织成员、团队权限和仓库可见性变化;
- 个人访问令牌、部署密钥和 OAuth 应用的创建与撤销;
- 异常登录、连续失败登录和来源地址;
- 代码仓库批量克隆、异常下载和大量 API 请求;
- Nginx 返回的
401、403、404、5xx; - Gitea 服务重启、配置变化和数据库错误。
可先查看系统服务和 Nginx 日志:
sudo journalctl -u gitea --since "24 hours ago" --no-pager
sudo tail -n 200 /var/log/nginx/access.log
sudo tail -n 200 /var/log/nginx/error.log
timedatectl status
Gitea 后台的审计和活动记录名称会随版本变化,应以当前版本界面为准。日志保留时间要覆盖一次安全事件的发现和调查周期,并将重要日志转发到独立存储,避免入侵者只清理本机日志。
结果检查:按访问路径验证,而不是只看服务状态
完成配置后,从外部和服务器本机分别检查。以下结果是判断依据:
| 验收项 | 检查方法 | 合格表现 |
|---|---|---|
| HTTP 跳转 | curl -I http://git.example.com | 跳转到 HTTPS |
| HTTPS 证书 | 浏览器或 curl -I https://git.example.com | 证书域名匹配,无明文访问 |
| 监听地址 | ss -lntup | Gitea HTTP 端口只在本机监听 |
| 端口暴露 | 云防火墙和 ufw status | 仅开放必要端口 |
| 匿名访问 | 未登录浏览私有仓库 | 无法查看私有内容 |
| 成员权限 | 只读账号尝试推送 | 被拒绝;授权账号可按预期推送 |
| SSH 管理 | 非允许来源连接管理端口 | 被防火墙拒绝 |
| 备份完整性 | sha256sum -c、pg_restore --list | 校验通过且归档可读取 |
| 服务日志 | journalctl -u gitea | 无配置解析、数据库连接或迁移错误 |
| 令牌治理 | 后台查看令牌和密钥 | 无长期闲置或来源不明凭据 |
还应使用一个普通成员账号测试仓库操作,不能只用管理员账号验证。管理员拥有过大的权限,无法发现团队权限配置过宽的问题。
异常处理:先判断入口,再处理应用
页面出现 502 或 Gitea 无法访问
先判断是反向代理问题还是 Gitea 进程问题:
curl -I http://127.0.0.1:3000
sudo systemctl status gitea --no-pager
sudo journalctl -u gitea -n 100 --no-pager
sudo nginx -t
- 本机
3000无响应:检查 Gitea 服务、配置文件和数据库连接。 - 本机正常、域名返回 502:检查 Nginx 的
proxy_pass、监听端口和 SELinux/AppArmor 限制。 - HTTPS 证书错误:检查证书路径、域名和续期任务,不要为了临时恢复而关闭证书校验。
管理员无法登录或二次认证导致锁定
不要直接删除用户记录或修改数据库。先通过仍可用的管理员账号、控制台或带外管理确认问题。必要时在维护窗口中恢复最近一次安全的 app.ini,并保留当前文件与日志。涉及二次认证的恢复应使用 Gitea 当前版本支持的管理员流程,避免手工改表造成权限数据不一致。
备份任务失败
先查看磁盘空间、数据库连接和备份存储权限:
df -h
df -i
sudo -u postgres psql -d gitea -c 'select now();'
sudo du -sh /srv/backup/gitea
不要在磁盘空间不足时继续压缩或覆盖旧备份。先保留最近一份可用备份,再清理符合保留策略的历史版本,并确认备份目标不是 Gitea 数据目录本身。
必要恢复:配置误改或仓库暴露时的处理边界
如果只是配置文件误改,优先恢复变更前的 app.ini 副本,并检查权限:
sudo cp -a /etc/gitea/app.ini.bak.YYYYMMDD-HHMMSS /etc/gitea/app.ini
sudo chmod 600 /etc/gitea/app.ini
sudo systemctl restart gitea
sudo systemctl status gitea --no-pager
如果需要恢复完整环境,应先停止服务并备份当前故障现场。数据库恢复和带 --delete 的目录同步都会覆盖现有数据,执行前必须确认备份日期、目标路径和影响范围:
sudo systemctl stop gitea
sudo rsync -aH --numeric-ids --delete \
/srv/backup/gitea/20250101-020000/gitea-data/ \
/var/lib/gitea/
sudo -u postgres pg_restore \
--clean --if-exists --no-owner \
-d gitea \
/srv/backup/gitea/20250101-020000/gitea.dump
sudo chown -R git:git /var/lib/gitea
sudo systemctl start gitea
sudo journalctl -u gitea -n 100 --no-pager
上面的数据库恢复会清理目标数据库中的对象,只适用于已确认需要恢复的维护窗口。生产环境执行前,应先对当前数据库做一份额外备份,并确认 Gitea 配置中的数据库名、账号、仓库路径与备份版本匹配。
如果发现仓库曾经被公开访问,不能只把仓库改回私有。应立即通过云防火墙或带外控制台限制入口,同时保留日志和备份,然后:
- 撤销相关个人访问令牌、部署密钥、Webhook 密钥和 CI 凭据;
- 重置受影响账号密码并检查二次认证状态;
- 检查代码、提交历史、Issue、附件和构建日志中是否包含云密钥、数据库密码或证书;
- 先轮换外部系统凭据,再处理 Git 历史中的敏感内容;
- 对历史重写提前通知协作者,并保留原始证据副本;
- 检查访问日志,确认暴露时间范围和可能的下载行为。
上线或验收检查清单
- [ ] Gitea HTTP 端口没有监听公网地址。
- [ ] 公网 Web 访问统一使用 HTTPS,HTTP 只做跳转。
- [ ] 云防火墙和系统防火墙规则已同时核对。
- [ ] 管理 SSH 端口仅允许固定管理来源。
- [ ] 不使用的 Gitea SSH 服务已关闭。
- [ ] 已关闭开放注册,匿名访问策略符合仓库公开需求。
- [ ] 管理员和开发账号已启用二次认证。
- [ ] 仓库、组织、团队和部署密钥遵循最小权限。
- [ ] 个人访问令牌有用途、作用域和有效期记录。
- [ ] 数据库、仓库、LFS、附件、配置和对象存储均纳入备份。
- [ ] 备份已复制到独立存储,并限制了访问权限。
- [ ] 备份校验通过,至少完成过一次隔离恢复测试。
- [ ] Gitea、系统和反向代理日志均可查询。
- [ ] 补丁更新前有备份,且明确了数据库迁移带来的回滚边界。
- [ ] 普通成员、管理员、只读账号和失效令牌均完成实际验证。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4949.html



