feat(compose): 添加管理员初始化脚本并更新文档

添加 init-admin.sh 脚本来自动创建 Gitea 管理员账号
更新相关文档说明使用新脚本替代手动创建步骤
修改 .env.example 注释以反映脚本使用情况
This commit is contained in:
2026-04-23 21:44:19 +08:00
parent ea3be5b45d
commit 81c64b4515
4 changed files with 113 additions and 20 deletions
+10 -18
View File
@@ -9,6 +9,7 @@
- `docker-compose.yml`: 启动 Gitea 与 PostgreSQL
- `.env.example`: 本地变量模板, 复制为 `.env` 后修改
- `init-admin.sh`: 读取 `.env` 中的管理员参数并初始化首个管理员账号
## 前置要求
@@ -42,31 +43,22 @@ sudo docker compose up -d
sudo docker compose logs -f gitea
```
首次启动后, 手动创建管理员账号:
首次启动后, 运行管理员初始化脚本:
```bash
sudo docker compose exec gitea \
gitea admin user create \
--admin \
--username admin \
--password 'ChangeMe!2026' \
--email [email protected]
sh ./init-admin.sh
```
将上面的 `admin` / `ChangeMe!2026` / `[email protected]` 替换为你在 `.env` 中准备好的值。
脚本会:
如果你在 Windows PowerShell 中执行, 使用:
- 从 `.env` 读取 `GITEA_ADMIN_USERNAME`、`GITEA_ADMIN_PASSWORD`、`GITEA_ADMIN_EMAIL`
- 等待 Gitea API 就绪
- 首次运行时创建管理员
- 再次运行时若管理员已存在则直接跳过
```powershell
sudo docker compose exec gitea `
gitea admin user create `
--admin `
--username admin `
--password 'ChangeMe!2026' `
--email admin@example.com
```
创建完成后, 访问 `GITEA_ROOT_URL`, 用 `.env` 中配置的管理员账号登录。
创建完成后, 访问 `GITEA_ROOT_URL`, 用管理员账号登录。
(不推荐Windows)如果你在 Windows 上使用 Docker Desktop, 建议通过 Git Bash 或 WSL 执行 `init-admin.sh`。
## 课程平台初始化