环境要求
服务器
Linux 系统（推荐 CentOS 7+ / Ubuntu 18+）
内存：最低 1GB，推荐 2GB+
数据库
MySQL 5.7+ 或 MySQL 8.0
Java
JDK 11+（推荐 JDK 17 或 21）
创建数据库
在宝塔面板中创建数据库：
- 打开宝塔面板 → 数据库 → 添加数据库
- 数据库名：
tv_store
- 用户名：
tv_store
- 设置一个强密码
数据库表会在首次启动时自动创建，无需手动导入 SQL
部署后端
1. 创建项目目录并上传文件：
mkdir -p /www/wwwroot/tv-launcher
# 上传 tv-launcher-server-1.0.0-encrypted.jar 和 application.yml
2. 创建配置文件 application.yml：
server:
port: 8088
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/tv_store?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
username: tv_store
password: 你的数据库密码
jpa:
hibernate:
ddl-auto: update
# 文件上传路径（必须使用绝对路径！）
upload:
path: /www/wwwroot/tv-launcher/uploads
runtime:
key: 你的授权密钥
encrypted-server-url: 从授权方获取
# 观影模式配置（企业版，编码后的API地址）
movie-mode:
cos-main-url: 从授权方获取
main-url: 从授权方获取
app-id: "10000"
3. 启动命令（请根据实际 JDK 路径调整）：
# JDK 路径请根据宝塔安装的实际版本调整
# 例如：/www/server/java/jdk-17.0.x/bin/java
# 或者：/www/server/java/jdk-21.0.x/bin/java
/www/server/java/jdk-21.0.2/bin/java \
-javaagent:/www/wwwroot/tv-launcher/tv-launcher-server-1.0.0-encrypted.jar="-pwd 你的解密密码" \
-Xmx1024M -Xms256M \
-jar /www/wwwroot/tv-launcher/tv-launcher-server-1.0.0-encrypted.jar \
--server.port=8088
不会部署？联系我们提供付费部署服务，仅需 50 元，快速上线无忧
OSS 配置（可选）
如需使用阿里云 OSS 存储上传的文件（推荐大流量场景），在 application.yml 中添加以下配置：
# 阿里云 OSS 配置（可选，不配置则使用本地存储）
aliyun:
oss:
enabled: true
endpoint: oss-cn-hangzhou.aliyuncs.com
access-key-id: 你的AccessKeyId
access-key-secret: 你的AccessKeySecret
bucket-name: 你的Bucket名称
# 自定义域名（可选，用于加速访问）
custom-domain: https://cdn.your-domain.com
配置步骤：
- 登录 阿里云 OSS 控制台
- 创建 Bucket，选择与服务器相近的地域
- 设置 Bucket 读写权限为「公共读」
- 在 RAM 访问控制中创建 AccessKey
- 将 AccessKey 信息填入配置文件
不配置 OSS？系统会自动使用本地存储，文件保存在 upload.path 指定的目录
安全提示：请妥善保管 AccessKey，不要泄露给他人。建议使用 RAM 子账号并仅授予 OSS 相关权限
部署前端
1. 创建网站目录：
/www/wwwroot/tv-launcher-admin/
2. 上传 dist 文件夹中的所有文件
3. 目录结构：
/www/wwwroot/tv-launcher-admin/
├── index.html
├── assets/
│ ├── index-xxx.js
│ └── index-xxx.css
└── ...
4. 配置伪静态（重要）：
location / {
try_files $uri $uri/ /index.html;
}
在宝塔面板的网站设置中，找到「伪静态」选项，粘贴上述配置即可
配置 Nginx
server {
listen 80;
server_name your-domain.com;
root /www/wwwroot/tv-launcher-admin;
index index.html;
client_max_body_size 100M;
# 前端路由
location / {
try_files $uri $uri/ /index.html;
}
# API 代理
location /api {
proxy_pass http://127.0.0.1:8088;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
# 上传文件
location /uploads {
alias /www/wwwroot/tv-launcher/uploads;
}
}
