【亲测免费】 OpenSCRM API Server 常见问题解决方案

项目基础介绍

OpenSCRM API Server 是一个基于 Go 和 React 的高质量企业微信私域流量管理系统。该项目遵守 Apache 2.0 协议，全网唯一免费商用。它主要用于企业微信的私域流量管理，包括企业微信、私域流量和 SCRM 等功能。

新手使用注意事项及解决方案

1. Node.js 版本问题

问题描述：项目前端部分对 Node.js 版本有严格要求，必须是 16.20.2 版本，其他版本可能会导致兼容性问题。

解决方案：

1. 安装 nvm：首先安装 Node Version Manager (nvm)，这是一个用于管理多个 Node.js 版本的工具。
2. 安装指定版本：使用 nvm 安装 16.20.2 版本的 Node.js。

   nvm install 16.20.2
   

3. 切换版本：安装完成后，切换到 16.20.2 版本。

   nvm use 16.20.2
   

2. 配置文件修改问题

问题描述：新手在启动项目时，可能会忽略对配置文件的修改，导致项目无法正常运行。

解决方案：

1. 复制配置文件：将 conf/config.example.yaml 复制为 conf/config.yaml。

   cp conf/config.example.yaml conf/config.yaml
   

2. 修改配置：打开 conf/config.yaml 文件，根据实际需求修改配置项，特别是 SuperAdmin 字段。
3. 启动项目：在项目根目录下启动 API Server。

   go run main.go
   

3. 前端开发环境搭建问题

问题描述：新手在搭建前端开发环境时，可能会遇到依赖安装失败或启动失败的问题。

解决方案：

1. 克隆前端项目：首先克隆前端项目到本地。

   git clone https://github.com/openscrm/dashboard
   

2. 安装依赖：进入前端项目目录，使用 npm 安装依赖。

   npm install --legacy-peer-deps
   

3. 启动前端：依赖安装完成后，启动前端项目。

   npm run start
   

通过以上步骤，新手可以顺利解决在使用 OpenSCRM API Server 项目时可能遇到的常见问题。