安装部署：宝塔面板部署

前置条件

• 已安装宝塔面板
• 已准备域名并解析到服务器 IP

1. 上传并解压程序

推荐部署目录：

/opt/vvcms5

上传发布包后解压，并确保 app1 有执行权限。

chmod +x /opt/vvcms5/app1

2. 配置文件

cp /opt/vvcms5/configs/config.yaml.example /opt/vvcms5/configs/config.yaml
vim /opt/vvcms5/configs/config.yaml

建议把监听改为本机：127.0.0.1:8000，由 Nginx 反代到公网。

3. 宝塔创建站点与反向代理

1. 宝塔 - 网站 - 添加站点：绑定域名，选择 Nginx
2. 站点设置 - 反向代理：目标 URL 填 http://127.0.0.1:8000
3. 站点设置 - SSL：申请并强制 HTTPS（可选）

4. 进程守护（方式一：宝塔进程守护）

宝塔 - 软件商店 搜索“进程守护/Supervisor”，创建守护进程：

命令：/opt/vvcms5/app1 -t vvcms5
目录：/opt/vvcms5

4. 进程守护（方式二：systemd）

若你更习惯 systemd，也可以按 Linux 部署 创建服务。

5. 初始化与后台

• 访问：https://你的域名
• 后台：https://你的域名/admin
• 需要演示数据时，在后台导入主题初始化数据

排查建议

• 页面 502：检查进程是否启动、端口是否监听、反代地址是否正确
• 上传失败：检查 uploads/ 权限与磁盘空间