部署相关问题

本文汇总了部署智站CMS时常见的问题和解决方案。

安装相关

安装向导打不开 — 检查服务是否启动,检查端口是否被占用,查看程序日志找错误信息,确认防火墙是否开放了端口。

数据库连接失败

SQLite — 检查数据库文件路径是否正确,检查目录是否有写入权限,确认SQLite驱动正常。

MySQL — 检查MySQL服务是否启动,确认数据库地址/端口/用户名/密码正确,确认数据库已创建,检查用户是否有访问权限,网络不通的话检查防火墙和安全组。

页面显示502 Bad Gateway — 这通常是Nginx反向代理配置问题:确认后端服务是否在运行,检查反向代理的地址和端口是否正确,查看Nginx错误日志。

宝塔面板相关

宝塔如何配置反向代理

  1. 进入宝塔面板 → 网站 → 站点设置
  2. 点击「反向代理」→「添加反向代理」
  3. 目标URL填写:http://127.0.0.1:8080
  4. 发送域名选择「不发送」
  5. 代理名称随便填
  6. 提交保存

静态资源加载不正常 — 可能是反向代理没有正确处理静态资源:确保反向代理配置正确,程序目录有读取权限,静态文件存在。

服务管理

如何设置开机自启 — 使用systemd管理服务,参考安装部署文档中的systemd配置方法。

如何查看程序日志 — 使用journalctl命令查看systemd服务的日志,或直接运行程序查看输出。

如何重启服务 — 使用systemctl restart命令,或直接kill掉进程重新启动。

性能问题

访问速度慢怎么办

  1. 开启静态化:生成静态页面,速度最快
  2. 使用CDN:静态资源使用CDN加速
  3. 数据库优化:数据量大的话考虑用MySQL代替SQLite
  4. 服务器配置:升级服务器配置
  5. 图片优化:压缩图片大小,使用图床

内存占用高怎么办 — 减少并发数,及时清理不需要的数据,考虑使用Agent分布式部署分担压力,SQLite单连接并发高时建议换MySQL。

域名和SSL

如何绑定域名

  1. 将域名解析到服务器IP
  2. 在宝塔面板中添加站点
  3. 配置反向代理到后端服务
  4. 申请SSL证书(建议开启)

如何配置HTTPS

  1. 在宝塔面板中申请Let's Encrypt免费证书
  2. 或者上传自己的SSL证书
  3. 开启强制HTTPS

升级相关

如何升级程序

  1. 备份数据库和配置文件
  2. 停止旧服务
  3. 替换新的二进制文件
  4. 启动新服务
  5. 检查功能是否正常

数据库迁移会自动执行,不需要手动操作。

升级后数据会丢失吗 — 不会。升级只会替换程序文件,数据都在数据库中,不会受到影响。但升级前还是建议备份。

Agent相关问题

Agent连不上怎么办 — 检查Agent是否在运行,检查配置文件中的服务端地址是否正确,检查Token是否正确,检查网络是否能访问主控端,查看Agent日志找错误信息。

Agent部署站点失败 — 检查Nginx是否安装并运行,检查Agent是否有Nginx配置目录的写入权限,检查磁盘空间是否充足,查看Agent日志和任务日志。