138 lines
2.2 KiB
Markdown
138 lines
2.2 KiB
Markdown
# 快速部署系统 - 部署文档
|
||
|
||
## 系统要求
|
||
|
||
- Node.js 18.0 或更高版本
|
||
- npm 9.0 或更高版本
|
||
- 腾讯云服务器 (推荐配置: 2核4G)
|
||
|
||
## 一、服务器环境配置
|
||
|
||
### 1. 安装 Node.js
|
||
|
||
```bash
|
||
# 使用 nvm 安装 Node.js
|
||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
|
||
source ~/.bashrc
|
||
nvm install 18
|
||
nvm use 18
|
||
```
|
||
|
||
### 2. 安装 PM2 (进程管理器)
|
||
|
||
```bash
|
||
npm install -g pm2
|
||
```
|
||
|
||
### 3. 配置防火墙
|
||
|
||
```bash
|
||
# 开放系统端口
|
||
firewall-cmd --permanent --add-port=8888/tcp
|
||
firewall-cmd --permanent --add-port=9000-9100/tcp
|
||
firewall-cmd --reload
|
||
```
|
||
|
||
### 4. 腾讯云安全组配置
|
||
|
||
在腾讯云控制台配置安全组规则：
|
||
- 开放 8888 端口 (管理界面)
|
||
- 开放 9000-9100 端口范围 (部署的项目)
|
||
|
||
## 二、项目部署
|
||
|
||
### 1. 上传项目代码
|
||
|
||
```bash
|
||
# 将项目上传到服务器
|
||
scp -r auto-deploy-demo root@your-server-ip:/opt/
|
||
```
|
||
|
||
### 2. 安装依赖
|
||
|
||
```bash
|
||
cd /opt/auto-deploy-demo
|
||
|
||
# 安装后端依赖
|
||
npm install
|
||
|
||
# 安装前端依赖并构建
|
||
cd client
|
||
npm install
|
||
npm run build
|
||
cd ..
|
||
```
|
||
|
||
### 3. 配置环境变量
|
||
|
||
创建 `.env` 文件：
|
||
|
||
```bash
|
||
cat > .env << EOF
|
||
PORT=8888
|
||
JWT_SECRET=your-secure-secret-key-change-this
|
||
BASE_DOMAIN=your-domain.com
|
||
PROJECT_PORT_START=9000
|
||
PROJECT_PORT_END=9100
|
||
EOF
|
||
```
|
||
|
||
默认登录账号：
|
||
- 用户名: admin
|
||
- 密码: 1221xian
|
||
|
||
### 4. 启动服务
|
||
|
||
```bash
|
||
# 使用 PM2 启动
|
||
pm2 start server/index.js --name "deploy-system"
|
||
|
||
# 设置开机自启
|
||
pm2 startup
|
||
pm2 save
|
||
```
|
||
|
||
### 5. 验证部署
|
||
|
||
访问 `http://your-server-ip:8888` 检查系统是否正常运行。
|
||
|
||
## 三、Nginx 反向代理配置 (可选)
|
||
|
||
如需使用域名访问，可配置 Nginx：
|
||
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name your-domain.com;
|
||
|
||
location / {
|
||
proxy_pass http://127.0.0.1:8888;
|
||
proxy_http_version 1.1;
|
||
proxy_set_header Upgrade $http_upgrade;
|
||
proxy_set_header Connection 'upgrade';
|
||
proxy_set_header Host $host;
|
||
proxy_cache_bypass $http_upgrade;
|
||
}
|
||
}
|
||
```
|
||
|
||
## 四、常见问题
|
||
|
||
### Q: 端口被占用怎么办？
|
||
|
||
检查端口占用：
|
||
```bash
|
||
lsof -i :8888
|
||
```
|
||
|
||
### Q: 如何查看日志？
|
||
|
||
```bash
|
||
pm2 logs deploy-system
|
||
```
|
||
|
||
### Q: 如何重启服务？
|
||
|
||
```bash
|
||
pm2 restart deploy-system
|
||
``` |