Skip to content

环境要求

系统环境

学习追踪系统支持多种操作系统和运行环境,以下是详细的环境要求。

必需环境

Node.js 环境

最低版本: 18.0.0
推荐版本: 20.x LTS

bash
# 检查 Node.js 版本
node --version

# 检查 npm 版本
npm --version

安装方式:

  • Windows: 从 Node.js 官网 下载安装包
  • macOS: 使用 Homebrew brew install node
  • Linux: 使用包管理器或 nvm

PostgreSQL 数据库

最低版本: 12.0
推荐版本: 15.x

安装方式:

  • Windows: 从 PostgreSQL 官网 下载
  • macOS: brew install postgresql
  • Ubuntu/Debian: sudo apt install postgresql postgresql-contrib

配置要求:

  • 至少 1GB 可用内存
  • 至少 5GB 可用存储空间
  • 启用 UTF-8 编码

Redis 缓存

最低版本: 6.0
推荐版本: 7.x

安装方式:

  • Windows: 使用 WSL 或 Docker
  • macOS: brew install redis
  • Ubuntu/Debian: sudo apt install redis-server

配置要求:

  • 至少 512MB 可用内存
  • 启用持久化存储

可选环境

邮件服务

用于发送通知邮件,支持以下 SMTP 服务:

  • Gmail SMTP
  • QQ 邮箱 SMTP
  • 163 邮箱 SMTP
  • 企业邮箱 SMTP

文件存储

本地存储: 默认使用本地文件系统 云存储: 支持阿里云 OSS、腾讯云 COS(需要额外配置)

开发环境

开发工具

推荐 IDE:

  • Visual Studio Code
  • WebStorm
  • Sublime Text

浏览器支持:

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

开发依赖

bash
# 全局安装开发工具
npm install -g nodemon
npm install -g pm2

生产环境

服务器要求

最低配置:

  • CPU: 2 核心
  • 内存: 4GB
  • 存储: 20GB SSD
  • 网络: 10Mbps

推荐配置:

  • CPU: 4 核心
  • 内存: 8GB
  • 存储: 50GB SSD
  • 网络: 100Mbps

操作系统

支持的系统:

  • Ubuntu 20.04 LTS+
  • CentOS 8+
  • Debian 11+
  • Windows Server 2019+
  • macOS Server

网络要求

  • 开放端口: 3001 (应用), 5432 (PostgreSQL), 6379 (Redis)
  • HTTPS 证书(生产环境必需)
  • 域名解析配置

性能要求

并发用户

基础版: 支持 100 并发用户 标准版: 支持 500 并发用户

响应时间

  • 页面加载: < 2 秒
  • API 响应: < 500ms
  • 数据库查询: < 100ms

安全要求

网络安全

  • 启用 HTTPS
  • 配置防火墙规则
  • 定期更新系统补丁

数据安全

  • 数据库访问控制
  • 文件上传限制
  • 用户权限管理

监控要求

系统监控

  • CPU 使用率监控
  • 内存使用率监控
  • 磁盘空间监控
  • 网络流量监控

应用监控

  • 错误日志记录
  • 性能指标收集
  • 用户行为分析

备份要求

数据备份

  • 数据库每日备份
  • 文件系统定期备份
  • 配置文件备份

恢复测试

  • 定期进行恢复演练
  • 验证备份数据完整性

Released under the MIT License.