docs: add Gitea account management guide for admin

- Batch account creation script via API
- Web UI manual creation steps
- Team-based permission management
- Developer notification template

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Du Wenbo
2026-04-03 22:22:47 +08:00
parent 32ff8b6619
commit 9d2c18af78

View File

@@ -0,0 +1,141 @@
# Gitea 账号管理说明(管理员操作)
> 本文档供项目经理/管理员使用,用于批量创建开发者账号和管理仓库权限。
---
## 管理员登录信息
| 项目 | 值 |
|------|-----|
| 管理后台 | https://ailabmac-studio.tail954f11.ts.net/git/-/admin |
| 管理员账号 | tianpu |
| 管理员密码 | TianpuGit2026! |
| 仓库地址 | https://ailabmac-studio.tail954f11.ts.net/git/tianpu/tianpu-ems |
---
## 方式一:网页手动创建账号
1. 登录管理员账号
2. 点击右上角头像 → **网站管理****用户账户****创建用户**
3. 填写信息:
- 用户名:开发者指定的用户名
- 邮箱:开发者邮箱(可以用 username@tianpu.com
- 密码:设置初始密码(建议统一用 `Tianpu2026!`,要求首次登录修改)
- 勾选:☑ 要求用户修改密码
4. 点击「创建用户」
5. 然后到仓库设置中添加协作者:
- 打开仓库 → **设置****协作者** → 输入用户名 → 选择权限Write→ 添加
## 方式二API批量创建推荐
用管理员 Token 通过 API 批量创建。先获取 Token
1. 登录管理员账号
2. 右上角头像 → **设置****应用****生成令牌**
3. 创建一个名为 "admin-api" 的令牌,权限全选
然后用以下脚本批量创建:
```bash
# 设置变量
GITEA_URL="https://ailabmac-studio.tail954f11.ts.net/git"
ADMIN_TOKEN="你的管理员Token"
REPO_OWNER="tianpu"
REPO_NAME="tianpu-ems"
# =============================================
# 在这里修改开发者名单
# 格式: "用户名 邮箱 全名"
# =============================================
DEVELOPERS=(
"zhangsan zhangsan@tianpu.com 张三"
"lisi lisi@tianpu.com 李四"
"wangwu wangwu@tianpu.com 王五"
"zhaoliu zhaoliu@tianpu.com 赵六"
)
# 初始密码(首次登录需修改)
INIT_PASSWORD="Tianpu2026!"
# 批量创建账号
for DEV in "${DEVELOPERS[@]}"; do
read -r USERNAME EMAIL FULLNAME <<< "$DEV"
echo "创建账号: $USERNAME ($FULLNAME)"
curl -s -X POST "$GITEA_URL/api/v1/admin/users" \
-H "Authorization: token $ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d "{
\"username\": \"$USERNAME\",
\"email\": \"$EMAIL\",
\"full_name\": \"$FULLNAME\",
\"password\": \"$INIT_PASSWORD\",
\"must_change_password\": true,
\"login_name\": \"$USERNAME\",
\"source_id\": 0,
\"visibility\": \"public\"
}" | python -c "import sys,json; d=json.load(sys.stdin); print(f' ✅ 创建成功: {d.get(\"login\",\"ERROR\")}') if 'id' in d else print(f' ❌ 失败: {d}')"
# 添加为仓库协作者Write权限
curl -s -X PUT "$GITEA_URL/api/v1/repos/$REPO_OWNER/$REPO_NAME/collaborators/$USERNAME" \
-H "Authorization: token $ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"permission": "write"}' \
&& echo " ✅ 已添加仓库权限"
echo ""
done
echo "============================="
echo "全部完成!"
echo "开发者登录地址: $GITEA_URL"
echo "初始密码: $INIT_PASSWORD(首次登录需修改)"
echo "仓库克隆命令: git clone $GITEA_URL/$REPO_OWNER/$REPO_NAME.git"
echo "============================="
```
---
## 方式三:创建团队并用组织管理(可选,适合大团队)
如果团队人多,可以在 Gitea 中创建组织和团队:
1. **创建组织**:网站管理 → 组织 → 创建 "tianpu-org"
2. **创建团队**
- `core-platform`(核心平台组)→ 权限Write → 添加仓库 tianpu-ems
- `delivery-app`(交付应用组)→ 权限Write → 添加仓库 tianpu-ems
3. **添加成员**:把后端开发加入 core-platform前端开发加入 delivery-app
---
## 创建完成后通知开发者
将以下信息发给每位开发者:
```
【天普EMS开发环境信息】
Git仓库地址: https://ailabmac-studio.tail954f11.ts.net/git/tianpu/tianpu-ems
你的账号: {用户名}
初始密码: Tianpu2026!(首次登录请修改密码)
克隆代码:
git clone https://ailabmac-studio.tail954f11.ts.net/git/tianpu/tianpu-ems.git
详细环境搭建步骤请参考仓库中的:
docs/开发者环境搭建指南.md
如有问题请在开发群内提问。
```
---
## 权限说明
| 权限级别 | 说明 | 建议分配给 |
|---------|------|-----------|
| Admin | 仓库管理(删除/设置) | 项目经理 |
| Write | 推送代码、创建分支 | 所有开发者 |
| Read | 只读(可克隆不可推送) | 外部评审人员 |