配置与访问

学习如何配置和访问 Canyon 社区版。

1. 初始化 Git 提供商配置（GitLab）

如果你使用 GitLab，请先导入 app/prisma/import-infra.sql 中的配置到数据库。

该文件默认包含两项：

• GITLAB_BASE_URL
• GITLAB_PRIVATE_TOKEN

执行前请先将 GITLAB_PRIVATE_TOKEN 修改为你自己的 Token。

示例：

cd app
psql "postgres://username:password@host:5432/dbname" -f prisma/import-infra.sql

2. 启动并访问系统

启动服务后，打开：

• 开发模式：http://localhost:3000
• 生产模式：http://localhost:8080

API 文档入口：

• Swagger UI：/api/ui
• OpenAPI JSON：/api/doc

可在页面中查看仓库、commit、compare 及覆盖率报告能力。

3. 重要说明

• 当前社区版文档优先覆盖 GitLab 场景。
• 如果你使用自建 GitLab，请将 GITLAB_BASE_URL 改为你的实例地址。
• 如果 Token 权限不足，会影响 compare、源码拉取、快照生成等能力。