前端部署

1. 本地的前端路径下 npm run build 生成 dist 文件夹

2. 将本地的 dist 文件夹传至宝塔 Linux 服务器中，会有个 index.html 文件命名相同，选择覆盖文件

3. 新建站点

4. 访问地址，就能打开前端界面了

5. 在宝塔 HTML 站点填入 Nginx 配置

原本前端无法访问到后端服务，通过 Nginx 来进行转发

1. 进入宝塔面板 → 网站 → 找到你刚才新建的HTML 项目站点 → 点【设置】
2. 左侧菜单选择【配置文件】（就是 Nginx 配置）
3. 把原来默认全部内容清空，粘贴截图里这段代码，然后修改两处：

▼
markdown
复制代码
server {
    listen 80;
    server_name shturl.cc/9Ngqh; # 👉这里改成你的域名，没有域名就填服务器公网IP

    # 前端静态文件
    location / {
        root /www/wwwroot/your-project/dist; # 👉改成你服务器上dist真实路径！！
        try_files $uri $uri/ /index.html;
    }

    # 后端 API 代理
    location /api {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_read_timeout 600s; # SSE流式传输需要较长的超时时间
    }
}

✅ 重点修改：

• server_name：填你的域名，没有域名就写服务器公网 IP
• root：写宝塔里这个网站目录下 dist 完整路径，例如 /www/wwwroot/vue-project/dist

4. 点【保存】，然后点【重启 Nginx】

验证：此时直接访问 IP / 域名，Vue 页面就可以打开了，但是点击接口会报错，因为 Python 后端还没启动

后端部署

建议先把本地的后端代码上传至 GitHub ，再通过 git 下载至服务器

1. 把本地的后端文件夹上传到宝塔 Linux 服务器
2. 安装 Python

软件商店，搜索 Python，下载

3. 创建虚拟环境，便于管理项目版本

建议选择 Python 3.10+ 的版本，适配本项目

最后点击右下角的 [ 创建 ] 即可

4. 创建项目

注意：

1. 填写环境变量时，把 .env 文件中的密钥全都放到这里，等号左右两边不要有空格，一行写一个密钥，最后不用加标点符号
2. 选择‘从文件加载 ’，可能会遇到宝塔已经读取环境变量，但是代码执行到 load_dotenv(override=True) 的时候，会覆盖环境变量等问题，导致最终无法成功读取环境变量，出现以下问题

5. 在虚拟环境中安装依赖、 ffmpeg、Playwright 浏览器

打开终端，通过虚拟环境的终端安装依赖

▼
markdown
复制代码
# 安装依赖
pip install -r requirements.txt

# 安装 ffmpeg
yum install ffmpeg

# 安装 Playwright 浏览器（每个人的解析视频的方法不一样，需要先判断自己的项目是否有用到这个工具）
playwright install

测试验证

1. 打开前端部署时写的域名，看能否成功下载视频、AI 总结、登录
2. 通过其他设备看能否打开并使用该网站

Bug

前端、后端部署完后，可以打开界面，但是无法读取 DEEPSEEK_API_KEY 环境变量

排查思路：

核心思路：查看日志，定位是什么错误，自己先在网上查询文档、问 AI ，最后还是不行再向其他人请教

1. Nginx 的 /api 代理配置写错
2. 后端服务是否启动成功

最终解决办法：直接在宝塔项目的环境变量区域填写这个 key。修改后完整停止并重新启动 Python 项目