cool-admin-api 的安装和配置教程

2025-05-27 08:49:15作者：魏献源Searcher

项目基础介绍

cool-admin-api 是一个基于 egg.js、typeorm、jwt 等技术封装的 API 开发脚手架，旨在帮助开发者快速开发后端 API 接口。该项目使用 TypeScript 作为主要的编程语言，通过一系列预封装的组件和工具，简化了后端服务的构建过程。

项目使用的关键技术和框架

egg.js：阿里出品的 Node.js 框架，提供了丰富的中间件和插件，用于构建高性能、高可靠性的后端服务。
typeorm：一个强大的 ORM 框架，用于简化数据库操作，支持多种数据库。
jwt：JSON Web Token，用于用户认证和授权。
Redis：用于数据缓存，提高系统性能。
axios：基于 Promise 的 HTTP 客户端，用于发送 HTTP 请求。

安装和配置准备工作

在开始安装 cool-admin-api 之前，请确保您的系统已经安装以下依赖：

Node.js（版本 >= 8.9.0）
Redis
MySQL
Git

确保您的开发环境满足以上条件后，可以按照以下步骤进行安装和配置。

安装步骤

克隆项目仓库

使用 Git 克隆项目到本地：

git clone https://github.com/apgzs/cool-admin-api.git

安装依赖

进入项目目录，使用 yarn 或 npm 安装项目依赖：
```
cd cool-admin-api
yarn install # 或者使用 npm install
```

配置数据库

在项目根目录下的 config/config.default.js 文件中配置数据库连接信息。找到 config.typeorm 部分，填写您的 MySQL 数据库配置。

config.typeorm = {
  // ... 其他配置
  // 数据库配置
  mysql: {
    // 数据库用户
    username: 'root',
    // 数据库密码
    password: 'password',
    // 数据库名称
    database: 'cool_admin',
    // 数据库地址
    host: '127.0.0.1',
    // 数据库端口
    port: 3306,
    // ... 其他数据库配置
  },
  // ... 其他配置
};

启动项目

使用 yarn 或 npm 启动项目：
```
yarn run dev # 或者使用 npm run dev
```
启动成功后，您可以通过 http://localhost:7001 访问后端服务。
环境变量配置（可选）

为了更好的开发和生产环境管理，建议设置环境变量。在项目根目录下创建一个 .env 文件，并填写所需的环境变量。
```
# .env 文件示例
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=root
DB_PASSWORD=password
DB_DATABASE=cool_admin
```
在 config/config.default.js 文件中，使用 process.env 来读取这些环境变量。