For AI agents: the complete documentation index is available at https://docs.fit2cloud.com/cordys/llms.txt, the full documentation bundle is available at https://docs.fit2cloud.com/cordys/llms-full.txt, and this page is available as Markdown at https://docs.fit2cloud.com/cordys/installation/offline_installtion.md.
Cordys CRM 文档

离线安装

1 环境要求

部署服务器要求：

  • 操作系统: 支持主流 Linux 发行版本（基于 Debian / RedHat，包括国产操作系统，内核版本要求 ≥ 3.10）
  • CPU/内存: 4 核 8 G
  • 磁盘空间: 100G

提示： Docker 版本太老可能会导致安装失败，建议使用安装包内的 Docker，或者使用 v23.0.5 版本及以上的 Docker。

2 下载离线安装包

打开飞致云开源社区 Cordys CRM 社区版下载 页面下载最新版本安装包，并上传至部署服务器（以 v1.0.0 为例说明安装部署过程）。

3 端口要求

离线部署 Cordys CRM 需要开通的访问端口说明如下：

表 1 端口说明
端口作用说明
22SSH安装、升级及管理使用
8081Web 服务端口默认 Web 服务访问端口，可根据实际情况进行更改
8082MCP Server 服务端口默认 MCP 服务访问端口，可根据实际情况进行更改

4 安装部署

4.1 解压安装包

以 root 用户通过 ssh 协议登录到部署服务器, 对安装包进行解压：

tar -zxvf cordys-crm-v1.0.0-x86_64-offline-installer.tar.gz

4.2 设置安装参数（可选）

Cordys CRM 安装目录、服务运行端口、数据库配置等信息可在安装包解压后中的 install.conf 文件进行配置。

注意: 这部分参数仅限于离线包安装使用，在线安装请参考在线一键安装 文档。

# 基础配置
## 安装路径, Cordys CRM 配置及数据文件默认将安装在 ${CORDYS_BASE}/cordys 目录下
CORDYS_BASE=/opt
## Cordys CRM 使用的 docker 网络网段信息
CORDYS_DOCKER_SUBNET=172.30.10.0/24
## 镜像前缀
CORDYS_IMAGE_PREFIX='registry.fit2cloud.com/cordys'
## 镜像相关
CORDYS_IMAGE_NAME=cordys-crm-ce
CORDYS_IMAGE_TAG=v1.0.0

## CORDYS 主程序的 HTTP 服务监听端口
CORDYS_SERVER_PORT=8081

# 数据库配置
## 是否使用外部数据库
CORDYS_EXTERNAL_MYSQL=false
## 数据库地址
CORDYS_MYSQL_HOST=$(hostname -I|cut -d" " -f 1)
## 数据库端口
CORDYS_MYSQL_PORT=3306
## 数据库库名
CORDYS_MYSQL_DB=cordys-crm
## 数据库用户名
CORDYS_MYSQL_USER=root
## 数据库密码
CORDYS_MYSQL_PASSWORD=CordysCRM@mysql

# Redis 配置
## 是否使用外部Redis
CORDYS_EXTERNAL_REDIS=false
## Redis 端口
CORDYS_REDIS_PORT=6379
## Redis 密码
CORDYS_REDIS_PASSWORD=CordysCRM@redis
## Redis地址
CORDYS_REDIS_HOST=$(hostname -I|cut -d" " -f 1)
 
#MCP Server
CORDYS_MCP_EXTERNAL_SERVER=false
CORDYS_MCP_SERVER_PORT=8082

PS： 如果使用外置数据库，需对应创建数据库。参考 SQL 示例：

CREATE DATABASE `cordys-crm`
CHARACTER SET utf8mb4
COLLATE utf8mb4_general_ci;

请确保在 install.conf 中将 CORDYS_EXTERNAL_MYSQL 设置为 true，并填写正确的外部数据库连接信息。

4.3 执行安装脚本

# 进入安装包解压缩后目录  
cd cordys-crm-v1.0.0-x86_64-offline-installer

# 执行安装命令
bash install.sh

5 离线升级

按照本文档 离线安装 步骤，下载新版本安装包并上传解压后，重新执行安装命令进行升级。

# 进入项目目录
cd cordys-crm-release-v1.x.y-offline

# 运行安装脚本
/bin/bash install.sh

# 查看 Cordys CRM 状态
csctl status

注意: 升级前做好数据库的备份工作是一个良好的习惯。

备份与还原

Cordys CRM 安装后，相关文件的分布路径如下：

  • /opt/cordys：默认运行路径，在安装时可设置。主要存放 Cordys CRM 运行时所需的配置文件及运行时产生的数据，包括日志文件等
  • /usr/bin：默认 docker 及 docker-compose 的运行程序被放置在此目录下
  • /usr/local/bin/csctl：Cordys CRM 的命令行工具
  • /var/lib/docker：默认 docker 镜像加载在此

综上所述，备份 Cordys CRM 主要需要备份运行路径，如 /opt/cordys 目录即可。还原步骤如下：

  • 该方式适用于相同版本 Cordys CRM 的迁移，请在新环境里安装同一个版本的 Cordys CRM，安装时请选择相同的配置参数
  • 停止 Cordys CRM 服务，执行命令： csctl stop
  • 把原环境里的运行目录 /opt/cordys 整个目录覆盖掉新环境里的 /opt/cordys 目录
  • 启动新环境里的 Cordys CRM 服务： csctl restart

6 登录访问

安装成功后即可通过浏览器访问地址 http://目标服务器 IP 地址:8081，并使用默认的管理员用户和密码登录 Cordys CRM。

用户名：admin

默认密码：CordysCRM
图 1 访问Cordys CRM
图 1 访问Cordys CRM