mengyalinkfly/部署说明.md

萌芽短链 - 前后端分离部署说明

架构说明

• 前端：构建为静态HTML文件，部署在Nginx服务器（8989端口）
• 后端：部署在Docker容器中（7878端口）

部署步骤

一、后端部署（Docker容器）

1. 构建Docker镜像

cd mengyalinkfly-backend
docker build -t mengyalinkfly-backend:latest .

2. 运行Docker容器

docker run -d \
  --name mengyalinkfly-backend \
  -p 7878:7878 \
  -v /shumengya/docker/storage/mengyalinkfly:/app/data \
  --restart unless-stopped \
  mengyalinkfly-backend:latest

3. 查看容器日志

docker logs -f mengyalinkfly-backend

二、前端部署（静态文件）

1. 构建前端

cd mengyalinkfly-frontend
npm install
npm run build

2. 部署到Nginx

# 复制构建产物到服务器
cp -r dist/* /shumengya/www/mengyalinkfly-frontend/

# 复制nginx配置（根目录下的nginx.conf）
cp nginx.conf /etc/nginx/sites-available/mengyalinkfly
ln -s /etc/nginx/sites-available/mengyalinkfly /etc/nginx/sites-enabled/

# 测试nginx配置
nginx -t

# 重启nginx
systemctl restart nginx

配置说明

1. 修改前端服务器地址

编辑 nginx.conf，将 localhost 替换为实际的后端服务器IP（如果前后端不在同一台机器）：

# 如果后端在其他服务器，修改为实际IP
location /api {
    proxy_pass http://后端服务器IP:7878;
    ...
}

location ~ ^/[a-zA-Z0-9]{4}$ {
    proxy_pass http://后端服务器IP:7878;
    ...
}

2. 修改CORS配置

编辑 mengyalinkfly-backend/app.py，添加你的前端域名：

CORS(app, origins=[
    "http://localhost:8989", 
    "http://127.0.0.1:8989", 
    "http://your-frontend-domain.com"  # 添加你的实际域名
])

访问方式

• 前端页面：http://your-server:8989
• 后端API：http://your-server:7878/api/*
• 短链跳转：http://your-server:8989/XXXX （4位短链代码）

功能特点

✅ 支持浏览器访问 - 通过前端页面创建和管理短链接
✅ 支持命令行工具 - wget、curl可直接下载文件（自动HTTP 302重定向）
✅ 前后端分离 - 易于扩展和维护
✅ Docker容器化 - 后端一键部署

测试命令

# 测试后端API
curl http://localhost:7878/api/links

# 测试短链跳转（浏览器）
curl -L http://localhost:8989/4GLS

# 测试wget下载（命令行）
wget http://localhost:8989/4GLS

目录结构

/shumengya/
├── www/
│   └── mengyalinkfly-frontend/     # 前端静态文件目录
│       ├── index.html
│       ├── assets/
│       └── ...
└── docker/
    └── storage/
        └── mengyalinkfly/          # 后端数据持久化目录
            └── link_data.json

常见问题

1. wget下载HTML而不是文件？

确保nginx配置中有短链匹配规则，并且优先级在前端路由之前。

2. API跨域错误？

检查后端的CORS配置，确保包含了前端域名。

3. 容器无法启动？

检查端口7878是否被占用：netstat -tulpn | grep 7878