webssh/docs/DEPLOYMENT.md

部署指南

Docker 部署

快速开始

# 一键部署
./deploy.sh

# 访问应用
http://localhost:3000

部署脚本功能

• 自动检查Docker环境
• 清理现有容器和镜像
• 生成生产环境配置文件
• 构建Docker镜像
• 启动服务并健康检查

环境变量

部署脚本会自动生成 .env.production 文件：

# 数据库配置
DB_HOST=mysql
DB_PORT=3306
DB_USER=webssh_user
DB_PASSWORD=webssh_password
DB_NAME=webssh

# JWT配置
JWT_SECRET=<随机生成>

# 服务器配置
PORT=3000
NODE_ENV=production

# 加密密钥（32字节）
ENCRYPTION_KEY=<随机生成>

手动部署

环境要求

• Node.js 16+
• MySQL 5.7+

步骤

1. 安装依赖

npm install

2. 数据库初始化

mysql -u root -p < install.sql

3. 环境配置

cp backend/.env.example backend/.env
# 编辑 backend/.env 文件

4. 启动应用

# 开发模式
npm run dev

# 生产模式
npm run build
npm start

端口配置

• 前端：5173 (开发) / 3000 (生产)
• 后端：3000
• MySQL：3306

故障排除

常见问题

Docker 部署问题

# 检查服务状态
docker compose ps

# 查看日志
docker compose logs

# 重启服务
docker compose restart

加密密钥错误 确保 ENCRYPTION_KEY 为32字节长度：

node -e "console.log(process.env.ENCRYPTION_KEY.length)"

数据库连接失败 检查MySQL服务状态和用户权限：

# 检查服务状态
sudo systemctl status mysql

# 检查数据库连接
mysql -u webssh_user -p webssh