克隆仓库前，请先参阅环境配置，确保Go、Node.js、pnpm、PostgreSQL等必要组件已正确安装。

克隆仓库

使用以下命令获取框架源码：

# 安装最新实验版本
git clone --depth 1 https://github.com/linaproai/linapro.git linapro

# 或者指定稳定发布版本，如 v0.1.0
git clone --depth 1 --branch v0.1.0 https://github.com/linaproai/linapro.git linapro

启动服务

准备 PostgreSQL

LinaPro默认使用PostgreSQL 14+作为数据库。make init和make dev不会启动或管理数据库，请先准备可连接的PostgreSQL实例。本地开发可以使用以下容器：

docker run \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=postgres \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_DB=linapro \
  postgres:14-alpine

如果本机5432端口已被占用，可以将容器映射到其他本机端口，例如15432:5432，并同步修改database.default.link中的端口。

配置数据库连接

克隆完成后，进入项目目录，将配置模板复制为正式配置文件：

cd linapro
cp apps/lina-core/manifest/config/config.template.yaml apps/lina-core/manifest/config/config.yaml

用编辑器打开config.yaml，找到数据库连接部分，将其修改为你本地PostgreSQL的实际连接信息：

apps/lina-core/manifest/config/config.yaml

database:
  default:
    link: "pgsql:postgres:postgres@tcp(127.0.0.1:5432)/linapro?sslmode=disable"

默认配置使用postgres:[email protected]:5432连接linapro数据库，如果你的PostgreSQL使用了不同的用户名、密码、主机、端口或数据库名，请在此处更新。

初始化数据库

配置完成后，执行以下命令创建数据库表结构并写入初始数据：

make init confirm=init

Windows用户如果使用PowerShell，可执行：

.\make init confirm=init

初始化完成后，数据库中将包含系统所需的基础表结构和默认配置数据。

加载演示数据（可选）

配置完成后，执行以下命令加载官方提供的演示数据：

make mock confirm=mock

启动开发服务

执行以下命令启动前后端服务：

make dev

服务启动成功后，访问以下地址：

服务	地址
默认管理工作台	http://localhost:5666
后端API服务	http://localhost:8080

使用默认账号登录管理工作台：

字段	值
账号	admin
密码	admin123

常用命令

make dev               # 启动前后端服务
make stop              # 停止所有本地服务
make status            # 查看服务运行状态
make init confirm=init # 重新初始化数据库
make mock confirm=mock # 重新加载演示数据
make test              # 运行完整 E2E 测试套件
make build             # 编译生成可发布的二进制文件
make image             # 构建 Docker 镜像

Windows cmd.exe可直接使用make <指令>；PowerShell使用.\make <指令>或.\make.cmd <指令>。

安装验证

服务启动后，打开浏览器访问http://localhost:5666，使用admin / admin123登录，如果能够正常进入管理工作台，说明安装已成功完成。

如果遇到问题，可以通过以下步骤排查：

1. 确认PostgreSQL服务已启动且config.yaml中的数据库连接配置正确
2. 查看后端日志输出，确认服务是否有异常
3. 执行make status检查前后端进程状态
4. 如果问题仍未解决，请前往社区交流寻求帮助