CN_Gather/Gitea本地协作开发服务器配置指南.md

Gitea本地协作开发服务器配置指南

概述

本文档说明如何将本地安装的Gitea配置为团队协作开发服务器，替代原有的物理服务器环境。

1. 网络配置

1.1 确认本机IP地址

# Windows系统
ipconfig
# 查找本机局域网IP地址，通常形如 192.168.x.x 或 10.x.x.x

1.2 配置Gitea服务地址

编辑Gitea配置文件 app.ini：

[server]
# 将localhost改为本机IP地址，确保同事可以访问
HTTP_ADDR = 0.0.0.0
HTTP_PORT = 3000
# 外部访问URL，替换为你的实际IP
ROOT_URL = http://192.168.x.x:3000/

1.3 防火墙配置

确保Windows防火墙允许Gitea端口通信：

# 打开Windows防火墙入站规则
# 添加端口3000的TCP入站规则

或在Windows防火墙中：

• 控制面板 → 系统和安全 → Windows Defender防火墙 → 高级设置
• 入站规则 → 新建规则 → 端口 → TCP → 特定本地端口: 3000

2. Gitea服务配置

2.1 启动Gitea服务

# 进入Gitea安装目录
cd C:\gitea  # 或你的安装路径
gitea.exe web

2.2 配置为Windows服务（推荐）

创建Windows服务确保开机自启：

1. 下载NSSM (Non-Sucking Service Manager)
2. 以管理员身份运行命令提示符：

nssm install Gitea
# 在弹出界面中配置：
# Path: C:\gitea\gitea.exe
# Arguments: web
# Working directory: C:\gitea

3. 启动服务：

net start Gitea

2.3 数据库配置优化

如果使用SQLite（默认），确保数据文件路径正确：

[database]
DB_TYPE = sqlite3
PATH = data/gitea.db

如果需要更好性能，考虑配置MySQL：

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

3. 同事访问配置

3.1 提供访问地址

向同事提供访问地址：

http://你的IP地址:3000
例如: http://192.168.1.100:3000

3.2 用户账号管理

1. 访问管理界面创建用户账号
2. 或开启用户自注册：

[service]
DISABLE_REGISTRATION = false
REQUIRE_SIGNIN_VIEW = false

3.3 权限配置

为协作项目设置适当权限：

• 项目所有者：完全控制权限
• 协作者：推送/拉取权限
• 读者：仅读取权限

4. 代码仓库迁移

4.1 从原服务器迁移仓库

如果原服务器数据可恢复：

# 在原服务器或备份中找到Git裸仓库
# 复制到新Gitea的repositories目录
# 通常位于 gitea-repositories/用户名/仓库名.git

4.2 重新创建仓库

如果需要重新创建：

1. 在Gitea界面创建新仓库
2. 本地添加新的远程地址：

git remote remove origin
git remote add origin http://你的IP:3000/用户名/仓库名.git
git push -u origin master

5. 开发工作流配置

5.1 分支保护规则

为主要分支设置保护规则：

• 设置 → 分支 → 分支保护规则
• 保护master分支，要求代码审查

5.2 Webhook配置

如果需要CI/CD集成：

设置 → Webhooks → 添加Webhook
配置自动构建触发器

6. 备份策略

6.1 定期备份

# 备份Gitea数据目录
# 包括：repositories/, data/, log/, custom/
robocopy "C:\gitea" "D:\backup\gitea" /MIR /Z /R:3 /W:10

6.2 自动备份脚本

创建批处理文件实现定期备份：

@echo off
set BACKUP_DIR=D:\backup\gitea_%date:~0,4%%date:~5,2%%date:~8,2%
robocopy "C:\gitea" "%BACKUP_DIR%" /MIR /Z /R:3 /W:10
echo Backup completed to %BACKUP_DIR%

7. 常见问题排查

7.1 访问问题

• 检查防火墙设置
• 确认IP地址和端口正确
• 验证Gitea服务是否正常运行

7.2 权限问题

• 检查用户账号状态
• 确认仓库权限设置
• 验证SSH密钥配置（如使用SSH）

7.3 性能优化

[server]
# 调整并发连接数
HTTP_ADDR = 0.0.0.0
HTTP_PORT = 3000

[database]
# 数据库连接池配置
MAX_IDLE_CONNS = 30
MAX_OPEN_CONNS = 300

8. 安全建议

1. 网络安全：

   • 仅在受信任的局域网环境中开放
   • 考虑使用VPN访问
   • 定期更新Gitea版本

2. 访问控制：

   • 禁用不必要的公开注册
   • 使用强密码策略
   • 启用双因子认证

3. 数据安全：

   • 定期备份重要数据
   • 监控异常访问
   • 记录操作日志

9. 同事操作指南

9.1 首次设置

# 克隆仓库
git clone http://你的IP:3000/用户名/CN_Gather.git

# 配置用户信息
git config user.name "姓名"
git config user.email "邮箱"

9.2 日常协作

# 拉取最新代码
git pull origin master

# 创建功能分支
git checkout -b feature/新功能

# 提交更改
git add .
git commit -m "描述信息"
git push origin feature/新功能

# 在Gitea界面创建Pull Request

---

联系信息：

• Gitea服务地址：http://你的IP:3000
• 管理员：[你的联系方式]
• 紧急联系：[备用联系方式]

注意：请确保定期备份重要代码，避免数据丢失。