服务器部署手册

本手册详细介绍了系统在各类服务器环境下的部署步骤，包括硬件要求、软件依赖、安装配置等内容。请按照以下步骤进行部署，确保系统能够正常运行。

1. 系统要求

1.1 硬件要求

• CPU：至少4核，推荐8核或以上
• 内存：至少8GB RAM，推荐16GB或以上
• 硬盘：至少100GB可用空间，推荐SSD
• 网络：稳定的网络连接

1.2 软件依赖

• 操作系统：
  • Linux：CentOS 7/8, Ubuntu 18.04/20.04, Debian 10/11
  • 国产操作系统：麒麟V10, 统信UOS V20, 欧拉OS 21.09+
• Web服务器：Nginx 1.18+ 或 Apache 2.4+
• 数据库：
  • MySQL 8.0+ 或 MariaDB 10.5+
  • 国产数据库：达梦DM8, 金仓KingbaseES V8, 高斯GaussDB
• 运行环境：Node.js 16.0+
• 缓存服务（可选）：Redis 6.0+

2. 部署前准备

2.1 系统环境检查

在部署前，请先检查服务器环境是否满足要求：

# 检查CPU核心数
lscpu | grep "CPU(s)"

# 检查内存大小
free -h

# 检查磁盘空间
df -h

# 检查操作系统版本
cat /etc/os-release

# 检查Nginx版本
nginx -v

# 检查MySQL版本
mysql -V

# 检查Node.js版本
node -v

2.2 依赖安装

根据不同的操作系统，执行相应的命令安装必要的依赖：

CentOS/RHEL：

# 更新系统
yum update -y

# 安装必要的工具
yum install -y wget curl tar gzip unzip

Ubuntu/Debian：

# 更新系统
apt update && apt upgrade -y

# 安装必要的工具
apt install -y wget curl tar gzip unzip

国产操作系统（以麒麟V10为例）：

# 更新系统
dnf update -y

# 安装必要的工具
dnf install -y wget curl tar gzip unzip

3. 系统安装

# 创建安装目录
mkdir -p /opt/beijingit
cd /opt/beijingit

# 下载安装包（示例，实际请替换为真实下载链接）
wget https://download.example.com/system-installer-v1.2.0.tar.gz

# 解压安装包
tar -zxvf system-installer-v1.2.0.tar.gz

# 进入安装目录
cd system-installer-v1.2.0

# 赋予执行权限
chmod +x install.sh

# 执行安装（以管理员权限）
sudo ./install.sh

4. 系统配置

4.1 数据库配置

根据安装过程中的提示，配置数据库连接信息：

# 编辑数据库配置文件
cd /opt/beijingit/system/config
vi database.json

配置文件示例：

{
  "type": "mysql",  // 数据库类型：mysql, mariadb, dm, kingbase, gaussdb
  "host": "localhost",
  "port": 3306,
  "database": "system_db",
  "username": "db_user",
  "password": "your_password",
  "charset": "utf8mb4"
}

4.2 应用配置

编辑应用配置文件，设置系统参数：

# 编辑应用配置文件
cd /opt/beijingit/system/config
vi application.json

配置文件示例：

{
  "port": 8080,  // 服务端口
  "host": "0.0.0.0",  // 监听地址
  "mode": "production",  // 运行模式：development, production
  "uploadPath": "/opt/beijingit/system/uploads",  // 文件上传路径
  "sessionTimeout": 3600,  // 会话超时时间（秒）
  "logLevel": "info",  // 日志级别：debug, info, warn, error
  "redis": {
    "enabled": true,
    "host": "localhost",
    "port": 6379,
    "db": 0
  }
}

5. 启动服务

配置完成后，启动系统服务：

# 进入系统目录
cd /opt/beijingit/system

# 启动服务
./start.sh

设置服务开机自启动：

# 创建系统服务文件
sudo vi /etc/systemd/system/beijingit.service

服务文件内容：

[Unit]
Description=Beijing IT System Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/beijingit/system
ExecStart=/opt/beijingit/system/start.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

# 重新加载系统服务
sudo systemctl daemon-reload

# 设置开机自启动
sudo systemctl enable beijingit.service

# 启动服务
sudo systemctl start beijingit.service

# 查看服务状态
sudo systemctl status beijingit.service

6. 验证安装

安装完成后，验证系统是否正常运行：

1. 访问系统管理界面：在浏览器中输入 http://服务器IP:8080
2. 使用默认管理员账号登录（首次登录后请立即修改密码）：
   • 用户名：admin
   • 密码：默认密码将在安装完成后显示在终端中
3. 检查系统各功能模块是否正常工作
4. 查看系统日志，确认无错误信息

7. 常见问题

7.1 服务启动失败

如果服务启动失败，请检查以下几点：

• 检查端口是否被占用：netstat -tlnp | grep 8080
• 检查数据库连接是否正常
• 查看系统日志：tail -f /opt/beijingit/system/logs/error.log

7.2 数据库连接错误

如果出现数据库连接错误，请确认：

• 数据库服务是否正常运行
• 数据库配置信息是否正确（主机、端口、用户名、密码等）
• 数据库用户是否有足够的权限

7.3 文件上传失败

如果文件上传失败，请检查：

• 上传路径是否存在且有写入权限：chmod -R 755 /opt/beijingit/system/uploads
• Web服务器配置中是否限制了上传文件大小
• 磁盘空间是否充足

7.4 国产化环境兼容性问题

在国产化环境中遇到兼容性问题时：

• 确保使用与操作系统兼容的软件版本
• 对于国产数据库，使用系统提供的专用驱动
• 如遇到特殊问题，请联系技术支持团队获取帮助