DEPLOYMENT.md

# 🚀 Linux部署指南

这是一个完整的聊天应用Linux部署指南，包含所有必要的脚本和配置文件。

## 📋 部署清单

### 🔧 必需软件
- [ ] Docker Engine
- [ ] Docker Compose
- [ ] Git (可选，用于版本控制)
- [ ] Nginx (用于反向代理，可选)
- [ ] Certbot (用于SSL证书，可选)

### 📁 文件清单
- [ ] `docker-compose.yml` - 生产环境配置
- [ ] `docker-compose.dev.yml` - 开发环境配置
- [ ] `Dockerfile` (client & server) - 容器构建文件
- [ ] `start.sh` - Linux启动脚本
- [ ] `stop.sh` - Linux停止脚本
- [ ] `deploy.sh` - 自动部署脚本
- [ ] `monitor.sh` - 监控脚本
- [ ] `test.sh` - 功能测试脚本
- [ ] `Makefile` - 管理命令

## 🚀 快速部署

### 方法1: 一键部署（推荐）
```bash
# 下载项目
git clone <your-repo-url>
cd chat-app

# 设置权限
chmod +x *.sh

# 一键部署
sudo ./deploy.sh
```

### 方法2: 手动部署
```bash
# 1. 安装Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 2. 启动应用
./start.sh

# 3. 验证部署
./test.sh
```

### 方法3: 使用Makefile
```bash
make install  # 设置权限
make start    # 启动应用
make health   # 检查状态
```

## 🔒 SSL配置（生产环境推荐）

```bash
# 自动配置SSL和nginx反向代理
sudo ./setup-ssl.sh
```

## 📊 监控和维护

```bash
# 查看实时监控
./monitor.sh

# 自动刷新监控（每30秒）
watch -n 30 ./monitor.sh

# 查看日志
make logs

# 备份数据库
make backup

# 测试功能
./test.sh
```

## 🔧 故障排除

### 常见问题

1. **端口被占用**
   ```bash
   # 检查端口使用情况
   sudo netstat -tulpn | grep :3000
   sudo netstat -tulpn | grep :5000
   sudo netstat -tulpn | grep :27017
   ```

2. **Docker权限问题**
   ```bash
   # 将用户添加到docker组
   sudo usermod -aG docker $USER
   # 重新登录或执行
   newgrp docker
   ```

3. **服务启动失败**
   ```bash
   # 查看详细日志
   docker-compose logs -f
   
   # 检查容器状态
   docker-compose ps
   ```

4. **内存不足**
   ```bash
   # 检查系统资源
   free -h
   df -h
   
   # 清理Docker资源
   make clean
   ```

## 🔐 安全配置

### 防火墙设置
```bash
# Ubuntu/Debian
sudo ufw allow 22    # SSH
sudo ufw allow 80    # HTTP
sudo ufw allow 443   # HTTPS
sudo ufw enable

# CentOS/RHEL
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
```

### 环境变量安全
1. 修改 `server/.env` 中的JWT密钥
2. 更改MongoDB默认密码
3. 设置强密码策略

### 定期维护
```bash
# 每日备份（添加到crontab）
0 2 * * * /path/to/chat-app/make backup

# 每周更新
0 3 * * 0 /path/to/chat-app/make update

# 监控磁盘空间
0 */6 * * * df -h | mail -s "Disk Usage Report" admin@yourdomain.com
```

## 📈 性能优化

### 系统级优化
```bash
# 增加文件描述符限制
echo "* soft nofile 65536" >> /etc/security/limits.conf
echo "* hard nofile 65536" >> /etc/security/limits.conf

# 优化网络参数
echo "net.core.somaxconn = 65536" >> /etc/sysctl.conf
sysctl -p
```

### Docker优化
```bash
# 限制日志大小
echo '{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}' > /etc/docker/daemon.json

systemctl restart docker
```

## 🆘 紧急恢复

### 快速恢复步骤
1. 停止所有服务: `make stop`
2. 恢复数据库备份: `make restore FILE=backup.gz`
3. 重启服务: `make start`
4. 验证功能: `./test.sh`

### 数据备份策略
- 每日自动备份数据库
- 保留最近30天的备份
- 异地备份重要数据

## 📞 支持联系

如果遇到问题，请：
1. 查看日志: `make logs`
2. 运行测试: `./test.sh`
3. 检查监控: `./monitor.sh`
4. 提交Issue到项目仓库