🚀 视频去水印小程序 – 部署与配置文档

这份文档完整梳理了项目的二次部署与维护指南。无论是换服务器、换域名还是换去水印接口，只需参照此文档操作，即可在 10 分钟内顺利上线。

https://www.jck123.cn/archives/445

一、 核心参数修改对照表（速查）

二、 宝塔面板环境配置与启动流程

1. 安装必备软件

在宝塔左侧【软件商店】内搜索并安装：

• MongoDB：数据库系统（推荐 4.x 或 5.x 版本）。安装后确认状态为“运行中”。
• PM2管理器：Node.js 环境管理工具（Node 版本选择 v16 或以上）。
• Nginx：用于配置域名和反向代理。

2. 添加站点与配置 SSL 证书

• 点击左侧【网站】-> 【添加站点】，输入你的后台域名（例如：jk.yourdomain.com）。
• 在网站设置中点击【SSL】，申请并开启 HTTPS 证书（小程序强制要求 HTTPS）。

3. 配置 Nginx 反向代理

• 在刚添加的网站设置中，找到【反向代理】->【添加反向代理】。
• 目标 URL 填写： http://127.0.0.1:3000
• 发送域名 填写： $host
• 提交保存。这一步让外网的 HTTPS 域名能够访问到服务器内部 3000 端口的后端服务。

4. 上传代码与安装依赖

将后端代码文件夹上传到服务器（如 /www/wwwroot/backend/），在宝塔中打开该目录的终端，执行：

npm install

5. 启动后端项目

继续在终端中输入 PM2 命令，让后端在后台永久运行：

pm2 start server.js --name "watermark-api"

三、 后端代码修改说明 (server.js)

如果将来更换了小程序、解析接口或者数据库报错，请打开后端 server.js 重点修改以下区域：

1. 替换小程序凭证与接口链接

// 【配置你的小程序参数】
const WX_APPID = '替换为新的 AppID';
const WX_SECRET = '替换为新的 AppSecret';

// 【配置解析接口秘钥】
// 更换服务商时替换此链接，注意保留最后的 `url=` 以便动态拼接
const PARSE_API_URL = 'https://jx.72ke.vip/home/api?type=dsp&uid=xxxx&key=xxxx&url=';

2. 数据库连接地址

mongoose.connect('mongodb://127.0.0.1:27017/watermark_db', { useNewUrlParser: true, useUnifiedTopology: true })

注意：修改完 server.js 后，必须在服务器终端执行 pm2 restart watermark-api 使代码生效。

四、 前端代码修改说明 (utils/api.js)

前端唯一需要修改服务器域名的地方在 utils/api.js：

// 注意：必须是线上域名，HTTPS开头，并拼上 /api
const BASE_URL = 'https://你的新域名.com/api'; 

export const request = (url, method = 'GET', data = {}) => {
  // ...下方的网络请求逻辑保持不变
}

五、 微信小程序后台配置（防白屏必看）

部署完成后，必须登录 微信公众平台 完成合法域名配置，否则手机真机无法联网：

1. 左侧菜单栏找到 【开发】 -> 【开发管理】，点击顶部的 【开发设置】。
2. 向下滚动找到 【服务器域名】，点击“修改”。
3. 在 request 合法域名 中填入后台域名（例：https://jk.yourdomain.com）。
4. （可选）如果需要保存视频到相册，需将第三方解析平台返回的视频源域名（如 https://v11-cold.douyinvod.com 等）添加到 downloadFile 合法域名 中。

💡 附：日常维护常用命令

以下命令请在服务器后台的 SSH 终端内执行：

# 1. 查看后端实时运行日志（排查报错神器，可按 Ctrl+C 退出）
pm2 logs

# 2. 重启后端服务（改完 server.js 代码后必须执行）
pm2 restart watermark-api

# 3. 停止后端服务
pm2 stop watermark-api

# 4. 设置开机自启（服务器重启后让 Node.js 自动跑起来）
pm2 save
pm2 startup