SHA256
forked from course-team/tjhlp-gitea
添加 init-admin.sh 脚本来自动创建 Gitea 管理员账号 更新相关文档说明使用新脚本替代手动创建步骤 修改 .env.example 注释以反映脚本使用情况
Docker Compose 部署
- 目标: 单机容器部署
Gitea + PostgreSQL - 不包含: Nginx、TLS 证书、外部对象存储、多节点编排
- 上层使用方式不变: 服务启动后仍然使用
scripts/里的tjhlpCLI 初始化课程组织、仓库、标签和 Webhook
文件说明
docker-compose.yml: 启动 Gitea 与 PostgreSQL.env.example: 本地变量模板, 复制为.env后修改init-admin.sh: 读取.env中的管理员参数并初始化首个管理员账号
前置要求
- 已安装 Docker Engine
- 已安装 Docker Compose Plugin, 能执行
docker compose - 目标机器开放 Gitea HTTP 访问端口
快速开始
cd deploy/compose
sudo cp .env.example .env
编辑 .env, 至少确认这些变量:
GITEA_IMAGE/POSTGRES_IMAGE: 要使用的镜像版本GITEA_ROOT_URL: Gitea 对外访问地址, 必须与实际访问 URL 一致GITEA_DOMAIN: 对外访问域名或主机名GITEA_HTTP_PORT: 宿主机暴露的 Gitea 端口POSTGRES_PASSWORD: PostgreSQL 密码PUID/PGID: 容器内 Gitea 运行用户的 UID/GID, 默认 1000GITEA_ADMIN_USERNAMEGITEA_ADMIN_PASSWORDGITEA_ADMIN_EMAIL
启动服务:
sudo docker compose up -d
sudo docker compose logs -f gitea
首次启动后, 运行管理员初始化脚本:
sh ./init-admin.sh
脚本会:
- 从
.env读取GITEA_ADMIN_USERNAME、GITEA_ADMIN_PASSWORD、GITEA_ADMIN_EMAIL - 等待 Gitea API 就绪
- 首次运行时创建管理员
- 再次运行时若管理员已存在则直接跳过
创建完成后, 访问 GITEA_ROOT_URL, 用 .env 中配置的管理员账号登录。
(不推荐Windows)如果你在 Windows 上使用 Docker Desktop, 建议通过 Git Bash 或 WSL 执行 init-admin.sh。
课程平台初始化
- 登录 Gitea
- 在“设置 -> 应用”中创建 API Token
- 进入仓库
scripts/目录 - 配置
.secrets.toml - 执行:
uv sync
uv run tjhlp setup status
uv run tjhlp setup init --org tjhlp-2025f
如果是 Docker Compose 部署, 记得把 scripts/settings.toml 或环境变量中的 Gitea URL 指向 GITEA_ROOT_URL。
例如:
export TJHLP_GITEA_URL=http://localhost:3000
PowerShell:
$env:TJHLP_GITEA_URL = "http://localhost:3000"
常用命令
启动:
sudo docker compose up -d
停止:
sudo docker compose down
查看日志:
sudo docker compose logs -f gitea
sudo docker compose logs -f postgres
升级镜像:
sudo docker compose pull
sudo docker compose up -d
数据持久化
本方案使用 Docker 命名卷:
gitea_data: Gitea 仓库、附件、LFS、配置等数据postgres_data: PostgreSQL 数据目录
删除容器不会删除卷, 但执行带 --volumes 的 docker compose down 会清空数据。
与 Ansible 方案的关系
ansible/仍然是现有的主机直装方案deploy/compose/是新增的单机容器方案- 两者部署完成后, 上层
scripts/的初始化和日常管理方式一致
注意事项
.env放环境差异和敏感参数,docker-compose.yml保留项目默认策略配置- 该方案默认只暴露 HTTP, 若要对外提供 HTTPS, 请在外部使用 Nginx/Caddy 等反向代理
GITEA_ROOT_URL配错时, Web 界面跳转、Webhook 和仓库链接通常会异常- 如果宿主机已经占用
3000, 请调整.env中的端口映射 - PostgreSQL 默认不对宿主机暴露端口, 以减少额外暴露面