cilimao安装指南：从零开始快速部署

什么是cilimao及其核心功能

cilimao是一款功能强大的开源数据可视化工具，专为现代数据分析需求设计。它支持多种数据源接入，提供直观的图表展示和交互式分析界面，能够帮助用户快速构建专业级的数据看板和报表系统。cilimao采用模块化架构，具有高度可扩展性，支持自定义插件开发，适用于企业级数据监控、业务分析和科研数据处理等多种场景。

系统环境要求与准备工作

在安装cilimao之前，请确保您的系统满足以下基本要求：操作系统建议使用Ubuntu 18.04+、CentOS 7+或Windows Server 2016+；内存至少4GB，推荐8GB以上；存储空间需要20GB可用空间。软件依赖包括Python 3.8+、Node.js 14+、Redis 5.0+和PostgreSQL 10+。建议提前配置好Python虚拟环境，并确保网络连接稳定以便下载依赖包。

依赖环境详细配置

Python环境建议使用conda或virtualenv创建独立环境：

conda create -n cilimao_env python=3.8
conda activate cilimao_env

数据库配置需要创建专用用户和数据库：

CREATE USER cilimao WITH PASSWORD 'your_password';
CREATE DATABASE cilimao_db OWNER cilimao;

详细安装步骤

步骤一：获取安装包

通过官方Git仓库克隆最新版本：

git clone https://github.com/cilimao/cilimao.git
cd cilimao

或使用pip直接安装稳定版：

pip install cilimao

步骤二：核心组件安装

执行安装脚本完成基础组件部署：

python setup.py install
pip install -r requirements.txt

前端资源构建命令：

npm install
npm run build

步骤三：配置文件设置

修改config/production.py中的关键配置项：

DATABASE_URI = 'postgresql://cilimao:password@localhost/cilimao_db'
REDIS_URL = 'redis://localhost:6379/0'
SECRET_KEY = 'your-secret-key-here'

步骤四：数据库初始化

执行数据库迁移命令：

python manage.py db init
python manage.py db migrate
python manage.py db upgrade

步骤五：启动服务

使用Gunicorn启动后端服务：

gunicorn -w 4 -b 0.0.0.0:5000 manage:app

前端服务启动：

npm start

安装后配置与验证

服务启动后，访问http://localhost:3000进入管理界面。首次使用需要创建管理员账户，执行：

python manage.py create_admin

验证安装是否成功：检查各服务端口状态，测试数据连接功能，验证图表渲染是否正常。建议运行基础测试套件：

python -m pytest tests/

常见问题排查

依赖冲突解决

如遇到依赖包版本冲突，可使用以下命令解决：

pip install --upgrade --force-reinstall package_name

端口占用处理

若默认端口被占用，可通过修改config文件更改服务端口：

SERVER_PORT = 5001

数据库连接错误

检查数据库服务状态，验证连接字符串格式：

psql -h localhost -U cilimao -d cilimao_db

性能优化建议

生产环境部署建议配置Nginx反向代理，启用Gzip压缩和静态文件缓存。数据库层面建议配置连接池，定期执行VACUUM操作。对于大规模数据场景，可启用查询缓存和异步任务处理功能。监控方面建议配置Prometheus指标收集和Grafana监控看板。

安全配置指南

启用HTTPS加密传输，配置防火墙规则限制访问IP。定期更新密钥和证书，设置强密码策略。建议启用操作日志审计功能，配置定期备份策略。重要数据建议进行加密存储，敏感配置项使用环境变量管理。

后续维护与升级

定期检查官方更新日志，建议在测试环境验证后再进行生产环境升级。备份数据库和配置文件后，执行：

git pull origin master
pip install -U -r requirements.txt
python manage.py db upgrade

建议订阅官方安全公告邮件列表，及时获取重要安全更新信息。

cilimao安装指南