NXCRM2
1. 指南
web 端安装

1. 解压安装包

将我们提供的安装包上传到您的服务器指定目录,并解压。建议将安装文件存放到网站根目录下,例如 /var/www/crm

2. 安装依赖

请确保您的服务器上已安装 ComposerNode.js,并执行以下命令:

安装 PHP 依赖

进入项目根目录,运行以下命令:

composer install

3. 配置 .env 文件

解压后的项目中包含一个 .env.example 文件。请复制该文件为 .env

cp .env.example .env

修改 .env 文件中的以下配置,根据您的实际环境填写:

APP_NAME=您的系统名称
APP_ENV=production
APP_KEY=不用管,稍后会自动生成
APP_DEBUG=false
APP_URL=http://您的系统域名

DB_CONNECTION=mysql
DB_HOST=数据库服务器地址
DB_PORT=3306
DB_DATABASE=数据库名称
DB_USERNAME=数据库用户名
DB_PASSWORD=数据库密码

CACHE_DRIVER=redis
QUEUE_CONNECTION=redis
SESSION_DRIVER=redis

4. 设置文件权限

为确保系统能够正常读写文件,请设置相关目录的权限:

chmod -R 775 storage bootstrap/cache
chown -R www:www storage bootstrap/cache

5. 执行安装

在项目根目录运行以下命令开始安装:

php artisan nxos:install

6. 配置 Web 服务器

运行目录修改

将网站的运行目录指向在根目录的 public 目录下。

Nginx 示例配置

请根据以下示例配置 Nginx,确保 CRM 系统能够正确运行:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}
location ~* \.(jpg|jpeg|gif|png|webp|svg|woff|woff2|ttf|css|js|ico|xml)$ {
       try_files $uri /index.php?$query_string;
       access_log        off;
       log_not_found     off;
       expires           14d;
}

Apache 示例配置

如果您使用 Apache,请确保启用了 mod_rewrite 模块,并根据以下示例配置虚拟主机:

<VirtualHost *:80>
    ServerName 您的域名
    DocumentRoot /path/to/your/project/public
 
    <Directory /path/to/your/project/public>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
 
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

7. 启动队列服务(可选)

CRM 系统依赖队列处理后台任务,请确保 Redis 已正确安装并运行,然后启动队列服务:

php artisan queue:work

建议使用 Supervisor 管理队列服务,以保证系统稳定运行。


测试与上线

完成以上步骤后,访问您的系统域名,检查系统是否正常运行。如有问题,请检查以下内容:

  1. .env 文件配置是否正确。
  2. 数据库是否成功迁移。
  3. 文件权限是否设置正确。
  4. Nginx 或 Apache 配置是否生效。

常见问题

  1. 页面显示 500 错误

    • 请检查 .env 文件中的数据库配置和 APP_KEY 是否正确生成。
    • 检查 storagebootstrap/cache 目录的权限。
  2. 前端资源未加载

    • 请确认已正确执行 yarn build 命令。
    • 检查 Nginx 或 Apache 的配置,确保指向 public 目录。
  3. 队列任务未处理

    • 请确保 Redis 服务已启动。
    • 检查 php artisan queue:work 是否正常运行。

技术支持

如有任何问题,请联系技术支持团队:

  • 微信: shebaoting
  • 电话:18709687207